Class: Aws::ElasticTranscoder::Types::Artwork

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-elastictranscoder/types.rb

Overview

The file to be used as album art. There can be multiple artworks associated with an audio file, to a maximum of 20.

To remove artwork or leave the artwork empty, you can either set ‘Artwork` to null, or set the `Merge Policy` to “Replace” and use an empty `Artwork` array.

To pass through existing artwork unchanged, set the ‘Merge Policy` to “Prepend”, “Append”, or “Fallback”, and use an empty `Artwork` array.

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#album_art_formatString

The format of album art, if any. Valid formats are ‘.jpg` and `.png`.

Returns:

  • (String)


107
108
109
110
111
112
113
114
115
116
117
# File 'lib/aws-sdk-elastictranscoder/types.rb', line 107

class Artwork < Struct.new(
  :input_key,
  :max_width,
  :max_height,
  :sizing_policy,
  :padding_policy,
  :album_art_format,
  :encryption)
  SENSITIVE = []
  include Aws::Structure
end

#encryptionTypes::Encryption

The encryption settings, if any, that you want Elastic Transcoder to apply to your artwork.

Returns:



107
108
109
110
111
112
113
114
115
116
117
# File 'lib/aws-sdk-elastictranscoder/types.rb', line 107

class Artwork < Struct.new(
  :input_key,
  :max_width,
  :max_height,
  :sizing_policy,
  :padding_policy,
  :album_art_format,
  :encryption)
  SENSITIVE = []
  include Aws::Structure
end

#input_keyString

The name of the file to be used as album art. To determine which Amazon S3 bucket contains the specified file, Elastic Transcoder checks the pipeline specified by ‘PipelineId`; the `InputBucket` object in that pipeline identifies the bucket.

If the file name includes a prefix, for example, ‘cooking/pie.jpg`, include the prefix in the key. If the file isn’t in the specified bucket, Elastic Transcoder returns an error.

Returns:

  • (String)


107
108
109
110
111
112
113
114
115
116
117
# File 'lib/aws-sdk-elastictranscoder/types.rb', line 107

class Artwork < Struct.new(
  :input_key,
  :max_width,
  :max_height,
  :sizing_policy,
  :padding_policy,
  :album_art_format,
  :encryption)
  SENSITIVE = []
  include Aws::Structure
end

#max_heightString

The maximum height of the output album art in pixels. If you specify ‘auto`, Elastic Transcoder uses 600 as the default value. If you specify a numeric value, enter an even integer between 32 and 3072, inclusive.

Returns:

  • (String)


107
108
109
110
111
112
113
114
115
116
117
# File 'lib/aws-sdk-elastictranscoder/types.rb', line 107

class Artwork < Struct.new(
  :input_key,
  :max_width,
  :max_height,
  :sizing_policy,
  :padding_policy,
  :album_art_format,
  :encryption)
  SENSITIVE = []
  include Aws::Structure
end

#max_widthString

The maximum width of the output album art in pixels. If you specify ‘auto`, Elastic Transcoder uses 600 as the default value. If you specify a numeric value, enter an even integer between 32 and 4096, inclusive.

Returns:

  • (String)


107
108
109
110
111
112
113
114
115
116
117
# File 'lib/aws-sdk-elastictranscoder/types.rb', line 107

class Artwork < Struct.new(
  :input_key,
  :max_width,
  :max_height,
  :sizing_policy,
  :padding_policy,
  :album_art_format,
  :encryption)
  SENSITIVE = []
  include Aws::Structure
end

#padding_policyString

When you set ‘PaddingPolicy` to `Pad`, Elastic Transcoder may add white bars to the top and bottom and/or left and right sides of the output album art to make the total size of the output art match the values that you specified for `MaxWidth` and `MaxHeight`.

Returns:

  • (String)


107
108
109
110
111
112
113
114
115
116
117
# File 'lib/aws-sdk-elastictranscoder/types.rb', line 107

class Artwork < Struct.new(
  :input_key,
  :max_width,
  :max_height,
  :sizing_policy,
  :padding_policy,
  :album_art_format,
  :encryption)
  SENSITIVE = []
  include Aws::Structure
end

#sizing_policyString

Specify one of the following values to control scaling of the output album art:

  • ‘Fit:` Elastic Transcoder scales the output art so it matches the value that you specified in either `MaxWidth` or `MaxHeight` without exceeding the other value.

  • ‘Fill:` Elastic Transcoder scales the output art so it matches the value that you specified in either `MaxWidth` or `MaxHeight` and matches or exceeds the other value. Elastic Transcoder centers the output art and then crops it in the dimension (if any) that exceeds the maximum value.

  • ‘Stretch:` Elastic Transcoder stretches the output art to match the values that you specified for `MaxWidth` and `MaxHeight`. If the relative proportions of the input art and the output art are different, the output art will be distorted.

  • ‘Keep:` Elastic Transcoder does not scale the output art. If either dimension of the input art exceeds the values that you specified for `MaxWidth` and `MaxHeight`, Elastic Transcoder crops the output art.

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

  • ‘ShrinkToFill` Elastic Transcoder scales the output art down so that its 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 the art up.

Returns:

  • (String)


107
108
109
110
111
112
113
114
115
116
117
# File 'lib/aws-sdk-elastictranscoder/types.rb', line 107

class Artwork < Struct.new(
  :input_key,
  :max_width,
  :max_height,
  :sizing_policy,
  :padding_policy,
  :album_art_format,
  :encryption)
  SENSITIVE = []
  include Aws::Structure
end