ILIAS\MediaObjects\Thumbs\ThumbsManager Class Reference

Collaboration diagram for ILIAS\MediaObjects\Thumbs\ThumbsManager:

Public Member Functions
	__construct (protected InternalDataService $data, protected InternalDomainService $domain)
	getThumbSrc (int $mob_id)
	For use in browser src of images. More...
	getPreviewSrc (int $mob_id)
	For use in browser src of images. More...

Protected Member Functions
	getThumbPath ()
	createThumb (int $mob_id, string $location, string $format, string $target_location,)

Protected Attributes
ILIAS MediaObjects MediaObjectManager	$media_manager
ImageOutputOptions	$output_options
Images	$image_converters

Detailed Description

Definition at line 31 of file ThumbsManager.php.

Constructor & Destructor Documentation

__construct()

ILIAS\MediaObjects\Thumbs\ThumbsManager::__construct	(	protected InternalDataService	$data,
		protected InternalDomainService	$domain
	)

Definition at line 38 of file ThumbsManager.php.

      {
        $this->media_manager = $this->domain->mediaObject();
        $this->image_converters = new Images(true);
        $this->output_options = new ImageOutputOptions();
    }

Member Function Documentation

createThumb()

ILIAS\MediaObjects\Thumbs\ThumbsManager::createThumb ( int  $mob_id, string  $location, string  $format, string  $target_location  )

protected

Definition at line 100 of file ThumbsManager.php.

References ilObjMediaObject\DEFAULT_PREVIEW_SIZE, and ILIAS\Filesystem\Util\Convert\ImageOutputOptions\FORMAT_PNG.

Referenced by ILIAS\MediaObjects\Thumbs\ThumbsManager\getThumbSrc().

      : void
    {
        $is_image = is_int(strpos($format, "image/"));
        if ($is_image) {
            if (!$this->media_manager->hasLocalFile($mob_id, $location)) {
                return;
            }
            $width = $height = \ilObjMediaObject::DEFAULT_PREVIEW_SIZE;
            $image_quality = 90;

            // the zip stream is not seekable, which is needed by Imagick
            // so we create a seekable stream first
            $tempStream = fopen('php://temp', 'w+');
            stream_copy_to_stream($this->media_manager->getLocationStream($mob_id, $location)->detach(), $tempStream);
            rewind($tempStream);
            $stream = new Stream($tempStream);

            $converter = $this->image_converters->resizeToFixedSize(
                $stream,
                $width,
                $height,
                true,
                $this->output_options
                    ->withQuality($image_quality)
                    ->withFormat(ImageOutputOptions::FORMAT_PNG)
            );
            $this->media_manager->addStream(
                $mob_id,
                $target_location,
                $converter->getStream()
            );
            fclose($tempStream);
        }
    }

Here is the caller graph for this function:

getPreviewSrc()

ILIAS\MediaObjects\Thumbs\ThumbsManager::getPreviewSrc

(

int

$mob_id

)

For use in browser src of images.

Definition at line 143 of file ThumbsManager.php.

Referenced by ILIAS\MediaObjects\Thumbs\ThumbsManager\getThumbSrc().

                                               : string
    {
        $ppics = array(
            "mob_vpreview.png",
            "mob_vpreview.jpg",
            "mob_vpreview.jpeg");
        foreach ($ppics as $pic) {
            if ($this->media_manager->hasLocalFile($mob_id, $pic)) {
                return $this->media_manager->getLocalSrc($mob_id, $pic);
            }
        }
        return "";
    }

Here is the caller graph for this function:

getThumbPath()

ILIAS\MediaObjects\Thumbs\ThumbsManager::getThumbPath ( )

protected

Definition at line 47 of file ThumbsManager.php.

Referenced by ILIAS\MediaObjects\Thumbs\ThumbsManager\getThumbSrc().

                                      : string
    {
        return "thumbs/Standard.png";
    }

Here is the caller graph for this function:

getThumbSrc()

ILIAS\MediaObjects\Thumbs\ThumbsManager::getThumbSrc

(

int

$mob_id

)

For use in browser src of images.

Definition at line 55 of file ThumbsManager.php.

References ILIAS\MediaObjects\Thumbs\ThumbsManager\createThumb(), ILIAS\MediaObjects\Thumbs\ThumbsManager\getPreviewSrc(), and ILIAS\MediaObjects\Thumbs\ThumbsManager\getThumbPath().

                                             : string
    {
        $mob = new \ilObjMediaObject($mob_id);
        $item = $mob->getMediaItem("Standard");
        // for svg return standard src
        if ($item?->getFormat() === "image/svg+xml") {
            return $mob->getStandardSrc();
        }

        // if thumb exists -> return
        $thumb_path = $this->getThumbPath();
        if ($this->media_manager->hasLocalFile($mob_id, $thumb_path)) {
            return $this->media_manager->getLocalSrc($mob_id, $thumb_path);
        }

        // if preview exists -> return
        $preview_src = $this->getPreviewSrc($mob_id);
        if ($preview_src !== "") {
            return $preview_src;
        }

        // if not tried already, create thumb and return
        if ($item?->getLocationType() === "LocalFile") {
            if ($item?->getThumbTried() !== "y") {
                $this->createThumb(
                    $mob_id,
                    $item?->getLocation(),
                    $item?->getFormat(),
                    $thumb_path
                );
                $item?->writeThumbTried("y");
                if ($this->media_manager->hasLocalFile($mob_id, $thumb_path)) {
                    return $this->media_manager->getLocalSrc($mob_id, $thumb_path);
                }
            }
        } else {
            if (str_starts_with($item?->getFormat(), "image/")) {
                return $item?->getLocation();
            }
        }

        // send generic thumb src
        return \ilUtil::getImagePath("standard/icon_mob.svg");
    }

Here is the call graph for this function:

Field Documentation

$image_converters

Images ILIAS\MediaObjects\Thumbs\ThumbsManager::$image_converters

protected

Definition at line 36 of file ThumbsManager.php.

$media_manager

ILIAS MediaObjects MediaObjectManager ILIAS\MediaObjects\Thumbs\ThumbsManager::$media_manager

protected

Definition at line 34 of file ThumbsManager.php.

$output_options

ImageOutputOptions ILIAS\MediaObjects\Thumbs\ThumbsManager::$output_options

protected

Definition at line 35 of file ThumbsManager.php.

---

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

• components/ILIAS/MediaObjects/Thumbs/ThumbsManager.php