View file vendor/intervention/gif/src/Decoders/LogicalScreenDescriptorDecoder.php

File size: 4.04Kb
<?php

declare(strict_types=1);

namespace Intervention\Gif\Decoders;

use Intervention\Gif\Blocks\LogicalScreenDescriptor;
use Intervention\Gif\Exceptions\DecoderException;

class LogicalScreenDescriptorDecoder extends AbstractPackedBitDecoder
{
    /**
     * Decode given string to current instance
     *
     * @throws DecoderException
     */
    public function decode(): LogicalScreenDescriptor
    {
        $logicalScreenDescriptor = new LogicalScreenDescriptor();

        // bytes 1-4
        $logicalScreenDescriptor->setSize(
            $this->decodeWidth($this->getNextBytesOrFail(2)),
            $this->decodeHeight($this->getNextBytesOrFail(2))
        );

        // byte 5
        $packedField = $this->getNextByteOrFail();

        $logicalScreenDescriptor->setGlobalColorTableExistance(
            $this->decodeGlobalColorTableExistance($packedField)
        );

        $logicalScreenDescriptor->setBitsPerPixel(
            $this->decodeBitsPerPixel($packedField)
        );

        $logicalScreenDescriptor->setGlobalColorTableSorted(
            $this->decodeGlobalColorTableSorted($packedField)
        );

        $logicalScreenDescriptor->setGlobalColorTableSize(
            $this->decodeGlobalColorTableSize($packedField)
        );

        // byte 6
        $logicalScreenDescriptor->setBackgroundColorIndex(
            $this->decodeBackgroundColorIndex($this->getNextByteOrFail())
        );

        // byte 7
        $logicalScreenDescriptor->setPixelAspectRatio(
            $this->decodePixelAspectRatio($this->getNextByteOrFail())
        );

        return $logicalScreenDescriptor;
    }

    /**
     * Decode width
     *
     * @throws DecoderException
     */
    protected function decodeWidth(string $source): int
    {
        $unpacked = unpack('v*', $source);

        if ($unpacked === false || !array_key_exists(1, $unpacked)) {
            throw new DecoderException('Unable to decode width.');
        }

        return $unpacked[1];
    }

    /**
     * Decode height
     *
     * @throws DecoderException
     */
    protected function decodeHeight(string $source): int
    {
        $unpacked = unpack('v*', $source);

        if ($unpacked === false || !array_key_exists(1, $unpacked)) {
            throw new DecoderException('Unable to decode height.');
        }

        return $unpacked[1];
    }

    /**
     * Decode existance of global color table
     *
     * @throws DecoderException
     */
    protected function decodeGlobalColorTableExistance(string $byte): bool
    {
        return $this->hasPackedBit($byte, 0);
    }

    /**
     * Decode color resolution in bits per pixel
     *
     * @throws DecoderException
     */
    protected function decodeBitsPerPixel(string $byte): int
    {
        return intval(bindec($this->getPackedBits($byte, 1, 3))) + 1;
    }

    /**
     * Decode global color table sorted status
     *
     * @throws DecoderException
     */
    protected function decodeGlobalColorTableSorted(string $byte): bool
    {
        return $this->hasPackedBit($byte, 4);
    }

    /**
     * Decode size of global color table
     *
     * @throws DecoderException
     */
    protected function decodeGlobalColorTableSize(string $byte): int
    {
        return intval(bindec($this->getPackedBits($byte, 5, 3)));
    }

    /**
     * Decode background color index
     *
     * @throws DecoderException
     */
    protected function decodeBackgroundColorIndex(string $source): int
    {
        $unpacked = unpack('C', $source);

        if ($unpacked === false || !array_key_exists(1, $unpacked)) {
            throw new DecoderException('Unable to decode background color index.');
        }

        return $unpacked[1];
    }

    /**
     * Decode pixel aspect ratio
     *
     * @throws DecoderException
     */
    protected function decodePixelAspectRatio(string $source): int
    {
        $unpacked = unpack('C', $source);

        if ($unpacked === false || !array_key_exists(1, $unpacked)) {
            throw new DecoderException('Unable to decode pixel aspect ratio.');
        }

        return $unpacked[1];
    }
}