HEX
Server: Apache
System: Linux server1.ariadata.co 4.18.0-553.120.1.el8_10.x86_64 #1 SMP Mon Apr 20 18:04:27 EDT 2026 x86_64
User: nepi (1051)
PHP: 7.4.33
Disabled: exec,passthru,shell_exec,system,show_source,popen,proc_open
Upload Files
File: /home/nepi/www/vendor/char0n/ffmpeg-php/src/Frame.php
<?php

namespace Char0n\FFMpegPHP;

/**
 * Represents one frame from the movie.
 */
class Frame implements \Serializable
{

    protected static $EX_CODE_NO_VALID_RESOURCE = 334563;

    /**
     * GdImage binary data.
     *
     * @var string
     */
    protected $gdImageData;

    /**
     * Presentation time stamp.
     *
     * @var float
     */
    protected $pts;

    /**
     * Frame width in pixels.
     *
     * @var int
     */
    protected $width;

    /**
     * Frame height in pixels.
     *
     * @var int
     */
    protected $height;

    /**
     * Create a Frame object from a GD image.
     *
     * @param resource $gdImage Image resource of type gd.
     * @param float    $pts Frame presentation timestamp.
     *
     * @throws \UnexpectedValueException
     */
    public function __construct($gdImage, $pts = 0.0)
    {
        if (!(is_resource($gdImage) && 'gd' === get_resource_type($gdImage))) {
            throw new \UnexpectedValueException(
                'Param given by constructor is not valid gd resource',
                self::$EX_CODE_NO_VALID_RESOURCE
            );
        }

        $this->gdImageData = $this->gdImageToBinaryData($gdImage);
        $this->width = imagesx($gdImage);
        $this->height = imagesy($gdImage);
        $this->pts = $pts;
    }

    /**
     * Transforms gdImage resource to binary data.
     *
     * @param resource $gdImage
     * @return string
     */
    protected function gdImageToBinaryData($gdImage)
    {
        ob_start();
        imagegd2($gdImage);

        return ob_get_clean();
    }

    /**
     * Return the presentation time stamp of the frame.
     *
     * @return float
     */
    public function getPresentationTimestamp()
    {
        return $this->getPTS();
    }

    /**
     * Return the presentation time stamp of the frame; alias $frame->getPresentationTimestamp().
     *
     * @return float
     */
    public function getPTS()
    {
        return $this->pts;
    }

    /**
     * Crop the frame.
     *
     * NOTE: Crop values must be even numbers.
     *
     * @param int $cropTop    Rows of pixels removed from the top of the frame.
     * @param int $cropBottom Rows of pixels removed from the bottom of the frame.
     * @param int $cropLeft   Rows of pixels removed from the left of the frame.
     * @param int $cropRight  Rows of pixels removed from the right of the frame.
     *
     * @return void
     */
    public function crop($cropTop, $cropBottom = 0, $cropLeft = 0, $cropRight = 0)
    {
        $this->resize($this->getWidth(), $this->getHeight(), $cropTop, $cropBottom, $cropLeft, $cropRight);
    }

    /**
     * Resize and optionally crop the frame. (Cropping is built into ffmpeg resizing so I'm providing it here for
     * completeness.)
     *
     * NOTE: Cropping is always applied to the frame before it is resized. Crop values must be even numbers.
     *
     * @param int $width      New width of the frame (must be an even number).
     * @param int $height     New height of the frame (must be an even number).
     * @param int $cropTop    Rows of pixels removed from the top of the frame.
     * @param int $cropBottom Rows of pixels removed from the bottom of the frame.
     * @param int $cropLeft   Rows of pixels removed from the left of the frame.
     * @param int $cropRight  Rows of pixels removed from the right of the frame.
     *
     * @return void
     */
    public function resize($width, $height, $cropTop = 0, $cropBottom = 0, $cropLeft = 0, $cropRight = 0)
    {
        $widthCrop = ($cropLeft + $cropRight);
        $heightCrop = ($cropTop + $cropBottom);
        $width -= $widthCrop;
        $height -= $heightCrop;
        $resizedImage = imagecreatetruecolor($width, $height);
        $gdImage = $this->toGDImage();
        imagecopyresampled(
            $resizedImage,
            $gdImage,
            0,
            0,
            $cropLeft,
            $cropTop,
            $width,
            $height,
            $this->getWidth() - $widthCrop,
            $this->getHeight() - $heightCrop
        );
        imageconvolution(
            $resizedImage,
            [
                [-1, -1, -1],
                [-1, 24, -1],
                [-1, -1, -1],
            ],
            16,
            0
        );

        $this->gdImageData = $this->gdImageToBinaryData($resizedImage);
        $this->width = imagesx($resizedImage);
        $this->height = imagesy($resizedImage);
        imagedestroy($gdImage);
        imagedestroy($resizedImage);
    }

    /**
     * Returns a truecolor GD image of the frame.
     *
     * @return resource Resource of type gd.
     */
    public function toGDImage()
    {
        return imagecreatefromstring($this->gdImageData);
    }

    /**
     * Return the width of the frame.
     *
     * @return int
     */
    public function getWidth()
    {
        return $this->width;
    }

    /**
     * Return the height of the frame.
     *
     * @return int
     */
    public function getHeight()
    {
        return $this->height;
    }

    /**
     * Return string representation of a Frame.
     *
     * @return string The string representation of the object or null.
     */
    public function serialize()
    {
        $data = [
            $this->gdImageData,
            $this->pts,
            $this->width,
            $this->height,
        ];

        return serialize($data);
    }

    /**
     * Constructs the Frame from serialized data.
     *
     * @param string $serialized The string representation of Frame instance.
     *
     * @return void
     */
    public function unserialize($serialized)
    {
        list(
            $this->gdImageData,
            $this->pts,
            $this->width,
            $this->height
        ) = unserialize($serialized);
    }
}