ILIAS\Filesystem\Util\Convert\LegacyImages Class Reference

Collaboration diagram for ILIAS\Filesystem\Util\Convert\LegacyImages:

Public Member Functions
	__construct ()
	thumbnail (string $path_to_original, string $path_to_output, int $fit_into_size, string $output_format=ImageOutputOptions::FORMAT_KEEP, int $image_quality=75)
	croppedSquare (string $path_to_original, string $path_to_output, int $square_size, string $output_format=ImageOutputOptions::FORMAT_KEEP, int $image_quality=75)
	resizeByWidth (string $path_to_original, string $path_to_output, int $width, string $output_format=ImageOutputOptions::FORMAT_KEEP, int $image_quality=60)
	resizeByHeight (string $path_to_original, string $path_to_output, int $height, string $output_format=ImageOutputOptions::FORMAT_KEEP, int $image_quality=60)
	resizeToFixedSize (string $path_to_original, string $path_to_output, int $width, int $height, bool $crop_if_true_and_resize_if_false=true, string $output_format=ImageOutputOptions::FORMAT_KEEP, int $image_quality=60)
	convertToFormat (string $path_to_original, string $path_to_output, string $output_format, ?int $width=null, ?int $height=null)

Private Member Functions
	storeStream (ImageConverter $converter, string $path)
	buildStream (string $path_to_original)

Private Attributes
Images	$image_converters
ImageOutputOptions	$output_options

Detailed Description

Author

Fabian Schmid fabia.nosp@m.n@sr.nosp@m..solu.nosp@m.tion.nosp@m.s

Deprecated:

ise \ILIAS\Filesystem\Util\Convert\Images instead

Definition at line 31 of file LegacyImages.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Filesystem\Util\Convert\LegacyImages::__construct

(

)

Definition at line 36 of file LegacyImages.php.

    {
        $this->image_converters = new Images(false);
        $this->output_options = new ImageOutputOptions();
    }

Member Function Documentation

buildStream()

ILIAS\Filesystem\Util\Convert\LegacyImages::buildStream ( string  $path_to_original )

private

Definition at line 196 of file LegacyImages.php.

                                                          : Stream|FileStream
    {
        return Streams::ofResource(fopen($path_to_original, 'rb'));
    }

convertToFormat()

ILIAS\Filesystem\Util\Convert\LegacyImages::convertToFormat	(	string	$path_to_original,
		string	$path_to_output,
		string	$output_format,
		?int	$width = null,
		?int	$height = null
	)

Definition at line 165 of file LegacyImages.php.

     : string {
        $converter = $this->image_converters->convertToFormat(
            $this->buildStream($path_to_original),
            $output_format,
            $width,
            $height
        );
        return $this->storeStream($converter, $path_to_output);
    }

croppedSquare()

ILIAS\Filesystem\Util\Convert\LegacyImages::croppedSquare	(	string	$path_to_original,
		string	$path_to_output,
		int	$square_size,
		string	$output_format = ImageOutputOptions::FORMAT_KEEP,
		int	$image_quality = 75
	)

Returns

string path to the thumbnail

Deprecated:

Use \ILIAS\Filesystem\Util\Convert\Images::croppedSquare() instead.

Definition at line 74 of file LegacyImages.php.

     : string {
        $converter = $this->image_converters->croppedSquare(
            $this->buildStream($path_to_original),
            $square_size,
            $this->output_options
                ->withQuality($image_quality)
                ->withFormat($output_format)
        );
 
        return $this->storeStream($converter, $path_to_output);
    }

resizeByHeight()

ILIAS\Filesystem\Util\Convert\LegacyImages::resizeByHeight	(	string	$path_to_original,
		string	$path_to_output,
		int	$height,
		string	$output_format = ImageOutputOptions::FORMAT_KEEP,
		int	$image_quality = 60
	)

Deprecated:

Use \ILIAS\Filesystem\Util\Convert\Images::resizeByHeight() instead.

Returns

string path to the resized image

