VideoParameters.java

/*
 * Copyright 2011-2016 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"). You may not
 * use this file except in compliance with the License. A copy of the License is
 * located at
 * 
 * http://aws.amazon.com/apache2.0
 * 
 * or in the "license" file accompanying this file. This file is distributed on
 * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
 * express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */
package com.amazonaws.services.elastictranscoder.model;

import java.io.Serializable;

/**
 * <p>
 * The <code>VideoParameters</code> structure.
 * </p>
 */
public class VideoParameters implements Serializable, Cloneable {

    /**
     * <p>
     * The video codec for the output file. Valid values include
     * <code>gif</code>, <code>H.264</code>, <code>mpeg2</code>, and
     * <code>vp8</code>. You can only specify <code>vp8</code> when the
     * container type is <code>webm</code>, <code>gif</code> when the container
     * type is <code>gif</code>, and <code>mpeg2</code> when the container type
     * is <code>mpg</code>.
     * </p>
     */
    private String codec;
    /**
     * <p>
     * <b>Profile (H.264/VP8 Only)</b>
     * </p>
     * <p>
     * The H.264 profile that you want to use for the output file. Elastic
     * Transcoder supports the following profiles:
     * </p>
     * <ul>
     * <li><code>baseline</code>: The profile most commonly used for
     * videoconferencing and for mobile applications.</li>
     * <li><code>main</code>: The profile used for standard-definition digital
     * TV broadcasts.</li>
     * <li><code>high</code>: The profile used for high-definition digital TV
     * broadcasts and for Blu-ray discs.</li>
     * </ul>
     * <p>
     * <b>Level (H.264 Only)</b>
     * </p>
     * <p>
     * The H.264 level that you want to use for the output file. Elastic
     * Transcoder supports the following levels:
     * </p>
     * <p>
     * <code>1</code>, <code>1b</code>, <code>1.1</code>, <code>1.2</code>,
     * <code>1.3</code>, <code>2</code>, <code>2.1</code>, <code>2.2</code>,
     * <code>3</code>, <code>3.1</code>, <code>3.2</code>, <code>4</code>,
     * <code>4.1</code>
     * </p>
     * <p>
     * <b>MaxReferenceFrames (H.264 Only)</b>
     * </p>
     * <p>
     * Applicable only when the value of Video:Codec is H.264. The maximum
     * number of previously decoded frames to use as a reference for decoding
     * future frames. Valid values are integers 0 through 16, but we recommend
     * that you not use a value greater than the following:
     * </p>
     * <p>
     * <code>Min(Floor(Maximum decoded picture buffer in macroblocks * 256 / (Width in pixels * Height in pixels)), 16)</code>
     * </p>
     * <p>
     * where <i>Width in pixels</i> and <i>Height in pixels</i> represent either
     * MaxWidth and MaxHeight, or Resolution. <i>Maximum decoded picture buffer
     * in macroblocks</i> depends on the value of the <code>Level</code> object.
     * See the list below. (A macroblock is a block of pixels measuring 16x16.)
     * </p>
     * <ul>
     * <li>1 - 396</li>
     * <li>1b - 396</li>
     * <li>1.1 - 900</li>
     * <li>1.2 - 2376</li>
     * <li>1.3 - 2376</li>
     * <li>2 - 2376</li>
     * <li>2.1 - 4752</li>
     * <li>2.2 - 8100</li>
     * <li>3 - 8100</li>
     * <li>3.1 - 18000</li>
     * <li>3.2 - 20480</li>
     * <li>4 - 32768</li>
     * <li>4.1 - 32768</li>
     * </ul>
     * <p>
     * <b>MaxBitRate (Optional, H.264/MPEG2/VP8 only)</b>
     * </p>
     * <p>
     * The maximum number of bits per second in a video buffer; the size of the
     * buffer is specified by <code>BufferSize</code>. Specify a value between
     * 16 and 62,500. You can reduce the bandwidth required to stream a video by
     * reducing the maximum bit rate, but this also reduces the quality of the
     * video.
     * </p>
     * <p>
     * <b>BufferSize (Optional, H.264/MPEG2/VP8 only)</b>
     * </p>
     * <p>
     * The maximum number of bits in any x seconds of the output video. This
     * window is commonly 10 seconds, the standard segment duration when you're
     * using FMP4 or MPEG-TS for the container type of the output video. Specify
     * an integer greater than 0. If you specify <code>MaxBitRate</code> and
     * omit <code>BufferSize</code>, Elastic Transcoder sets
     * <code>BufferSize</code> to 10 times the value of <code>MaxBitRate</code>.
     * </p>
     * <p>
     * <b>InterlacedMode (Optional, H.264/MPEG2 Only)</b>
     * </p>
     * <p>
     * The interlace mode for the output video.
     * </p>
     * <p>
     * Interlaced video is used to double the perceived frame rate for a video
     * by interlacing two fields (one field on every other line, the other field
     * on the other lines) so that the human eye registers multiple pictures per
     * frame. Interlacing reduces the bandwidth required for transmitting a
     * video, but can result in blurred images and flickering.
     * </p>
     * <p>
     * Valid values include <code>Progressive</code> (no interlacing, top to
     * bottom), <code>TopFirst</code> (top field first),
     * <code>BottomFirst</code> (bottom field first), and <code>Auto</code>.
     * </p>
     * <p>
     * If <code>InterlaceMode</code> is not specified, Elastic Transcoder uses
     * <code>Progressive</code> for the output. If <code>Auto</code> is
     * specified, Elastic Transcoder interlaces the output.
     * </p>
     * <p>
     * <b>ColorSpaceConversionMode (Optional, H.264/MPEG2 Only)</b>
     * </p>
     * <p>
     * The color space conversion Elastic Transcoder applies to the output
     * video. Color spaces are the algorithms used by the computer to store
     * information about how to render color. <code>Bt.601</code> is the
     * standard for standard definition video, while <code>Bt.709</code> is the
     * standard for high definition video.
     * </p>
     * <p>
     * Valid values include <code>None</code>, <code>Bt709toBt601</code>,
     * <code>Bt601toBt709</code>, and <code>Auto</code>.
     * </p>
     * <p>
     * If you chose <code>Auto</code> for <code>ColorSpaceConversionMode</code>
     * and your output is interlaced, your frame rate is one of
     * <code>23.97</code>, <code>24</code>, <code>25</code>, <code>29.97</code>,
     * <code>50</code>, or <code>60</code>, your <code>SegmentDuration</code> is
     * null, and you are using one of the resolution changes from the list
     * below, Elastic Transcoder applies the following color space conversions:
     * </p>
     * <ul>
     * <li><i>Standard to HD, 720x480 to 1920x1080</i> - Elastic Transcoder
     * applies <code>Bt601ToBt709</code></li>
     * <li><i>Standard to HD, 720x576 to 1920x1080</i> - Elastic Transcoder
     * applies <code>Bt601ToBt709</code></li>
     * <li><i>HD to Standard, 1920x1080 to 720x480</i> - Elastic Transcoder
     * applies <code>Bt709ToBt601</code></li>
     * <li><i>HD to Standard, 1920x1080 to 720x576</i> - Elastic Transcoder
     * applies <code>Bt709ToBt601</code></li>
     * </ul>
     * <note>Elastic Transcoder may change the behavior of the
     * <code>ColorspaceConversionMode</code> <code>Auto</code> mode in the
     * future. All outputs in a playlist must use the same
     * <code>ColorSpaceConversionMode</code>.</note>
     * <p>
     * If you do not specify a <code>ColorSpaceConversionMode</code>, Elastic
     * Transcoder does not change the color space of a file. If you are unsure
     * what <code>ColorSpaceConversionMode</code> was applied to your output
     * file, you can check the <code>AppliedColorSpaceConversion</code>
     * parameter included in your job response. If your job does not have an
     * <code>AppliedColorSpaceConversion</code> in its response, no
     * <code>ColorSpaceConversionMode</code> was applied.
     * </p>
     * <p>
     * <b>ChromaSubsampling</b>
     * </p>
     * <p>
     * The sampling pattern for the chroma (color) channels of the output video.
     * Valid values include <code>yuv420p</code> and <code>yuv422p</code>.
     * </p>
     * <p>
     * <code>yuv420p</code> samples the chroma information of every other
     * horizontal and every other vertical line, <code>yuv422p</code> samples
     * the color information of every horizontal line and every other vertical
     * line.
     * </p>
     * <p>
     * <b>LoopCount (Gif Only)</b>
     * </p>
     * <p>
     * The number of times you want the output gif to loop. Valid values include
     * <code>Infinite</code> and integers between <code>0</code> and
     * <code>100</code>, inclusive.
     * </p>
     */
    private com.amazonaws.internal.SdkInternalMap<String, String> codecOptions;
    /**
     * <p>
     * Applicable only when the value of Video:Codec is one of
     * <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.
     * </p>
     * <p>
     * The maximum number of frames between key frames. Key frames are fully
     * encoded frames; the frames between key frames are encoded based, in part,
     * on the content of the key frames. The value is an integer formatted as a
     * string; valid values are between 1 (every frame is a key frame) and
     * 100000, inclusive. A higher value results in higher compression but may
     * also discernibly decrease video quality.
     * </p>
     * <p>
     * For <code>Smooth</code> outputs, the <code>FrameRate</code> must have a
     * constant ratio to the <code>KeyframesMaxDist</code>. This allows
     * <code>Smooth</code> playlists to switch between different quality levels
     * while the file is being played.
     * </p>
     * <p>
     * For example, an input file can have a <code>FrameRate</code> of 30 with a
     * <code>KeyframesMaxDist</code> of 90. The output file then needs to have a
     * ratio of 1:3. Valid outputs would have <code>FrameRate</code> of 30, 25,
     * and 10, and <code>KeyframesMaxDist</code> of 90, 75, and 30,
     * respectively.
     * </p>
     * <p>
     * Alternately, this can be achieved by setting <code>FrameRate</code> to
     * auto and having the same values for <code>MaxFrameRate</code> and
     * <code>KeyframesMaxDist</code>.
     * </p>
     */
    private String keyframesMaxDist;
    /**
     * <p>
     * Applicable only when the value of Video:Codec is one of
     * <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.
     * </p>
     * <p>
     * Whether to use a fixed value for <code>FixedGOP</code>. Valid values are
     * <code>true</code> and <code>false</code>:
     * </p>
     * <ul>
     * <li><code>true</code>: Elastic Transcoder uses the value of
     * <code>KeyframesMaxDist</code> for the distance between key frames (the
     * number of frames in a group of pictures, or GOP).</li>
     * <li><code>false</code>: The distance between key frames can vary.</li>
     * </ul>
     * <important>
     * <p>
     * <code>FixedGOP</code> must be set to <code>true</code> for
     * <code>fmp4</code> containers.
     * </p>
     * </important>
     */
    private String fixedGOP;
    /**
     * <p>
     * The bit rate of the video stream in the output file, in kilobits/second.
     * Valid values depend on the values of <code>Level</code> and
     * <code>Profile</code>. If you specify <code>auto</code>, Elastic
     * Transcoder uses the detected bit rate of the input source. If you specify
     * a value other than <code>auto</code>, we recommend that you specify a
     * value less than or equal to the maximum H.264-compliant value listed for
     * your level and profile:
     * </p>
     * <p>
     * <i>Level - Maximum video bit rate in kilobits/second (baseline and main
     * Profile) : maximum video bit rate in kilobits/second (high Profile)</i>
     * </p>
     * <ul>
     * <li>1 - 64 : 80</li>
     * <li>1b - 128 : 160</li>
     * <li>1.1 - 192 : 240</li>
     * <li>1.2 - 384 : 480</li>
     * <li>1.3 - 768 : 960</li>
     * <li>2 - 2000 : 2500</li>
     * <li>3 - 10000 : 12500</li>
     * <li>3.1 - 14000 : 17500</li>
     * <li>3.2 - 20000 : 25000</li>
     * <li>4 - 20000 : 25000</li>
     * <li>4.1 - 50000 : 62500</li>
     * </ul>
     */
    private String bitRate;
    /**
     * <p>
     * The frames per second for the video stream in the output file. Valid
     * values include:
     * </p>
     * <p>
     * <code>auto</code>, <code>10</code>, <code>15</code>, <code>23.97</code>,
     * <code>24</code>, <code>25</code>, <code>29.97</code>, <code>30</code>,
     * <code>60</code>
     * </p>
     * <p>
     * If you specify <code>auto</code>, Elastic Transcoder uses the detected
     * frame rate of the input source. If you specify a frame rate, we recommend
     * that you perform the following calculation:
     * </p>
     * <p>
     * <code>Frame rate = maximum recommended decoding speed in luma samples/second / (width in pixels * height in pixels)</code>
     * </p>
     * <p>
     * where:
     * </p>
     * <ul>
     * <li><i>width in pixels</i> and <i>height in pixels</i> represent the
     * Resolution of the output video.</li>
     * <li><i>maximum recommended decoding speed in Luma samples/second</i> is
     * less than or equal to the maximum value listed in the following table,
     * based on the value that you specified for Level.</li>
     * </ul>
     * <p>
     * The maximum recommended decoding speed in Luma samples/second for each
     * level is described in the following list (<i>Level - Decoding speed</i>):
     * </p>
     * <ul>
     * <li>1 - 380160</li>
     * <li>1b - 380160</li>
     * <li>1.1 - 76800</li>
     * <li>1.2 - 1536000</li>
     * <li>1.3 - 3041280</li>
     * <li>2 - 3041280</li>
     * <li>2.1 - 5068800</li>
     * <li>2.2 - 5184000</li>
     * <li>3 - 10368000</li>
     * <li>3.1 - 27648000</li>
     * <li>3.2 - 55296000</li>
     * <li>4 - 62914560</li>
     * <li>4.1 - 62914560</li>
     * </ul>
     */
    private String frameRate;
    /**
     * <p>
     * If you specify <code>auto</code> for <code>FrameRate</code>, Elastic
     * Transcoder uses the frame rate of the input video for the frame rate of
     * the output video. Specify the maximum frame rate that you want Elastic
     * Transcoder to use when the frame rate of the input video is greater than
     * the desired maximum frame rate of the output video. Valid values include:
     * <code>10</code>, <code>15</code>, <code>23.97</code>, <code>24</code>,
     * <code>25</code>, <code>29.97</code>, <code>30</code>, <code>60</code>.
     * </p>
     */
    private String maxFrameRate;
    /**
     * <important>
     * <p>
     * To better control resolution and aspect ratio of output videos, we
     * recommend that you use the values <code>MaxWidth</code>,
     * <code>MaxHeight</code>, <code>SizingPolicy</code>,
     * <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code> instead
     * of <code>Resolution</code> and <code>AspectRatio</code>. The two groups
     * of settings are mutually exclusive. Do not use them together.
     * </p>
     * </important>
     * <p>
     * The width and height of the video in the output file, in pixels. Valid
     * values are <code>auto</code> and <i>width</i> x <i>height</i>:
     * </p>
     * <ul>
     * <li><code>auto</code>: Elastic Transcoder attempts to preserve the width
     * and height of the input file, subject to the following rules.</li>
     * <li><code><i>width</i> x <i>height</i></code>: The width and height of
     * the output video in pixels.</li>
     * </ul>
     * <p>
     * Note the following about specifying the width and height:
     * </p>
     * <ul>
     * <li>The width must be an even integer between 128 and 4096, inclusive.</li>
     * <li>The height must be an even integer between 96 and 3072, inclusive.</li>
     * <li>If you specify a resolution that is less than the resolution of the
     * input file, Elastic Transcoder rescales the output file to the lower
     * resolution.</li>
     * <li>If you specify a resolution that is greater than the resolution of
     * the input file, Elastic Transcoder rescales the output to the higher
     * resolution.</li>
     * <li>We recommend that you specify a resolution for which the product of
     * width and height is less than or equal to the applicable value in the
     * following list (<i>List - Max width x height value</i>):</li>
     * <ul>
     * <li>1 - 25344</li>
     * <li>1b - 25344</li>
     * <li>1.1 - 101376</li>
     * <li>1.2 - 101376</li>
     * <li>1.3 - 101376</li>
     * <li>2 - 101376</li>
     * <li>2.1 - 202752</li>
     * <li>2.2 - 404720</li>
     * <li>3 - 404720</li>
     * <li>3.1 - 921600</li>
     * <li>3.2 - 1310720</li>
     * <li>4 - 2097152</li>
     * <li>4.1 - 2097152</li>
     * </ul>
     * </ul>
     */
    private String resolution;
    /**
     * <important>
     * <p>
     * To better control resolution and aspect ratio of output videos, we
     * recommend that you use the values <code>MaxWidth</code>,
     * <code>MaxHeight</code>, <code>SizingPolicy</code>,
     * <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code> instead
     * of <code>Resolution</code> and <code>AspectRatio</code>. The two groups
     * of settings are mutually exclusive. Do not use them together.
     * </p>
     * </important>
     * <p>
     * The display aspect ratio of the video in the output file. Valid values
     * include:
     * </p>
     * <p>
     * <code>auto</code>, <code>1:1</code>, <code>4:3</code>, <code>3:2</code>,
     * <code>16:9</code>
     * </p>
     * <p>
     * If you specify <code>auto</code>, Elastic Transcoder tries to preserve
     * the aspect ratio of the input file.
     * </p>
     * <p>
     * If you specify an aspect ratio for the output file that differs from
     * aspect ratio of the input file, Elastic Transcoder adds pillarboxing
     * (black bars on the sides) or letterboxing (black bars on the top and
     * bottom) to maintain the aspect ratio of the active region of the video.
     * </p>
     */
    private String aspectRatio;
    /**
     * <p>
     * The maximum width of the output video in pixels. If you specify
     * <code>auto</code>, Elastic Transcoder uses 1920 (Full HD) as the default
     * value. If you specify a numeric value, enter an even integer between 128
     * and 4096.
     * </p>
     */
    private String maxWidth;
    /**
     * <p>
     * The maximum height of the output video in pixels. If you specify
     * <code>auto</code>, Elastic Transcoder uses 1080 (Full HD) as the default
     * value. If you specify a numeric value, enter an even integer between 96
     * and 3072.
     * </p>
     */
    private String maxHeight;
    /**
     * <p>
     * The value that Elastic Transcoder adds to the metadata in the output
     * file.
     * </p>
     */
    private String displayAspectRatio;
    /**
     * <p>
     * Specify one of the following values to control scaling of the output
     * video:
     * </p>
     * <p>
     * <ul>
     * <li><code>Fit</code>: Elastic Transcoder scales the output video so it
     * matches the value that you specified in either <code>MaxWidth</code> or
     * <code>MaxHeight</code> without exceeding the other value.</li>
     * <li><code>Fill</code>: Elastic Transcoder scales the output video so it
     * matches the value that you specified in either <code>MaxWidth</code> or
     * <code>MaxHeight</code> and matches or exceeds the other value. Elastic
     * Transcoder centers the output video and then crops it in the dimension
     * (if any) that exceeds the maximum value.</li>
     * <li><code>Stretch</code>: Elastic Transcoder stretches the output video
     * to match the values that you specified for <code>MaxWidth</code> and
     * <code>MaxHeight</code>. If the relative proportions of the input video
     * and the output video are different, the output video will be distorted.</li>
     * <li><code>Keep</code>: Elastic Transcoder does not scale the output
     * video. If either dimension of the input video exceeds the values that you
     * specified for <code>MaxWidth</code> and <code>MaxHeight</code>, Elastic
     * Transcoder crops the output video.</li>
     * <li><code>ShrinkToFit</code>: Elastic Transcoder scales the output video
     * down so that its dimensions match the values that you specified for at
     * least one of <code>MaxWidth</code> and <code>MaxHeight</code> without
     * exceeding either value. If you specify this option, Elastic Transcoder
     * does not scale the video up.</li>
     * <li><code>ShrinkToFill</code>: Elastic Transcoder scales the output video
     * down so that its dimensions match the values that you specified for at
     * least one of <code>MaxWidth</code> and <code>MaxHeight</code> without
     * dropping below either value. If you specify this option, Elastic
     * Transcoder does not scale the video up.</li>
     * </ul>
     * </p>
     */
    private String sizingPolicy;
    /**
     * <p>
     * When you set <code>PaddingPolicy</code> to <code>Pad</code>, Elastic
     * Transcoder may add black bars to the top and bottom and/or left and right
     * sides of the output video to make the total size of the output video
     * match the values that you specified for <code>MaxWidth</code> and
     * <code>MaxHeight</code>.
     * </p>
     */
    private String paddingPolicy;
    /**
     * <p>
     * Settings for the size, location, and opacity of graphics that you want
     * Elastic Transcoder to overlay over videos that are transcoded using this
     * preset. You can specify settings for up to four watermarks. Watermarks
     * appear in the specified size and location, and with the specified opacity
     * for the duration of the transcoded video.
     * </p>
     * <p>
     * Watermarks can be in .png or .jpg format. If you want to display a
     * watermark that is not rectangular, use the .png format, which supports
     * transparency.
     * </p>
     * <p>
     * When you create a job that uses this preset, you specify the .png or .jpg
     * graphics that you want Elastic Transcoder to include in the transcoded
     * videos. You can specify fewer graphics in the job than you specify
     * watermark settings in the preset, which allows you to use the same preset
     * for up to four watermarks that have different dimensions.
     * </p>
     */
    private com.amazonaws.internal.SdkInternalList<PresetWatermark> watermarks;

