CoreFiles by mySites.guru
ImageFilter.php69 lines, 1,794 bytes, from Joomla_4.4.14-Stable-Full_Package.zip
Raw History Compare with 4.4.13
md5
659da27d7eacb9715dc5c8cbc5329a9f
sha1
6c05784caff166b868dd24bd5ccc9314b8d1e4bb
sha256
c5c3aa2e3f8594ddb5067c42bbed459d70d93b00f12da4f8e80e6fc1614b5e2a
<?php

/**
 * Joomla! Content Management System
 *
 * @copyright  (C) 2017 Open Source Matters, Inc. <https://www.joomla.org>
 * @license    GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\CMS\Image;

// phpcs:disable PSR1.Files.SideEffects
\defined('JPATH_PLATFORM') or die;
// phpcs:enable PSR1.Files.SideEffects

/**
 * Class to manipulate an image.
 *
 * @since  1.7.3
 */
abstract class ImageFilter
{
    /**
     * @var    resource  The image resource handle.
     * @since  2.5.0
     */
    protected $handle;

    /**
     * Class constructor.
     *
     * @param   resource  $handle  The image resource on which to apply the filter.
     *
     * @since   1.7.3
     * @throws  \InvalidArgumentException
     * @throws  \RuntimeException
     */
    public function __construct($handle)
    {
        // Verify that image filter support for PHP is available.
        if (!\function_exists('imagefilter')) {
            throw new \RuntimeException('The imagefilter function for PHP is not available.');
        }

        /**
         * Make sure the file handle is valid.
         * @todo: Remove check for resource when we only support PHP 8
         */
        if (
            !((\is_object($handle) && get_class($handle) == 'GdImage')
            || (\is_resource($handle) && get_resource_type($handle) == 'gd'))
        ) {
            throw new \InvalidArgumentException('The image handle is invalid for the image filter.');
        }

        $this->handle = $handle;
    }

    /**
     * Method to apply a filter to an image resource.
     *
     * @param   array  $options  An array of options for the filter.
     *
     * @return  void
     *
     * @since   2.5.0
     */
    abstract public function execute(array $options = []);
}

The same content is in 70 releases, Joomla 4.2.1 to 4.4.14. See them all, or every version of this file.