Просмотр архива ROTOR 14.1.1


<?php

declare(strict_types=1);

namespace InterventionGif;

use InterventionGifBlocksColorTable;
use InterventionGifBlocksCommentExtension;
use InterventionGifBlocksFrameBlock;
use InterventionGifBlocksHeader;
use InterventionGifBlocksLogicalScreenDescriptor;
use InterventionGifBlocksNetscapeApplicationExtension;
use InterventionGifBlocksTrailer;

class GifDataStream extends AbstractEntity
{
    /**
     * Create new instance.
     *
     * @param array<FrameBlock> $frames
     * @param array<CommentExtension> $comments
     */
    public function __construct(
        protected Header $header = new Header(),
        protected LogicalScreenDescriptor $logicalScreenDescriptor = new LogicalScreenDescriptor(),
        protected ?ColorTable $globalColorTable = null,
        protected array $frames = [],
        protected array $comments = []
    ) {
        //
    }

    /**
     * Get header.
     */
    public function header(): Header
    {
        return $this->header;
    }

    /**
     * Set header.
     */
    public function setHeader(Header $header): self
    {
        $this->header = $header;

        return $this;
    }

    /**
     * Get logical screen descriptor.
     */
    public function logicalScreenDescriptor(): LogicalScreenDescriptor
    {
        return $this->logicalScreenDescriptor;
    }

    /**
     * Set logical screen descriptor.
     */
    public function setLogicalScreenDescriptor(LogicalScreenDescriptor $descriptor): self
    {
        $this->logicalScreenDescriptor = $descriptor;

        return $this;
    }

    /**
     * Return global color table if available else null.
     */
    public function globalColorTable(): ?ColorTable
    {
        return $this->globalColorTable;
    }

    /**
     * Set global color table.
     */
    public function setGlobalColorTable(ColorTable $table): self
    {
        $this->globalColorTable = $table;
        $this->logicalScreenDescriptor->setGlobalColorTableExistance(true);
        $this->logicalScreenDescriptor->setGlobalColorTableSize(
            $table->logicalSize()
        );

        return $this;
    }

    /**
     * Get main graphic control extension.
     */
    public function mainApplicationExtension(): ?NetscapeApplicationExtension
    {
        foreach ($this->frames as $frame) {
            $extension = $frame->netscapeExtension();
            if ($extension !== null) {
                return $extension;
            }
        }

        return null;
    }

    /**
     * Get array of frames.
     *
     * @return array<FrameBlock>
     */
    public function frames(): array
    {
        return $this->frames;
    }

    /**
     * Return array of "global" comments.
     *
     * @return array<CommentExtension>
     */
    public function comments(): array
    {
        return $this->comments;
    }

    /**
     * Return first frame.
     */
    public function firstFrame(): ?FrameBlock
    {
        if ($this->frames === []) {
            return null;
        }

        if (!array_key_exists(0, $this->frames)) {
            return null;
        }

        return $this->frames[0];
    }

    /**
     * Add frame.
     */
    public function addFrame(FrameBlock $frame): self
    {
        $this->frames[] = $frame;

        return $this;
    }

    /**
     * Add comment extension.
     */
    public function addComment(CommentExtension $comment): self
    {
        $this->comments[] = $comment;

        return $this;
    }

    /**
     * Set the current data.
     *
     * @param array<FrameBlock> $frames
     */
    public function setFrames(array $frames): self
    {
        $this->frames = $frames;

        return $this;
    }

    /**
     * Get trailer.
     */
    public function trailer(): Trailer
    {
        return new Trailer();
    }

    /**
     * Determine if gif is animated.
     */
    public function isAnimated(): bool
    {
        return count($this->frames()) > 1;
    }

    /**
     * Determine if global color table is set.
     */
    public function hasGlobalColorTable(): bool
    {
        return !is_null($this->globalColorTable);
    }
}