    /**
     * <p>
     * The video codec for the output file. Valid values include
     * <code>gif</code>, <code>H.264</code>, <code>mpeg2</code>, and
     * <code>vp8</code>. You can only specify <code>vp8</code> when the
     * container type is <code>webm</code>, <code>gif</code> when the container
     * type is <code>gif</code>, and <code>mpeg2</code> when the container type
     * is <code>mpg</code>.
     * </p>
     * 
     * @param codec
     *        The video codec for the output file. Valid values include
     *        <code>gif</code>, <code>H.264</code>, <code>mpeg2</code>, and
     *        <code>vp8</code>. You can only specify <code>vp8</code> when the
     *        container type is <code>webm</code>, <code>gif</code> when the
     *        container type is <code>gif</code>, and <code>mpeg2</code> when
     *        the container type is <code>mpg</code>.
     */

    public void setCodec(String codec) {
        this.codec = codec;
    }

    /**
     * <p>
     * The video codec for the output file. Valid values include
     * <code>gif</code>, <code>H.264</code>, <code>mpeg2</code>, and
     * <code>vp8</code>. You can only specify <code>vp8</code> when the
     * container type is <code>webm</code>, <code>gif</code> when the container
     * type is <code>gif</code>, and <code>mpeg2</code> when the container type
     * is <code>mpg</code>.
     * </p>
     * 
     * @return The video codec for the output file. Valid values include
     *         <code>gif</code>, <code>H.264</code>, <code>mpeg2</code>, and
     *         <code>vp8</code>. You can only specify <code>vp8</code> when the
     *         container type is <code>webm</code>, <code>gif</code> when the
     *         container type is <code>gif</code>, and <code>mpeg2</code> when
     *         the container type is <code>mpg</code>.
     */

    public String getCodec() {
        return this.codec;
    }

    /**
     * <p>
     * The video codec for the output file. Valid values include
     * <code>gif</code>, <code>H.264</code>, <code>mpeg2</code>, and
     * <code>vp8</code>. You can only specify <code>vp8</code> when the
     * container type is <code>webm</code>, <code>gif</code> when the container
     * type is <code>gif</code>, and <code>mpeg2</code> when the container type
     * is <code>mpg</code>.
     * </p>
     * 
     * @param codec
     *        The video codec for the output file. Valid values include
     *        <code>gif</code>, <code>H.264</code>, <code>mpeg2</code>, and
     *        <code>vp8</code>. You can only specify <code>vp8</code> when the
     *        container type is <code>webm</code>, <code>gif</code> when the
     *        container type is <code>gif</code>, and <code>mpeg2</code> when
     *        the container type is <code>mpg</code>.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withCodec(String codec) {
        setCodec(codec);
        return this;
    }

    /**
     * <p>
     * <b>Profile (H.264/VP8 Only)</b>
     * </p>
     * <p>
     * The H.264 profile that you want to use for the output file. Elastic
     * Transcoder supports the following profiles:
     * </p>
     * <ul>
     * <li><code>baseline</code>: The profile most commonly used for
     * videoconferencing and for mobile applications.</li>
     * <li><code>main</code>: The profile used for standard-definition digital
     * TV broadcasts.</li>
     * <li><code>high</code>: The profile used for high-definition digital TV
     * broadcasts and for Blu-ray discs.</li>
     * </ul>
     * <p>
     * <b>Level (H.264 Only)</b>
     * </p>
     * <p>
     * The H.264 level that you want to use for the output file. Elastic
     * Transcoder supports the following levels:
     * </p>
     * <p>
     * <code>1</code>, <code>1b</code>, <code>1.1</code>, <code>1.2</code>,
     * <code>1.3</code>, <code>2</code>, <code>2.1</code>, <code>2.2</code>,
     * <code>3</code>, <code>3.1</code>, <code>3.2</code>, <code>4</code>,
     * <code>4.1</code>
     * </p>
     * <p>
     * <b>MaxReferenceFrames (H.264 Only)</b>
     * </p>
     * <p>
     * Applicable only when the value of Video:Codec is H.264. The maximum
     * number of previously decoded frames to use as a reference for decoding
     * future frames. Valid values are integers 0 through 16, but we recommend
     * that you not use a value greater than the following:
     * </p>
     * <p>
     * <code>Min(Floor(Maximum decoded picture buffer in macroblocks * 256 / (Width in pixels * Height in pixels)), 16)</code>
     * </p>
     * <p>
     * where <i>Width in pixels</i> and <i>Height in pixels</i> represent either
     * MaxWidth and MaxHeight, or Resolution. <i>Maximum decoded picture buffer
     * in macroblocks</i> depends on the value of the <code>Level</code> object.
     * See the list below. (A macroblock is a block of pixels measuring 16x16.)
     * </p>
     * <ul>
     * <li>1 - 396</li>
     * <li>1b - 396</li>
     * <li>1.1 - 900</li>
     * <li>1.2 - 2376</li>
     * <li>1.3 - 2376</li>
     * <li>2 - 2376</li>
     * <li>2.1 - 4752</li>
     * <li>2.2 - 8100</li>
     * <li>3 - 8100</li>
     * <li>3.1 - 18000</li>
     * <li>3.2 - 20480</li>
     * <li>4 - 32768</li>
     * <li>4.1 - 32768</li>
     * </ul>
     * <p>
     * <b>MaxBitRate (Optional, H.264/MPEG2/VP8 only)</b>
     * </p>
     * <p>
     * The maximum number of bits per second in a video buffer; the size of the
     * buffer is specified by <code>BufferSize</code>. Specify a value between
     * 16 and 62,500. You can reduce the bandwidth required to stream a video by
     * reducing the maximum bit rate, but this also reduces the quality of the
     * video.
     * </p>
     * <p>
     * <b>BufferSize (Optional, H.264/MPEG2/VP8 only)</b>
     * </p>
     * <p>
     * The maximum number of bits in any x seconds of the output video. This
     * window is commonly 10 seconds, the standard segment duration when you're
     * using FMP4 or MPEG-TS for the container type of the output video. Specify
     * an integer greater than 0. If you specify <code>MaxBitRate</code> and
     * omit <code>BufferSize</code>, Elastic Transcoder sets
     * <code>BufferSize</code> to 10 times the value of <code>MaxBitRate</code>.
     * </p>
     * <p>
     * <b>InterlacedMode (Optional, H.264/MPEG2 Only)</b>
     * </p>
     * <p>
     * The interlace mode for the output video.
     * </p>
     * <p>
     * Interlaced video is used to double the perceived frame rate for a video
     * by interlacing two fields (one field on every other line, the other field
     * on the other lines) so that the human eye registers multiple pictures per
     * frame. Interlacing reduces the bandwidth required for transmitting a
     * video, but can result in blurred images and flickering.
     * </p>
     * <p>
     * Valid values include <code>Progressive</code> (no interlacing, top to
     * bottom), <code>TopFirst</code> (top field first),
     * <code>BottomFirst</code> (bottom field first), and <code>Auto</code>.
     * </p>
     * <p>
     * If <code>InterlaceMode</code> is not specified, Elastic Transcoder uses
     * <code>Progressive</code> for the output. If <code>Auto</code> is
     * specified, Elastic Transcoder interlaces the output.
     * </p>
     * <p>
     * <b>ColorSpaceConversionMode (Optional, H.264/MPEG2 Only)</b>
     * </p>
     * <p>
     * The color space conversion Elastic Transcoder applies to the output
     * video. Color spaces are the algorithms used by the computer to store
     * information about how to render color. <code>Bt.601</code> is the
     * standard for standard definition video, while <code>Bt.709</code> is the
     * standard for high definition video.
     * </p>
     * <p>
     * Valid values include <code>None</code>, <code>Bt709toBt601</code>,
     * <code>Bt601toBt709</code>, and <code>Auto</code>.
     * </p>
     * <p>
     * If you chose <code>Auto</code> for <code>ColorSpaceConversionMode</code>
     * and your output is interlaced, your frame rate is one of
     * <code>23.97</code>, <code>24</code>, <code>25</code>, <code>29.97</code>,
     * <code>50</code>, or <code>60</code>, your <code>SegmentDuration</code> is
     * null, and you are using one of the resolution changes from the list
     * below, Elastic Transcoder applies the following color space conversions:
     * </p>
     * <ul>
     * <li><i>Standard to HD, 720x480 to 1920x1080</i> - Elastic Transcoder
     * applies <code>Bt601ToBt709</code></li>
     * <li><i>Standard to HD, 720x576 to 1920x1080</i> - Elastic Transcoder
     * applies <code>Bt601ToBt709</code></li>
     * <li><i>HD to Standard, 1920x1080 to 720x480</i> - Elastic Transcoder
     * applies <code>Bt709ToBt601</code></li>
     * <li><i>HD to Standard, 1920x1080 to 720x576</i> - Elastic Transcoder
     * applies <code>Bt709ToBt601</code></li>
     * </ul>
     * <note>Elastic Transcoder may change the behavior of the
     * <code>ColorspaceConversionMode</code> <code>Auto</code> mode in the
     * future. All outputs in a playlist must use the same
     * <code>ColorSpaceConversionMode</code>.</note>
     * <p>
     * If you do not specify a <code>ColorSpaceConversionMode</code>, Elastic
     * Transcoder does not change the color space of a file. If you are unsure
     * what <code>ColorSpaceConversionMode</code> was applied to your output
     * file, you can check the <code>AppliedColorSpaceConversion</code>
     * parameter included in your job response. If your job does not have an
     * <code>AppliedColorSpaceConversion</code> in its response, no
     * <code>ColorSpaceConversionMode</code> was applied.
     * </p>
     * <p>
     * <b>ChromaSubsampling</b>
     * </p>
     * <p>
     * The sampling pattern for the chroma (color) channels of the output video.
     * Valid values include <code>yuv420p</code> and <code>yuv422p</code>.
     * </p>
     * <p>
     * <code>yuv420p</code> samples the chroma information of every other
     * horizontal and every other vertical line, <code>yuv422p</code> samples
     * the color information of every horizontal line and every other vertical
     * line.
     * </p>
     * <p>
     * <b>LoopCount (Gif Only)</b>
     * </p>
     * <p>
     * The number of times you want the output gif to loop. Valid values include
     * <code>Infinite</code> and integers between <code>0</code> and
     * <code>100</code>, inclusive.
     * </p>
     * 
     * @return <b>Profile (H.264/VP8 Only)</b> </p>
     *         <p>
     *         The H.264 profile that you want to use for the output file.
     *         Elastic Transcoder supports the following profiles:
     *         </p>
     *         <ul>
     *         <li><code>baseline</code>: The profile most commonly used for
     *         videoconferencing and for mobile applications.</li>
     *         <li><code>main</code>: The profile used for standard-definition
     *         digital TV broadcasts.</li>
     *         <li><code>high</code>: The profile used for high-definition
     *         digital TV broadcasts and for Blu-ray discs.</li>
     *         </ul>
     *         <p>
     *         <b>Level (H.264 Only)</b>
     *         </p>
     *         <p>
     *         The H.264 level that you want to use for the output file. Elastic
     *         Transcoder supports the following levels:
     *         </p>
     *         <p>
     *         <code>1</code>, <code>1b</code>, <code>1.1</code>,
     *         <code>1.2</code>, <code>1.3</code>, <code>2</code>,
     *         <code>2.1</code>, <code>2.2</code>, <code>3</code>,
     *         <code>3.1</code>, <code>3.2</code>, <code>4</code>,
     *         <code>4.1</code>
     *         </p>
     *         <p>
     *         <b>MaxReferenceFrames (H.264 Only)</b>
     *         </p>
     *         <p>
     *         Applicable only when the value of Video:Codec is H.264. The
     *         maximum number of previously decoded frames to use as a reference
     *         for decoding future frames. Valid values are integers 0 through
     *         16, but we recommend that you not use a value greater than the
     *         following:
     *         </p>
     *         <p>
     *         <code>Min(Floor(Maximum decoded picture buffer in macroblocks * 256 / (Width in pixels * Height in pixels)), 16)</code>
     *         </p>
     *         <p>
     *         where <i>Width in pixels</i> and <i>Height in pixels</i>
     *         represent either MaxWidth and MaxHeight, or Resolution.
     *         <i>Maximum decoded picture buffer in macroblocks</i> depends on
     *         the value of the <code>Level</code> object. See the list below.
     *         (A macroblock is a block of pixels measuring 16x16.)
     *         </p>
     *         <ul>
     *         <li>1 - 396</li>
     *         <li>1b - 396</li>
     *         <li>1.1 - 900</li>
     *         <li>1.2 - 2376</li>
     *         <li>1.3 - 2376</li>
     *         <li>2 - 2376</li>
     *         <li>2.1 - 4752</li>
     *         <li>2.2 - 8100</li>
     *         <li>3 - 8100</li>
     *         <li>3.1 - 18000</li>
     *         <li>3.2 - 20480</li>
     *         <li>4 - 32768</li>
     *         <li>4.1 - 32768</li>
     *         </ul>
     *         <p>
     *         <b>MaxBitRate (Optional, H.264/MPEG2/VP8 only)</b>
     *         </p>
     *         <p>
     *         The maximum number of bits per second in a video buffer; the size
     *         of the buffer is specified by <code>BufferSize</code>. Specify a
     *         value between 16 and 62,500. You can reduce the bandwidth
     *         required to stream a video by reducing the maximum bit rate, but
     *         this also reduces the quality of the video.
     *         </p>
     *         <p>
     *         <b>BufferSize (Optional, H.264/MPEG2/VP8 only)</b>
     *         </p>
     *         <p>
     *         The maximum number of bits in any x seconds of the output video.
     *         This window is commonly 10 seconds, the standard segment duration
     *         when you're using FMP4 or MPEG-TS for the container type of the
     *         output video. Specify an integer greater than 0. If you specify
     *         <code>MaxBitRate</code> and omit <code>BufferSize</code>, Elastic
     *         Transcoder sets <code>BufferSize</code> to 10 times the value of
     *         <code>MaxBitRate</code>.
     *         </p>
     *         <p>
     *         <b>InterlacedMode (Optional, H.264/MPEG2 Only)</b>
     *         </p>
     *         <p>
     *         The interlace mode for the output video.
     *         </p>
     *         <p>
     *         Interlaced video is used to double the perceived frame rate for a
     *         video by interlacing two fields (one field on every other line,
     *         the other field on the other lines) so that the human eye
     *         registers multiple pictures per frame. Interlacing reduces the
     *         bandwidth required for transmitting a video, but can result in
     *         blurred images and flickering.
     *         </p>
     *         <p>
     *         Valid values include <code>Progressive</code> (no interlacing,
     *         top to bottom), <code>TopFirst</code> (top field first),
     *         <code>BottomFirst</code> (bottom field first), and
     *         <code>Auto</code>.
     *         </p>
     *         <p>
     *         If <code>InterlaceMode</code> is not specified, Elastic
     *         Transcoder uses <code>Progressive</code> for the output. If
     *         <code>Auto</code> is specified, Elastic Transcoder interlaces the
     *         output.
     *         </p>
     *         <p>
     *         <b>ColorSpaceConversionMode (Optional, H.264/MPEG2 Only)</b>
     *         </p>
     *         <p>
     *         The color space conversion Elastic Transcoder applies to the
     *         output video. Color spaces are the algorithms used by the
     *         computer to store information about how to render color.
     *         <code>Bt.601</code> is the standard for standard definition
     *         video, while <code>Bt.709</code> is the standard for high
     *         definition video.
     *         </p>
     *         <p>
     *         Valid values include <code>None</code>, <code>Bt709toBt601</code>, <code>Bt601toBt709</code>, and <code>Auto</code>.
     *         </p>
     *         <p>
     *         If you chose <code>Auto</code> for
     *         <code>ColorSpaceConversionMode</code> and your output is
     *         interlaced, your frame rate is one of <code>23.97</code>,
     *         <code>24</code>, <code>25</code>, <code>29.97</code>,
     *         <code>50</code>, or <code>60</code>, your
     *         <code>SegmentDuration</code> is null, and you are using one of
     *         the resolution changes from the list below, Elastic Transcoder
     *         applies the following color space conversions:
     *         </p>
     *         <ul>
     *         <li><i>Standard to HD, 720x480 to 1920x1080</i> - Elastic
     *         Transcoder applies <code>Bt601ToBt709</code></li>
     *         <li><i>Standard to HD, 720x576 to 1920x1080</i> - Elastic
     *         Transcoder applies <code>Bt601ToBt709</code></li>
     *         <li><i>HD to Standard, 1920x1080 to 720x480</i> - Elastic
     *         Transcoder applies <code>Bt709ToBt601</code></li>
     *         <li><i>HD to Standard, 1920x1080 to 720x576</i> - Elastic
     *         Transcoder applies <code>Bt709ToBt601</code></li>
     *         </ul>
     *         <note>Elastic Transcoder may change the behavior of the
     *         <code>ColorspaceConversionMode</code> <code>Auto</code> mode in
     *         the future. All outputs in a playlist must use the same
     *         <code>ColorSpaceConversionMode</code>.</note>
     *         <p>
     *         If you do not specify a <code>ColorSpaceConversionMode</code>,
     *         Elastic Transcoder does not change the color space of a file. If
     *         you are unsure what <code>ColorSpaceConversionMode</code> was
     *         applied to your output file, you can check the
     *         <code>AppliedColorSpaceConversion</code> parameter included in
     *         your job response. If your job does not have an
     *         <code>AppliedColorSpaceConversion</code> in its response, no
     *         <code>ColorSpaceConversionMode</code> was applied.
     *         </p>
     *         <p>
     *         <b>ChromaSubsampling</b>
     *         </p>
     *         <p>
     *         The sampling pattern for the chroma (color) channels of the
     *         output video. Valid values include <code>yuv420p</code> and
     *         <code>yuv422p</code>.
     *         </p>
     *         <p>
     *         <code>yuv420p</code> samples the chroma information of every
     *         other horizontal and every other vertical line,
     *         <code>yuv422p</code> samples the color information of every
     *         horizontal line and every other vertical line.
     *         </p>
     *         <p>
     *         <b>LoopCount (Gif Only)</b>
     *         </p>
     *         <p>
     *         The number of times you want the output gif to loop. Valid values
     *         include <code>Infinite</code> and integers between <code>0</code>
     *         and <code>100</code>, inclusive.
     */

    public java.util.Map<String, String> getCodecOptions() {
        if (codecOptions == null) {
            codecOptions = new com.amazonaws.internal.SdkInternalMap<String, String>();
        }
        return codecOptions;
    }

