Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.ElasticTranscoder.Types.Artwork

Description

Synopsis

data Artwork = Artwork' {
- sizingPolicy :: Maybe Text
- albumArtFormat :: Maybe Text
- maxHeight :: Maybe Text
- inputKey :: Maybe Text
- paddingPolicy :: Maybe Text
- encryption :: Maybe Encryption
- maxWidth :: Maybe Text
}
newArtwork :: Artwork
artwork_sizingPolicy :: Lens' Artwork (Maybe Text)
artwork_albumArtFormat :: Lens' Artwork (Maybe Text)
artwork_maxHeight :: Lens' Artwork (Maybe Text)
artwork_inputKey :: Lens' Artwork (Maybe Text)
artwork_paddingPolicy :: Lens' Artwork (Maybe Text)
artwork_encryption :: Lens' Artwork (Maybe Encryption)
artwork_maxWidth :: Lens' Artwork (Maybe Text)

Documentation

data Artwork Source #

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.

See: newArtwork smart constructor.

Constructors

Artwork'

Fields

sizingPolicy :: Maybe Text
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.
albumArtFormat :: Maybe Text
The format of album art, if any. Valid formats are .jpg and .png.
maxHeight :: Maybe Text
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.
inputKey :: Maybe Text
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.
paddingPolicy :: Maybe Text
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.
encryption :: Maybe Encryption
The encryption settings, if any, that you want Elastic Transcoder to apply to your artwork.
maxWidth :: Maybe Text
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.

Instances

Instances details

Eq Artwork Source #
Instance details Defined in Amazonka.ElasticTranscoder.Types.Artwork Methods (==) :: Artwork -> Artwork -> Bool # (/=) :: Artwork -> Artwork -> Bool #
Read Artwork Source #
Instance details Defined in Amazonka.ElasticTranscoder.Types.Artwork Methods readsPrec :: Int -> ReadS Artwork # readList :: ReadS [Artwork] # readPrec :: ReadPrec Artwork # readListPrec :: ReadPrec [Artwork] #
Show Artwork Source #
Instance details Defined in Amazonka.ElasticTranscoder.Types.Artwork Methods showsPrec :: Int -> Artwork -> ShowS # show :: Artwork -> String # showList :: [Artwork] -> ShowS #
Generic Artwork Source #
Instance details Defined in Amazonka.ElasticTranscoder.Types.Artwork Associated Types type Rep Artwork :: Type -> Type # Methods from :: Artwork -> Rep Artwork x # to :: Rep Artwork x -> Artwork #
NFData Artwork Source #
Instance details Defined in Amazonka.ElasticTranscoder.Types.Artwork Methods rnf :: Artwork -> () #
Hashable Artwork Source #
Instance details Defined in Amazonka.ElasticTranscoder.Types.Artwork Methods hashWithSalt :: Int -> Artwork -> Int # hash :: Artwork -> Int #
ToJSON Artwork Source #
Instance details Defined in Amazonka.ElasticTranscoder.Types.Artwork Methods toJSON :: Artwork -> Value # toEncoding :: Artwork -> Encoding # toJSONList :: [Artwork] -> Value # toEncodingList :: [Artwork] -> Encoding #
FromJSON Artwork Source #
Instance details Defined in Amazonka.ElasticTranscoder.Types.Artwork Methods parseJSON :: Value -> Parser Artwork # parseJSONList :: Value -> Parser [Artwork] #
type Rep Artwork Source #
Instance details Defined in Amazonka.ElasticTranscoder.Types.Artwork type Rep Artwork = D1 ('MetaData "Artwork" "Amazonka.ElasticTranscoder.Types.Artwork" "libZSservicesZSamazonka-elastictranscoderZSamazonka-elastictranscoder" 'False) (C1 ('MetaCons "Artwork'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "sizingPolicy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "albumArtFormat") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "maxHeight") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :: ((S1 ('MetaSel ('Just "inputKey") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "paddingPolicy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "encryption") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Encryption)) :: S1 ('MetaSel ('Just "maxWidth") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))))

newArtwork :: Artwork Source #

Create a value of Artwork with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:sizingPolicy:Artwork', artwork_sizingPolicy - 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.

$sel:albumArtFormat:Artwork', artwork_albumArtFormat - The format of album art, if any. Valid formats are .jpg and .png.

$sel:maxHeight:Artwork', artwork_maxHeight - 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.

$sel:inputKey:Artwork', artwork_inputKey - 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.

$sel:paddingPolicy:Artwork', artwork_paddingPolicy - 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.

$sel:encryption:Artwork', artwork_encryption - The encryption settings, if any, that you want Elastic Transcoder to apply to your artwork.

$sel:maxWidth:Artwork', artwork_maxWidth - 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.

artwork_sizingPolicy :: Lens' Artwork (Maybe Text) Source #

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.

artwork_albumArtFormat :: Lens' Artwork (Maybe Text) Source #

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

artwork_maxHeight :: Lens' Artwork (Maybe Text) Source #

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.

artwork_inputKey :: Lens' Artwork (Maybe Text) Source #

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.

artwork_paddingPolicy :: Lens' Artwork (Maybe Text) Source #

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.

artwork_encryption :: Lens' Artwork (Maybe Encryption) Source #

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

artwork_maxWidth :: Lens' Artwork (Maybe Text) Source #

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.