IPreview
in
This class provides functions to render and show thumbnails and previews of files
Tags
Table of Contents
Constants
- MODE_COVER = 'cover'
- MODE_FILL = 'fill'
Methods
- generatePreviews() : ISimpleFile
- Generates previews of a file
- getPreview() : ISimpleFile
- Returns a preview of a file
- getProviders() : array<string|int, mixed>
- Get all providers
- hasProviders() : bool
- Does the manager have any providers
- isAvailable() : bool
- Check if a preview can be generated for a file
- isMimeSupported() : bool
- Returns true if the passed mime type is supported
- registerProvider() : void
- In order to improve lazy loading a closure can be registered which will be called in case preview providers are actually requested
Constants
MODE_COVER
public
mixed
MODE_COVER
= 'cover'
Tags
MODE_FILL
public
mixed
MODE_FILL
= 'fill'
Tags
Methods
generatePreviews()
Generates previews of a file
public
generatePreviews(File $file, array<string|int, mixed> $specifications[, string $mimeType = null ]) : ISimpleFile
Parameters
- $file : File
- $specifications : array<string|int, mixed>
- $mimeType : string = null
Tags
Return values
ISimpleFile —the last preview that was generated
getPreview()
Returns a preview of a file
public
getPreview(File $file[, int $width = -1 ][, int $height = -1 ][, bool $crop = false ][, string $mode = IPreview::MODE_FILL ][, string $mimeType = null ][, bool $cacheResult = true ]) : ISimpleFile
The cache is searched first and if nothing usable was found then a preview is generated by one of the providers
Parameters
- $file : File
- $width : int = -1
- $height : int = -1
- $crop : bool = false
- $mode : string = IPreview::MODE_FILL
- $mimeType : string = null
-
To force a given mimetype for the file (files_versions needs this)
- $cacheResult : bool = true
-
Whether or not to cache the preview on the filesystem. Default to true. Can be useful to set to false to limit the amount of stored previews.
Tags
Return values
ISimpleFilegetProviders()
Get all providers
public
getProviders() : array<string|int, mixed>
Tags
Return values
array<string|int, mixed>hasProviders()
Does the manager have any providers
public
hasProviders() : bool
Tags
Return values
boolisAvailable()
Check if a preview can be generated for a file
public
isAvailable(FileInfo $file) : bool
Parameters
- $file : FileInfo
Tags
Return values
boolisMimeSupported()
Returns true if the passed mime type is supported
public
isMimeSupported([string $mimeType = '*' ]) : bool
Parameters
- $mimeType : string = '*'
Tags
Return values
boolregisterProvider()
In order to improve lazy loading a closure can be registered which will be called in case preview providers are actually requested
public
registerProvider(string $mimeTypeRegex, Closure $callable) : void
Register your provider via the IRegistrationContext when booting the app
$callable has to return an instance of \OCP\Preview\IProvider
Parameters
- $mimeTypeRegex : string
-
Regex with the mime types that are supported by this provider
- $callable : Closure