    /**
     * <p>
     * <b>Profile (H.264/VP8 Only)</b>
     * </p>
     * <p>
     * The H.264 profile that you want to use for the output file. Elastic
     * Transcoder supports the following profiles:
     * </p>
     * <ul>
     * <li><code>baseline</code>: The profile most commonly used for
     * videoconferencing and for mobile applications.</li>
     * <li><code>main</code>: The profile used for standard-definition digital
     * TV broadcasts.</li>
     * <li><code>high</code>: The profile used for high-definition digital TV
     * broadcasts and for Blu-ray discs.</li>
     * </ul>
     * <p>
     * <b>Level (H.264 Only)</b>
     * </p>
     * <p>
     * The H.264 level that you want to use for the output file. Elastic
     * Transcoder supports the following levels:
     * </p>
     * <p>
     * <code>1</code>, <code>1b</code>, <code>1.1</code>, <code>1.2</code>,
     * <code>1.3</code>, <code>2</code>, <code>2.1</code>, <code>2.2</code>,
     * <code>3</code>, <code>3.1</code>, <code>3.2</code>, <code>4</code>,
     * <code>4.1</code>
     * </p>
     * <p>
     * <b>MaxReferenceFrames (H.264 Only)</b>
     * </p>
     * <p>
     * Applicable only when the value of Video:Codec is H.264. The maximum
     * number of previously decoded frames to use as a reference for decoding
     * future frames. Valid values are integers 0 through 16, but we recommend
     * that you not use a value greater than the following:
     * </p>
     * <p>
     * <code>Min(Floor(Maximum decoded picture buffer in macroblocks * 256 / (Width in pixels * Height in pixels)), 16)</code>
     * </p>
     * <p>
     * where <i>Width in pixels</i> and <i>Height in pixels</i> represent either
     * MaxWidth and MaxHeight, or Resolution. <i>Maximum decoded picture buffer
     * in macroblocks</i> depends on the value of the <code>Level</code> object.
     * See the list below. (A macroblock is a block of pixels measuring 16x16.)
     * </p>
     * <ul>
     * <li>1 - 396</li>
     * <li>1b - 396</li>
     * <li>1.1 - 900</li>
     * <li>1.2 - 2376</li>
     * <li>1.3 - 2376</li>
     * <li>2 - 2376</li>
     * <li>2.1 - 4752</li>
     * <li>2.2 - 8100</li>
     * <li>3 - 8100</li>
     * <li>3.1 - 18000</li>
     * <li>3.2 - 20480</li>
     * <li>4 - 32768</li>
     * <li>4.1 - 32768</li>
     * </ul>
     * <p>
     * <b>MaxBitRate (Optional, H.264/MPEG2/VP8 only)</b>
     * </p>
     * <p>
     * The maximum number of bits per second in a video buffer; the size of the
     * buffer is specified by <code>BufferSize</code>. Specify a value between
     * 16 and 62,500. You can reduce the bandwidth required to stream a video by
     * reducing the maximum bit rate, but this also reduces the quality of the
     * video.
     * </p>
     * <p>
     * <b>BufferSize (Optional, H.264/MPEG2/VP8 only)</b>
     * </p>
     * <p>
     * The maximum number of bits in any x seconds of the output video. This
     * window is commonly 10 seconds, the standard segment duration when you're
     * using FMP4 or MPEG-TS for the container type of the output video. Specify
     * an integer greater than 0. If you specify <code>MaxBitRate</code> and
     * omit <code>BufferSize</code>, Elastic Transcoder sets
     * <code>BufferSize</code> to 10 times the value of <code>MaxBitRate</code>.
     * </p>
     * <p>
     * <b>InterlacedMode (Optional, H.264/MPEG2 Only)</b>
     * </p>
     * <p>
     * The interlace mode for the output video.
     * </p>
     * <p>
     * Interlaced video is used to double the perceived frame rate for a video
     * by interlacing two fields (one field on every other line, the other field
     * on the other lines) so that the human eye registers multiple pictures per
     * frame. Interlacing reduces the bandwidth required for transmitting a
     * video, but can result in blurred images and flickering.
     * </p>
     * <p>
     * Valid values include <code>Progressive</code> (no interlacing, top to
     * bottom), <code>TopFirst</code> (top field first),
     * <code>BottomFirst</code> (bottom field first), and <code>Auto</code>.
     * </p>
     * <p>
     * If <code>InterlaceMode</code> is not specified, Elastic Transcoder uses
     * <code>Progressive</code> for the output. If <code>Auto</code> is
     * specified, Elastic Transcoder interlaces the output.
     * </p>
     * <p>
     * <b>ColorSpaceConversionMode (Optional, H.264/MPEG2 Only)</b>
     * </p>
     * <p>
     * The color space conversion Elastic Transcoder applies to the output
     * video. Color spaces are the algorithms used by the computer to store
     * information about how to render color. <code>Bt.601</code> is the
     * standard for standard definition video, while <code>Bt.709</code> is the
     * standard for high definition video.
     * </p>
     * <p>
     * Valid values include <code>None</code>, <code>Bt709toBt601</code>,
     * <code>Bt601toBt709</code>, and <code>Auto</code>.
     * </p>
     * <p>
     * If you chose <code>Auto</code> for <code>ColorSpaceConversionMode</code>
     * and your output is interlaced, your frame rate is one of
     * <code>23.97</code>, <code>24</code>, <code>25</code>, <code>29.97</code>,
     * <code>50</code>, or <code>60</code>, your <code>SegmentDuration</code> is
     * null, and you are using one of the resolution changes from the list
     * below, Elastic Transcoder applies the following color space conversions:
     * </p>
     * <ul>
     * <li><i>Standard to HD, 720x480 to 1920x1080</i> - Elastic Transcoder
     * applies <code>Bt601ToBt709</code></li>
     * <li><i>Standard to HD, 720x576 to 1920x1080</i> - Elastic Transcoder
     * applies <code>Bt601ToBt709</code></li>
     * <li><i>HD to Standard, 1920x1080 to 720x480</i> - Elastic Transcoder
     * applies <code>Bt709ToBt601</code></li>
     * <li><i>HD to Standard, 1920x1080 to 720x576</i> - Elastic Transcoder
     * applies <code>Bt709ToBt601</code></li>
     * </ul>
     * <note>Elastic Transcoder may change the behavior of the
     * <code>ColorspaceConversionMode</code> <code>Auto</code> mode in the
     * future. All outputs in a playlist must use the same
     * <code>ColorSpaceConversionMode</code>.</note>
     * <p>
     * If you do not specify a <code>ColorSpaceConversionMode</code>, Elastic
     * Transcoder does not change the color space of a file. If you are unsure
     * what <code>ColorSpaceConversionMode</code> was applied to your output
     * file, you can check the <code>AppliedColorSpaceConversion</code>
     * parameter included in your job response. If your job does not have an
     * <code>AppliedColorSpaceConversion</code> in its response, no
     * <code>ColorSpaceConversionMode</code> was applied.
     * </p>
     * <p>
     * <b>ChromaSubsampling</b>
     * </p>
     * <p>
     * The sampling pattern for the chroma (color) channels of the output video.
     * Valid values include <code>yuv420p</code> and <code>yuv422p</code>.
     * </p>
     * <p>
     * <code>yuv420p</code> samples the chroma information of every other
     * horizontal and every other vertical line, <code>yuv422p</code> samples
     * the color information of every horizontal line and every other vertical
     * line.
     * </p>
     * <p>
     * <b>LoopCount (Gif Only)</b>
     * </p>
     * <p>
     * The number of times you want the output gif to loop. Valid values include
     * <code>Infinite</code> and integers between <code>0</code> and
     * <code>100</code>, inclusive.
     * </p>
     * 
     * @param codecOptions
     *        <b>Profile (H.264/VP8 Only)</b> </p>
     *        <p>
     *        The H.264 profile that you want to use for the output file.
     *        Elastic Transcoder supports the following profiles:
     *        </p>
     *        <ul>
     *        <li><code>baseline</code>: The profile most commonly used for
     *        videoconferencing and for mobile applications.</li>
     *        <li><code>main</code>: The profile used for standard-definition
     *        digital TV broadcasts.</li>
     *        <li><code>high</code>: The profile used for high-definition
     *        digital TV broadcasts and for Blu-ray discs.</li>
     *        </ul>
     *        <p>
     *        <b>Level (H.264 Only)</b>
     *        </p>
     *        <p>
     *        The H.264 level that you want to use for the output file. Elastic
     *        Transcoder supports the following levels:
     *        </p>
     *        <p>
     *        <code>1</code>, <code>1b</code>, <code>1.1</code>,
     *        <code>1.2</code>, <code>1.3</code>, <code>2</code>,
     *        <code>2.1</code>, <code>2.2</code>, <code>3</code>,
     *        <code>3.1</code>, <code>3.2</code>, <code>4</code>,
     *        <code>4.1</code>
     *        </p>
     *        <p>
     *        <b>MaxReferenceFrames (H.264 Only)</b>
     *        </p>
     *        <p>
     *        Applicable only when the value of Video:Codec is H.264. The
     *        maximum number of previously decoded frames to use as a reference
     *        for decoding future frames. Valid values are integers 0 through
     *        16, but we recommend that you not use a value greater than the
     *        following:
     *        </p>
     *        <p>
     *        <code>Min(Floor(Maximum decoded picture buffer in macroblocks * 256 / (Width in pixels * Height in pixels)), 16)</code>
     *        </p>
     *        <p>
     *        where <i>Width in pixels</i> and <i>Height in pixels</i> represent
     *        either MaxWidth and MaxHeight, or Resolution. <i>Maximum decoded
     *        picture buffer in macroblocks</i> depends on the value of the
     *        <code>Level</code> object. See the list below. (A macroblock is a
     *        block of pixels measuring 16x16.)
     *        </p>
     *        <ul>
     *        <li>1 - 396</li>
     *        <li>1b - 396</li>
     *        <li>1.1 - 900</li>
     *        <li>1.2 - 2376</li>
     *        <li>1.3 - 2376</li>
     *        <li>2 - 2376</li>
     *        <li>2.1 - 4752</li>
     *        <li>2.2 - 8100</li>
     *        <li>3 - 8100</li>
     *        <li>3.1 - 18000</li>
     *        <li>3.2 - 20480</li>
     *        <li>4 - 32768</li>
     *        <li>4.1 - 32768</li>
     *        </ul>
     *        <p>
     *        <b>MaxBitRate (Optional, H.264/MPEG2/VP8 only)</b>
     *        </p>
     *        <p>
     *        The maximum number of bits per second in a video buffer; the size
     *        of the buffer is specified by <code>BufferSize</code>. Specify a
     *        value between 16 and 62,500. You can reduce the bandwidth required
     *        to stream a video by reducing the maximum bit rate, but this also
     *        reduces the quality of the video.
     *        </p>
     *        <p>
     *        <b>BufferSize (Optional, H.264/MPEG2/VP8 only)</b>
     *        </p>
     *        <p>
     *        The maximum number of bits in any x seconds of the output video.
     *        This window is commonly 10 seconds, the standard segment duration
     *        when you're using FMP4 or MPEG-TS for the container type of the
     *        output video. Specify an integer greater than 0. If you specify
     *        <code>MaxBitRate</code> and omit <code>BufferSize</code>, Elastic
     *        Transcoder sets <code>BufferSize</code> to 10 times the value of
     *        <code>MaxBitRate</code>.
     *        </p>
     *        <p>
     *        <b>InterlacedMode (Optional, H.264/MPEG2 Only)</b>
     *        </p>
     *        <p>
     *        The interlace mode for the output video.
     *        </p>
     *        <p>
     *        Interlaced video is used to double the perceived frame rate for a
     *        video by interlacing two fields (one field on every other line,
     *        the other field on the other lines) so that the human eye
     *        registers multiple pictures per frame. Interlacing reduces the
     *        bandwidth required for transmitting a video, but can result in
     *        blurred images and flickering.
     *        </p>
     *        <p>
     *        Valid values include <code>Progressive</code> (no interlacing, top
     *        to bottom), <code>TopFirst</code> (top field first),
     *        <code>BottomFirst</code> (bottom field first), and
     *        <code>Auto</code>.
     *        </p>
     *        <p>
     *        If <code>InterlaceMode</code> is not specified, Elastic Transcoder
     *        uses <code>Progressive</code> for the output. If <code>Auto</code>
     *        is specified, Elastic Transcoder interlaces the output.
     *        </p>
     *        <p>
     *        <b>ColorSpaceConversionMode (Optional, H.264/MPEG2 Only)</b>
     *        </p>
     *        <p>
     *        The color space conversion Elastic Transcoder applies to the
     *        output video. Color spaces are the algorithms used by the computer
     *        to store information about how to render color.
     *        <code>Bt.601</code> is the standard for standard definition video,
     *        while <code>Bt.709</code> is the standard for high definition
     *        video.
     *        </p>
     *        <p>
     *        Valid values include <code>None</code>, <code>Bt709toBt601</code>,
     *        <code>Bt601toBt709</code>, and <code>Auto</code>.
     *        </p>
     *        <p>
     *        If you chose <code>Auto</code> for
     *        <code>ColorSpaceConversionMode</code> and your output is
     *        interlaced, your frame rate is one of <code>23.97</code>,
     *        <code>24</code>, <code>25</code>, <code>29.97</code>,
     *        <code>50</code>, or <code>60</code>, your
     *        <code>SegmentDuration</code> is null, and you are using one of the
     *        resolution changes from the list below, Elastic Transcoder applies
     *        the following color space conversions:
     *        </p>
     *        <ul>
     *        <li><i>Standard to HD, 720x480 to 1920x1080</i> - Elastic
     *        Transcoder applies <code>Bt601ToBt709</code></li>
     *        <li><i>Standard to HD, 720x576 to 1920x1080</i> - Elastic
     *        Transcoder applies <code>Bt601ToBt709</code></li>
     *        <li><i>HD to Standard, 1920x1080 to 720x480</i> - Elastic
     *        Transcoder applies <code>Bt709ToBt601</code></li>
     *        <li><i>HD to Standard, 1920x1080 to 720x576</i> - Elastic
     *        Transcoder applies <code>Bt709ToBt601</code></li>
     *        </ul>
     *        <note>Elastic Transcoder may change the behavior of the
     *        <code>ColorspaceConversionMode</code> <code>Auto</code> mode in
     *        the future. All outputs in a playlist must use the same
     *        <code>ColorSpaceConversionMode</code>.</note>
     *        <p>
     *        If you do not specify a <code>ColorSpaceConversionMode</code>,
     *        Elastic Transcoder does not change the color space of a file. If
     *        you are unsure what <code>ColorSpaceConversionMode</code> was
     *        applied to your output file, you can check the
     *        <code>AppliedColorSpaceConversion</code> parameter included in
     *        your job response. If your job does not have an
     *        <code>AppliedColorSpaceConversion</code> in its response, no
     *        <code>ColorSpaceConversionMode</code> was applied.
     *        </p>
     *        <p>
     *        <b>ChromaSubsampling</b>
     *        </p>
     *        <p>
     *        The sampling pattern for the chroma (color) channels of the output
     *        video. Valid values include <code>yuv420p</code> and
     *        <code>yuv422p</code>.
     *        </p>
     *        <p>
     *        <code>yuv420p</code> samples the chroma information of every other
     *        horizontal and every other vertical line, <code>yuv422p</code>
     *        samples the color information of every horizontal line and every
     *        other vertical line.
     *        </p>
     *        <p>
     *        <b>LoopCount (Gif Only)</b>
     *        </p>
     *        <p>
     *        The number of times you want the output gif to loop. Valid values
     *        include <code>Infinite</code> and integers between <code>0</code>
     *        and <code>100</code>, inclusive.
     */

    public void setCodecOptions(java.util.Map<String, String> codecOptions) {
        this.codecOptions = codecOptions == null ? null
                : new com.amazonaws.internal.SdkInternalMap<String, String>(
                        codecOptions);
    }

