Skip to content

/AWS1/CL_ETCTHUMBNAILS

Thumbnails for videos.

CONSTRUCTOR

IMPORTING

Optional arguments:

iv_format TYPE /AWS1/ETCJPGORPNG /AWS1/ETCJPGORPNG

The format of thumbnails, if any. Valid values are jpg and png.

You specify whether you want Elastic Transcoder to create thumbnails when you create a job.

iv_interval TYPE /AWS1/ETCDIGITS /AWS1/ETCDIGITS

The approximate number of seconds between thumbnails. Specify an integer value.

iv_resolution TYPE /AWS1/ETCTHUMBNAILRESOLUTION /AWS1/ETCTHUMBNAILRESOLUTION

To better control resolution and aspect ratio of thumbnails, we recommend that you use the values MaxWidth, MaxHeight, SizingPolicy, and PaddingPolicy instead of Resolution and AspectRatio. The two groups of settings are mutually exclusive. Do not use them together.

The width and height of thumbnail files in pixels. Specify a value in the format width x height where both values are even integers. The values cannot exceed the width and height that you specified in the Video:Resolution object.

iv_aspectratio TYPE /AWS1/ETCASPECTRATIO /AWS1/ETCASPECTRATIO

To better control resolution and aspect ratio of thumbnails, we recommend that you use the values MaxWidth, MaxHeight, SizingPolicy, and PaddingPolicy instead of Resolution and AspectRatio. The two groups of settings are mutually exclusive. Do not use them together.

The aspect ratio of thumbnails. Valid values include:

auto, 1:1, 4:3, 3:2, 16:9

If you specify auto, Elastic Transcoder tries to preserve the aspect ratio of the video in the output file.

iv_maxwidth TYPE /AWS1/ETCDIGITSORAUTO /AWS1/ETCDIGITSORAUTO

The maximum width of thumbnails in pixels. If you specify auto, Elastic Transcoder uses 1920 (Full HD) as the default value. If you specify a numeric value, enter an even integer between 32 and 4096.

iv_maxheight TYPE /AWS1/ETCDIGITSORAUTO /AWS1/ETCDIGITSORAUTO

The maximum height of thumbnails in pixels. If you specify auto, Elastic Transcoder uses 1080 (Full HD) as the default value. If you specify a numeric value, enter an even integer between 32 and 3072.

iv_sizingpolicy TYPE /AWS1/ETCSIZINGPOLICY /AWS1/ETCSIZINGPOLICY

Specify one of the following values to control scaling of thumbnails:

  • Fit: Elastic Transcoder scales thumbnails so they match the value that you specified in thumbnail MaxWidth or MaxHeight settings without exceeding the other value.

  • Fill: Elastic Transcoder scales thumbnails so they match the value that you specified in thumbnail MaxWidth or MaxHeight settings and matches or exceeds the other value. Elastic Transcoder centers the image in thumbnails and then crops in the dimension (if any) that exceeds the maximum value.

  • Stretch: Elastic Transcoder stretches thumbnails to match the values that you specified for thumbnail MaxWidth and MaxHeight settings. If the relative proportions of the input video and thumbnails are different, the thumbnails will be distorted.

  • Keep: Elastic Transcoder does not scale thumbnails. If either dimension of the input video exceeds the values that you specified for thumbnail MaxWidth and MaxHeight settings, Elastic Transcoder crops the thumbnails.

  • ShrinkToFit: Elastic Transcoder scales thumbnails down so that their dimensions match the values that you specified for at least one of thumbnail MaxWidth and MaxHeight without exceeding either value. If you specify this option, Elastic Transcoder does not scale thumbnails up.

  • ShrinkToFill: Elastic Transcoder scales thumbnails down so that their dimensions match the values that you specified for at least one of MaxWidth and MaxHeight without dropping below either value. If you specify this option, Elastic Transcoder does not scale thumbnails up.

iv_paddingpolicy TYPE /AWS1/ETCPADDINGPOLICY /AWS1/ETCPADDINGPOLICY

When you set PaddingPolicy to Pad, Elastic Transcoder may add black bars to the top and bottom and/or left and right sides of thumbnails to make the total size of the thumbnails match the values that you specified for thumbnail MaxWidth and MaxHeight settings.

Queryable Attributes

Format

The format of thumbnails, if any. Valid values are jpg and png.

You specify whether you want Elastic Transcoder to create thumbnails when you create a job.

Accessible with the following methods

Method Description
GET_FORMAT() Getter for FORMAT, with configurable default
ASK_FORMAT() Getter for FORMAT w/ exceptions if field has no value
HAS_FORMAT() Determine if FORMAT has a value

Interval

The approximate number of seconds between thumbnails. Specify an integer value.

Accessible with the following methods

Method Description
GET_INTERVAL() Getter for INTERVAL, with configurable default
ASK_INTERVAL() Getter for INTERVAL w/ exceptions if field has no value
HAS_INTERVAL() Determine if INTERVAL has a value

