ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / lab2454c / healthvalidate.com / vendor / cloudinary / cloudinary_php / src / Tag

<?php
/**
 * This file is part of the Cloudinary PHP package.
 *
 * (c) Cloudinary
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Cloudinary\Tag;

use Cloudinary\ArrayUtils;
use Cloudinary\Asset\AssetDescriptorTrait;
use Cloudinary\Asset\AssetType;
use Cloudinary\Asset\Image;
use Cloudinary\Asset\Video;
use Cloudinary\Configuration\AssetConfigTrait;
use Cloudinary\Configuration\Configuration;
use Cloudinary\Transformation\BaseAction;
use Cloudinary\Transformation\CommonTransformation;
use Cloudinary\Transformation\ImageTransformation;
use Cloudinary\Transformation\Qualifier\BaseQualifier;
use Cloudinary\Transformation\VideoCodec;
use Cloudinary\Transformation\VideoTransformationInterface;
use Cloudinary\Transformation\VideoTransformationTrait;

/**
 * Generates an HTML `<video>` tag with specified attributes, containing `<source>` tags for the transformation URLs.
 *
 * For example:
 *
 * ```
 * <video poster="https://res.cloudinary.com/demo/video/upload/dog.jpg">
 * <source src="https://res.cloudinary.com/demo/video/upload/vc_h265/dog.mp4" type="video/mp4; codecs=hev1">
 * <source src="https://res.cloudinary.com/demo/video/upload/vc_vp9/dog.webm" type="video/webm; codecs=vp9">
 * <source src="https://res.cloudinary.com/demo/video/upload/vc_auto/dog.mp4" type="video/mp4">
 * <source src="https://res.cloudinary.com/demo/video/upload/vc_auto/dog.webm" type="video/webm">
 * </video>
 * ```
 *
 * @api
 */