    /**
     * <p>
     * <b>Profile (H.264/VP8 Only)</b>
     * </p>
     * <p>
     * The H.264 profile that you want to use for the output file. Elastic
     * Transcoder supports the following profiles:
     * </p>
     * <ul>
     * <li><code>baseline</code>: The profile most commonly used for
     * videoconferencing and for mobile applications.</li>
     * <li><code>main</code>: The profile used for standard-definition digital
     * TV broadcasts.</li>
     * <li><code>high</code>: The profile used for high-definition digital TV
     * broadcasts and for Blu-ray discs.</li>
     * </ul>
     * <p>
     * <b>Level (H.264 Only)</b>
     * </p>
     * <p>
     * The H.264 level that you want to use for the output file. Elastic
     * Transcoder supports the following levels:
     * </p>
     * <p>
     * <code>1</code>, <code>1b</code>, <code>1.1</code>, <code>1.2</code>,
     * <code>1.3</code>, <code>2</code>, <code>2.1</code>, <code>2.2</code>,
     * <code>3</code>, <code>3.1</code>, <code>3.2</code>, <code>4</code>,
     * <code>4.1</code>
     * </p>
     * <p>
     * <b>MaxReferenceFrames (H.264 Only)</b>
     * </p>
     * <p>
     * Applicable only when the value of Video:Codec is H.264. The maximum
     * number of previously decoded frames to use as a reference for decoding
     * future frames. Valid values are integers 0 through 16, but we recommend
     * that you not use a value greater than the following:
     * </p>
     * <p>
     * <code>Min(Floor(Maximum decoded picture buffer in macroblocks * 256 / (Width in pixels * Height in pixels)), 16)</code>
     * </p>
     * <p>
     * where <i>Width in pixels</i> and <i>Height in pixels</i> represent either
     * MaxWidth and MaxHeight, or Resolution. <i>Maximum decoded picture buffer
     * in macroblocks</i> depends on the value of the <code>Level</code> object.
     * See the list below. (A macroblock is a block of pixels measuring 16x16.)
     * </p>
     * <ul>
     * <li>1 - 396</li>
     * <li>1b - 396</li>
     * <li>1.1 - 900</li>
     * <li>1.2 - 2376</li>
     * <li>1.3 - 2376</li>
     * <li>2 - 2376</li>
     * <li>2.1 - 4752</li>
     * <li>2.2 - 8100</li>
     * <li>3 - 8100</li>
     * <li>3.1 - 18000</li>
     * <li>3.2 - 20480</li>
     * <li>4 - 32768</li>
     * <li>4.1 - 32768</li>
     * </ul>
     * <p>
     * <b>MaxBitRate (Optional, H.264/MPEG2/VP8 only)</b>
     * </p>
     * <p>
     * The maximum number of bits per second in a video buffer; the size of the
     * buffer is specified by <code>BufferSize</code>. Specify a value between
     * 16 and 62,500. You can reduce the bandwidth required to stream a video by
     * reducing the maximum bit rate, but this also reduces the quality of the
     * video.
     * </p>
     * <p>
     * <b>BufferSize (Optional, H.264/MPEG2/VP8 only)</b>
     * </p>
     * <p>
     * The maximum number of bits in any x seconds of the output video. This
     * window is commonly 10 seconds, the standard segment duration when you're
     * using FMP4 or MPEG-TS for the container type of the output video. Specify
     * an integer greater than 0. If you specify <code>MaxBitRate</code> and
     * omit <code>BufferSize</code>, Elastic Transcoder sets
     * <code>BufferSize</code> to 10 times the value of <code>MaxBitRate</code>.
     * </p>
     * <p>
     * <b>InterlacedMode (Optional, H.264/MPEG2 Only)</b>
     * </p>
     * <p>
     * The interlace mode for the output video.
     * </p>
     * <p>
     * Interlaced video is used to double the perceived frame rate for a video
     * by interlacing two fields (one field on every other line, the other field
     * on the other lines) so that the human eye registers multiple pictures per
     * frame. Interlacing reduces the bandwidth required for transmitting a
     * video, but can result in blurred images and flickering.
     * </p>
     * <p>
     * Valid values include <code>Progressive</code> (no interlacing, top to
     * bottom), <code>TopFirst</code> (top field first),
     * <code>BottomFirst</code> (bottom field first), and <code>Auto</code>.
     * </p>
     * <p>
     * If <code>InterlaceMode</code> is not specified, Elastic Transcoder uses
     * <code>Progressive</code> for the output. If <code>Auto</code> is
     * specified, Elastic Transcoder interlaces the output.
     * </p>
     * <p>
     * <b>ColorSpaceConversionMode (Optional, H.264/MPEG2 Only)</b>
     * </p>
     * <p>
     * The color space conversion Elastic Transcoder applies to the output
     * video. Color spaces are the algorithms used by the computer to store
     * information about how to render color. <code>Bt.601</code> is the
     * standard for standard definition video, while <code>Bt.709</code> is the
     * standard for high definition video.
     * </p>
     * <p>
     * Valid values include <code>None</code>, <code>Bt709toBt601</code>,
     * <code>Bt601toBt709</code>, and <code>Auto</code>.
     * </p>
     * <p>
     * If you chose <code>Auto</code> for <code>ColorSpaceConversionMode</code>
     * and your output is interlaced, your frame rate is one of
     * <code>23.97</code>, <code>24</code>, <code>25</code>, <code>29.97</code>,
     * <code>50</code>, or <code>60</code>, your <code>SegmentDuration</code> is
     * null, and you are using one of the resolution changes from the list
     * below, Elastic Transcoder applies the following color space conversions:
     * </p>
     * <ul>
     * <li><i>Standard to HD, 720x480 to 1920x1080</i> - Elastic Transcoder
     * applies <code>Bt601ToBt709</code></li>
     * <li><i>Standard to HD, 720x576 to 1920x1080</i> - Elastic Transcoder
     * applies <code>Bt601ToBt709</code></li>
     * <li><i>HD to Standard, 1920x1080 to 720x480</i> - Elastic Transcoder
     * applies <code>Bt709ToBt601</code></li>
     * <li><i>HD to Standard, 1920x1080 to 720x576</i> - Elastic Transcoder
     * applies <code>Bt709ToBt601</code></li>
     * </ul>
     * <note>Elastic Transcoder may change the behavior of the
     * <code>ColorspaceConversionMode</code> <code>Auto</code> mode in the
     * future. All outputs in a playlist must use the same
     * <code>ColorSpaceConversionMode</code>.</note>
     * <p>
     * If you do not specify a <code>ColorSpaceConversionMode</code>, Elastic
     * Transcoder does not change the color space of a file. If you are unsure
     * what <code>ColorSpaceConversionMode</code> was applied to your output
     * file, you can check the <code>AppliedColorSpaceConversion</code>
     * parameter included in your job response. If your job does not have an
     * <code>AppliedColorSpaceConversion</code> in its response, no
     * <code>ColorSpaceConversionMode</code> was applied.
     * </p>
     * <p>
     * <b>ChromaSubsampling</b>
     * </p>
     * <p>
     * The sampling pattern for the chroma (color) channels of the output video.
     * Valid values include <code>yuv420p</code> and <code>yuv422p</code>.
     * </p>
     * <p>
     * <code>yuv420p</code> samples the chroma information of every other
     * horizontal and every other vertical line, <code>yuv422p</code> samples
     * the color information of every horizontal line and every other vertical
     * line.
     * </p>
     * <p>
     * <b>LoopCount (Gif Only)</b>
     * </p>
     * <p>
     * The number of times you want the output gif to loop. Valid values include
     * <code>Infinite</code> and integers between <code>0</code> and
     * <code>100</code>, inclusive.
     * </p>
     * 
     * @param codecOptions
     *        <b>Profile (H.264/VP8 Only)</b> </p>
     *        <p>
     *        The H.264 profile that you want to use for the output file.
     *        Elastic Transcoder supports the following profiles:
     *        </p>
     *        <ul>
     *        <li><code>baseline</code>: The profile most commonly used for
     *        videoconferencing and for mobile applications.</li>
     *        <li><code>main</code>: The profile used for standard-definition
     *        digital TV broadcasts.</li>
     *        <li><code>high</code>: The profile used for high-definition
     *        digital TV broadcasts and for Blu-ray discs.</li>
     *        </ul>
     *        <p>
     *        <b>Level (H.264 Only)</b>
     *        </p>
     *        <p>
     *        The H.264 level that you want to use for the output file. Elastic
     *        Transcoder supports the following levels:
     *        </p>
     *        <p>
     *        <code>1</code>, <code>1b</code>, <code>1.1</code>,
     *        <code>1.2</code>, <code>1.3</code>, <code>2</code>,
     *        <code>2.1</code>, <code>2.2</code>, <code>3</code>,
     *        <code>3.1</code>, <code>3.2</code>, <code>4</code>,
     *        <code>4.1</code>
     *        </p>
     *        <p>
     *        <b>MaxReferenceFrames (H.264 Only)</b>
     *        </p>
     *        <p>
     *        Applicable only when the value of Video:Codec is H.264. The
     *        maximum number of previously decoded frames to use as a reference
     *        for decoding future frames. Valid values are integers 0 through
     *        16, but we recommend that you not use a value greater than the
     *        following:
     *        </p>
     *        <p>
     *        <code>Min(Floor(Maximum decoded picture buffer in macroblocks * 256 / (Width in pixels * Height in pixels)), 16)</code>
     *        </p>
     *        <p>
     *        where <i>Width in pixels</i> and <i>Height in pixels</i> represent
     *        either MaxWidth and MaxHeight, or Resolution. <i>Maximum decoded
     *        picture buffer in macroblocks</i> depends on the value of the
     *        <code>Level</code> object. See the list below. (A macroblock is a
     *        block of pixels measuring 16x16.)
     *        </p>
     *        <ul>
     *        <li>1 - 396</li>
     *        <li>1b - 396</li>
     *        <li>1.1 - 900</li>
     *        <li>1.2 - 2376</li>
     *        <li>1.3 - 2376</li>
     *        <li>2 - 2376</li>
     *        <li>2.1 - 4752</li>
     *        <li>2.2 - 8100</li>
     *        <li>3 - 8100</li>
     *        <li>3.1 - 18000</li>
     *        <li>3.2 - 20480</li>
     *        <li>4 - 32768</li>
     *        <li>4.1 - 32768</li>
     *        </ul>
     *        <p>
     *        <b>MaxBitRate (Optional, H.264/MPEG2/VP8 only)</b>
     *        </p>
     *        <p>
     *        The maximum number of bits per second in a video buffer; the size
     *        of the buffer is specified by <code>BufferSize</code>. Specify a
     *        value between 16 and 62,500. You can reduce the bandwidth required
     *        to stream a video by reducing the maximum bit rate, but this also
     *        reduces the quality of the video.
     *        </p>
     *        <p>
     *        <b>BufferSize (Optional, H.264/MPEG2/VP8 only)</b>
     *        </p>
     *        <p>
     *        The maximum number of bits in any x seconds of the output video.
     *        This window is commonly 10 seconds, the standard segment duration
     *        when you're using FMP4 or MPEG-TS for the container type of the
     *        output video. Specify an integer greater than 0. If you specify
     *        <code>MaxBitRate</code> and omit <code>BufferSize</code>, Elastic
     *        Transcoder sets <code>BufferSize</code> to 10 times the value of
     *        <code>MaxBitRate</code>.
     *        </p>
     *        <p>
     *        <b>InterlacedMode (Optional, H.264/MPEG2 Only)</b>
     *        </p>
     *        <p>
     *        The interlace mode for the output video.
     *        </p>
     *        <p>
     *        Interlaced video is used to double the perceived frame rate for a
     *        video by interlacing two fields (one field on every other line,
     *        the other field on the other lines) so that the human eye
     *        registers multiple pictures per frame. Interlacing reduces the
     *        bandwidth required for transmitting a video, but can result in
     *        blurred images and flickering.
     *        </p>
     *        <p>
     *        Valid values include <code>Progressive</code> (no interlacing, top
     *        to bottom), <code>TopFirst</code> (top field first),
     *        <code>BottomFirst</code> (bottom field first), and
     *        <code>Auto</code>.
     *        </p>
     *        <p>
     *        If <code>InterlaceMode</code> is not specified, Elastic Transcoder
     *        uses <code>Progressive</code> for the output. If <code>Auto</code>
     *        is specified, Elastic Transcoder interlaces the output.
     *        </p>
     *        <p>
     *        <b>ColorSpaceConversionMode (Optional, H.264/MPEG2 Only)</b>
     *        </p>
     *        <p>
     *        The color space conversion Elastic Transcoder applies to the
     *        output video. Color spaces are the algorithms used by the computer
     *        to store information about how to render color.
     *        <code>Bt.601</code> is the standard for standard definition video,
     *        while <code>Bt.709</code> is the standard for high definition
     *        video.
     *        </p>
     *        <p>
     *        Valid values include <code>None</code>, <code>Bt709toBt601</code>,
     *        <code>Bt601toBt709</code>, and <code>Auto</code>.
     *        </p>
     *        <p>
     *        If you chose <code>Auto</code> for
     *        <code>ColorSpaceConversionMode</code> and your output is
     *        interlaced, your frame rate is one of <code>23.97</code>,
     *        <code>24</code>, <code>25</code>, <code>29.97</code>,
     *        <code>50</code>, or <code>60</code>, your
     *        <code>SegmentDuration</code> is null, and you are using one of the
     *        resolution changes from the list below, Elastic Transcoder applies
     *        the following color space conversions:
     *        </p>
     *        <ul>
     *        <li><i>Standard to HD, 720x480 to 1920x1080</i> - Elastic
     *        Transcoder applies <code>Bt601ToBt709</code></li>
     *        <li><i>Standard to HD, 720x576 to 1920x1080</i> - Elastic
     *        Transcoder applies <code>Bt601ToBt709</code></li>
     *        <li><i>HD to Standard, 1920x1080 to 720x480</i> - Elastic
     *        Transcoder applies <code>Bt709ToBt601</code></li>
     *        <li><i>HD to Standard, 1920x1080 to 720x576</i> - Elastic
     *        Transcoder applies <code>Bt709ToBt601</code></li>
     *        </ul>
     *        <note>Elastic Transcoder may change the behavior of the
     *        <code>ColorspaceConversionMode</code> <code>Auto</code> mode in
     *        the future. All outputs in a playlist must use the same
     *        <code>ColorSpaceConversionMode</code>.</note>
     *        <p>
     *        If you do not specify a <code>ColorSpaceConversionMode</code>,
     *        Elastic Transcoder does not change the color space of a file. If
     *        you are unsure what <code>ColorSpaceConversionMode</code> was
     *        applied to your output file, you can check the
     *        <code>AppliedColorSpaceConversion</code> parameter included in
     *        your job response. If your job does not have an
     *        <code>AppliedColorSpaceConversion</code> in its response, no
     *        <code>ColorSpaceConversionMode</code> was applied.
     *        </p>
     *        <p>
     *        <b>ChromaSubsampling</b>
     *        </p>
     *        <p>
     *        The sampling pattern for the chroma (color) channels of the output
     *        video. Valid values include <code>yuv420p</code> and
     *        <code>yuv422p</code>.
     *        </p>
     *        <p>
     *        <code>yuv420p</code> samples the chroma information of every other
     *        horizontal and every other vertical line, <code>yuv422p</code>
     *        samples the color information of every horizontal line and every
     *        other vertical line.
     *        </p>
     *        <p>
     *        <b>LoopCount (Gif Only)</b>
     *        </p>
     *        <p>
     *        The number of times you want the output gif to loop. Valid values
     *        include <code>Infinite</code> and integers between <code>0</code>
     *        and <code>100</code>, inclusive.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withCodecOptions(
            java.util.Map<String, String> codecOptions) {
        setCodecOptions(codecOptions);
        return this;
    }

    public VideoParameters addCodecOptionsEntry(String key, String value) {
        if (null == this.codecOptions) {
            this.codecOptions = new com.amazonaws.internal.SdkInternalMap<String, String>();
        }
        if (this.codecOptions.containsKey(key))
            throw new IllegalArgumentException("Duplicated keys ("
                    + key.toString() + ") are provided.");
        this.codecOptions.put(key, value);
        return this;
    }

    /**
     * Removes all the entries added into CodecOptions. &lt;p> Returns a
     * reference to this object so that method calls can be chained together.
     */

    public VideoParameters clearCodecOptionsEntries() {
        this.codecOptions = null;
        return this;
    }

    /**
     * <p>
     * Applicable only when the value of Video:Codec is one of
     * <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.
     * </p>
     * <p>
     * The maximum number of frames between key frames. Key frames are fully
     * encoded frames; the frames between key frames are encoded based, in part,
     * on the content of the key frames. The value is an integer formatted as a
     * string; valid values are between 1 (every frame is a key frame) and
     * 100000, inclusive. A higher value results in higher compression but may
     * also discernibly decrease video quality.
     * </p>
     * <p>
     * For <code>Smooth</code> outputs, the <code>FrameRate</code> must have a
     * constant ratio to the <code>KeyframesMaxDist</code>. This allows
     * <code>Smooth</code> playlists to switch between different quality levels
     * while the file is being played.
     * </p>
     * <p>
     * For example, an input file can have a <code>FrameRate</code> of 30 with a
     * <code>KeyframesMaxDist</code> of 90. The output file then needs to have a
     * ratio of 1:3. Valid outputs would have <code>FrameRate</code> of 30, 25,
     * and 10, and <code>KeyframesMaxDist</code> of 90, 75, and 30,
     * respectively.
     * </p>
     * <p>
     * Alternately, this can be achieved by setting <code>FrameRate</code> to
     * auto and having the same values for <code>MaxFrameRate</code> and
     * <code>KeyframesMaxDist</code>.
     * </p>
     * 
     * @param keyframesMaxDist
     *        Applicable only when the value of Video:Codec is one of
     *        <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.</p>
     *        <p>
     *        The maximum number of frames between key frames. Key frames are
     *        fully encoded frames; the frames between key frames are encoded
     *        based, in part, on the content of the key frames. The value is an
     *        integer formatted as a string; valid values are between 1 (every
     *        frame is a key frame) and 100000, inclusive. A higher value
     *        results in higher compression but may also discernibly decrease
     *        video quality.
     *        </p>
     *        <p>
     *        For <code>Smooth</code> outputs, the <code>FrameRate</code> must
     *        have a constant ratio to the <code>KeyframesMaxDist</code>. This
     *        allows <code>Smooth</code> playlists to switch between different
     *        quality levels while the file is being played.
     *        </p>
     *        <p>
     *        For example, an input file can have a <code>FrameRate</code> of 30
     *        with a <code>KeyframesMaxDist</code> of 90. The output file then
     *        needs to have a ratio of 1:3. Valid outputs would have
     *        <code>FrameRate</code> of 30, 25, and 10, and
     *        <code>KeyframesMaxDist</code> of 90, 75, and 30, respectively.
     *        </p>
     *        <p>
     *        Alternately, this can be achieved by setting
     *        <code>FrameRate</code> to auto and having the same values for
     *        <code>MaxFrameRate</code> and <code>KeyframesMaxDist</code>.
     */

    public void setKeyframesMaxDist(String keyframesMaxDist) {
        this.keyframesMaxDist = keyframesMaxDist;
    }

    /**
     * <p>
     * Applicable only when the value of Video:Codec is one of
     * <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.
     * </p>
     * <p>
     * The maximum number of frames between key frames. Key frames are fully
     * encoded frames; the frames between key frames are encoded based, in part,
     * on the content of the key frames. The value is an integer formatted as a
     * string; valid values are between 1 (every frame is a key frame) and
     * 100000, inclusive. A higher value results in higher compression but may
     * also discernibly decrease video quality.
     * </p>
     * <p>
     * For <code>Smooth</code> outputs, the <code>FrameRate</code> must have a
     * constant ratio to the <code>KeyframesMaxDist</code>. This allows
     * <code>Smooth</code> playlists to switch between different quality levels
     * while the file is being played.
     * </p>
     * <p>
     * For example, an input file can have a <code>FrameRate</code> of 30 with a
     * <code>KeyframesMaxDist</code> of 90. The output file then needs to have a
     * ratio of 1:3. Valid outputs would have <code>FrameRate</code> of 30, 25,
     * and 10, and <code>KeyframesMaxDist</code> of 90, 75, and 30,
     * respectively.
     * </p>
     * <p>
     * Alternately, this can be achieved by setting <code>FrameRate</code> to
     * auto and having the same values for <code>MaxFrameRate</code> and
     * <code>KeyframesMaxDist</code>.
     * </p>
     * 
     * @return Applicable only when the value of Video:Codec is one of
     *         <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.</p>
     *         <p>
     *         The maximum number of frames between key frames. Key frames are
     *         fully encoded frames; the frames between key frames are encoded
     *         based, in part, on the content of the key frames. The value is an
     *         integer formatted as a string; valid values are between 1 (every
     *         frame is a key frame) and 100000, inclusive. A higher value
     *         results in higher compression but may also discernibly decrease
     *         video quality.
     *         </p>
     *         <p>
     *         For <code>Smooth</code> outputs, the <code>FrameRate</code> must
     *         have a constant ratio to the <code>KeyframesMaxDist</code>. This
     *         allows <code>Smooth</code> playlists to switch between different
     *         quality levels while the file is being played.
     *         </p>
     *         <p>
     *         For example, an input file can have a <code>FrameRate</code> of
     *         30 with a <code>KeyframesMaxDist</code> of 90. The output file
     *         then needs to have a ratio of 1:3. Valid outputs would have
     *         <code>FrameRate</code> of 30, 25, and 10, and
     *         <code>KeyframesMaxDist</code> of 90, 75, and 30, respectively.
     *         </p>
     *         <p>
     *         Alternately, this can be achieved by setting
     *         <code>FrameRate</code> to auto and having the same values for
     *         <code>MaxFrameRate</code> and <code>KeyframesMaxDist</code>.
     */

    public String getKeyframesMaxDist() {
        return this.keyframesMaxDist;
    }

    /**
     * <p>
     * Applicable only when the value of Video:Codec is one of
     * <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.
     * </p>
     * <p>
     * The maximum number of frames between key frames. Key frames are fully
     * encoded frames; the frames between key frames are encoded based, in part,
     * on the content of the key frames. The value is an integer formatted as a
     * string; valid values are between 1 (every frame is a key frame) and
     * 100000, inclusive. A higher value results in higher compression but may
     * also discernibly decrease video quality.
     * </p>
     * <p>
     * For <code>Smooth</code> outputs, the <code>FrameRate</code> must have a
     * constant ratio to the <code>KeyframesMaxDist</code>. This allows
     * <code>Smooth</code> playlists to switch between different quality levels
     * while the file is being played.
     * </p>
     * <p>
     * For example, an input file can have a <code>FrameRate</code> of 30 with a
     * <code>KeyframesMaxDist</code> of 90. The output file then needs to have a
     * ratio of 1:3. Valid outputs would have <code>FrameRate</code> of 30, 25,
     * and 10, and <code>KeyframesMaxDist</code> of 90, 75, and 30,
     * respectively.
     * </p>
     * <p>
     * Alternately, this can be achieved by setting <code>FrameRate</code> to
     * auto and having the same values for <code>MaxFrameRate</code> and
     * <code>KeyframesMaxDist</code>.
     * </p>
     * 
     * @param keyframesMaxDist
     *        Applicable only when the value of Video:Codec is one of
     *        <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.</p>
     *        <p>
     *        The maximum number of frames between key frames. Key frames are
     *        fully encoded frames; the frames between key frames are encoded
     *        based, in part, on the content of the key frames. The value is an
     *        integer formatted as a string; valid values are between 1 (every
     *        frame is a key frame) and 100000, inclusive. A higher value
     *        results in higher compression but may also discernibly decrease
     *        video quality.
     *        </p>
     *        <p>
     *        For <code>Smooth</code> outputs, the <code>FrameRate</code> must
     *        have a constant ratio to the <code>KeyframesMaxDist</code>. This
     *        allows <code>Smooth</code> playlists to switch between different
     *        quality levels while the file is being played.
     *        </p>
     *        <p>
     *        For example, an input file can have a <code>FrameRate</code> of 30
     *        with a <code>KeyframesMaxDist</code> of 90. The output file then
     *        needs to have a ratio of 1:3. Valid outputs would have
     *        <code>FrameRate</code> of 30, 25, and 10, and
     *        <code>KeyframesMaxDist</code> of 90, 75, and 30, respectively.
     *        </p>
     *        <p>
     *        Alternately, this can be achieved by setting
     *        <code>FrameRate</code> to auto and having the same values for
     *        <code>MaxFrameRate</code> and <code>KeyframesMaxDist</code>.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withKeyframesMaxDist(String keyframesMaxDist) {
        setKeyframesMaxDist(keyframesMaxDist);
        return this;
    }

    /**
     * <p>
     * Applicable only when the value of Video:Codec is one of
     * <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.
     * </p>
     * <p>
     * Whether to use a fixed value for <code>FixedGOP</code>. Valid values are
     * <code>true</code> and <code>false</code>:
     * </p>
     * <ul>
     * <li><code>true</code>: Elastic Transcoder uses the value of
     * <code>KeyframesMaxDist</code> for the distance between key frames (the
     * number of frames in a group of pictures, or GOP).</li>
     * <li><code>false</code>: The distance between key frames can vary.</li>
     * </ul>
     * <important>
     * <p>
     * <code>FixedGOP</code> must be set to <code>true</code> for
     * <code>fmp4</code> containers.
     * </p>
     * </important>
     * 
     * @param fixedGOP
     *        Applicable only when the value of Video:Codec is one of
     *        <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.</p>
     *        <p>
     *        Whether to use a fixed value for <code>FixedGOP</code>. Valid
     *        values are <code>true</code> and <code>false</code>:
     *        </p>
     *        <ul>
     *        <li><code>true</code>: Elastic Transcoder uses the value of
     *        <code>KeyframesMaxDist</code> for the distance between key frames
     *        (the number of frames in a group of pictures, or GOP).</li>
     *        <li><code>false</code>: The distance between key frames can vary.</li>
     *        </ul>
     *        <important>
     *        <p>
     *        <code>FixedGOP</code> must be set to <code>true</code> for
     *        <code>fmp4</code> containers.
     *        </p>
     */

