ImagePreviewTask extends AbstractTask
A task for generating an image preview.
Table of Contents
Properties
- $configuration : array<string|int, mixed>
- $executed : bool
- $sourceFile : File
- $successful : bool
- $targetFile : ProcessedFile
- $targetFileExtension : string|null
Methods
- __construct() : mixed
- fileNeedsProcessing() : bool
- We only have to trigger the file processing if the file either is new, does not exist or the original file has changed since the last processing run (the last case has to trigger a reprocessing even if the original file was used until now).
- getConfiguration() : array<string|int, mixed>
- Returns the configuration for this task.
- getConfigurationChecksum() : string
- Returns the checksum for this task's configuration, also taking the file and task type into account.
- getName() : string
- Returns the name of this task
- getSourceFile() : File
- Returns the original file this task is based on.
- getTargetFile() : ProcessedFile
- Returns the processed file this task is executed on.
- getTargetFileExtension() : string
- Determines the file extension the processed file should have in the filesystem.
- getTargetFilename() : string
- Returns the name the processed file should have in the filesystem.
- getType() : string
- Returns the type of this task
- isExecuted() : bool
- Returns TRUE if this task has been executed, no matter if the execution was successful.
- isSuccessful() : bool
- Returns TRUE if this task has been successfully executed. Only call this method if the task has been processed at all.
- sanitizeConfiguration() : void
- Enforce default configuration for preview processing here, to be sure we find already processed files below, which we wouldn't if we would change the configuration later, as configuration is part of the lookup.
- setExecuted() : void
- Set this task executed. This is used by the Processors in order to transfer the state of this task to the file processing service.
- determineTargetFileExtension() : string
- Gets the file extension the processed file should have in the filesystem by either using the configuration setting, or the extension of the original file.
- getChecksumData() : array<string|int, mixed>
- Sets parameters needed in the checksum. Can be overridden to add additional parameters to the checksum.
Properties
$configuration
protected
array<string|int, mixed>
$configuration
$executed
protected
bool
$executed
= false
$sourceFile
protected
File
$sourceFile
$successful
protected
bool
$successful
$targetFile
protected
ProcessedFile
$targetFile
$targetFileExtension
protected
string|null
$targetFileExtension
Methods
__construct()
public
__construct(ProcessedFile $targetFile, array<string|int, mixed> $configuration) : mixed
Parameters
- $targetFile : ProcessedFile
- $configuration : array<string|int, mixed>
fileNeedsProcessing()
We only have to trigger the file processing if the file either is new, does not exist or the original file has changed since the last processing run (the last case has to trigger a reprocessing even if the original file was used until now).
public
fileNeedsProcessing() : bool
Return values
boolgetConfiguration()
Returns the configuration for this task.
public
getConfiguration() : array<string|int, mixed>
Return values
array<string|int, mixed>getConfigurationChecksum()
Returns the checksum for this task's configuration, also taking the file and task type into account.
public
getConfigurationChecksum() : string
Return values
stringgetName()
Returns the name of this task
public
getName() : string
Return values
stringgetSourceFile()
Returns the original file this task is based on.
public
getSourceFile() : File
Return values
FilegetTargetFile()
Returns the processed file this task is executed on.
public
getTargetFile() : ProcessedFile
Return values
ProcessedFilegetTargetFileExtension()
Determines the file extension the processed file should have in the filesystem.
public
getTargetFileExtension() : string
Return values
stringgetTargetFilename()
Returns the name the processed file should have in the filesystem.
public
getTargetFilename() : string
Return values
stringgetType()
Returns the type of this task
public
getType() : string
Return values
stringisExecuted()
Returns TRUE if this task has been executed, no matter if the execution was successful.
public
isExecuted() : bool
Return values
boolisSuccessful()
Returns TRUE if this task has been successfully executed. Only call this method if the task has been processed at all.
public
isSuccessful() : bool
Tags
Return values
boolsanitizeConfiguration()
Enforce default configuration for preview processing here, to be sure we find already processed files below, which we wouldn't if we would change the configuration later, as configuration is part of the lookup.
public
sanitizeConfiguration() : void
setExecuted()
Set this task executed. This is used by the Processors in order to transfer the state of this task to the file processing service.
public
setExecuted(bool $successful) : void
Parameters
- $successful : bool
-
Set this to FALSE if executing the task failed
determineTargetFileExtension()
Gets the file extension the processed file should have in the filesystem by either using the configuration setting, or the extension of the original file.
protected
determineTargetFileExtension() : string
Return values
stringgetChecksumData()
Sets parameters needed in the checksum. Can be overridden to add additional parameters to the checksum.
protected
getChecksumData() : array<string|int, mixed>
This should include all parameters that could possibly vary between different task instances, e.g. the TYPO3 image configuration in TYPO3_CONF_VARS[GFX] for graphic processing tasks.