Image.php

См. документацию.

<?php
 
namespace Bitrix\Main\File;
 
use Bitrix\Main\DI;
 
class Image
{
    const
        FORMAT_PNG = \IMAGETYPE_PNG,
        FORMAT_JPEG = \IMAGETYPE_JPEG,
        FORMAT_GIF = \IMAGETYPE_GIF,
        FORMAT_BMP = \IMAGETYPE_BMP,
        FORMAT_WEBP = \IMAGETYPE_WEBP;
 
    const
        RESIZE_PROPORTIONAL_ALT = 0,
        RESIZE_PROPORTIONAL = 1,
        RESIZE_EXACT = 2;
 
    protected $file;

    protected $engine;

    public function __construct($file = null)
    {
        $this->file = $file;
 
        $serviceLocator = DI\ServiceLocator::getInstance();
        if($serviceLocator->has("main.imageEngine"))
        {
            $this->setEngine($serviceLocator->get("main.imageEngine"));
        }
        else
        {
            $this->setEngine(new Image\Gd());
        }
    }

    public function setEngine(Image\Engine $engine)
    {
        $this->engine = $engine;
 
        if($this->file !== null)
        {
            $this->engine->setFile($this->file);
        }
    }

    public function getExifData()
    {
        return $this->engine->getExifData();
    }

    public function getInfo($flashEnabled = false)
    {
        return $this->engine->getInfo($flashEnabled);
    }

    public function load()
    {
        return $this->engine->load();
    }

    public function rotate($angle, Image\Color $bgColor = null)
    {
        if($bgColor === null)
        {
            $bgColor = new Image\Color();
        }
        return $this->engine->rotate($angle, $bgColor);
    }

    public function flipVertical()
    {
        return $this->engine->flipVertical();
    }

    public function flipHorizontal()
    {
        return $this->engine->flipHorizontal();
    }

    public function autoRotate($orientation)
    {
        if ($this->engine->substituted())
        {
            // no need to rotated a stub image
            return false;
        }
 
        if($orientation > 1)
        {
            if($orientation == 7 || $orientation == 8)
            {
                $this->rotate(270);
            }
            elseif($orientation == 3 || $orientation == 4)
            {
                $this->rotate(180);
            }
            elseif($orientation == 5 || $orientation == 6)
            {
                $this->rotate(90);
            }
 
            if ($orientation == 2 || $orientation == 7 || $orientation == 4 || $orientation == 5)
            {
                $this->flipHorizontal();
            }
 
            $this->setOrientation(1);
 
            return true;
        }
        return false;
    }

    public function setOrientation($orientation)
    {
        return $this->engine->setOrientation($orientation);
    }

    public function resize(Image\Rectangle $source, Image\Rectangle $destination)
    {
        return $this->engine->resize($source, $destination);
    }

    public function blur(int $sigma): bool
    {
        return $this->engine->blur($sigma);
    }

    public function filter(Image\Mask $mask)
    {
        return $this->engine->filter($mask);
    }

    public function drawWatermark(Image\Watermark $watermark)
    {
        if($watermark instanceof Image\TextWatermark)
        {
            return $this->engine->drawTextWatermark($watermark);
        }
        if($watermark instanceof Image\ImageWatermark)
        {
            return $this->engine->drawImageWatermark($watermark);
        }
        return false;
    }

    public function save($quality = 95)
    {
        if($quality <= 0 || $quality > 100)
        {
            $quality = 95;
        }
 
        if($this->engine->save($this->file, $quality))
        {
            $this->setFileAttributes($this->file);
 
            return true;
        }
        return false;
    }

    public function saveAs($file, $quality = 95, $format = null)
    {
        if($quality <= 0 || $quality > 100)
        {
            $quality = 95;
        }
 
        if($this->engine->save($file, $quality, $format))
        {
            $this->setFileAttributes($file);
 
            return true;
        }
        return false;
    }
 
    protected function setFileAttributes($file)
    {
        @chmod($file, BX_FILE_PERMISSIONS);
        clearstatcache(true, $file);
    }

    public function getWidth()
    {
        return $this->engine->getWidth();
    }

    public function getHeight()
    {
        return $this->engine->getHeight();
    }

    public function getDimensions()
    {
        return $this->engine->getDimensions();
    }

    public function exceedsMaxSize(): bool
    {
        return $this->engine->exceedsMaxSize();
    }

    public function clear()
    {
        $this->engine->clear();
    }
}