    public void setFixedGOP(String fixedGOP) {
        this.fixedGOP = fixedGOP;
    }

    /**
     * <p>
     * Applicable only when the value of Video:Codec is one of
     * <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.
     * </p>
     * <p>
     * Whether to use a fixed value for <code>FixedGOP</code>. Valid values are
     * <code>true</code> and <code>false</code>:
     * </p>
     * <ul>
     * <li><code>true</code>: Elastic Transcoder uses the value of
     * <code>KeyframesMaxDist</code> for the distance between key frames (the
     * number of frames in a group of pictures, or GOP).</li>
     * <li><code>false</code>: The distance between key frames can vary.</li>
     * </ul>
     * <important>
     * <p>
     * <code>FixedGOP</code> must be set to <code>true</code> for
     * <code>fmp4</code> containers.
     * </p>
     * </important>
     * 
     * @return Applicable only when the value of Video:Codec is one of
     *         <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.</p>
     *         <p>
     *         Whether to use a fixed value for <code>FixedGOP</code>. Valid
     *         values are <code>true</code> and <code>false</code>:
     *         </p>
     *         <ul>
     *         <li><code>true</code>: Elastic Transcoder uses the value of
     *         <code>KeyframesMaxDist</code> for the distance between key frames
     *         (the number of frames in a group of pictures, or GOP).</li>
     *         <li><code>false</code>: The distance between key frames can vary.
     *         </li>
     *         </ul>
     *         <important>
     *         <p>
     *         <code>FixedGOP</code> must be set to <code>true</code> for
     *         <code>fmp4</code> containers.
     *         </p>
     */

    public String getFixedGOP() {
        return this.fixedGOP;
    }

    /**
     * <p>
     * Applicable only when the value of Video:Codec is one of
     * <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.
     * </p>
     * <p>
     * Whether to use a fixed value for <code>FixedGOP</code>. Valid values are
     * <code>true</code> and <code>false</code>:
     * </p>
     * <ul>
     * <li><code>true</code>: Elastic Transcoder uses the value of
     * <code>KeyframesMaxDist</code> for the distance between key frames (the
     * number of frames in a group of pictures, or GOP).</li>
     * <li><code>false</code>: The distance between key frames can vary.</li>
     * </ul>
     * <important>
     * <p>
     * <code>FixedGOP</code> must be set to <code>true</code> for
     * <code>fmp4</code> containers.
     * </p>
     * </important>
     * 
     * @param fixedGOP
     *        Applicable only when the value of Video:Codec is one of
     *        <code>H.264</code>, <code>MPEG2</code>, or <code>VP8</code>.</p>
     *        <p>
     *        Whether to use a fixed value for <code>FixedGOP</code>. Valid
     *        values are <code>true</code> and <code>false</code>:
     *        </p>
     *        <ul>
     *        <li><code>true</code>: Elastic Transcoder uses the value of
     *        <code>KeyframesMaxDist</code> for the distance between key frames
     *        (the number of frames in a group of pictures, or GOP).</li>
     *        <li><code>false</code>: The distance between key frames can vary.</li>
     *        </ul>
     *        <important>
     *        <p>
     *        <code>FixedGOP</code> must be set to <code>true</code> for
     *        <code>fmp4</code> containers.
     *        </p>
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withFixedGOP(String fixedGOP) {
        setFixedGOP(fixedGOP);
        return this;
    }

    /**
     * <p>
     * The bit rate of the video stream in the output file, in kilobits/second.
     * Valid values depend on the values of <code>Level</code> and
     * <code>Profile</code>. If you specify <code>auto</code>, Elastic
     * Transcoder uses the detected bit rate of the input source. If you specify
     * a value other than <code>auto</code>, we recommend that you specify a
     * value less than or equal to the maximum H.264-compliant value listed for
     * your level and profile:
     * </p>
     * <p>
     * <i>Level - Maximum video bit rate in kilobits/second (baseline and main
     * Profile) : maximum video bit rate in kilobits/second (high Profile)</i>
     * </p>
     * <ul>
     * <li>1 - 64 : 80</li>
     * <li>1b - 128 : 160</li>
     * <li>1.1 - 192 : 240</li>
     * <li>1.2 - 384 : 480</li>
     * <li>1.3 - 768 : 960</li>
     * <li>2 - 2000 : 2500</li>
     * <li>3 - 10000 : 12500</li>
     * <li>3.1 - 14000 : 17500</li>
     * <li>3.2 - 20000 : 25000</li>
     * <li>4 - 20000 : 25000</li>
     * <li>4.1 - 50000 : 62500</li>
     * </ul>
     * 
     * @param bitRate
     *        The bit rate of the video stream in the output file, in
     *        kilobits/second. Valid values depend on the values of
     *        <code>Level</code> and <code>Profile</code>. If you specify
     *        <code>auto</code>, Elastic Transcoder uses the detected bit rate
     *        of the input source. If you specify a value other than
     *        <code>auto</code>, we recommend that you specify a value less than
     *        or equal to the maximum H.264-compliant value listed for your
     *        level and profile:</p>
     *        <p>
     *        <i>Level - Maximum video bit rate in kilobits/second (baseline and
     *        main Profile) : maximum video bit rate in kilobits/second (high
     *        Profile)</i>
     *        </p>
     *        <ul>
     *        <li>1 - 64 : 80</li>
     *        <li>1b - 128 : 160</li>
     *        <li>1.1 - 192 : 240</li>
     *        <li>1.2 - 384 : 480</li>
     *        <li>1.3 - 768 : 960</li>
     *        <li>2 - 2000 : 2500</li>
     *        <li>3 - 10000 : 12500</li>
     *        <li>3.1 - 14000 : 17500</li>
     *        <li>3.2 - 20000 : 25000</li>
     *        <li>4 - 20000 : 25000</li>
     *        <li>4.1 - 50000 : 62500</li>
     */

    public void setBitRate(String bitRate) {
        this.bitRate = bitRate;
    }

    /**
     * <p>
     * The bit rate of the video stream in the output file, in kilobits/second.
     * Valid values depend on the values of <code>Level</code> and
     * <code>Profile</code>. If you specify <code>auto</code>, Elastic
     * Transcoder uses the detected bit rate of the input source. If you specify
     * a value other than <code>auto</code>, we recommend that you specify a
     * value less than or equal to the maximum H.264-compliant value listed for
     * your level and profile:
     * </p>
     * <p>
     * <i>Level - Maximum video bit rate in kilobits/second (baseline and main
     * Profile) : maximum video bit rate in kilobits/second (high Profile)</i>
     * </p>
     * <ul>
     * <li>1 - 64 : 80</li>
     * <li>1b - 128 : 160</li>
     * <li>1.1 - 192 : 240</li>
     * <li>1.2 - 384 : 480</li>
     * <li>1.3 - 768 : 960</li>
     * <li>2 - 2000 : 2500</li>
     * <li>3 - 10000 : 12500</li>
     * <li>3.1 - 14000 : 17500</li>
     * <li>3.2 - 20000 : 25000</li>
     * <li>4 - 20000 : 25000</li>
     * <li>4.1 - 50000 : 62500</li>
     * </ul>
     * 
     * @return The bit rate of the video stream in the output file, in
     *         kilobits/second. Valid values depend on the values of
     *         <code>Level</code> and <code>Profile</code>. If you specify
     *         <code>auto</code>, Elastic Transcoder uses the detected bit rate
     *         of the input source. If you specify a value other than
     *         <code>auto</code>, we recommend that you specify a value less
     *         than or equal to the maximum H.264-compliant value listed for
     *         your level and profile:</p>
     *         <p>
     *         <i>Level - Maximum video bit rate in kilobits/second (baseline
     *         and main Profile) : maximum video bit rate in kilobits/second
     *         (high Profile)</i>
     *         </p>
     *         <ul>
     *         <li>1 - 64 : 80</li>
     *         <li>1b - 128 : 160</li>
     *         <li>1.1 - 192 : 240</li>
     *         <li>1.2 - 384 : 480</li>
     *         <li>1.3 - 768 : 960</li>
     *         <li>2 - 2000 : 2500</li>
     *         <li>3 - 10000 : 12500</li>
     *         <li>3.1 - 14000 : 17500</li>
     *         <li>3.2 - 20000 : 25000</li>
     *         <li>4 - 20000 : 25000</li>
     *         <li>4.1 - 50000 : 62500</li>
     */

    public String getBitRate() {
        return this.bitRate;
    }

    /**
     * <p>
     * The bit rate of the video stream in the output file, in kilobits/second.
     * Valid values depend on the values of <code>Level</code> and
     * <code>Profile</code>. If you specify <code>auto</code>, Elastic
     * Transcoder uses the detected bit rate of the input source. If you specify
     * a value other than <code>auto</code>, we recommend that you specify a
     * value less than or equal to the maximum H.264-compliant value listed for
     * your level and profile:
     * </p>
     * <p>
     * <i>Level - Maximum video bit rate in kilobits/second (baseline and main
     * Profile) : maximum video bit rate in kilobits/second (high Profile)</i>
     * </p>
     * <ul>
     * <li>1 - 64 : 80</li>
     * <li>1b - 128 : 160</li>
     * <li>1.1 - 192 : 240</li>
     * <li>1.2 - 384 : 480</li>
     * <li>1.3 - 768 : 960</li>
     * <li>2 - 2000 : 2500</li>
     * <li>3 - 10000 : 12500</li>
     * <li>3.1 - 14000 : 17500</li>
     * <li>3.2 - 20000 : 25000</li>
     * <li>4 - 20000 : 25000</li>
     * <li>4.1 - 50000 : 62500</li>
     * </ul>
     * 
     * @param bitRate
     *        The bit rate of the video stream in the output file, in
     *        kilobits/second. Valid values depend on the values of
     *        <code>Level</code> and <code>Profile</code>. If you specify
     *        <code>auto</code>, Elastic Transcoder uses the detected bit rate
     *        of the input source. If you specify a value other than
     *        <code>auto</code>, we recommend that you specify a value less than
     *        or equal to the maximum H.264-compliant value listed for your
     *        level and profile:</p>
     *        <p>
     *        <i>Level - Maximum video bit rate in kilobits/second (baseline and
     *        main Profile) : maximum video bit rate in kilobits/second (high
     *        Profile)</i>
     *        </p>
     *        <ul>
     *        <li>1 - 64 : 80</li>
     *        <li>1b - 128 : 160</li>
     *        <li>1.1 - 192 : 240</li>
     *        <li>1.2 - 384 : 480</li>
     *        <li>1.3 - 768 : 960</li>
     *        <li>2 - 2000 : 2500</li>
     *        <li>3 - 10000 : 12500</li>
     *        <li>3.1 - 14000 : 17500</li>
     *        <li>3.2 - 20000 : 25000</li>
     *        <li>4 - 20000 : 25000</li>
     *        <li>4.1 - 50000 : 62500</li>
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withBitRate(String bitRate) {
        setBitRate(bitRate);
        return this;
    }

    /**
     * <p>
     * The frames per second for the video stream in the output file. Valid
     * values include:
     * </p>
     * <p>
     * <code>auto</code>, <code>10</code>, <code>15</code>, <code>23.97</code>,
     * <code>24</code>, <code>25</code>, <code>29.97</code>, <code>30</code>,
     * <code>60</code>
     * </p>
     * <p>
     * If you specify <code>auto</code>, Elastic Transcoder uses the detected
     * frame rate of the input source. If you specify a frame rate, we recommend
     * that you perform the following calculation:
     * </p>
     * <p>
     * <code>Frame rate = maximum recommended decoding speed in luma samples/second / (width in pixels * height in pixels)</code>
     * </p>
     * <p>
     * where:
     * </p>
     * <ul>
     * <li><i>width in pixels</i> and <i>height in pixels</i> represent the
     * Resolution of the output video.</li>
     * <li><i>maximum recommended decoding speed in Luma samples/second</i> is
     * less than or equal to the maximum value listed in the following table,
     * based on the value that you specified for Level.</li>
     * </ul>
     * <p>
     * The maximum recommended decoding speed in Luma samples/second for each
     * level is described in the following list (<i>Level - Decoding speed</i>):
     * </p>
     * <ul>
     * <li>1 - 380160</li>
     * <li>1b - 380160</li>
     * <li>1.1 - 76800</li>
     * <li>1.2 - 1536000</li>
     * <li>1.3 - 3041280</li>
     * <li>2 - 3041280</li>
     * <li>2.1 - 5068800</li>
     * <li>2.2 - 5184000</li>
     * <li>3 - 10368000</li>
     * <li>3.1 - 27648000</li>
     * <li>3.2 - 55296000</li>
     * <li>4 - 62914560</li>
     * <li>4.1 - 62914560</li>
     * </ul>
     * 
     * @param frameRate
     *        The frames per second for the video stream in the output file.
     *        Valid values include:</p>
     *        <p>
     *        <code>auto</code>, <code>10</code>, <code>15</code>,
     *        <code>23.97</code>, <code>24</code>, <code>25</code>,
     *        <code>29.97</code>, <code>30</code>, <code>60</code>
     *        </p>
     *        <p>
     *        If you specify <code>auto</code>, Elastic Transcoder uses the
     *        detected frame rate of the input source. If you specify a frame
     *        rate, we recommend that you perform the following calculation:
     *        </p>
     *        <p>
     *        <code>Frame rate = maximum recommended decoding speed in luma samples/second / (width in pixels * height in pixels)</code>
     *        </p>
     *        <p>
     *        where:
     *        </p>
     *        <ul>
     *        <li><i>width in pixels</i> and <i>height in pixels</i> represent
     *        the Resolution of the output video.</li>
     *        <li><i>maximum recommended decoding speed in Luma
     *        samples/second</i> is less than or equal to the maximum value
     *        listed in the following table, based on the value that you
     *        specified for Level.</li>
     *        </ul>
     *        <p>
     *        The maximum recommended decoding speed in Luma samples/second for
     *        each level is described in the following list (<i>Level - Decoding
     *        speed</i>):
     *        </p>
     *        <ul>
     *        <li>1 - 380160</li>
     *        <li>1b - 380160</li>
     *        <li>1.1 - 76800</li>
     *        <li>1.2 - 1536000</li>
     *        <li>1.3 - 3041280</li>
     *        <li>2 - 3041280</li>
     *        <li>2.1 - 5068800</li>
     *        <li>2.2 - 5184000</li>
     *        <li>3 - 10368000</li>
     *        <li>3.1 - 27648000</li>
     *        <li>3.2 - 55296000</li>
     *        <li>4 - 62914560</li>
     *        <li>4.1 - 62914560</li>
     */

    public void setFrameRate(String frameRate) {
        this.frameRate = frameRate;
    }

    /**
     * <p>
     * The frames per second for the video stream in the output file. Valid
     * values include:
     * </p>
     * <p>
     * <code>auto</code>, <code>10</code>, <code>15</code>, <code>23.97</code>,
     * <code>24</code>, <code>25</code>, <code>29.97</code>, <code>30</code>,
     * <code>60</code>
     * </p>
     * <p>
     * If you specify <code>auto</code>, Elastic Transcoder uses the detected
     * frame rate of the input source. If you specify a frame rate, we recommend
     * that you perform the following calculation:
     * </p>
     * <p>
     * <code>Frame rate = maximum recommended decoding speed in luma samples/second / (width in pixels * height in pixels)</code>
     * </p>
     * <p>
     * where:
     * </p>
     * <ul>
     * <li><i>width in pixels</i> and <i>height in pixels</i> represent the
     * Resolution of the output video.</li>
     * <li><i>maximum recommended decoding speed in Luma samples/second</i> is
     * less than or equal to the maximum value listed in the following table,
     * based on the value that you specified for Level.</li>
     * </ul>
     * <p>
     * The maximum recommended decoding speed in Luma samples/second for each
     * level is described in the following list (<i>Level - Decoding speed</i>):
     * </p>
     * <ul>
     * <li>1 - 380160</li>
     * <li>1b - 380160</li>
     * <li>1.1 - 76800</li>
     * <li>1.2 - 1536000</li>
     * <li>1.3 - 3041280</li>
     * <li>2 - 3041280</li>
     * <li>2.1 - 5068800</li>
     * <li>2.2 - 5184000</li>
     * <li>3 - 10368000</li>
     * <li>3.1 - 27648000</li>
     * <li>3.2 - 55296000</li>
     * <li>4 - 62914560</li>
     * <li>4.1 - 62914560</li>
     * </ul>
     * 
     * @return The frames per second for the video stream in the output file.
     *         Valid values include:</p>
     *         <p>
     *         <code>auto</code>, <code>10</code>, <code>15</code>,
     *         <code>23.97</code>, <code>24</code>, <code>25</code>,
     *         <code>29.97</code>, <code>30</code>, <code>60</code>
     *         </p>
     *         <p>
     *         If you specify <code>auto</code>, Elastic Transcoder uses the
     *         detected frame rate of the input source. If you specify a frame
     *         rate, we recommend that you perform the following calculation:
     *         </p>
     *         <p>
     *         <code>Frame rate = maximum recommended decoding speed in luma samples/second / (width in pixels * height in pixels)</code>
     *         </p>
     *         <p>
     *         where:
     *         </p>
     *         <ul>
     *         <li><i>width in pixels</i> and <i>height in pixels</i> represent
     *         the Resolution of the output video.</li>
     *         <li><i>maximum recommended decoding speed in Luma
     *         samples/second</i> is less than or equal to the maximum value
     *         listed in the following table, based on the value that you
     *         specified for Level.</li>
     *         </ul>
     *         <p>
     *         The maximum recommended decoding speed in Luma samples/second for
     *         each level is described in the following list (<i>Level -
     *         Decoding speed</i>):
     *         </p>
     *         <ul>
     *         <li>1 - 380160</li>
     *         <li>1b - 380160</li>
     *         <li>1.1 - 76800</li>
     *         <li>1.2 - 1536000</li>
     *         <li>1.3 - 3041280</li>
     *         <li>2 - 3041280</li>
     *         <li>2.1 - 5068800</li>
     *         <li>2.2 - 5184000</li>
     *         <li>3 - 10368000</li>
     *         <li>3.1 - 27648000</li>
     *         <li>3.2 - 55296000</li>
     *         <li>4 - 62914560</li>
     *         <li>4.1 - 62914560</li>
     */

    public String getFrameRate() {
        return this.frameRate;
    }

