NAME

Paws::ElasticTranscoder::Artwork

USAGE

This class represents one of two things:

Arguments in a call to a service

Use the attributes of this class as arguments to methods. You shouldn't make instances of this class. Each attribute should be used as a named argument in the calls that expect this type of object.

As an example, if Att1 is expected to be a Paws::ElasticTranscoder::Artwork object:

  $service_obj->Method(Att1 => { AlbumArtFormat => $value, ..., SizingPolicy => $value  });

Results returned from an API call

Use accessors for each attribute. If Att1 is expected to be an Paws::ElasticTranscoder::Artwork object:

  $result = $service_obj->Method(...);
  $result->Att1->AlbumArtFormat

DESCRIPTION

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.

ATTRIBUTES

AlbumArtFormat => Str

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

Encryption => Paws::ElasticTranscoder::Encryption

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

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.

MaxHeight => Str

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.

MaxWidth => Str

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.

PaddingPolicy => Str

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".

SizingPolicy => Str

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.

BUGS and CONTRIBUTIONS

The source code is located here: <https://github.com/pplu/aws-sdk-perl>

Please report bugs to: <https://github.com/pplu/aws-sdk-perl/issues>