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 ]) : 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)
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