    /**
     * <p>
     * The frames per second for the video stream in the output file. Valid
     * values include:
     * </p>
     * <p>
     * <code>auto</code>, <code>10</code>, <code>15</code>, <code>23.97</code>,
     * <code>24</code>, <code>25</code>, <code>29.97</code>, <code>30</code>,
     * <code>60</code>
     * </p>
     * <p>
     * If you specify <code>auto</code>, Elastic Transcoder uses the detected
     * frame rate of the input source. If you specify a frame rate, we recommend
     * that you perform the following calculation:
     * </p>
     * <p>
     * <code>Frame rate = maximum recommended decoding speed in luma samples/second / (width in pixels * height in pixels)</code>
     * </p>
     * <p>
     * where:
     * </p>
     * <ul>
     * <li><i>width in pixels</i> and <i>height in pixels</i> represent the
     * Resolution of the output video.</li>
     * <li><i>maximum recommended decoding speed in Luma samples/second</i> is
     * less than or equal to the maximum value listed in the following table,
     * based on the value that you specified for Level.</li>
     * </ul>
     * <p>
     * The maximum recommended decoding speed in Luma samples/second for each
     * level is described in the following list (<i>Level - Decoding speed</i>):
     * </p>
     * <ul>
     * <li>1 - 380160</li>
     * <li>1b - 380160</li>
     * <li>1.1 - 76800</li>
     * <li>1.2 - 1536000</li>
     * <li>1.3 - 3041280</li>
     * <li>2 - 3041280</li>
     * <li>2.1 - 5068800</li>
     * <li>2.2 - 5184000</li>
     * <li>3 - 10368000</li>
     * <li>3.1 - 27648000</li>
     * <li>3.2 - 55296000</li>
     * <li>4 - 62914560</li>
     * <li>4.1 - 62914560</li>
     * </ul>
     * 
     * @param frameRate
     *        The frames per second for the video stream in the output file.
     *        Valid values include:</p>
     *        <p>
     *        <code>auto</code>, <code>10</code>, <code>15</code>,
     *        <code>23.97</code>, <code>24</code>, <code>25</code>,
     *        <code>29.97</code>, <code>30</code>, <code>60</code>
     *        </p>
     *        <p>
     *        If you specify <code>auto</code>, Elastic Transcoder uses the
     *        detected frame rate of the input source. If you specify a frame
     *        rate, we recommend that you perform the following calculation:
     *        </p>
     *        <p>
     *        <code>Frame rate = maximum recommended decoding speed in luma samples/second / (width in pixels * height in pixels)</code>
     *        </p>
     *        <p>
     *        where:
     *        </p>
     *        <ul>
     *        <li><i>width in pixels</i> and <i>height in pixels</i> represent
     *        the Resolution of the output video.</li>
     *        <li><i>maximum recommended decoding speed in Luma
     *        samples/second</i> is less than or equal to the maximum value
     *        listed in the following table, based on the value that you
     *        specified for Level.</li>
     *        </ul>
     *        <p>
     *        The maximum recommended decoding speed in Luma samples/second for
     *        each level is described in the following list (<i>Level - Decoding
     *        speed</i>):
     *        </p>
     *        <ul>
     *        <li>1 - 380160</li>
     *        <li>1b - 380160</li>
     *        <li>1.1 - 76800</li>
     *        <li>1.2 - 1536000</li>
     *        <li>1.3 - 3041280</li>
     *        <li>2 - 3041280</li>
     *        <li>2.1 - 5068800</li>
     *        <li>2.2 - 5184000</li>
     *        <li>3 - 10368000</li>
     *        <li>3.1 - 27648000</li>
     *        <li>3.2 - 55296000</li>
     *        <li>4 - 62914560</li>
     *        <li>4.1 - 62914560</li>
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withFrameRate(String frameRate) {
        setFrameRate(frameRate);
        return this;
    }

    /**
     * <p>
     * If you specify <code>auto</code> for <code>FrameRate</code>, Elastic
     * Transcoder uses the frame rate of the input video for the frame rate of
     * the output video. Specify the maximum frame rate that you want Elastic
     * Transcoder to use when the frame rate of the input video is greater than
     * the desired maximum frame rate of the output video. Valid values include:
     * <code>10</code>, <code>15</code>, <code>23.97</code>, <code>24</code>,
     * <code>25</code>, <code>29.97</code>, <code>30</code>, <code>60</code>.
     * </p>
     * 
     * @param maxFrameRate
     *        If you specify <code>auto</code> for <code>FrameRate</code>,
     *        Elastic Transcoder uses the frame rate of the input video for the
     *        frame rate of the output video. Specify the maximum frame rate
     *        that you want Elastic Transcoder to use when the frame rate of the
     *        input video is greater than the desired maximum frame rate of the
     *        output video. Valid values include: <code>10</code>,
     *        <code>15</code>, <code>23.97</code>, <code>24</code>,
     *        <code>25</code>, <code>29.97</code>, <code>30</code>,
     *        <code>60</code>.
     */

    public void setMaxFrameRate(String maxFrameRate) {
        this.maxFrameRate = maxFrameRate;
    }

    /**
     * <p>
     * If you specify <code>auto</code> for <code>FrameRate</code>, Elastic
     * Transcoder uses the frame rate of the input video for the frame rate of
     * the output video. Specify the maximum frame rate that you want Elastic
     * Transcoder to use when the frame rate of the input video is greater than
     * the desired maximum frame rate of the output video. Valid values include:
     * <code>10</code>, <code>15</code>, <code>23.97</code>, <code>24</code>,
     * <code>25</code>, <code>29.97</code>, <code>30</code>, <code>60</code>.
     * </p>
     * 
     * @return If you specify <code>auto</code> for <code>FrameRate</code>,
     *         Elastic Transcoder uses the frame rate of the input video for the
     *         frame rate of the output video. Specify the maximum frame rate
     *         that you want Elastic Transcoder to use when the frame rate of
     *         the input video is greater than the desired maximum frame rate of
     *         the output video. Valid values include: <code>10</code>,
     *         <code>15</code>, <code>23.97</code>, <code>24</code>,
     *         <code>25</code>, <code>29.97</code>, <code>30</code>,
     *         <code>60</code>.
     */

    public String getMaxFrameRate() {
        return this.maxFrameRate;
    }

    /**
     * <p>
     * If you specify <code>auto</code> for <code>FrameRate</code>, Elastic
     * Transcoder uses the frame rate of the input video for the frame rate of
     * the output video. Specify the maximum frame rate that you want Elastic
     * Transcoder to use when the frame rate of the input video is greater than
     * the desired maximum frame rate of the output video. Valid values include:
     * <code>10</code>, <code>15</code>, <code>23.97</code>, <code>24</code>,
     * <code>25</code>, <code>29.97</code>, <code>30</code>, <code>60</code>.
     * </p>
     * 
     * @param maxFrameRate
     *        If you specify <code>auto</code> for <code>FrameRate</code>,
     *        Elastic Transcoder uses the frame rate of the input video for the
     *        frame rate of the output video. Specify the maximum frame rate
     *        that you want Elastic Transcoder to use when the frame rate of the
     *        input video is greater than the desired maximum frame rate of the
     *        output video. Valid values include: <code>10</code>,
     *        <code>15</code>, <code>23.97</code>, <code>24</code>,
     *        <code>25</code>, <code>29.97</code>, <code>30</code>,
     *        <code>60</code>.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withMaxFrameRate(String maxFrameRate) {
        setMaxFrameRate(maxFrameRate);
        return this;
    }

    /**
     * <important>
     * <p>
     * To better control resolution and aspect ratio of output videos, we
     * recommend that you use the values <code>MaxWidth</code>,
     * <code>MaxHeight</code>, <code>SizingPolicy</code>,
     * <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code> instead
     * of <code>Resolution</code> and <code>AspectRatio</code>. The two groups
     * of settings are mutually exclusive. Do not use them together.
     * </p>
     * </important>
     * <p>
     * The width and height of the video in the output file, in pixels. Valid
     * values are <code>auto</code> and <i>width</i> x <i>height</i>:
     * </p>
     * <ul>
     * <li><code>auto</code>: Elastic Transcoder attempts to preserve the width
     * and height of the input file, subject to the following rules.</li>
     * <li><code><i>width</i> x <i>height</i></code>: The width and height of
     * the output video in pixels.</li>
     * </ul>
     * <p>
     * Note the following about specifying the width and height:
     * </p>
     * <ul>
     * <li>The width must be an even integer between 128 and 4096, inclusive.</li>
     * <li>The height must be an even integer between 96 and 3072, inclusive.</li>
     * <li>If you specify a resolution that is less than the resolution of the
     * input file, Elastic Transcoder rescales the output file to the lower
     * resolution.</li>
     * <li>If you specify a resolution that is greater than the resolution of
     * the input file, Elastic Transcoder rescales the output to the higher
     * resolution.</li>
     * <li>We recommend that you specify a resolution for which the product of
     * width and height is less than or equal to the applicable value in the
     * following list (<i>List - Max width x height value</i>):</li>
     * <ul>
     * <li>1 - 25344</li>
     * <li>1b - 25344</li>
     * <li>1.1 - 101376</li>
     * <li>1.2 - 101376</li>
     * <li>1.3 - 101376</li>
     * <li>2 - 101376</li>
     * <li>2.1 - 202752</li>
     * <li>2.2 - 404720</li>
     * <li>3 - 404720</li>
     * <li>3.1 - 921600</li>
     * <li>3.2 - 1310720</li>
     * <li>4 - 2097152</li>
     * <li>4.1 - 2097152</li>
     * </ul>
     * </ul>
     * 
     * @param resolution
     *        <p>
     *        To better control resolution and aspect ratio of output videos, we
     *        recommend that you use the values <code>MaxWidth</code>,
     *        <code>MaxHeight</code>, <code>SizingPolicy</code>,
     *        <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code>
     *        instead of <code>Resolution</code> and <code>AspectRatio</code>.
     *        The two groups of settings are mutually exclusive. Do not use them
     *        together.
     *        </p>
     *        </important>
     *        <p>
     *        The width and height of the video in the output file, in pixels.
     *        Valid values are <code>auto</code> and <i>width</i> x
     *        <i>height</i>:
     *        </p>
     *        <ul>
     *        <li><code>auto</code>: Elastic Transcoder attempts to preserve the
     *        width and height of the input file, subject to the following
     *        rules.</li>
     *        <li><code><i>width</i> x <i>height</i></code>: The width and
     *        height of the output video in pixels.</li>
     *        </ul>
     *        <p>
     *        Note the following about specifying the width and height:
     *        </p>
     *        <ul>
     *        <li>The width must be an even integer between 128 and 4096,
     *        inclusive.</li>
     *        <li>The height must be an even integer between 96 and 3072,
     *        inclusive.</li>
     *        <li>If you specify a resolution that is less than the resolution
     *        of the input file, Elastic Transcoder rescales the output file to
     *        the lower resolution.</li>
     *        <li>If you specify a resolution that is greater than the
     *        resolution of the input file, Elastic Transcoder rescales the
     *        output to the higher resolution.</li>
     *        <li>We recommend that you specify a resolution for which the
     *        product of width and height is less than or equal to the
     *        applicable value in the following list (<i>List - Max width x
     *        height value</i>):</li>
     *        <ul>
     *        <li>1 - 25344</li>
     *        <li>1b - 25344</li>
     *        <li>1.1 - 101376</li>
     *        <li>1.2 - 101376</li>
     *        <li>1.3 - 101376</li>
     *        <li>2 - 101376</li>
     *        <li>2.1 - 202752</li>
     *        <li>2.2 - 404720</li>
     *        <li>3 - 404720</li>
     *        <li>3.1 - 921600</li>
     *        <li>3.2 - 1310720</li>
     *        <li>4 - 2097152</li>
     *        <li>4.1 - 2097152</li>
     *        </ul>
     */

    public void setResolution(String resolution) {
        this.resolution = resolution;
    }

    /**
     * <important>
     * <p>
     * To better control resolution and aspect ratio of output videos, we
     * recommend that you use the values <code>MaxWidth</code>,
     * <code>MaxHeight</code>, <code>SizingPolicy</code>,
     * <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code> instead
     * of <code>Resolution</code> and <code>AspectRatio</code>. The two groups
     * of settings are mutually exclusive. Do not use them together.
     * </p>
     * </important>
     * <p>
     * The width and height of the video in the output file, in pixels. Valid
     * values are <code>auto</code> and <i>width</i> x <i>height</i>:
     * </p>
     * <ul>
     * <li><code>auto</code>: Elastic Transcoder attempts to preserve the width
     * and height of the input file, subject to the following rules.</li>
     * <li><code><i>width</i> x <i>height</i></code>: The width and height of
     * the output video in pixels.</li>
     * </ul>
     * <p>
     * Note the following about specifying the width and height:
     * </p>
     * <ul>
     * <li>The width must be an even integer between 128 and 4096, inclusive.</li>
     * <li>The height must be an even integer between 96 and 3072, inclusive.</li>
     * <li>If you specify a resolution that is less than the resolution of the
     * input file, Elastic Transcoder rescales the output file to the lower
     * resolution.</li>
     * <li>If you specify a resolution that is greater than the resolution of
     * the input file, Elastic Transcoder rescales the output to the higher
     * resolution.</li>
     * <li>We recommend that you specify a resolution for which the product of
     * width and height is less than or equal to the applicable value in the
     * following list (<i>List - Max width x height value</i>):</li>
     * <ul>
     * <li>1 - 25344</li>
     * <li>1b - 25344</li>
     * <li>1.1 - 101376</li>
     * <li>1.2 - 101376</li>
     * <li>1.3 - 101376</li>
     * <li>2 - 101376</li>
     * <li>2.1 - 202752</li>
     * <li>2.2 - 404720</li>
     * <li>3 - 404720</li>
     * <li>3.1 - 921600</li>
     * <li>3.2 - 1310720</li>
     * <li>4 - 2097152</li>
     * <li>4.1 - 2097152</li>
     * </ul>
     * </ul>
     * 
     * @return <p>
     *         To better control resolution and aspect ratio of output videos,
     *         we recommend that you use the values <code>MaxWidth</code>,
     *         <code>MaxHeight</code>, <code>SizingPolicy</code>,
     *         <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code>
     *         instead of <code>Resolution</code> and <code>AspectRatio</code>.
     *         The two groups of settings are mutually exclusive. Do not use
     *         them together.
     *         </p>
     *         </important>
     *         <p>
     *         The width and height of the video in the output file, in pixels.
     *         Valid values are <code>auto</code> and <i>width</i> x
     *         <i>height</i>:
     *         </p>
     *         <ul>
     *         <li><code>auto</code>: Elastic Transcoder attempts to preserve
     *         the width and height of the input file, subject to the following
     *         rules.</li>
     *         <li><code><i>width</i> x <i>height</i></code>: The width and
     *         height of the output video in pixels.</li>
     *         </ul>
     *         <p>
     *         Note the following about specifying the width and height:
     *         </p>
     *         <ul>
     *         <li>The width must be an even integer between 128 and 4096,
     *         inclusive.</li>
     *         <li>The height must be an even integer between 96 and 3072,
     *         inclusive.</li>
     *         <li>If you specify a resolution that is less than the resolution
     *         of the input file, Elastic Transcoder rescales the output file to
     *         the lower resolution.</li>
     *         <li>If you specify a resolution that is greater than the
     *         resolution of the input file, Elastic Transcoder rescales the
     *         output to the higher resolution.</li>
     *         <li>We recommend that you specify a resolution for which the
     *         product of width and height is less than or equal to the
     *         applicable value in the following list (<i>List - Max width x
     *         height value</i>):</li>
     *         <ul>
     *         <li>1 - 25344</li>
     *         <li>1b - 25344</li>
     *         <li>1.1 - 101376</li>
     *         <li>1.2 - 101376</li>
     *         <li>1.3 - 101376</li>
     *         <li>2 - 101376</li>
     *         <li>2.1 - 202752</li>
     *         <li>2.2 - 404720</li>
     *         <li>3 - 404720</li>
     *         <li>3.1 - 921600</li>
     *         <li>3.2 - 1310720</li>
     *         <li>4 - 2097152</li>
     *         <li>4.1 - 2097152</li>
     *         </ul>
     */

    public String getResolution() {
        return this.resolution;
    }

    /**
     * <important>
     * <p>
     * To better control resolution and aspect ratio of output videos, we
     * recommend that you use the values <code>MaxWidth</code>,
     * <code>MaxHeight</code>, <code>SizingPolicy</code>,
     * <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code> instead
     * of <code>Resolution</code> and <code>AspectRatio</code>. The two groups
     * of settings are mutually exclusive. Do not use them together.
     * </p>
     * </important>
     * <p>
     * The width and height of the video in the output file, in pixels. Valid
     * values are <code>auto</code> and <i>width</i> x <i>height</i>:
     * </p>
     * <ul>
     * <li><code>auto</code>: Elastic Transcoder attempts to preserve the width
     * and height of the input file, subject to the following rules.</li>
     * <li><code><i>width</i> x <i>height</i></code>: The width and height of
     * the output video in pixels.</li>
     * </ul>
     * <p>
     * Note the following about specifying the width and height:
     * </p>
     * <ul>
     * <li>The width must be an even integer between 128 and 4096, inclusive.</li>
     * <li>The height must be an even integer between 96 and 3072, inclusive.</li>
     * <li>If you specify a resolution that is less than the resolution of the
     * input file, Elastic Transcoder rescales the output file to the lower
     * resolution.</li>
     * <li>If you specify a resolution that is greater than the resolution of
     * the input file, Elastic Transcoder rescales the output to the higher
     * resolution.</li>
     * <li>We recommend that you specify a resolution for which the product of
     * width and height is less than or equal to the applicable value in the
     * following list (<i>List - Max width x height value</i>):</li>
     * <ul>
     * <li>1 - 25344</li>
     * <li>1b - 25344</li>
     * <li>1.1 - 101376</li>
     * <li>1.2 - 101376</li>
     * <li>1.3 - 101376</li>
     * <li>2 - 101376</li>
     * <li>2.1 - 202752</li>
     * <li>2.2 - 404720</li>
     * <li>3 - 404720</li>
     * <li>3.1 - 921600</li>
     * <li>3.2 - 1310720</li>
     * <li>4 - 2097152</li>
     * <li>4.1 - 2097152</li>
     * </ul>
     * </ul>
     * 
     * @param resolution
     *        <p>
     *        To better control resolution and aspect ratio of output videos, we
     *        recommend that you use the values <code>MaxWidth</code>,
     *        <code>MaxHeight</code>, <code>SizingPolicy</code>,
     *        <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code>
     *        instead of <code>Resolution</code> and <code>AspectRatio</code>.
     *        The two groups of settings are mutually exclusive. Do not use them
     *        together.
     *        </p>
     *        </important>
     *        <p>
     *        The width and height of the video in the output file, in pixels.
     *        Valid values are <code>auto</code> and <i>width</i> x
     *        <i>height</i>:
     *        </p>
     *        <ul>
     *        <li><code>auto</code>: Elastic Transcoder attempts to preserve the
     *        width and height of the input file, subject to the following
     *        rules.</li>
     *        <li><code><i>width</i> x <i>height</i></code>: The width and
     *        height of the output video in pixels.</li>
     *        </ul>
     *        <p>
     *        Note the following about specifying the width and height:
     *        </p>
     *        <ul>
     *        <li>The width must be an even integer between 128 and 4096,
     *        inclusive.</li>
     *        <li>The height must be an even integer between 96 and 3072,
     *        inclusive.</li>
     *        <li>If you specify a resolution that is less than the resolution
     *        of the input file, Elastic Transcoder rescales the output file to
     *        the lower resolution.</li>
     *        <li>If you specify a resolution that is greater than the
     *        resolution of the input file, Elastic Transcoder rescales the
     *        output to the higher resolution.</li>
     *        <li>We recommend that you specify a resolution for which the
     *        product of width and height is less than or equal to the
     *        applicable value in the following list (<i>List - Max width x
     *        height value</i>):</li>
     *        <ul>
     *        <li>1 - 25344</li>
     *        <li>1b - 25344</li>
     *        <li>1.1 - 101376</li>
     *        <li>1.2 - 101376</li>
     *        <li>1.3 - 101376</li>
     *        <li>2 - 101376</li>
     *        <li>2.1 - 202752</li>
     *        <li>2.2 - 404720</li>
     *        <li>3 - 404720</li>
     *        <li>3.1 - 921600</li>
     *        <li>3.2 - 1310720</li>
     *        <li>4 - 2097152</li>
     *        <li>4.1 - 2097152</li>
     *        </ul>
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withResolution(String resolution) {
        setResolution(resolution);
        return this;
    }

    /**
     * <important>
     * <p>
     * To better control resolution and aspect ratio of output videos, we
     * recommend that you use the values <code>MaxWidth</code>,
     * <code>MaxHeight</code>, <code>SizingPolicy</code>,
     * <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code> instead
     * of <code>Resolution</code> and <code>AspectRatio</code>. The two groups
     * of settings are mutually exclusive. Do not use them together.
     * </p>
     * </important>
     * <p>
     * The display aspect ratio of the video in the output file. Valid values
     * include:
     * </p>
     * <p>
     * <code>auto</code>, <code>1:1</code>, <code>4:3</code>, <code>3:2</code>,
     * <code>16:9</code>
     * </p>
     * <p>
     * If you specify <code>auto</code>, Elastic Transcoder tries to preserve
     * the aspect ratio of the input file.
     * </p>
     * <p>
     * If you specify an aspect ratio for the output file that differs from
     * aspect ratio of the input file, Elastic Transcoder adds pillarboxing
     * (black bars on the sides) or letterboxing (black bars on the top and
     * bottom) to maintain the aspect ratio of the active region of the video.
     * </p>
     * 
     * @param aspectRatio
     *        <p>
     *        To better control resolution and aspect ratio of output videos, we
     *        recommend that you use the values <code>MaxWidth</code>,
     *        <code>MaxHeight</code>, <code>SizingPolicy</code>,
     *        <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code>
     *        instead of <code>Resolution</code> and <code>AspectRatio</code>.
     *        The two groups of settings are mutually exclusive. Do not use them
     *        together.
     *        </p>
     *        </important>
     *        <p>
     *        The display aspect ratio of the video in the output file. Valid
     *        values include:
     *        </p>
     *        <p>
     *        <code>auto</code>, <code>1:1</code>, <code>4:3</code>,
     *        <code>3:2</code>, <code>16:9</code>
     *        </p>
     *        <p>
     *        If you specify <code>auto</code>, Elastic Transcoder tries to
     *        preserve the aspect ratio of the input file.
     *        </p>
     *        <p>
     *        If you specify an aspect ratio for the output file that differs
     *        from aspect ratio of the input file, Elastic Transcoder adds
     *        pillarboxing (black bars on the sides) or letterboxing (black bars
     *        on the top and bottom) to maintain the aspect ratio of the active
     *        region of the video.
     */