Resolution

To better control resolution and aspect ratio of thumbnails, we recommend that you use the values MaxWidth, MaxHeight, SizingPolicy, and PaddingPolicy instead of Resolution and AspectRatio. The two groups of settings are mutually exclusive. Do not use them together.

The width and height of thumbnail files in pixels. Specify a value in the format width x height where both values are even integers. The values cannot exceed the width and height that you specified in the Video:Resolution object.

Accessible with the following methods

Method Description
GET_RESOLUTION() Getter for RESOLUTION, with configurable default
ASK_RESOLUTION() Getter for RESOLUTION w/ exceptions if field has no value
HAS_RESOLUTION() Determine if RESOLUTION has a value

AspectRatio

To better control resolution and aspect ratio of thumbnails, we recommend that you use the values MaxWidth, MaxHeight, SizingPolicy, and PaddingPolicy instead of Resolution and AspectRatio. The two groups of settings are mutually exclusive. Do not use them together.

The aspect ratio of thumbnails. Valid values include:

auto, 1:1, 4:3, 3:2, 16:9

If you specify auto, Elastic Transcoder tries to preserve the aspect ratio of the video in the output file.

Accessible with the following methods

Method Description
GET_ASPECTRATIO() Getter for ASPECTRATIO, with configurable default
ASK_ASPECTRATIO() Getter for ASPECTRATIO w/ exceptions if field has no value
HAS_ASPECTRATIO() Determine if ASPECTRATIO has a value

MaxWidth

The maximum width of thumbnails in pixels. If you specify auto, Elastic Transcoder uses 1920 (Full HD) as the default value. If you specify a numeric value, enter an even integer between 32 and 4096.

Accessible with the following methods

Method Description
GET_MAXWIDTH() Getter for MAXWIDTH, with configurable default
ASK_MAXWIDTH() Getter for MAXWIDTH w/ exceptions if field has no value
HAS_MAXWIDTH() Determine if MAXWIDTH has a value

MaxHeight

The maximum height of thumbnails in pixels. If you specify auto, Elastic Transcoder uses 1080 (Full HD) as the default value. If you specify a numeric value, enter an even integer between 32 and 3072.

Accessible with the following methods

Method Description
GET_MAXHEIGHT() Getter for MAXHEIGHT, with configurable default
ASK_MAXHEIGHT() Getter for MAXHEIGHT w/ exceptions if field has no value
HAS_MAXHEIGHT() Determine if MAXHEIGHT has a value

SizingPolicy

Specify one of the following values to control scaling of thumbnails:

  • Fit: Elastic Transcoder scales thumbnails so they match the value that you specified in thumbnail MaxWidth or MaxHeight settings without exceeding the other value.

  • Fill: Elastic Transcoder scales thumbnails so they match the value that you specified in thumbnail MaxWidth or MaxHeight settings and matches or exceeds the other value. Elastic Transcoder centers the image in thumbnails and then crops in the dimension (if any) that exceeds the maximum value.

  • Stretch: Elastic Transcoder stretches thumbnails to match the values that you specified for thumbnail MaxWidth and MaxHeight settings. If the relative proportions of the input video and thumbnails are different, the thumbnails will be distorted.

  • Keep: Elastic Transcoder does not scale thumbnails. If either dimension of the input video exceeds the values that you specified for thumbnail MaxWidth and MaxHeight settings, Elastic Transcoder crops the thumbnails.

  • ShrinkToFit: Elastic Transcoder scales thumbnails down so that their dimensions match the values that you specified for at least one of thumbnail MaxWidth and MaxHeight without exceeding either value. If you specify this option, Elastic Transcoder does not scale thumbnails up.

  • ShrinkToFill: Elastic Transcoder scales thumbnails down so that their dimensions match the values that you specified for at least one of MaxWidth and MaxHeight without dropping below either value. If you specify this option, Elastic Transcoder does not scale thumbnails up.

Accessible with the following methods

Method Description
GET_SIZINGPOLICY() Getter for SIZINGPOLICY, with configurable default
ASK_SIZINGPOLICY() Getter for SIZINGPOLICY w/ exceptions if field has no value
HAS_SIZINGPOLICY() Determine if SIZINGPOLICY has a value

PaddingPolicy

When you set PaddingPolicy to Pad, Elastic Transcoder may add black bars to the top and bottom and/or left and right sides of thumbnails to make the total size of the thumbnails match the values that you specified for thumbnail MaxWidth and MaxHeight settings.

Accessible with the following methods

Method Description
GET_PADDINGPOLICY() Getter for PADDINGPOLICY, with configurable default
ASK_PADDINGPOLICY() Getter for PADDINGPOLICY w/ exceptions if field has no value
HAS_PADDINGPOLICY() Determine if PADDINGPOLICY has a value