Definition at line 122 of file LegacyImages.php.

     : string {
        $converter = $this->image_converters->resizeByHeight(
            $this->buildStream($path_to_original),
            $height,
            $this->output_options
                ->withQuality($image_quality)
                ->withFormat($output_format)
        );
        return $this->storeStream($converter, $path_to_output);
    }

resizeByWidth()

ILIAS\Filesystem\Util\Convert\LegacyImages::resizeByWidth	(	string	$path_to_original,
		string	$path_to_output,
		int	$width,
		string	$output_format = ImageOutputOptions::FORMAT_KEEP,
		int	$image_quality = 60
	)

Returns

string path to the thumbnail

Deprecated:

Use \ILIAS\Filesystem\Util\Convert\Images::resizeByWidth() instead.

Definition at line 100 of file LegacyImages.php.

     : string {
        $converter = $this->image_converters->resizeByWidth(
            $this->buildStream($path_to_original),
            $width,
            $this->output_options
                ->withQuality($image_quality)
                ->withFormat($output_format)
        );
        return $this->storeStream($converter, $path_to_output);
    }

resizeToFixedSize()

ILIAS\Filesystem\Util\Convert\LegacyImages::resizeToFixedSize	(	string	$path_to_original,
		string	$path_to_output,
		int	$width,
		int	$height,
		bool	$crop_if_true_and_resize_if_false = true,
		string	$output_format = ImageOutputOptions::FORMAT_KEEP,
		int	$image_quality = 60
	)

Returns

string path to the thumbnail

Deprecated:

Use \ILIAS\Filesystem\Util\Convert\Images::resizeToFixedSize() instead.

Definition at line 144 of file LegacyImages.php.

     : string {
        $converter = $this->image_converters->resizeToFixedSize(
            $this->buildStream($path_to_original),
            $width,
            $height,
            $crop_if_true_and_resize_if_false,
            $this->output_options
                ->withQuality($image_quality)
                ->withFormat($output_format)
        );
        return $this->storeStream($converter, $path_to_output);
    }

storeStream()

ILIAS\Filesystem\Util\Convert\LegacyImages::storeStream ( ImageConverter  $converter, string  $path  )

private

Definition at line 181 of file LegacyImages.php.

                                                                         : string
    {
        if (!$converter->isOK()) {
            throw $converter->getThrowableIfAny() ?? new \RuntimeException('Could not create requested image');
        }
 
        $stream = $converter->getStream();
 
        $stream->rewind();
        if (file_put_contents($path, $stream->getContents()) === false) {
            throw new \RuntimeException('Could not store image');
        }
        return $path;
    }

References $path, ILIAS\Filesystem\Util\Convert\ImageConverter\getStream(), ILIAS\Filesystem\Util\Convert\ImageConverter\getThrowableIfAny(), and ILIAS\Filesystem\Util\Convert\ImageConverter\isOK().

Here is the call graph for this function:

thumbnail()

ILIAS\Filesystem\Util\Convert\LegacyImages::thumbnail	(	string	$path_to_original,
		string	$path_to_output,
		int	$fit_into_size,
		string	$output_format = ImageOutputOptions::FORMAT_KEEP,
		int	$image_quality = 75
	)

Returns

string path to the thumbnail

Deprecated:

Use \ILIAS\Filesystem\Util\Convert\Images::thumbnail() instead.

Definition at line 49 of file LegacyImages.php.

     : string {
        $converter = $this->image_converters->thumbnail(
            $this->buildStream($path_to_original),
            $fit_into_size,
            $this->output_options
                ->withQuality($image_quality)
                ->withFormat($output_format)
        );
        return $this->storeStream($converter, $path_to_output);
    }

Field Documentation

$image_converters

Images ILIAS\Filesystem\Util\Convert\LegacyImages::$image_converters

private

Definition at line 33 of file LegacyImages.php.

$output_options

ImageOutputOptions ILIAS\Filesystem\Util\Convert\LegacyImages::$output_options

private

Definition at line 34 of file LegacyImages.php.

---

The documentation for this class was generated from the following file:

• components/ILIAS/Filesystem/src/Util/Convert/LegacyImages.php