    public void setAspectRatio(String aspectRatio) {
        this.aspectRatio = aspectRatio;
    }

    /**
     * <important>
     * <p>
     * To better control resolution and aspect ratio of output videos, we
     * recommend that you use the values <code>MaxWidth</code>,
     * <code>MaxHeight</code>, <code>SizingPolicy</code>,
     * <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code> instead
     * of <code>Resolution</code> and <code>AspectRatio</code>. The two groups
     * of settings are mutually exclusive. Do not use them together.
     * </p>
     * </important>
     * <p>
     * The display aspect ratio of the video in the output file. Valid values
     * include:
     * </p>
     * <p>
     * <code>auto</code>, <code>1:1</code>, <code>4:3</code>, <code>3:2</code>,
     * <code>16:9</code>
     * </p>
     * <p>
     * If you specify <code>auto</code>, Elastic Transcoder tries to preserve
     * the aspect ratio of the input file.
     * </p>
     * <p>
     * If you specify an aspect ratio for the output file that differs from
     * aspect ratio of the input file, Elastic Transcoder adds pillarboxing
     * (black bars on the sides) or letterboxing (black bars on the top and
     * bottom) to maintain the aspect ratio of the active region of the video.
     * </p>
     * 
     * @return <p>
     *         To better control resolution and aspect ratio of output videos,
     *         we recommend that you use the values <code>MaxWidth</code>,
     *         <code>MaxHeight</code>, <code>SizingPolicy</code>,
     *         <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code>
     *         instead of <code>Resolution</code> and <code>AspectRatio</code>.
     *         The two groups of settings are mutually exclusive. Do not use
     *         them together.
     *         </p>
     *         </important>
     *         <p>
     *         The display aspect ratio of the video in the output file. Valid
     *         values include:
     *         </p>
     *         <p>
     *         <code>auto</code>, <code>1:1</code>, <code>4:3</code>,
     *         <code>3:2</code>, <code>16:9</code>
     *         </p>
     *         <p>
     *         If you specify <code>auto</code>, Elastic Transcoder tries to
     *         preserve the aspect ratio of the input file.
     *         </p>
     *         <p>
     *         If you specify an aspect ratio for the output file that differs
     *         from aspect ratio of the input file, Elastic Transcoder adds
     *         pillarboxing (black bars on the sides) or letterboxing (black
     *         bars on the top and bottom) to maintain the aspect ratio of the
     *         active region of the video.
     */

    public String getAspectRatio() {
        return this.aspectRatio;
    }

    /**
     * <important>
     * <p>
     * To better control resolution and aspect ratio of output videos, we
     * recommend that you use the values <code>MaxWidth</code>,
     * <code>MaxHeight</code>, <code>SizingPolicy</code>,
     * <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code> instead
     * of <code>Resolution</code> and <code>AspectRatio</code>. The two groups
     * of settings are mutually exclusive. Do not use them together.
     * </p>
     * </important>
     * <p>
     * The display aspect ratio of the video in the output file. Valid values
     * include:
     * </p>
     * <p>
     * <code>auto</code>, <code>1:1</code>, <code>4:3</code>, <code>3:2</code>,
     * <code>16:9</code>
     * </p>
     * <p>
     * If you specify <code>auto</code>, Elastic Transcoder tries to preserve
     * the aspect ratio of the input file.
     * </p>
     * <p>
     * If you specify an aspect ratio for the output file that differs from
     * aspect ratio of the input file, Elastic Transcoder adds pillarboxing
     * (black bars on the sides) or letterboxing (black bars on the top and
     * bottom) to maintain the aspect ratio of the active region of the video.
     * </p>
     * 
     * @param aspectRatio
     *        <p>
     *        To better control resolution and aspect ratio of output videos, we
     *        recommend that you use the values <code>MaxWidth</code>,
     *        <code>MaxHeight</code>, <code>SizingPolicy</code>,
     *        <code>PaddingPolicy</code>, and <code>DisplayAspectRatio</code>
     *        instead of <code>Resolution</code> and <code>AspectRatio</code>.
     *        The two groups of settings are mutually exclusive. Do not use them
     *        together.
     *        </p>
     *        </important>
     *        <p>
     *        The display aspect ratio of the video in the output file. Valid
     *        values include:
     *        </p>
     *        <p>
     *        <code>auto</code>, <code>1:1</code>, <code>4:3</code>,
     *        <code>3:2</code>, <code>16:9</code>
     *        </p>
     *        <p>
     *        If you specify <code>auto</code>, Elastic Transcoder tries to
     *        preserve the aspect ratio of the input file.
     *        </p>
     *        <p>
     *        If you specify an aspect ratio for the output file that differs
     *        from aspect ratio of the input file, Elastic Transcoder adds
     *        pillarboxing (black bars on the sides) or letterboxing (black bars
     *        on the top and bottom) to maintain the aspect ratio of the active
     *        region of the video.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withAspectRatio(String aspectRatio) {
        setAspectRatio(aspectRatio);
        return this;
    }

    /**
     * <p>
     * The maximum width of the output video in pixels. If you specify
     * <code>auto</code>, Elastic Transcoder uses 1920 (Full HD) as the default
     * value. If you specify a numeric value, enter an even integer between 128
     * and 4096.
     * </p>
     * 
     * @param maxWidth
     *        The maximum width of the output video in pixels. If you specify
     *        <code>auto</code>, Elastic Transcoder uses 1920 (Full HD) as the
     *        default value. If you specify a numeric value, enter an even
     *        integer between 128 and 4096.
     */

    public void setMaxWidth(String maxWidth) {
        this.maxWidth = maxWidth;
    }

    /**
     * <p>
     * The maximum width of the output video in pixels. If you specify
     * <code>auto</code>, Elastic Transcoder uses 1920 (Full HD) as the default
     * value. If you specify a numeric value, enter an even integer between 128
     * and 4096.
     * </p>
     * 
     * @return The maximum width of the output video in pixels. If you specify
     *         <code>auto</code>, Elastic Transcoder uses 1920 (Full HD) as the
     *         default value. If you specify a numeric value, enter an even
     *         integer between 128 and 4096.
     */

    public String getMaxWidth() {
        return this.maxWidth;
    }

    /**
     * <p>
     * The maximum width of the output video in pixels. If you specify
     * <code>auto</code>, Elastic Transcoder uses 1920 (Full HD) as the default
     * value. If you specify a numeric value, enter an even integer between 128
     * and 4096.
     * </p>
     * 
     * @param maxWidth
     *        The maximum width of the output video in pixels. If you specify
     *        <code>auto</code>, Elastic Transcoder uses 1920 (Full HD) as the
     *        default value. If you specify a numeric value, enter an even
     *        integer between 128 and 4096.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withMaxWidth(String maxWidth) {
        setMaxWidth(maxWidth);
        return this;
    }

    /**
     * <p>
     * The maximum height of the output video in pixels. If you specify
     * <code>auto</code>, Elastic Transcoder uses 1080 (Full HD) as the default
     * value. If you specify a numeric value, enter an even integer between 96
     * and 3072.
     * </p>
     * 
     * @param maxHeight
     *        The maximum height of the output video in pixels. If you specify
     *        <code>auto</code>, Elastic Transcoder uses 1080 (Full HD) as the
     *        default value. If you specify a numeric value, enter an even
     *        integer between 96 and 3072.
     */

    public void setMaxHeight(String maxHeight) {
        this.maxHeight = maxHeight;
    }

    /**
     * <p>
     * The maximum height of the output video in pixels. If you specify
     * <code>auto</code>, Elastic Transcoder uses 1080 (Full HD) as the default
     * value. If you specify a numeric value, enter an even integer between 96
     * and 3072.
     * </p>
     * 
     * @return The maximum height of the output video in pixels. If you specify
     *         <code>auto</code>, Elastic Transcoder uses 1080 (Full HD) as the
     *         default value. If you specify a numeric value, enter an even
     *         integer between 96 and 3072.
     */

    public String getMaxHeight() {
        return this.maxHeight;
    }

    /**
     * <p>
     * The maximum height of the output video in pixels. If you specify
     * <code>auto</code>, Elastic Transcoder uses 1080 (Full HD) as the default
     * value. If you specify a numeric value, enter an even integer between 96
     * and 3072.
     * </p>
     * 
     * @param maxHeight
     *        The maximum height of the output video in pixels. If you specify
     *        <code>auto</code>, Elastic Transcoder uses 1080 (Full HD) as the
     *        default value. If you specify a numeric value, enter an even
     *        integer between 96 and 3072.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withMaxHeight(String maxHeight) {
        setMaxHeight(maxHeight);
        return this;
    }

    /**
     * <p>
     * The value that Elastic Transcoder adds to the metadata in the output
     * file.
     * </p>
     * 
     * @param displayAspectRatio
     *        The value that Elastic Transcoder adds to the metadata in the
     *        output file.
     */

    public void setDisplayAspectRatio(String displayAspectRatio) {
        this.displayAspectRatio = displayAspectRatio;
    }

    /**
     * <p>
     * The value that Elastic Transcoder adds to the metadata in the output
     * file.
     * </p>
     * 
     * @return The value that Elastic Transcoder adds to the metadata in the
     *         output file.
     */

    public String getDisplayAspectRatio() {
        return this.displayAspectRatio;
    }

    /**
     * <p>
     * The value that Elastic Transcoder adds to the metadata in the output
     * file.
     * </p>
     * 
     * @param displayAspectRatio
     *        The value that Elastic Transcoder adds to the metadata in the
     *        output file.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withDisplayAspectRatio(String displayAspectRatio) {
        setDisplayAspectRatio(displayAspectRatio);
        return this;
    }

    /**
     * <p>
     * Specify one of the following values to control scaling of the output
     * video:
     * </p>
     * <p>
     * <ul>
     * <li><code>Fit</code>: Elastic Transcoder scales the output video so it
     * matches the value that you specified in either <code>MaxWidth</code> or
     * <code>MaxHeight</code> without exceeding the other value.</li>
     * <li><code>Fill</code>: Elastic Transcoder scales the output video so it
     * matches the value that you specified in either <code>MaxWidth</code> or
     * <code>MaxHeight</code> and matches or exceeds the other value. Elastic
     * Transcoder centers the output video and then crops it in the dimension
     * (if any) that exceeds the maximum value.</li>
     * <li><code>Stretch</code>: Elastic Transcoder stretches the output video
     * to match the values that you specified for <code>MaxWidth</code> and
     * <code>MaxHeight</code>. If the relative proportions of the input video
     * and the output video are different, the output video will be distorted.</li>
     * <li><code>Keep</code>: Elastic Transcoder does not scale the output
     * video. If either dimension of the input video exceeds the values that you
     * specified for <code>MaxWidth</code> and <code>MaxHeight</code>, Elastic
     * Transcoder crops the output video.</li>
     * <li><code>ShrinkToFit</code>: Elastic Transcoder scales the output video
     * down so that its dimensions match the values that you specified for at
     * least one of <code>MaxWidth</code> and <code>MaxHeight</code> without
     * exceeding either value. If you specify this option, Elastic Transcoder
     * does not scale the video up.</li>
     * <li><code>ShrinkToFill</code>: Elastic Transcoder scales the output video
     * down so that its dimensions match the values that you specified for at
     * least one of <code>MaxWidth</code> and <code>MaxHeight</code> without
     * dropping below either value. If you specify this option, Elastic
     * Transcoder does not scale the video up.</li>
     * </ul>
     * </p>
     * 
     * @param sizingPolicy
     *        Specify one of the following values to control scaling of the
     *        output video:</p>
     *        <p>
     *        <ul>
     *        <li><code>Fit</code>: Elastic Transcoder scales the output video
     *        so it matches the value that you specified in either
     *        <code>MaxWidth</code> or <code>MaxHeight</code> without exceeding
     *        the other value.</li>
     *        <li><code>Fill</code>: Elastic Transcoder scales the output video
     *        so it matches the value that you specified in either
     *        <code>MaxWidth</code> or <code>MaxHeight</code> and matches or
     *        exceeds the other value. Elastic Transcoder centers the output
     *        video and then crops it in the dimension (if any) that exceeds the
     *        maximum value.</li>
     *        <li><code>Stretch</code>: Elastic Transcoder stretches the output
     *        video to match the values that you specified for
     *        <code>MaxWidth</code> and <code>MaxHeight</code>. If the relative
     *        proportions of the input video and the output video are different,
     *        the output video will be distorted.</li>
     *        <li><code>Keep</code>: Elastic Transcoder does not scale the
     *        output video. If either dimension of the input video exceeds the
     *        values that you specified for <code>MaxWidth</code> and
     *        <code>MaxHeight</code>, Elastic Transcoder crops the output video.
     *        </li>
     *        <li><code>ShrinkToFit</code>: Elastic Transcoder scales the output
     *        video down so that its dimensions match the values that you
     *        specified for at least one of <code>MaxWidth</code> and
     *        <code>MaxHeight</code> without exceeding either value. If you
     *        specify this option, Elastic Transcoder does not scale the video
     *        up.</li>
     *        <li><code>ShrinkToFill</code>: Elastic Transcoder scales the
     *        output video down so that its dimensions match the values that you
     *        specified for at least one of <code>MaxWidth</code> and
     *        <code>MaxHeight</code> without dropping below either value. If you
     *        specify this option, Elastic Transcoder does not scale the video
     *        up.</li>
     *        </ul>
     */

    public void setSizingPolicy(String sizingPolicy) {
        this.sizingPolicy = sizingPolicy;
    }

    /**
     * <p>
     * Specify one of the following values to control scaling of the output
     * video:
     * </p>
     * <p>
     * <ul>
     * <li><code>Fit</code>: Elastic Transcoder scales the output video so it
     * matches the value that you specified in either <code>MaxWidth</code> or
     * <code>MaxHeight</code> without exceeding the other value.</li>
     * <li><code>Fill</code>: Elastic Transcoder scales the output video so it
     * matches the value that you specified in either <code>MaxWidth</code> or
     * <code>MaxHeight</code> and matches or exceeds the other value. Elastic
     * Transcoder centers the output video and then crops it in the dimension
     * (if any) that exceeds the maximum value.</li>
     * <li><code>Stretch</code>: Elastic Transcoder stretches the output video
     * to match the values that you specified for <code>MaxWidth</code> and
     * <code>MaxHeight</code>. If the relative proportions of the input video
     * and the output video are different, the output video will be distorted.</li>
     * <li><code>Keep</code>: Elastic Transcoder does not scale the output
     * video. If either dimension of the input video exceeds the values that you
     * specified for <code>MaxWidth</code> and <code>MaxHeight</code>, Elastic
     * Transcoder crops the output video.</li>
     * <li><code>ShrinkToFit</code>: Elastic Transcoder scales the output video
     * down so that its dimensions match the values that you specified for at
     * least one of <code>MaxWidth</code> and <code>MaxHeight</code> without
     * exceeding either value. If you specify this option, Elastic Transcoder
     * does not scale the video up.</li>
     * <li><code>ShrinkToFill</code>: Elastic Transcoder scales the output video
     * down so that its dimensions match the values that you specified for at
     * least one of <code>MaxWidth</code> and <code>MaxHeight</code> without
     * dropping below either value. If you specify this option, Elastic
     * Transcoder does not scale the video up.</li>
     * </ul>
     * </p>
     * 
     * @return Specify one of the following values to control scaling of the
     *         output video:</p>
     *         <p>
     *         <ul>
     *         <li><code>Fit</code>: Elastic Transcoder scales the output video
     *         so it matches the value that you specified in either
     *         <code>MaxWidth</code> or <code>MaxHeight</code> without exceeding
     *         the other value.</li>
     *         <li><code>Fill</code>: Elastic Transcoder scales the output video
     *         so it matches the value that you specified in either
     *         <code>MaxWidth</code> or <code>MaxHeight</code> and matches or
     *         exceeds the other value. Elastic Transcoder centers the output
     *         video and then crops it in the dimension (if any) that exceeds
     *         the maximum value.</li>
     *         <li><code>Stretch</code>: Elastic Transcoder stretches the output
     *         video to match the values that you specified for
     *         <code>MaxWidth</code> and <code>MaxHeight</code>. If the relative
     *         proportions of the input video and the output video are
     *         different, the output video will be distorted.</li>
     *         <li><code>Keep</code>: Elastic Transcoder does not scale the
     *         output video. If either dimension of the input video exceeds the
     *         values that you specified for <code>MaxWidth</code> and
     *         <code>MaxHeight</code>, Elastic Transcoder crops the output
     *         video.</li>
     *         <li><code>ShrinkToFit</code>: Elastic Transcoder scales the
     *         output video down so that its dimensions match the values that
     *         you specified for at least one of <code>MaxWidth</code> and
     *         <code>MaxHeight</code> without exceeding either value. If you
     *         specify this option, Elastic Transcoder does not scale the video
     *         up.</li>
     *         <li><code>ShrinkToFill</code>: Elastic Transcoder scales the
     *         output video down so that its dimensions match the values that
     *         you specified for at least one of <code>MaxWidth</code> and
     *         <code>MaxHeight</code> without dropping below either value. If
     *         you specify this option, Elastic Transcoder does not scale the
     *         video up.</li>
     *         </ul>
     */

    public String getSizingPolicy() {
        return this.sizingPolicy;
    }