class VideoTag extends BaseTag implements VideoTransformationInterface
{
    use VideoTagDeliveryTypeTrait;
    use VideoTransformationTrait;
    use AssetDescriptorTrait;
    use AssetConfigTrait;

const NAME = 'video';

/**
     * @var Video $video The video of the tag.
     */
    protected $video;

/**
     * @var array $sources VideoSourceTag array
     */
    protected $sources;

/**
     * The default video sources of the video tag.
     *
     * @return array
     */
    public static function defaultVideoSources()
    {
        return [
            [
                'type'           => VideoSourceType::mp4('hev1'),
                'transformation' => VideoCodec::h265(),
            ],
            [
                'type'           => VideoSourceType::webm('vp9'),
                'transformation' => VideoCodec::vp9(),
            ],
            [
                'type'           => VideoSourceType::mp4(),
                'transformation' => VideoCodec::auto(),
            ],
            [
                'type'           => VideoSourceType::webm(),
                'transformation' => VideoCodec::auto(),
            ],
        ];
    }

protected static $defaultSourceTypes = ['webm', 'mp4', 'ogv'];

/**
     * VideoTag constructor.
     *
     * @param string|Video  $video         The public ID or Video instance.
     * @param array|null    $sources       The tag sources definition.
     * @param Configuration $configuration The configuration instance.
     */
    public function __construct($video, $sources = null, $configuration = null)
    {
        parent::__construct($configuration);

$this->video($video, $configuration);

$sources = $sources !== null ? $sources : self::defaultVideoSources();
        $this->sources($sources);
    }

/**
     * Sets the video of the tag.
     *
     * @param mixed         $video         The public ID or the Video asset.
     * @param Configuration $configuration The configuration instance.
     *
     * @return static
     */
    public function video($video, $configuration = null)
    {
        $this->video = new Video($video, $configuration);

return $this;
    }

/**
     * Sets the tag sources.
     *
     * @param array $sourcesDefinitions The definitions of the sources.
     *
     * @return $this
     */
    public function sources($sourcesDefinitions)
    {
        $this->sources = [];

foreach ($sourcesDefinitions as $source) {
            if (is_array($source)) {
                $sourceTag = new VideoSourceTag(
                    $this->video,
                    $this->config,
                    ArrayUtils::get($source, 'transformation', ArrayUtils::get($source, 'transformations'))
                );
                $sourceTag->type(ArrayUtils::get($source, 'type'), ArrayUtils::get($source, 'codecs'));

$source = $sourceTag;
            }

$this->sources [] = $source;
        }

return $this;
    }

/**
     * Creates a new video tag from the provided source and an array of parameters.
     *
     * @param string $source The public ID of the asset.
     * @param array  $params The asset parameters.
     *
     * @return mixed
     */

public static function fromParams($source, $params = [])
    {
        $video = Video::fromParams($source, $params);

$tagAttributes = ArrayUtils::pop($params, 'attributes', []);

$fallback = ArrayUtils::pop($params, 'fallback_content', '');

$sources     = ArrayUtils::pop($params, 'sources');
        $sourceTypes = ArrayUtils::pop($params, 'source_types', self::$defaultSourceTypes);
        // fallback to (legacy) source types
        if (empty($sources)) {
            $sources = self::populateSourceTypesSources($sourceTypes, $params);
        }

if (count($sources) === 1) {
            $video->asset->setPublicId($video->asset->publicId(true) . '.' . $sources[0]['type']);
            $sources = [];
        }

$configuration                        = self::fromParamsDefaultConfig();
        $configuration->tag->voidClosingSlash = false;

$configuration->importJson($params);

$tagAttributes['poster'] = self::generateVideoPosterAttr($source, $params, $configuration);
        if (empty($tagAttributes['poster'])) {
            $tagAttributes['poster'] = false; // indicates that we want to omit poster attribute
        }

TagUtils::handleSpecialAttributes($tagAttributes, $params, $configuration);
        $tagAttributes = array_merge($tagAttributes, self::collectAttributesFromParams($params));

return (new static($video, $sources, $configuration))->setAttributes($tagAttributes)->fallback($fallback);
    }

/**
     * Helper function for cl_video_tag, generates video poster URL
     *
     * @param string $source      The public ID of the resource
     * @param array  $videoParams Additional options
     * @param        $configuration
     *
     * @return string Resulting video poster URL
     *
     *                     * @internal
     */
    protected static function generateVideoPosterAttr($source, &$videoParams, $configuration)
    {
        ArrayUtils::setDefaultValue($videoParams, 'resource_type', AssetType::VIDEO);
        ArrayUtils::setDefaultValue($videoParams, 'format', $configuration->tag->videoPosterFormat);

if (! array_key_exists('poster', $videoParams)) {
            // set default poster based on the video
            return Image::fromParams($source, $videoParams);
        }

// Custom poster
        $poster = ArrayUtils::pop($videoParams, 'poster');

if (! is_array($poster)) {
            // direct url
            return $poster;
        }

ArrayUtils::setDefaultValue($poster, 'format', $configuration->tag->videoPosterFormat);

if (! array_key_exists('public_id', $poster)) {
            // build poster using the video source
            ArrayUtils::setDefaultValue($poster, 'resource_type', AssetType::VIDEO);

return Image::fromParams($source, $poster);
        }

return Image::fromParams($poster['public_id'], $poster);
    }

/**
     * @param $sourceTypes
     * @param $params
     *
     * @return array
     */
    protected static function populateSourceTypesSources($sourceTypes, &$params)
    {
        $sourceTransformation = ArrayUtils::pop($params, 'source_transformation', []);
        $sources              = [];
        foreach (ArrayUtils::build($sourceTypes) as $sourceType) {
            $sources[] = ['type'           => $sourceType,
                          'transformation' => ArrayUtils::pop($sourceTransformation, $sourceType, []),
            ];
        }

return $sources;
    }

/**
     * Sets the fallback content.
     *
     * @param string $content The fallback content.
     *
     * @return $this
     */
    public function fallback($content)
    {
        $this->addContent($content, 'fallback');

return $this;
    }

/**
     * Sets the poster attribute.
     *
     * @param string|Image|ImageTransformation $poster The poster image.
     *
     * @return $this
     */
    public function poster($poster)
    {
        if (is_string($poster)) {
            $this->setAttribute('poster', $poster);
        }

return $this;
    }

/**
     * Serializes the tag attributes.
     *
     * @param array $attributes Optional. Additional attributes to add without affecting the tag state.
     *
     * @return string
     */
    public function serializeAttributes($attributes = [])
    {
        if (empty($this->sources)) {
            $attributes['src'] = $this->video;
        }

if (! array_key_exists('poster', $this->attributes)) {
            $poster                   = new Image($this->video);
            $poster->asset->extension = $this->config->tag->videoPosterFormat;

$attributes['poster'] = $poster;
        }

return parent::serializeAttributes($attributes);
    }

/**
     * Serializes the tag content.
     *
     * @param array $additionalContent        The additional content.
     * @param bool  $prependAdditionalContent Whether to prepend additional content (instead of append)
     *
     * @return string
     */
    public function serializeContent($additionalContent = [], $prependAdditionalContent = false)
    {
        $content = $prependAdditionalContent ? ArrayUtils::mergeNonEmpty($additionalContent, $this->sources) :
            ArrayUtils::mergeNonEmpty($this->sources, $additionalContent);

return parent::serializeContent(
            $content,
            true
        );
    }

/**
     * Serializes to json.
     *
     * @return mixed
     */
    public function jsonSerialize()
    {
        // TODO: Implement jsonSerialize() method.
    }

/**
     * Adds (appends) a transformation.
     *
     * Appended transformation is nested.
     *
     * @param CommonTransformation $transformation The transformation to add.
     *
     * @return static
     */
    public function addTransformation($transformation)
    {
        return $this->applyAssetModification('addTransformation', $transformation);
    }

/**
     * Adds (chains) a transformation action.
     *
     * @param BaseAction|BaseQualifier|mixed $action The transformation action to add.
     *                                               If BaseQualifier is provided, it is wrapped with action.
     *
     * @return static
     */
    public function addAction($action)
    {
        return $this->applyAssetModification('addAction', $action);
    }

/**
     * Sets the property of the asset descriptor.
     *
     * @param string $propertyName  The name of the property.
     * @param mixed  $propertyValue The value of the property.
     *
     * @return $this
     *
     * @internal
     */
    public function setAssetProperty($propertyName, $propertyValue)
    {
        return $this->applyAssetModification('setAssetProperty', $propertyName, $propertyValue);
    }

/**
     * Sets the Cloud configuration key with the specified value.
     *
     * @param string $configKey   The configuration key.
     * @param mixed  $configValue THe configuration value.
     *
     * @return $this
     *
     * @internal
     */
    public function setCloudConfig($configKey, $configValue)
    {
        return $this->applyAssetModification('setCloudConfig', $configKey, $configValue);
    }

/**
     * Sets the Url configuration key with the specified value.
     *
     * @param string $configKey   The configuration key.
     * @param mixed  $configValue THe configuration value.
     *
     * @return $this
     *
     * @internal
     */
    public function setUrlConfig($configKey, $configValue)
    {
        return $this->applyAssetModification('setUrlConfig', $configKey, $configValue);
    }

/**
     * Applies modification to the asset and to all sources.
     *
     * @param string $modificationName The name of the modification.
     * @param mixed  ...$args          The modification arguments.
     *
     * @return $this
     */
    private function applyAssetModification($modificationName, ...$args)
    {
        $this->video->$modificationName(...$args);

foreach ($this->sources as $source) {
            $source->video->$modificationName(...$args);
        }

return $this;
    }
}

[-] VideoSourceTag.php [edit]
[-] JsConfigTag.php [edit]
[-] VideoTag.php [edit]
[+] ..
[-] PictureSourceTag.php [edit]
[-] ImageTag.php [edit]
[-] ImageTagDeliveryTypeTrait.php [edit]
[-] UploadTag.php [edit]
[-] SpriteTag.php [edit]
[-] BaseImageTag.php [edit]
[-] TagBuilder.php [edit]
[+] Attribute
[-] FormInputTag.php [edit]
[-] PictureTag.php [edit]
[-] ClientHintsMetaTag.php [edit]
[-] BaseConfigurableApiTag.php [edit]
[-] BaseTag.php [edit]
[-] VideoTagDeliveryTypeTrait.php [edit]
[-] VideoThumbnailTag.php [edit]
[-] Tag.php [edit]
[-] FormTag.php [edit]
[-] TagUtils.php [edit]