FirstPageToTileImageFlavourMachine.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
use ILIAS\ILIASObject\Properties\CoreProperties\TileImage\FlavourDefinition as TileImageFlavourDefinition;
use ILIAS\Filesystem\Stream\FileStream;
use ILIAS\ResourceStorage\Flavour\Machine\DefaultMachines\CropRectangle;
use ILIAS\ResourceStorage\Flavour\Machine\DefaultMachines\ExtractPages;
use ILIAS\ResourceStorage\Flavour\Definition\FlavourDefinition;
use ILIAS\ResourceStorage\Flavour\Definition\CropToRectangle;
use ILIAS\ResourceStorage\Flavour\Definition\PagesToExtract;
use ILIAS\ResourceStorage\Flavour\Machine\FlavourMachine;
use ILIAS\ResourceStorage\Flavour\Machine\DefaultMachines\AbstractMachine;
use ILIAS\ResourceStorage\Flavour\Machine\Result;
use ILIAS\ResourceStorage\Information\FileInformation;
use ILIAS\ResourceStorage\Flavour\Engine\ImagickEngine;
 
class FirstPageToTileImageMachine extends AbstractMachine implements FlavourMachine
{
    public const ID = "be03e07e396a61f7d9b31a712f0913fe9c6cd43b009ce69d30aa0f10bd3500bd";
    private const FULL_QUALITY_SIZE_THRESHOLD = 100;
    private ExtractPages $extract_pages;
    private CropRectangle $crop;
    private ?TileImageFlavourDefinition $definition = null;
    private ?FileInformation $information = null;
 
    public function __construct()
    {
        $this->extract_pages = new ExtractPages();
        $this->crop = new CropRectangle();
    }
 
 
    public function getId(): string
    {
        return self::ID;
    }
 
    public function canHandleDefinition(FlavourDefinition $definition): bool
    {
        return $definition instanceof TileImageFlavourDefinition;
    }
 
    public function dependsOnEngine(): ?string
    {
        return ImagickEngine::class;
    }
 
    public function processStream(
        FileInformation $information,
        FileStream $stream,
        FlavourDefinition $for_definition
    ): \Generator {
        $this->definition = $for_definition;
        $this->information = $information;
 
        $page_stream = $this->extract_pages->processStream(
            $this->information,
            $stream,
            new PagesToExtract(
                false,
                $this->definition->getWidths()['xl'],
                1,
                false,
                100
            )
        )->current()?->getStream();
 
        if ($page_stream === null) {
            return;
        }
 
        $i = 0;
        foreach ($for_definition->getWidths() as $width) {
            yield new Result(
                $for_definition,
                $this->cropImage($page_stream, $width),
                $i,
                true
            );
            $i++;
        }
    }
 
    protected function cropImage(
        FileStream $stream,
        int $width
    ) {
        $quality = $width <= self::FULL_QUALITY_SIZE_THRESHOLD
            ? 100 // we take 100% jpeg quality for small resultions
            : $this->definition->getQuality();
 
 
        return $this->crop->processStream(
            $this->information,
            $stream,
            new CropToRectangle(
                false,
                $width,
                $this->definition->getRatio(),
                $quality
            )
        )->current()->getStream();
    }
}