    /**
     * <p>
     * Specify one of the following values to control scaling of the output
     * video:
     * </p>
     * <p>
     * <ul>
     * <li><code>Fit</code>: Elastic Transcoder scales the output video so it
     * matches the value that you specified in either <code>MaxWidth</code> or
     * <code>MaxHeight</code> without exceeding the other value.</li>
     * <li><code>Fill</code>: Elastic Transcoder scales the output video so it
     * matches the value that you specified in either <code>MaxWidth</code> or
     * <code>MaxHeight</code> and matches or exceeds the other value. Elastic
     * Transcoder centers the output video and then crops it in the dimension
     * (if any) that exceeds the maximum value.</li>
     * <li><code>Stretch</code>: Elastic Transcoder stretches the output video
     * to match the values that you specified for <code>MaxWidth</code> and
     * <code>MaxHeight</code>. If the relative proportions of the input video
     * and the output video are different, the output video will be distorted.</li>
     * <li><code>Keep</code>: Elastic Transcoder does not scale the output
     * video. If either dimension of the input video exceeds the values that you
     * specified for <code>MaxWidth</code> and <code>MaxHeight</code>, Elastic
     * Transcoder crops the output video.</li>
     * <li><code>ShrinkToFit</code>: Elastic Transcoder scales the output video
     * down so that its dimensions match the values that you specified for at
     * least one of <code>MaxWidth</code> and <code>MaxHeight</code> without
     * exceeding either value. If you specify this option, Elastic Transcoder
     * does not scale the video up.</li>
     * <li><code>ShrinkToFill</code>: Elastic Transcoder scales the output video
     * down so that its dimensions match the values that you specified for at
     * least one of <code>MaxWidth</code> and <code>MaxHeight</code> without
     * dropping below either value. If you specify this option, Elastic
     * Transcoder does not scale the video up.</li>
     * </ul>
     * </p>
     * 
     * @param sizingPolicy
     *        Specify one of the following values to control scaling of the
     *        output video:</p>
     *        <p>
     *        <ul>
     *        <li><code>Fit</code>: Elastic Transcoder scales the output video
     *        so it matches the value that you specified in either
     *        <code>MaxWidth</code> or <code>MaxHeight</code> without exceeding
     *        the other value.</li>
     *        <li><code>Fill</code>: Elastic Transcoder scales the output video
     *        so it matches the value that you specified in either
     *        <code>MaxWidth</code> or <code>MaxHeight</code> and matches or
     *        exceeds the other value. Elastic Transcoder centers the output
     *        video and then crops it in the dimension (if any) that exceeds the
     *        maximum value.</li>
     *        <li><code>Stretch</code>: Elastic Transcoder stretches the output
     *        video to match the values that you specified for
     *        <code>MaxWidth</code> and <code>MaxHeight</code>. If the relative
     *        proportions of the input video and the output video are different,
     *        the output video will be distorted.</li>
     *        <li><code>Keep</code>: Elastic Transcoder does not scale the
     *        output video. If either dimension of the input video exceeds the
     *        values that you specified for <code>MaxWidth</code> and
     *        <code>MaxHeight</code>, Elastic Transcoder crops the output video.
     *        </li>
     *        <li><code>ShrinkToFit</code>: Elastic Transcoder scales the output
     *        video down so that its dimensions match the values that you
     *        specified for at least one of <code>MaxWidth</code> and
     *        <code>MaxHeight</code> without exceeding either value. If you
     *        specify this option, Elastic Transcoder does not scale the video
     *        up.</li>
     *        <li><code>ShrinkToFill</code>: Elastic Transcoder scales the
     *        output video down so that its dimensions match the values that you
     *        specified for at least one of <code>MaxWidth</code> and
     *        <code>MaxHeight</code> without dropping below either value. If you
     *        specify this option, Elastic Transcoder does not scale the video
     *        up.</li>
     *        </ul>
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withSizingPolicy(String sizingPolicy) {
        setSizingPolicy(sizingPolicy);
        return this;
    }

    /**
     * <p>
     * When you set <code>PaddingPolicy</code> to <code>Pad</code>, Elastic
     * Transcoder may add black bars to the top and bottom and/or left and right
     * sides of the output video to make the total size of the output video
     * match the values that you specified for <code>MaxWidth</code> and
     * <code>MaxHeight</code>.
     * </p>
     * 
     * @param paddingPolicy
     *        When you set <code>PaddingPolicy</code> to <code>Pad</code>,
     *        Elastic Transcoder may add black bars to the top and bottom and/or
     *        left and right sides of the output video to make the total size of
     *        the output video match the values that you specified for
     *        <code>MaxWidth</code> and <code>MaxHeight</code>.
     */

    public void setPaddingPolicy(String paddingPolicy) {
        this.paddingPolicy = paddingPolicy;
    }

    /**
     * <p>
     * When you set <code>PaddingPolicy</code> to <code>Pad</code>, Elastic
     * Transcoder may add black bars to the top and bottom and/or left and right
     * sides of the output video to make the total size of the output video
     * match the values that you specified for <code>MaxWidth</code> and
     * <code>MaxHeight</code>.
     * </p>
     * 
     * @return When you set <code>PaddingPolicy</code> to <code>Pad</code>,
     *         Elastic Transcoder may add black bars to the top and bottom
     *         and/or left and right sides of the output video to make the total
     *         size of the output video match the values that you specified for
     *         <code>MaxWidth</code> and <code>MaxHeight</code>.
     */

    public String getPaddingPolicy() {
        return this.paddingPolicy;
    }

    /**
     * <p>
     * When you set <code>PaddingPolicy</code> to <code>Pad</code>, Elastic
     * Transcoder may add black bars to the top and bottom and/or left and right
     * sides of the output video to make the total size of the output video
     * match the values that you specified for <code>MaxWidth</code> and
     * <code>MaxHeight</code>.
     * </p>
     * 
     * @param paddingPolicy
     *        When you set <code>PaddingPolicy</code> to <code>Pad</code>,
     *        Elastic Transcoder may add black bars to the top and bottom and/or
     *        left and right sides of the output video to make the total size of
     *        the output video match the values that you specified for
     *        <code>MaxWidth</code> and <code>MaxHeight</code>.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withPaddingPolicy(String paddingPolicy) {
        setPaddingPolicy(paddingPolicy);
        return this;
    }

    /**
     * <p>
     * Settings for the size, location, and opacity of graphics that you want
     * Elastic Transcoder to overlay over videos that are transcoded using this
     * preset. You can specify settings for up to four watermarks. Watermarks
     * appear in the specified size and location, and with the specified opacity
     * for the duration of the transcoded video.
     * </p>
     * <p>
     * Watermarks can be in .png or .jpg format. If you want to display a
     * watermark that is not rectangular, use the .png format, which supports
     * transparency.
     * </p>
     * <p>
     * When you create a job that uses this preset, you specify the .png or .jpg
     * graphics that you want Elastic Transcoder to include in the transcoded
     * videos. You can specify fewer graphics in the job than you specify
     * watermark settings in the preset, which allows you to use the same preset
     * for up to four watermarks that have different dimensions.
     * </p>
     * 
     * @return Settings for the size, location, and opacity of graphics that you
     *         want Elastic Transcoder to overlay over videos that are
     *         transcoded using this preset. You can specify settings for up to
     *         four watermarks. Watermarks appear in the specified size and
     *         location, and with the specified opacity for the duration of the
     *         transcoded video.</p>
     *         <p>
     *         Watermarks can be in .png or .jpg format. If you want to display
     *         a watermark that is not rectangular, use the .png format, which
     *         supports transparency.
     *         </p>
     *         <p>
     *         When you create a job that uses this preset, you specify the .png
     *         or .jpg graphics that you want Elastic Transcoder to include in
     *         the transcoded videos. You can specify fewer graphics in the job
     *         than you specify watermark settings in the preset, which allows
     *         you to use the same preset for up to four watermarks that have
     *         different dimensions.
     */

    public java.util.List<PresetWatermark> getWatermarks() {
        if (watermarks == null) {
            watermarks = new com.amazonaws.internal.SdkInternalList<PresetWatermark>();
        }
        return watermarks;
    }

    /**
     * <p>
     * Settings for the size, location, and opacity of graphics that you want
     * Elastic Transcoder to overlay over videos that are transcoded using this
     * preset. You can specify settings for up to four watermarks. Watermarks
     * appear in the specified size and location, and with the specified opacity
     * for the duration of the transcoded video.
     * </p>
     * <p>
     * Watermarks can be in .png or .jpg format. If you want to display a
     * watermark that is not rectangular, use the .png format, which supports
     * transparency.
     * </p>
     * <p>
     * When you create a job that uses this preset, you specify the .png or .jpg
     * graphics that you want Elastic Transcoder to include in the transcoded
     * videos. You can specify fewer graphics in the job than you specify
     * watermark settings in the preset, which allows you to use the same preset
     * for up to four watermarks that have different dimensions.
     * </p>
     * 
     * @param watermarks
     *        Settings for the size, location, and opacity of graphics that you
     *        want Elastic Transcoder to overlay over videos that are transcoded
     *        using this preset. You can specify settings for up to four
     *        watermarks. Watermarks appear in the specified size and location,
     *        and with the specified opacity for the duration of the transcoded
     *        video.</p>
     *        <p>
     *        Watermarks can be in .png or .jpg format. If you want to display a
     *        watermark that is not rectangular, use the .png format, which
     *        supports transparency.
     *        </p>
     *        <p>
     *        When you create a job that uses this preset, you specify the .png
     *        or .jpg graphics that you want Elastic Transcoder to include in
     *        the transcoded videos. You can specify fewer graphics in the job
     *        than you specify watermark settings in the preset, which allows
     *        you to use the same preset for up to four watermarks that have
     *        different dimensions.
     */

    public void setWatermarks(java.util.Collection<PresetWatermark> watermarks) {
        if (watermarks == null) {
            this.watermarks = null;
            return;
        }

        this.watermarks = new com.amazonaws.internal.SdkInternalList<PresetWatermark>(
                watermarks);
    }

    /**
     * <p>
     * Settings for the size, location, and opacity of graphics that you want
     * Elastic Transcoder to overlay over videos that are transcoded using this
     * preset. You can specify settings for up to four watermarks. Watermarks
     * appear in the specified size and location, and with the specified opacity
     * for the duration of the transcoded video.
     * </p>
     * <p>
     * Watermarks can be in .png or .jpg format. If you want to display a
     * watermark that is not rectangular, use the .png format, which supports
     * transparency.
     * </p>
     * <p>
     * When you create a job that uses this preset, you specify the .png or .jpg
     * graphics that you want Elastic Transcoder to include in the transcoded
     * videos. You can specify fewer graphics in the job than you specify
     * watermark settings in the preset, which allows you to use the same preset
     * for up to four watermarks that have different dimensions.
     * </p>
     * <p>
     * <b>NOTE:</b> This method appends the values to the existing list (if
     * any). Use {@link #setWatermarks(java.util.Collection)} or
     * {@link #withWatermarks(java.util.Collection)} if you want to override the
     * existing values.
     * </p>
     * 
     * @param watermarks
     *        Settings for the size, location, and opacity of graphics that you
     *        want Elastic Transcoder to overlay over videos that are transcoded
     *        using this preset. You can specify settings for up to four
     *        watermarks. Watermarks appear in the specified size and location,
     *        and with the specified opacity for the duration of the transcoded
     *        video.</p>
     *        <p>
     *        Watermarks can be in .png or .jpg format. If you want to display a
     *        watermark that is not rectangular, use the .png format, which
     *        supports transparency.
     *        </p>
     *        <p>
     *        When you create a job that uses this preset, you specify the .png
     *        or .jpg graphics that you want Elastic Transcoder to include in
     *        the transcoded videos. You can specify fewer graphics in the job
     *        than you specify watermark settings in the preset, which allows
     *        you to use the same preset for up to four watermarks that have
     *        different dimensions.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withWatermarks(PresetWatermark... watermarks) {
        if (this.watermarks == null) {
            setWatermarks(new com.amazonaws.internal.SdkInternalList<PresetWatermark>(
                    watermarks.length));
        }
        for (PresetWatermark ele : watermarks) {
            this.watermarks.add(ele);
        }
        return this;
    }

    /**
     * <p>
     * Settings for the size, location, and opacity of graphics that you want
     * Elastic Transcoder to overlay over videos that are transcoded using this
     * preset. You can specify settings for up to four watermarks. Watermarks
     * appear in the specified size and location, and with the specified opacity
     * for the duration of the transcoded video.
     * </p>
     * <p>
     * Watermarks can be in .png or .jpg format. If you want to display a
     * watermark that is not rectangular, use the .png format, which supports
     * transparency.
     * </p>
     * <p>
     * When you create a job that uses this preset, you specify the .png or .jpg
     * graphics that you want Elastic Transcoder to include in the transcoded
     * videos. You can specify fewer graphics in the job than you specify
     * watermark settings in the preset, which allows you to use the same preset
     * for up to four watermarks that have different dimensions.
     * </p>
     * 
     * @param watermarks
     *        Settings for the size, location, and opacity of graphics that you
     *        want Elastic Transcoder to overlay over videos that are transcoded
     *        using this preset. You can specify settings for up to four
     *        watermarks. Watermarks appear in the specified size and location,
     *        and with the specified opacity for the duration of the transcoded
     *        video.</p>
     *        <p>
     *        Watermarks can be in .png or .jpg format. If you want to display a
     *        watermark that is not rectangular, use the .png format, which
     *        supports transparency.
     *        </p>
     *        <p>
     *        When you create a job that uses this preset, you specify the .png
     *        or .jpg graphics that you want Elastic Transcoder to include in
     *        the transcoded videos. You can specify fewer graphics in the job
     *        than you specify watermark settings in the preset, which allows
     *        you to use the same preset for up to four watermarks that have
     *        different dimensions.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public VideoParameters withWatermarks(
            java.util.Collection<PresetWatermark> watermarks) {
        setWatermarks(watermarks);
        return this;
    }

    /**
     * Returns a string representation of this object; useful for testing and
     * debugging.
     *
     * @return A string representation of this object.
     *
     * @see java.lang.Object#toString()
     */
    @Override
    public String toString() {
        StringBuilder sb = new StringBuilder();
        sb.append("{");
        if (getCodec() != null)
            sb.append("Codec: " + getCodec() + ",");
        if (getCodecOptions() != null)
            sb.append("CodecOptions: " + getCodecOptions() + ",");
        if (getKeyframesMaxDist() != null)
            sb.append("KeyframesMaxDist: " + getKeyframesMaxDist() + ",");
        if (getFixedGOP() != null)
            sb.append("FixedGOP: " + getFixedGOP() + ",");
        if (getBitRate() != null)
            sb.append("BitRate: " + getBitRate() + ",");
        if (getFrameRate() != null)
            sb.append("FrameRate: " + getFrameRate() + ",");
        if (getMaxFrameRate() != null)
            sb.append("MaxFrameRate: " + getMaxFrameRate() + ",");
        if (getResolution() != null)
            sb.append("Resolution: " + getResolution() + ",");
        if (getAspectRatio() != null)
            sb.append("AspectRatio: " + getAspectRatio() + ",");
        if (getMaxWidth() != null)
            sb.append("MaxWidth: " + getMaxWidth() + ",");
        if (getMaxHeight() != null)
            sb.append("MaxHeight: " + getMaxHeight() + ",");
        if (getDisplayAspectRatio() != null)
            sb.append("DisplayAspectRatio: " + getDisplayAspectRatio() + ",");
        if (getSizingPolicy() != null)
            sb.append("SizingPolicy: " + getSizingPolicy() + ",");
        if (getPaddingPolicy() != null)
            sb.append("PaddingPolicy: " + getPaddingPolicy() + ",");
        if (getWatermarks() != null)
            sb.append("Watermarks: " + getWatermarks());
        sb.append("}");
        return sb.toString();
    }

    @Override
    public boolean equals(Object obj) {
        if (this == obj)
            return true;
        if (obj == null)
            return false;

        if (obj instanceof VideoParameters == false)
            return false;
        VideoParameters other = (VideoParameters) obj;
        if (other.getCodec() == null ^ this.getCodec() == null)
            return false;
        if (other.getCodec() != null
                && other.getCodec().equals(this.getCodec()) == false)
            return false;
        if (other.getCodecOptions() == null ^ this.getCodecOptions() == null)
            return false;
        if (other.getCodecOptions() != null
                && other.getCodecOptions().equals(this.getCodecOptions()) == false)
            return false;
        if (other.getKeyframesMaxDist() == null
                ^ this.getKeyframesMaxDist() == null)
            return false;
        if (other.getKeyframesMaxDist() != null
                && other.getKeyframesMaxDist().equals(
                        this.getKeyframesMaxDist()) == false)
            return false;
        if (other.getFixedGOP() == null ^ this.getFixedGOP() == null)
            return false;
        if (other.getFixedGOP() != null
                && other.getFixedGOP().equals(this.getFixedGOP()) == false)
            return false;
        if (other.getBitRate() == null ^ this.getBitRate() == null)
            return false;
        if (other.getBitRate() != null
                && other.getBitRate().equals(this.getBitRate()) == false)
            return false;
        if (other.getFrameRate() == null ^ this.getFrameRate() == null)
            return false;
        if (other.getFrameRate() != null
                && other.getFrameRate().equals(this.getFrameRate()) == false)
            return false;
        if (other.getMaxFrameRate() == null ^ this.getMaxFrameRate() == null)
            return false;
        if (other.getMaxFrameRate() != null
                && other.getMaxFrameRate().equals(this.getMaxFrameRate()) == false)
            return false;
        if (other.getResolution() == null ^ this.getResolution() == null)
            return false;
        if (other.getResolution() != null
                && other.getResolution().equals(this.getResolution()) == false)
            return false;
        if (other.getAspectRatio() == null ^ this.getAspectRatio() == null)
            return false;
        if (other.getAspectRatio() != null
                && other.getAspectRatio().equals(this.getAspectRatio()) == false)
            return false;
        if (other.getMaxWidth() == null ^ this.getMaxWidth() == null)
            return false;
        if (other.getMaxWidth() != null
                && other.getMaxWidth().equals(this.getMaxWidth()) == false)
            return false;
        if (other.getMaxHeight() == null ^ this.getMaxHeight() == null)
            return false;
        if (other.getMaxHeight() != null
                && other.getMaxHeight().equals(this.getMaxHeight()) == false)
            return false;
        if (other.getDisplayAspectRatio() == null
                ^ this.getDisplayAspectRatio() == null)
            return false;
        if (other.getDisplayAspectRatio() != null
                && other.getDisplayAspectRatio().equals(
                        this.getDisplayAspectRatio()) == false)
            return false;
        if (other.getSizingPolicy() == null ^ this.getSizingPolicy() == null)
            return false;
        if (other.getSizingPolicy() != null
                && other.getSizingPolicy().equals(this.getSizingPolicy()) == false)
            return false;
        if (other.getPaddingPolicy() == null ^ this.getPaddingPolicy() == null)
            return false;
        if (other.getPaddingPolicy() != null
                && other.getPaddingPolicy().equals(this.getPaddingPolicy()) == false)
            return false;
        if (other.getWatermarks() == null ^ this.getWatermarks() == null)
            return false;
        if (other.getWatermarks() != null
                && other.getWatermarks().equals(this.getWatermarks()) == false)
            return false;
        return true;
    }

    @Override
    public int hashCode() {
        final int prime = 31;
        int hashCode = 1;

        hashCode = prime * hashCode
                + ((getCodec() == null) ? 0 : getCodec().hashCode());
        hashCode = prime
                * hashCode
                + ((getCodecOptions() == null) ? 0 : getCodecOptions()
                        .hashCode());
        hashCode = prime
                * hashCode
                + ((getKeyframesMaxDist() == null) ? 0 : getKeyframesMaxDist()
                        .hashCode());
        hashCode = prime * hashCode
                + ((getFixedGOP() == null) ? 0 : getFixedGOP().hashCode());
        hashCode = prime * hashCode
                + ((getBitRate() == null) ? 0 : getBitRate().hashCode());
        hashCode = prime * hashCode
                + ((getFrameRate() == null) ? 0 : getFrameRate().hashCode());
        hashCode = prime
                * hashCode
                + ((getMaxFrameRate() == null) ? 0 : getMaxFrameRate()
                        .hashCode());
        hashCode = prime * hashCode
                + ((getResolution() == null) ? 0 : getResolution().hashCode());
        hashCode = prime
                * hashCode
                + ((getAspectRatio() == null) ? 0 : getAspectRatio().hashCode());
        hashCode = prime * hashCode
                + ((getMaxWidth() == null) ? 0 : getMaxWidth().hashCode());
        hashCode = prime * hashCode
                + ((getMaxHeight() == null) ? 0 : getMaxHeight().hashCode());
        hashCode = prime
                * hashCode
                + ((getDisplayAspectRatio() == null) ? 0
                        : getDisplayAspectRatio().hashCode());
        hashCode = prime
                * hashCode
                + ((getSizingPolicy() == null) ? 0 : getSizingPolicy()
                        .hashCode());
        hashCode = prime
                * hashCode
                + ((getPaddingPolicy() == null) ? 0 : getPaddingPolicy()
                        .hashCode());
        hashCode = prime * hashCode
                + ((getWatermarks() == null) ? 0 : getWatermarks().hashCode());
        return hashCode;
    }

    @Override
    public VideoParameters clone() {
        try {
            return (VideoParameters) super.clone();
        } catch (CloneNotSupportedException e) {
            throw new IllegalStateException(
                    "Got a CloneNotSupportedException from Object.clone() "
                            + "even though we're Cloneable!", e);
        }
    }
}