class ImageFactory

Same name in other branches
  1. 8.9.x core/lib/Drupal/Core/Image/ImageFactory.php \Drupal\Core\Image\ImageFactory
  2. 10 core/lib/Drupal/Core/Image/ImageFactory.php \Drupal\Core\Image\ImageFactory
  3. 11.x core/lib/Drupal/Core/Image/ImageFactory.php \Drupal\Core\Image\ImageFactory

Provides a factory for image objects.

Hierarchy

Expanded class hierarchy of ImageFactory

6 files declare their use of ImageFactory
EditorFileReference.php in core/modules/editor/src/Plugin/Filter/EditorFileReference.php
Image.php in core/modules/media/src/Plugin/media/Source/Image.php
ImageStyleDownloadController.php in core/modules/image/src/Controller/ImageStyleDownloadController.php
ImageWidget.php in core/modules/image/src/Plugin/Field/FieldWidget/ImageWidget.php
QuickEditImageController.php in core/modules/quickedit/src/Controller/QuickEditImageController.php

... See full list

1 string reference to 'ImageFactory'
core.services.yml in core/core.services.yml
core/core.services.yml
1 service uses ImageFactory
image.factory in core/core.services.yml
Drupal\Core\Image\ImageFactory

File

core/lib/Drupal/Core/Image/ImageFactory.php, line 10

Namespace

Drupal\Core\Image
View source
class ImageFactory {
    
    /**
     * The image toolkit plugin manager.
     *
     * @var \Drupal\Core\ImageToolkit\ImageToolkitManager
     */
    protected $toolkitManager;
    
    /**
     * The image toolkit ID to use for this factory.
     *
     * @var string
     */
    protected $toolkitId;
    
    /**
     * Constructs a new ImageFactory object.
     *
     * @param \Drupal\Core\ImageToolkit\ImageToolkitManager $toolkit_manager
     *   The image toolkit plugin manager.
     */
    public function __construct(ImageToolkitManager $toolkit_manager) {
        $this->toolkitManager = $toolkit_manager;
        $this->toolkitId = $this->toolkitManager
            ->getDefaultToolkitId();
    }
    
    /**
     * Sets the ID of the image toolkit.
     *
     * @param string $toolkit_id
     *   The ID of the image toolkit to use for this image factory.
     *
     * @return $this
     */
    public function setToolkitId($toolkit_id) {
        $this->toolkitId = $toolkit_id;
        return $this;
    }
    
    /**
     * Gets the ID of the image toolkit currently in use.
     *
     * @return string
     *   The ID of the image toolkit in use by the image factory.
     */
    public function getToolkitId() {
        return $this->toolkitId;
    }
    
    /**
     * Constructs a new Image object.
     *
     * Normally, the toolkit set as default in the admin UI is used by the
     * factory to create new Image objects. This can be overridden through
     * \Drupal\Core\Image\ImageInterface::setToolkitId() so that any new Image
     * object created will use the new toolkit specified. Finally, a single
     * Image object can be created using a specific toolkit, regardless of the
     * current factory settings, by passing its plugin ID in the $toolkit_id
     * argument.
     *
     * @param string|null $source
     *   (optional) The path to an image file, or NULL to construct the object
     *   with no image source.
     * @param string|null $toolkit_id
     *   (optional) The ID of the image toolkit to use for this image, or NULL
     *   to use the current toolkit.
     *
     * @return \Drupal\Core\Image\ImageInterface
     *   An Image object.
     *
     * @see ImageFactory::setToolkitId()
     */
    public function get($source = NULL, $toolkit_id = NULL) {
        $toolkit_id = $toolkit_id ?: $this->toolkitId;
        return new Image($this->toolkitManager
            ->createInstance($toolkit_id), $source);
    }
    
    /**
     * Returns the image file extensions supported by the toolkit.
     *
     * @param string|null $toolkit_id
     *   (optional) The ID of the image toolkit to use for checking, or NULL
     *   to use the current toolkit.
     *
     * @return array
     *   An array of supported image file extensions (e.g. png/jpeg/gif).
     *
     * @see \Drupal\Core\ImageToolkit\ImageToolkitInterface::getSupportedExtensions()
     */
    public function getSupportedExtensions($toolkit_id = NULL) {
        $toolkit_id = $toolkit_id ?: $this->toolkitId;
        $definition = $this->toolkitManager
            ->getDefinition($toolkit_id);
        return call_user_func($definition['class'] . '::getSupportedExtensions');
    }

}

Members

Title Sort descending Modifiers Object type Summary
ImageFactory::$toolkitId protected property The image toolkit ID to use for this factory.
ImageFactory::$toolkitManager protected property The image toolkit plugin manager.
ImageFactory::get public function Constructs a new Image object.
ImageFactory::getSupportedExtensions public function Returns the image file extensions supported by the toolkit.
ImageFactory::getToolkitId public function Gets the ID of the image toolkit currently in use.
ImageFactory::setToolkitId public function Sets the ID of the image toolkit.
ImageFactory::__construct public function Constructs a new ImageFactory object.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.