Create a processing task
A processing task is a step within a processing flow. You can configure the output of a processing task to be an entity rendition. To do this, enable the Store output feature for a task and create rendition links.
To create a processing task:
-
On the menu bar, click Manage
.
-
On the Manage page, click Media processing.
-
On the Media processing page, select a processing set, then click the flow where you want to add a task.
-
On the visual canvas, on the node of the flow you want to add the task to, click
.
-
In the right-hand pane, select a task type.
-
On the Parameters tab, fill out the task parameters.
-
Click Save task.
Task parameters
You can use the following task parameters.
Store file
Parameter |
Description |
Mandatory |
---|---|---|
Name |
Name of the task. |
No |
Content type |
ContentType/MimeType for the output file. |
No |
Content disposition |
Defines whether the file is an attachment or provided inline. |
Yes |
Convert image
Parameter |
Description |
Mandatory |
---|---|---|
Name |
Name of the task. This must match the output name on the Outputs tab. |
No |
Content type |
ContentType/MimeType for the output file. |
No |
Content disposition |
Defines whether the file is an attachment or provided inline. |
Yes |
Resize option |
Method used to resize images. |
Yes |
Target extension |
File extension of resulting output. |
No |
Width (px) |
Width of the output image. |
No. Parameter not available if Resize option is None. |
Height (px) |
Height of the output image. |
No. Parameter not available if Resize option is None. |
Resize algorithm |
Algorithm used for cropping. The available algorithms are:
Note If an image is identified as a logo, the contents of the image are reduced to 75% of their original size, while the overall size of the image remains the same. This results in an empty border around the original image, which is then filled with the color detected at all four corners of the original. |
Yes. Parameter only available if Resize option is Resize for crop. |
Color profile |
Color profile applied on the output image. |
Yes |
Color space |
Color space applied on the output image. |
Yes. Parameter only available if Color profile is None. |
Density |
DPI used for the output image. |
Yes |
Multi-page |
Determines whether renditions should be created for all pages of the file, or only the first. |
No |
Clipping path |
Name of the clipping path you want to crop the image to. |
No |
Embedded preview priorities |
An ordered, comma-separated list of previews. The processing agent checks for availability of these previews in the RAW file metadata. If a preview is available, the agent applies default image conversion to it to generate the target image. If none of the listed previews are available, the agent applies default image conversion to the original image instead. |
No |
The following is an example of RAW file metadata extracted with the Exiftool command exiftool -preview:all image
:
exiftool -preview:all RAW_CANON_EOS_5DMARK3.CR2
Preview Image : (Binary data 3192436 bytes, use -b option to extract)
Thumbnail Image : (Binary data 18733 bytes, use -b option to extract)
To add these previews to the Embedded preview priorities field, remove the spaces in the names. For example write PreviewImage or ThumbnailImage.
Convert video
Parameter |
Description |
Mandatory |
---|---|---|
Name |
Name of the task. |
No |
Content type |
ContentType/MimeType for the output file. |
No |
Content disposition |
Defines whether the file is an attachment or provided inline. |
Yes |
Seek |
The time point in a video from which the rendition starts. For example, with a value of 5, the output file starts at the fifth second of original file. |
No |
Length |
Duration of the output file in seconds. |
No |
Number of preview frames |
Maximum number of frames extracted from the video for preview creation. |
No |
Target extension |
File extension of resulting output. |
No |
Width (px) |
Width of the output image. |
No. Parameter not available if Resize option is None. |
Height (px) |
Height of the output image. |
No. Parameter not available if Resize option is None. |
Bitrate (% from original) |
Defines the quality of the rendition based on the original file. |
Behavior of the Bitrate (% from original) parameter:
-
The value of this parameter can range from 1 to 100. If an invalid value is used, this parameter will default to 30.
-
The default value, based on YouTube's 360p recommended minimum (1 Mbps videostream, 96khz audiostream) serves as minimum quality parameters. If the calculated target bitrate is lower, the default bitrate is used.
-
To prevent upscaling, if the calculated target bitrate is higher than the original, that original bitrate is applied instead.
Convert document
Parameter |
Description |
Mandatory |
---|---|---|
Name |
Name of the task. |
No |
Content type |
ContentType/MimeType for the output file. |
No |
Content disposition |
Defines whether the file is an attachment or provided inline. |
Yes |
Multi-page |
Determines whether renditions should be created for all pages of the file, or only the first. |
No |
Low resolution |
Defines whether the output file uses compression methods to reduce the file size. |
No |
Extract content |
Defines whether text is extracted from the document for full-text search. |
No |
Convert HTML
Parameter |
Description |
Mandatory |
---|---|---|
Name |
Name of the task. |
No |
Content type |
ContentType/MimeType for the output file. |
No |
Content disposition |
Defines whether the file is an attachment or provided inline. |
Yes |
The HTML media processor only renders the text without applying layouts on it. It also does not render images referenced in the HTML or use the CSS to style the HTML. Thus, the preview you see on the asset details page might differ from how you see the HTML asset in a web browser.
Create storyboard
Parameter |
Description |
Mandatory |
---|---|---|
Name |
Name of the task. |
No |
Content type |
ContentType/MimeType for the output file. |
No |
Content disposition |
Defines whether the file is an attachment or provided inline. |
Yes |
Target extension |
File extension of resulting output. |
No |
Seekbar thumbnail - Width |
Width of the thumbnail when seeking in a video. |
Yes |
Seekbar thumbnail - Height |
Height of the thumbnail when seeking in a video. |
Yes |
Seekbar thumbnail - Amount |
Amount of frames used for seeking in a video. |
Yes |
Story thumbnail - Width |
Width of the thumbnail for the storyboard rendition. |
Yes |
Story thumbnail - Height |
Height of the thumbnail for the storyboard rendition. |
Yes |
Story thumbnail - Amount |
Amount of frames used for the storyboard rendition. |
Yes |
Extract clipping paths
Parameter |
Description |
Mandatory |
---|---|---|
Name |
Name of the task. |
No |
Extract metadata
Parameter |
Description |
Mandatory |
---|---|---|
Name |
Name of the task. |
No |
Content disposition |
Defines whether the file is an attachment or provided inline. |
Yes |
Extract vision data
Parameter |
Description |
Mandatory |
---|---|---|
Name |
Name of the task. Warning We recommend you do not change the name of the task. Use the default vision task name analysis. |
No |
Content type |
ContentType/MimeType for the output file. |
No |
Content disposition |
Defines whether the file is an attachment or provided inline. |
Yes |
Endpoint |
Send a request to either the OCR endpoint for text recognition both to the Analyze endpoint for image features recognition. |
Yes |
Detect orientation |
Defines whether the OCR feature detect the orientation of text. |
No |
Minimum confidence |
Determines the minimum accuracy level of the analysis (default value: 0.5). Note Changing the minimum confidence level only affects analysis performed after the change; it has no effect on previous analysis. |
Yes |
Features |
Features to extract. |
No |
Details |
Types of content to analyze. |
No |
Extract video indexer data
Parameter |
Description |
Mandatory |
---|---|---|
Name |
Name of the task. |
No |
Content type |
ContentType/MimeType for the output file. |
No |
Content disposition |
Defines whether the file is an attachment or provided inline. |
Yes |
Image format |
Output format for the storyboard and face renditions. |
No |
Thumbnail height |
Height for the face thumbnail renditions. |
Yes |
Thumbnail width |
Width for the face thumbnail renditions. |
Yes |
Key frame height |
Height for the key frame renditions. |
Yes |
Key frame width |
Width for the key frame renditions. |
Yes |
Run external web task
Parameter |
Description |
Mandatory |
---|---|---|
Name |
Name of the task. |
No |
Content type |
ContentType/MimeType for the output file. |
No |
Content disposition |
Defines whether the file is an attachment or provided inline. |
Yes |
URL |
URL of the external task. |
No |
Headers |
JSON containing web request headers. |
No |
Parameters |
JSON containing web request parameters. |
No |