Interface Thumbnails.Builder

All Superinterfaces:
Buildable, CopyableBuilder<Thumbnails.Builder,Thumbnails>, SdkBuilder<Thumbnails.Builder,Thumbnails>, SdkPojo
Enclosing class:
Thumbnails
public static interface Thumbnails.Builder extends SdkPojo, CopyableBuilder<Thumbnails.Builder,Thumbnails>

  • Method Details

    • format

      Thumbnails.Builder format(String 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.

      Parameters:
      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.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • interval

      Thumbnails.Builder interval(String interval)

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

      Parameters:
      interval - The approximate number of seconds between thumbnails. Specify an integer value.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • resolution

      Thumbnails.Builder resolution(String 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.

      Parameters:
      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.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • aspectRatio

      Thumbnails.Builder aspectRatio(String 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.

      Parameters:
      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.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • maxWidth

      Thumbnails.Builder maxWidth(String 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.

      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • maxHeight

      Thumbnails.Builder maxHeight(String 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.

      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • sizingPolicy

      Thumbnails.Builder sizingPolicy(String 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.

      Parameters:
      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.

      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • paddingPolicy

      Thumbnails.Builder paddingPolicy(String 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.

      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.