CreateJobOutput.java

/*
 * Copyright 2010-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>CreateJobOutput</code> structure.
 * </p>
 */
public class CreateJobOutput implements Serializable, Cloneable {

    /**
     * <p>
     * The name to assign to the transcoded file. Elastic Transcoder saves the
     * file in the Amazon S3 bucket specified by the <code>OutputBucket</code>
     * object in the pipeline that is specified by the pipeline ID. If a file
     * with the specified name already exists in the output bucket, the job
     * fails.
     * </p>
     */
    private String key;
    /**
     * <p>
     * Whether you want Elastic Transcoder to create thumbnails for your videos
     * and, if so, how you want Elastic Transcoder to name the files.
     * </p>
     * <p>
     * If you don't want Elastic Transcoder to create thumbnails, specify "".
     * </p>
     * <p>
     * If you do want Elastic Transcoder to create thumbnails, specify the
     * information that you want to include in the file name for each thumbnail.
     * You can specify the following values in any sequence:
     * </p>
     * <ul>
     * <li>
     * <p>
     * <b><code>{count}</code> (Required)</b>: If you want to create thumbnails,
     * you must include <code>{count}</code> in the
     * <code>ThumbnailPattern</code> object. Wherever you specify
     * <code>{count}</code>, Elastic Transcoder adds a five-digit sequence
     * number (beginning with <b>00001</b>) to thumbnail file names. The number
     * indicates where a given thumbnail appears in the sequence of thumbnails
     * for a transcoded file.
     * </p>
     * <important>If you specify a literal value and/or
     * <code>{resolution}</code> but you omit <code>{count}</code>, Elastic
     * Transcoder returns a validation error and does not create the
     * job.</important></li>
     * <li>
     * <p>
     * <b>Literal values (Optional)</b>: You can specify literal values anywhere
     * in the <code>ThumbnailPattern</code> object. For example, you can include
     * them as a file name prefix or as a delimiter between
     * <code>{resolution}</code> and <code>{count}</code>.
     * </p>
     * </li>
     * <li>
     * <p>
     * <b><code>{resolution}</code> (Optional)</b>: If you want Elastic
     * Transcoder to include the resolution in the file name, include
     * <code>{resolution}</code> in the <code>ThumbnailPattern</code> object.
     * </p>
     * </li>
     * </ul>
     * <p>
     * When creating thumbnails, Elastic Transcoder automatically saves the
     * files in the format (.jpg or .png) that appears in the preset that you
     * specified in the <code>PresetID</code> value of
     * <code>CreateJobOutput</code>. Elastic Transcoder also appends the
     * applicable file name extension.
     * </p>
     */
    private String thumbnailPattern;
    /**
     * <p>
     * The encryption settings, if any, that you want Elastic Transcoder to
     * apply to your thumbnail.
     * </p>
     */
    private Encryption thumbnailEncryption;
    /**
     * <p>
     * The number of degrees clockwise by which you want Elastic Transcoder to
     * rotate the output relative to the input. Enter one of the following
     * values: <code>auto</code>, <code>0</code>, <code>90</code>,
     * <code>180</code>, <code>270</code>. The value <code>auto</code> generally
     * works only if the file that you're transcoding contains rotation
     * metadata.
     * </p>
     */
    private String rotate;
    /**
     * <p>
     * The <code>Id</code> of the preset to use for this job. The preset
     * determines the audio, video, and thumbnail settings that Elastic
     * Transcoder uses for transcoding.
     * </p>
     */
    private String presetId;
    /**
     * <p>
     * <important>(Outputs in Fragmented MP4 or MPEG-TS format
     * only.</important>If you specify a preset in <code>PresetId</code> for
     * which the value of <code>Container</code> is <code>fmp4</code>
     * (Fragmented MP4) or <code>ts</code> (MPEG-TS),
     * <code>SegmentDuration</code> is the target maximum duration of each
     * segment in seconds. For <code>HLSv3</code> format playlists, each media
     * segment is stored in a separate <code>.ts</code> file. For
     * <code>HLSv4</code> and <code>Smooth</code> playlists, all media segments
     * for an output are stored in a single file. Each segment is approximately
     * the length of the <code>SegmentDuration</code>, though individual
     * segments might be shorter or longer.
     * </p>
     * <p>
     * The range of valid values is 1 to 60 seconds. If the duration of the
     * video is not evenly divisible by <code>SegmentDuration</code>, the
     * duration of the last segment is the remainder of total
     * length/SegmentDuration.
     * </p>
     * <p>
     * Elastic Transcoder creates an output-specific playlist for each output
     * <code>HLS</code> output that you specify in OutputKeys. To add an output
     * to the master playlist for this job, include it in the
     * <code>OutputKeys</code> of the associated playlist.
     * </p>
     */
    private String segmentDuration;
    /**
     * <p>
     * Information about the watermarks that you want Elastic Transcoder to add
     * to the video during transcoding. You can specify up to four watermarks
     * for each output. Settings for each watermark must be defined in the
     * preset for the current output.
     * </p>
     */
    private com.amazonaws.internal.SdkInternalList<JobWatermark> watermarks;
    /**
     * <p>
     * Information about the album art that you want Elastic Transcoder to add
     * to the file during transcoding. You can specify up to twenty album
     * artworks for each output. Settings for each artwork must be defined in
     * the job for the current output.
     * </p>
     */
    private JobAlbumArt albumArt;
    /**
     * <p>
     * You can create an output file that contains an excerpt from the input
     * file. This excerpt, called a clip, can come from the beginning, middle,
     * or end of the file. The Composition object contains settings for the
     * clips that make up an output file. For the current release, you can only
     * specify settings for a single clip per output file. The Composition
     * object cannot be null.
     * </p>
     */
    private com.amazonaws.internal.SdkInternalList<Clip> composition;
    /**
     * <p>
     * You can configure Elastic Transcoder to transcode captions, or subtitles,
     * from one format to another. All captions must be in UTF-8. Elastic
     * Transcoder supports two types of captions:
     * </p>
     * <ul>
     * <li>
     * <p>
     * <b>Embedded:</b> Embedded captions are included in the same file as the
     * audio and video. Elastic Transcoder supports only one embedded caption
     * per language, to a maximum of 300 embedded captions per file.
     * </p>
     * <p>
     * Valid input values include: <code>CEA-608 (EIA-608</code>, first
     * non-empty channel only), <code>CEA-708 (EIA-708</code>, first non-empty
     * channel only), and <code>mov-text</code>
     * </p>
     * <p>
     * Valid outputs include: <code>mov-text</code>
     * </p>
     * <p>
     * Elastic Transcoder supports a maximum of one embedded format per output.
     * </p>
     * </li>
     * <li>
     * <p>
     * <b>Sidecar:</b> Sidecar captions are kept in a separate metadata file
     * from the audio and video data. Sidecar captions require a player that is
     * capable of understanding the relationship between the video file and the
     * sidecar file. Elastic Transcoder supports only one sidecar caption per
     * language, to a maximum of 20 sidecar captions per file.
     * </p>
     * <p>
     * Valid input values include: <code>dfxp</code> (first div element only),
     * <code>ebu-tt</code>, <code>scc</code>, <code>smpt</code>,
     * <code>srt</code>, <code>ttml</code> (first div element only), and
     * <code>webvtt</code>
     * </p>
     * <p>
     * Valid outputs include: <code>dfxp</code> (first div element only),
     * <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.
     * </p>
     * </li>
     * </ul>
     * <p>
     * If you want ttml or smpte-tt compatible captions, specify dfxp as your
     * output format.
     * </p>
     * <p>
     * Elastic Transcoder does not support OCR (Optical Character Recognition),
     * does not accept pictures as a valid input for captions, and is not
     * available for audio-only transcoding. Elastic Transcoder does not
     * preserve text formatting (for example, italics) during the transcoding
     * process.
     * </p>
     * <p>
     * To remove captions or leave the captions empty, set <code>Captions</code>
     * to null. To pass through existing captions unchanged, set the
     * <code>MergePolicy</code> to <code>MergeRetain</code>, and pass in a null
     * <code>CaptionSources</code> array.
     * </p>
     * <p>
     * For more information on embedded files, see the Subtitles Wikipedia page.
     * </p>
     * <p>
     * For more information on sidecar files, see the Extensible Metadata
     * Platform and Sidecar file Wikipedia pages.
     * </p>
     */
    private Captions captions;
    /**
     * <p>
     * You can specify encryption settings for any output files that you want to
     * use for a transcoding job. This includes the output file and any
     * watermarks, thumbnails, album art, or captions that you want to use. You
     * must specify encryption settings for each file individually.
     * </p>
     */
    private Encryption encryption;

    /**
     * <p>
     * The name to assign to the transcoded file. Elastic Transcoder saves the
     * file in the Amazon S3 bucket specified by the <code>OutputBucket</code>
     * object in the pipeline that is specified by the pipeline ID. If a file
     * with the specified name already exists in the output bucket, the job
     * fails.
     * </p>
     * 
     * @param key
     *        The name to assign to the transcoded file. Elastic Transcoder
     *        saves the file in the Amazon S3 bucket specified by the
     *        <code>OutputBucket</code> object in the pipeline that is specified
     *        by the pipeline ID. If a file with the specified name already
     *        exists in the output bucket, the job fails.
     */

    public void setKey(String key) {
        this.key = key;
    }

    /**
     * <p>
     * The name to assign to the transcoded file. Elastic Transcoder saves the
     * file in the Amazon S3 bucket specified by the <code>OutputBucket</code>
     * object in the pipeline that is specified by the pipeline ID. If a file
     * with the specified name already exists in the output bucket, the job
     * fails.
     * </p>
     * 
     * @return The name to assign to the transcoded file. Elastic Transcoder
     *         saves the file in the Amazon S3 bucket specified by the
     *         <code>OutputBucket</code> object in the pipeline that is
     *         specified by the pipeline ID. If a file with the specified name
     *         already exists in the output bucket, the job fails.
     */

    public String getKey() {
        return this.key;
    }

    /**
     * <p>
     * The name to assign to the transcoded file. Elastic Transcoder saves the
     * file in the Amazon S3 bucket specified by the <code>OutputBucket</code>
     * object in the pipeline that is specified by the pipeline ID. If a file
     * with the specified name already exists in the output bucket, the job
     * fails.
     * </p>
     * 
     * @param key
     *        The name to assign to the transcoded file. Elastic Transcoder
     *        saves the file in the Amazon S3 bucket specified by the
     *        <code>OutputBucket</code> object in the pipeline that is specified
     *        by the pipeline ID. If a file with the specified name already
     *        exists in the output bucket, the job fails.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public CreateJobOutput withKey(String key) {
        setKey(key);
        return this;
    }

    /**
     * <p>
     * Whether you want Elastic Transcoder to create thumbnails for your videos
     * and, if so, how you want Elastic Transcoder to name the files.
     * </p>
     * <p>
     * If you don't want Elastic Transcoder to create thumbnails, specify "".
     * </p>
     * <p>
     * If you do want Elastic Transcoder to create thumbnails, specify the
     * information that you want to include in the file name for each thumbnail.
     * You can specify the following values in any sequence:
     * </p>
     * <ul>
     * <li>
     * <p>
     * <b><code>{count}</code> (Required)</b>: If you want to create thumbnails,
     * you must include <code>{count}</code> in the
     * <code>ThumbnailPattern</code> object. Wherever you specify
     * <code>{count}</code>, Elastic Transcoder adds a five-digit sequence
     * number (beginning with <b>00001</b>) to thumbnail file names. The number
     * indicates where a given thumbnail appears in the sequence of thumbnails
     * for a transcoded file.
     * </p>
     * <important>If you specify a literal value and/or
     * <code>{resolution}</code> but you omit <code>{count}</code>, Elastic
     * Transcoder returns a validation error and does not create the
     * job.</important></li>
     * <li>
     * <p>
     * <b>Literal values (Optional)</b>: You can specify literal values anywhere
     * in the <code>ThumbnailPattern</code> object. For example, you can include
     * them as a file name prefix or as a delimiter between
     * <code>{resolution}</code> and <code>{count}</code>.
     * </p>
     * </li>
     * <li>
     * <p>
     * <b><code>{resolution}</code> (Optional)</b>: If you want Elastic
     * Transcoder to include the resolution in the file name, include
     * <code>{resolution}</code> in the <code>ThumbnailPattern</code> object.
     * </p>
     * </li>
     * </ul>
     * <p>
     * When creating thumbnails, Elastic Transcoder automatically saves the
     * files in the format (.jpg or .png) that appears in the preset that you
     * specified in the <code>PresetID</code> value of
     * <code>CreateJobOutput</code>. Elastic Transcoder also appends the
     * applicable file name extension.
     * </p>
     * 
     * @param thumbnailPattern
     *        Whether you want Elastic Transcoder to create thumbnails for your
     *        videos and, if so, how you want Elastic Transcoder to name the
     *        files.</p>
     *        <p>
     *        If you don't want Elastic Transcoder to create thumbnails, specify
     *        "".
     *        </p>
     *        <p>
     *        If you do want Elastic Transcoder to create thumbnails, specify
     *        the information that you want to include in the file name for each
     *        thumbnail. You can specify the following values in any sequence:
     *        </p>
     *        <ul>
     *        <li>
     *        <p>
     *        <b><code>{count}</code> (Required)</b>: If you want to create
     *        thumbnails, you must include <code>{count}</code> in the
     *        <code>ThumbnailPattern</code> object. Wherever you specify
     *        <code>{count}</code>, Elastic Transcoder adds a five-digit
     *        sequence number (beginning with <b>00001</b>) to thumbnail file
     *        names. The number indicates where a given thumbnail appears in the
     *        sequence of thumbnails for a transcoded file.
     *        </p>
     *        <important>If you specify a literal value and/or
     *        <code>{resolution}</code> but you omit <code>{count}</code>,
     *        Elastic Transcoder returns a validation error and does not create
     *        the job.</important></li>
     *        <li>
     *        <p>
     *        <b>Literal values (Optional)</b>: You can specify literal values
     *        anywhere in the <code>ThumbnailPattern</code> object. For example,
     *        you can include them as a file name prefix or as a delimiter
     *        between <code>{resolution}</code> and <code>{count}</code>.
     *        </p>
     *        </li>
     *        <li>
     *        <p>
     *        <b><code>{resolution}</code> (Optional)</b>: If you want Elastic
     *        Transcoder to include the resolution in the file name, include
     *        <code>{resolution}</code> in the <code>ThumbnailPattern</code>
     *        object.
     *        </p>
     *        </li>
     *        </ul>
     *        <p>
     *        When creating thumbnails, Elastic Transcoder automatically saves
     *        the files in the format (.jpg or .png) that appears in the preset
     *        that you specified in the <code>PresetID</code> value of
     *        <code>CreateJobOutput</code>. Elastic Transcoder also appends the
     *        applicable file name extension.
     */

    public void setThumbnailPattern(String thumbnailPattern) {
        this.thumbnailPattern = thumbnailPattern;
    }

    /**
     * <p>
     * Whether you want Elastic Transcoder to create thumbnails for your videos
     * and, if so, how you want Elastic Transcoder to name the files.
     * </p>
     * <p>
     * If you don't want Elastic Transcoder to create thumbnails, specify "".
     * </p>
     * <p>
     * If you do want Elastic Transcoder to create thumbnails, specify the
     * information that you want to include in the file name for each thumbnail.
     * You can specify the following values in any sequence:
     * </p>
     * <ul>
     * <li>
     * <p>
     * <b><code>{count}</code> (Required)</b>: If you want to create thumbnails,
     * you must include <code>{count}</code> in the
     * <code>ThumbnailPattern</code> object. Wherever you specify
     * <code>{count}</code>, Elastic Transcoder adds a five-digit sequence
     * number (beginning with <b>00001</b>) to thumbnail file names. The number
     * indicates where a given thumbnail appears in the sequence of thumbnails
     * for a transcoded file.
     * </p>
     * <important>If you specify a literal value and/or
     * <code>{resolution}</code> but you omit <code>{count}</code>, Elastic
     * Transcoder returns a validation error and does not create the
     * job.</important></li>
     * <li>
     * <p>
     * <b>Literal values (Optional)</b>: You can specify literal values anywhere
     * in the <code>ThumbnailPattern</code> object. For example, you can include
     * them as a file name prefix or as a delimiter between
     * <code>{resolution}</code> and <code>{count}</code>.
     * </p>
     * </li>
     * <li>
     * <p>
     * <b><code>{resolution}</code> (Optional)</b>: If you want Elastic
     * Transcoder to include the resolution in the file name, include
     * <code>{resolution}</code> in the <code>ThumbnailPattern</code> object.
     * </p>
     * </li>
     * </ul>
     * <p>
     * When creating thumbnails, Elastic Transcoder automatically saves the
     * files in the format (.jpg or .png) that appears in the preset that you
     * specified in the <code>PresetID</code> value of
     * <code>CreateJobOutput</code>. Elastic Transcoder also appends the
     * applicable file name extension.
     * </p>
     * 
     * @return Whether you want Elastic Transcoder to create thumbnails for your
     *         videos and, if so, how you want Elastic Transcoder to name the
     *         files.</p>
     *         <p>
     *         If you don't want Elastic Transcoder to create thumbnails,
     *         specify "".
     *         </p>
     *         <p>
     *         If you do want Elastic Transcoder to create thumbnails, specify
     *         the information that you want to include in the file name for
     *         each thumbnail. You can specify the following values in any
     *         sequence:
     *         </p>
     *         <ul>
     *         <li>
     *         <p>
     *         <b><code>{count}</code> (Required)</b>: If you want to create
     *         thumbnails, you must include <code>{count}</code> in the
     *         <code>ThumbnailPattern</code> object. Wherever you specify
     *         <code>{count}</code>, Elastic Transcoder adds a five-digit
     *         sequence number (beginning with <b>00001</b>) to thumbnail file
     *         names. The number indicates where a given thumbnail appears in
     *         the sequence of thumbnails for a transcoded file.
     *         </p>
     *         <important>If you specify a literal value and/or
     *         <code>{resolution}</code> but you omit <code>{count}</code>,
     *         Elastic Transcoder returns a validation error and does not create
     *         the job.</important></li>
     *         <li>
     *         <p>
     *         <b>Literal values (Optional)</b>: You can specify literal values
     *         anywhere in the <code>ThumbnailPattern</code> object. For
     *         example, you can include them as a file name prefix or as a
     *         delimiter between <code>{resolution}</code> and
     *         <code>{count}</code>.
     *         </p>
     *         </li>
     *         <li>
     *         <p>
     *         <b><code>{resolution}</code> (Optional)</b>: If you want Elastic
     *         Transcoder to include the resolution in the file name, include
     *         <code>{resolution}</code> in the <code>ThumbnailPattern</code>
     *         object.
     *         </p>
     *         </li>
     *         </ul>
     *         <p>
     *         When creating thumbnails, Elastic Transcoder automatically saves
     *         the files in the format (.jpg or .png) that appears in the preset
     *         that you specified in the <code>PresetID</code> value of
     *         <code>CreateJobOutput</code>. Elastic Transcoder also appends the
     *         applicable file name extension.
     */

    public String getThumbnailPattern() {
        return this.thumbnailPattern;
    }

    /**
     * <p>
     * Whether you want Elastic Transcoder to create thumbnails for your videos
     * and, if so, how you want Elastic Transcoder to name the files.
     * </p>
     * <p>
     * If you don't want Elastic Transcoder to create thumbnails, specify "".
     * </p>
     * <p>
     * If you do want Elastic Transcoder to create thumbnails, specify the
     * information that you want to include in the file name for each thumbnail.
     * You can specify the following values in any sequence:
     * </p>
     * <ul>
     * <li>
     * <p>
     * <b><code>{count}</code> (Required)</b>: If you want to create thumbnails,
     * you must include <code>{count}</code> in the
     * <code>ThumbnailPattern</code> object. Wherever you specify
     * <code>{count}</code>, Elastic Transcoder adds a five-digit sequence
     * number (beginning with <b>00001</b>) to thumbnail file names. The number
     * indicates where a given thumbnail appears in the sequence of thumbnails
     * for a transcoded file.
     * </p>
     * <important>If you specify a literal value and/or
     * <code>{resolution}</code> but you omit <code>{count}</code>, Elastic
     * Transcoder returns a validation error and does not create the
     * job.</important></li>
     * <li>
     * <p>
     * <b>Literal values (Optional)</b>: You can specify literal values anywhere
     * in the <code>ThumbnailPattern</code> object. For example, you can include
     * them as a file name prefix or as a delimiter between
     * <code>{resolution}</code> and <code>{count}</code>.
     * </p>
     * </li>
     * <li>
     * <p>
     * <b><code>{resolution}</code> (Optional)</b>: If you want Elastic
     * Transcoder to include the resolution in the file name, include
     * <code>{resolution}</code> in the <code>ThumbnailPattern</code> object.
     * </p>
     * </li>
     * </ul>
     * <p>
     * When creating thumbnails, Elastic Transcoder automatically saves the
     * files in the format (.jpg or .png) that appears in the preset that you
     * specified in the <code>PresetID</code> value of
     * <code>CreateJobOutput</code>. Elastic Transcoder also appends the
     * applicable file name extension.
     * </p>
     * 
     * @param thumbnailPattern
     *        Whether you want Elastic Transcoder to create thumbnails for your
     *        videos and, if so, how you want Elastic Transcoder to name the
     *        files.</p>
     *        <p>
     *        If you don't want Elastic Transcoder to create thumbnails, specify
     *        "".
     *        </p>
     *        <p>
     *        If you do want Elastic Transcoder to create thumbnails, specify
     *        the information that you want to include in the file name for each
     *        thumbnail. You can specify the following values in any sequence:
     *        </p>
     *        <ul>
     *        <li>
     *        <p>
     *        <b><code>{count}</code> (Required)</b>: If you want to create
     *        thumbnails, you must include <code>{count}</code> in the
     *        <code>ThumbnailPattern</code> object. Wherever you specify
     *        <code>{count}</code>, Elastic Transcoder adds a five-digit
     *        sequence number (beginning with <b>00001</b>) to thumbnail file
     *        names. The number indicates where a given thumbnail appears in the
     *        sequence of thumbnails for a transcoded file.
     *        </p>
     *        <important>If you specify a literal value and/or
     *        <code>{resolution}</code> but you omit <code>{count}</code>,
     *        Elastic Transcoder returns a validation error and does not create
     *        the job.</important></li>
     *        <li>
     *        <p>
     *        <b>Literal values (Optional)</b>: You can specify literal values
     *        anywhere in the <code>ThumbnailPattern</code> object. For example,
     *        you can include them as a file name prefix or as a delimiter
     *        between <code>{resolution}</code> and <code>{count}</code>.
     *        </p>
     *        </li>
     *        <li>
     *        <p>
     *        <b><code>{resolution}</code> (Optional)</b>: If you want Elastic
     *        Transcoder to include the resolution in the file name, include
     *        <code>{resolution}</code> in the <code>ThumbnailPattern</code>
     *        object.
     *        </p>
     *        </li>
     *        </ul>
     *        <p>
     *        When creating thumbnails, Elastic Transcoder automatically saves
     *        the files in the format (.jpg or .png) that appears in the preset
     *        that you specified in the <code>PresetID</code> value of
     *        <code>CreateJobOutput</code>. Elastic Transcoder also appends the
     *        applicable file name extension.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public CreateJobOutput withThumbnailPattern(String thumbnailPattern) {
        setThumbnailPattern(thumbnailPattern);
        return this;
    }

    /**
     * <p>
     * The encryption settings, if any, that you want Elastic Transcoder to
     * apply to your thumbnail.
     * </p>
     * 
     * @param thumbnailEncryption
     *        The encryption settings, if any, that you want Elastic Transcoder
     *        to apply to your thumbnail.
     */

    public void setThumbnailEncryption(Encryption thumbnailEncryption) {
        this.thumbnailEncryption = thumbnailEncryption;
    }

    /**
     * <p>
     * The encryption settings, if any, that you want Elastic Transcoder to
     * apply to your thumbnail.
     * </p>
     * 
     * @return The encryption settings, if any, that you want Elastic Transcoder
     *         to apply to your thumbnail.
     */

    public Encryption getThumbnailEncryption() {
        return this.thumbnailEncryption;
    }

    /**
     * <p>
     * The encryption settings, if any, that you want Elastic Transcoder to
     * apply to your thumbnail.
     * </p>
     * 
     * @param thumbnailEncryption
     *        The encryption settings, if any, that you want Elastic Transcoder
     *        to apply to your thumbnail.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public CreateJobOutput withThumbnailEncryption(
            Encryption thumbnailEncryption) {
        setThumbnailEncryption(thumbnailEncryption);
        return this;
    }

    /**
     * <p>
     * The number of degrees clockwise by which you want Elastic Transcoder to
     * rotate the output relative to the input. Enter one of the following
     * values: <code>auto</code>, <code>0</code>, <code>90</code>,
     * <code>180</code>, <code>270</code>. The value <code>auto</code> generally
     * works only if the file that you're transcoding contains rotation
     * metadata.
     * </p>
     * 
     * @param rotate
     *        The number of degrees clockwise by which you want Elastic
     *        Transcoder to rotate the output relative to the input. Enter one
     *        of the following values: <code>auto</code>, <code>0</code>,
     *        <code>90</code>, <code>180</code>, <code>270</code>. The value
     *        <code>auto</code> generally works only if the file that you're
     *        transcoding contains rotation metadata.
     */

    public void setRotate(String rotate) {
        this.rotate = rotate;
    }

    /**
     * <p>
     * The number of degrees clockwise by which you want Elastic Transcoder to
     * rotate the output relative to the input. Enter one of the following
     * values: <code>auto</code>, <code>0</code>, <code>90</code>,
     * <code>180</code>, <code>270</code>. The value <code>auto</code> generally
     * works only if the file that you're transcoding contains rotation
     * metadata.
     * </p>
     * 
     * @return The number of degrees clockwise by which you want Elastic
     *         Transcoder to rotate the output relative to the input. Enter one
     *         of the following values: <code>auto</code>, <code>0</code>,
     *         <code>90</code>, <code>180</code>, <code>270</code>. The value
     *         <code>auto</code> generally works only if the file that you're
     *         transcoding contains rotation metadata.
     */

    public String getRotate() {
        return this.rotate;
    }

    /**
     * <p>
     * The number of degrees clockwise by which you want Elastic Transcoder to
     * rotate the output relative to the input. Enter one of the following
     * values: <code>auto</code>, <code>0</code>, <code>90</code>,
     * <code>180</code>, <code>270</code>. The value <code>auto</code> generally
     * works only if the file that you're transcoding contains rotation
     * metadata.
     * </p>
     * 
     * @param rotate
     *        The number of degrees clockwise by which you want Elastic
     *        Transcoder to rotate the output relative to the input. Enter one
     *        of the following values: <code>auto</code>, <code>0</code>,
     *        <code>90</code>, <code>180</code>, <code>270</code>. The value
     *        <code>auto</code> generally works only if the file that you're
     *        transcoding contains rotation metadata.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public CreateJobOutput withRotate(String rotate) {
        setRotate(rotate);
        return this;
    }

    /**
     * <p>
     * The <code>Id</code> of the preset to use for this job. The preset
     * determines the audio, video, and thumbnail settings that Elastic
     * Transcoder uses for transcoding.
     * </p>
     * 
     * @param presetId
     *        The <code>Id</code> of the preset to use for this job. The preset
     *        determines the audio, video, and thumbnail settings that Elastic
     *        Transcoder uses for transcoding.
     */

    public void setPresetId(String presetId) {
        this.presetId = presetId;
    }

    /**
     * <p>
     * The <code>Id</code> of the preset to use for this job. The preset
     * determines the audio, video, and thumbnail settings that Elastic
     * Transcoder uses for transcoding.
     * </p>
     * 
     * @return The <code>Id</code> of the preset to use for this job. The preset
     *         determines the audio, video, and thumbnail settings that Elastic
     *         Transcoder uses for transcoding.
     */

    public String getPresetId() {
        return this.presetId;
    }

    /**
     * <p>
     * The <code>Id</code> of the preset to use for this job. The preset
     * determines the audio, video, and thumbnail settings that Elastic
     * Transcoder uses for transcoding.
     * </p>
     * 
     * @param presetId
     *        The <code>Id</code> of the preset to use for this job. The preset
     *        determines the audio, video, and thumbnail settings that Elastic
     *        Transcoder uses for transcoding.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public CreateJobOutput withPresetId(String presetId) {
        setPresetId(presetId);
        return this;
    }

    /**
     * <p>
     * <important>(Outputs in Fragmented MP4 or MPEG-TS format
     * only.</important>If you specify a preset in <code>PresetId</code> for
     * which the value of <code>Container</code> is <code>fmp4</code>
     * (Fragmented MP4) or <code>ts</code> (MPEG-TS),
     * <code>SegmentDuration</code> is the target maximum duration of each
     * segment in seconds. For <code>HLSv3</code> format playlists, each media
     * segment is stored in a separate <code>.ts</code> file. For
     * <code>HLSv4</code> and <code>Smooth</code> playlists, all media segments
     * for an output are stored in a single file. Each segment is approximately
     * the length of the <code>SegmentDuration</code>, though individual
     * segments might be shorter or longer.
     * </p>
     * <p>
     * The range of valid values is 1 to 60 seconds. If the duration of the
     * video is not evenly divisible by <code>SegmentDuration</code>, the
     * duration of the last segment is the remainder of total
     * length/SegmentDuration.
     * </p>
     * <p>
     * Elastic Transcoder creates an output-specific playlist for each output
     * <code>HLS</code> output that you specify in OutputKeys. To add an output
     * to the master playlist for this job, include it in the
     * <code>OutputKeys</code> of the associated playlist.
     * </p>
     * 
     * @param segmentDuration
     *        (Outputs in Fragmented MP4 or MPEG-TS format only.</important>If
     *        you specify a preset in <code>PresetId</code> for which the value
     *        of <code>Container</code> is <code>fmp4</code> (Fragmented MP4) or
     *        <code>ts</code> (MPEG-TS), <code>SegmentDuration</code> is the
     *        target maximum duration of each segment in seconds. For
     *        <code>HLSv3</code> format playlists, each media segment is stored
     *        in a separate <code>.ts</code> file. For <code>HLSv4</code> and
     *        <code>Smooth</code> playlists, all media segments for an output
     *        are stored in a single file. Each segment is approximately the
     *        length of the <code>SegmentDuration</code>, though individual
     *        segments might be shorter or longer.</p>
     *        <p>
     *        The range of valid values is 1 to 60 seconds. If the duration of
     *        the video is not evenly divisible by <code>SegmentDuration</code>,
     *        the duration of the last segment is the remainder of total
     *        length/SegmentDuration.
     *        </p>
     *        <p>
     *        Elastic Transcoder creates an output-specific playlist for each
     *        output <code>HLS</code> output that you specify in OutputKeys. To
     *        add an output to the master playlist for this job, include it in
     *        the <code>OutputKeys
     */

    public void setSegmentDuration(String segmentDuration) {
        this.segmentDuration = segmentDuration;
    }

    /**
     * <p>
     * <important>(Outputs in Fragmented MP4 or MPEG-TS format
     * only.</important>If you specify a preset in <code>PresetId</code> for
     * which the value of <code>Container</code> is <code>fmp4</code>
     * (Fragmented MP4) or <code>ts</code> (MPEG-TS),
     * <code>SegmentDuration</code> is the target maximum duration of each
     * segment in seconds. For <code>HLSv3</code> format playlists, each media
     * segment is stored in a separate <code>.ts</code> file. For
     * <code>HLSv4</code> and <code>Smooth</code> playlists, all media segments
     * for an output are stored in a single file. Each segment is approximately
     * the length of the <code>SegmentDuration</code>, though individual
     * segments might be shorter or longer.
     * </p>
     * <p>
     * The range of valid values is 1 to 60 seconds. If the duration of the
     * video is not evenly divisible by <code>SegmentDuration</code>, the
     * duration of the last segment is the remainder of total
     * length/SegmentDuration.
     * </p>
     * <p>
     * Elastic Transcoder creates an output-specific playlist for each output
     * <code>HLS</code> output that you specify in OutputKeys. To add an output
     * to the master playlist for this job, include it in the
     * <code>OutputKeys</code> of the associated playlist.
     * </p>
     * 
     * @return (Outputs in Fragmented MP4 or MPEG-TS format only.</important>If
     *         you specify a preset in <code>PresetId</code> for which the value
     *         of <code>Container</code> is <code>fmp4</code> (Fragmented MP4)
     *         or <code>ts</code> (MPEG-TS), <code>SegmentDuration</code> is the
     *         target maximum duration of each segment in seconds. For
     *         <code>HLSv3</code> format playlists, each media segment is stored
     *         in a separate <code>.ts</code> file. For <code>HLSv4</code> and
     *         <code>Smooth</code> playlists, all media segments for an output
     *         are stored in a single file. Each segment is approximately the
     *         length of the <code>SegmentDuration</code>, though individual
     *         segments might be shorter or longer.</p>
     *         <p>
     *         The range of valid values is 1 to 60 seconds. If the duration of
     *         the video is not evenly divisible by <code>SegmentDuration</code>
     *         , the duration of the last segment is the remainder of total
     *         length/SegmentDuration.
     *         </p>
     *         <p>
     *         Elastic Transcoder creates an output-specific playlist for each
     *         output <code>HLS</code> output that you specify in OutputKeys. To
     *         add an output to the master playlist for this job, include it in
     *         the <code>OutputKeys
     */

    public String getSegmentDuration() {
        return this.segmentDuration;
    }

    /**
     * <p>
     * <important>(Outputs in Fragmented MP4 or MPEG-TS format
     * only.</important>If you specify a preset in <code>PresetId</code> for
     * which the value of <code>Container</code> is <code>fmp4</code>
     * (Fragmented MP4) or <code>ts</code> (MPEG-TS),
     * <code>SegmentDuration</code> is the target maximum duration of each
     * segment in seconds. For <code>HLSv3</code> format playlists, each media
     * segment is stored in a separate <code>.ts</code> file. For
     * <code>HLSv4</code> and <code>Smooth</code> playlists, all media segments
     * for an output are stored in a single file. Each segment is approximately
     * the length of the <code>SegmentDuration</code>, though individual
     * segments might be shorter or longer.
     * </p>
     * <p>
     * The range of valid values is 1 to 60 seconds. If the duration of the
     * video is not evenly divisible by <code>SegmentDuration</code>, the
     * duration of the last segment is the remainder of total
     * length/SegmentDuration.
     * </p>
     * <p>
     * Elastic Transcoder creates an output-specific playlist for each output
     * <code>HLS</code> output that you specify in OutputKeys. To add an output
     * to the master playlist for this job, include it in the
     * <code>OutputKeys</code> of the associated playlist.
     * </p>
     * 
     * @param segmentDuration
     *        (Outputs in Fragmented MP4 or MPEG-TS format only.</important>If
     *        you specify a preset in <code>PresetId</code> for which the value
     *        of <code>Container</code> is <code>fmp4</code> (Fragmented MP4) or
     *        <code>ts</code> (MPEG-TS), <code>SegmentDuration</code> is the
     *        target maximum duration of each segment in seconds. For
     *        <code>HLSv3</code> format playlists, each media segment is stored
     *        in a separate <code>.ts</code> file. For <code>HLSv4</code> and
     *        <code>Smooth</code> playlists, all media segments for an output
     *        are stored in a single file. Each segment is approximately the
     *        length of the <code>SegmentDuration</code>, though individual
     *        segments might be shorter or longer.</p>
     *        <p>
     *        The range of valid values is 1 to 60 seconds. If the duration of
     *        the video is not evenly divisible by <code>SegmentDuration</code>,
     *        the duration of the last segment is the remainder of total
     *        length/SegmentDuration.
     *        </p>
     *        <p>
     *        Elastic Transcoder creates an output-specific playlist for each
     *        output <code>HLS</code> output that you specify in OutputKeys. To
     *        add an output to the master playlist for this job, include it in
     *        the <code>OutputKeys
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public CreateJobOutput withSegmentDuration(String segmentDuration) {
        setSegmentDuration(segmentDuration);
        return this;
    }

    /**
     * <p>
     * Information about the watermarks that you want Elastic Transcoder to add
     * to the video during transcoding. You can specify up to four watermarks
     * for each output. Settings for each watermark must be defined in the
     * preset for the current output.
     * </p>
     * 
     * @return Information about the watermarks that you want Elastic Transcoder
     *         to add to the video during transcoding. You can specify up to
     *         four watermarks for each output. Settings for each watermark must
     *         be defined in the preset for the current output.
     */

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

    /**
     * <p>
     * Information about the watermarks that you want Elastic Transcoder to add
     * to the video during transcoding. You can specify up to four watermarks
     * for each output. Settings for each watermark must be defined in the
     * preset for the current output.
     * </p>
     * 
     * @param watermarks
     *        Information about the watermarks that you want Elastic Transcoder
     *        to add to the video during transcoding. You can specify up to four
     *        watermarks for each output. Settings for each watermark must be
     *        defined in the preset for the current output.
     */

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

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

    /**
     * <p>
     * Information about the watermarks that you want Elastic Transcoder to add
     * to the video during transcoding. You can specify up to four watermarks
     * for each output. Settings for each watermark must be defined in the
     * preset for the current output.
     * </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
     *        Information about the watermarks that you want Elastic Transcoder
     *        to add to the video during transcoding. You can specify up to four
     *        watermarks for each output. Settings for each watermark must be
     *        defined in the preset for the current output.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

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

    /**
     * <p>
     * Information about the watermarks that you want Elastic Transcoder to add
     * to the video during transcoding. You can specify up to four watermarks
     * for each output. Settings for each watermark must be defined in the
     * preset for the current output.
     * </p>
     * 
     * @param watermarks
     *        Information about the watermarks that you want Elastic Transcoder
     *        to add to the video during transcoding. You can specify up to four
     *        watermarks for each output. Settings for each watermark must be
     *        defined in the preset for the current output.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

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

    /**
     * <p>
     * Information about the album art that you want Elastic Transcoder to add
     * to the file during transcoding. You can specify up to twenty album
     * artworks for each output. Settings for each artwork must be defined in
     * the job for the current output.
     * </p>
     * 
     * @param albumArt
     *        Information about the album art that you want Elastic Transcoder
     *        to add to the file during transcoding. You can specify up to
     *        twenty album artworks for each output. Settings for each artwork
     *        must be defined in the job for the current output.
     */

    public void setAlbumArt(JobAlbumArt albumArt) {
        this.albumArt = albumArt;
    }

    /**
     * <p>
     * Information about the album art that you want Elastic Transcoder to add
     * to the file during transcoding. You can specify up to twenty album
     * artworks for each output. Settings for each artwork must be defined in
     * the job for the current output.
     * </p>
     * 
     * @return Information about the album art that you want Elastic Transcoder
     *         to add to the file during transcoding. You can specify up to
     *         twenty album artworks for each output. Settings for each artwork
     *         must be defined in the job for the current output.
     */

    public JobAlbumArt getAlbumArt() {
        return this.albumArt;
    }

    /**
     * <p>
     * Information about the album art that you want Elastic Transcoder to add
     * to the file during transcoding. You can specify up to twenty album
     * artworks for each output. Settings for each artwork must be defined in
     * the job for the current output.
     * </p>
     * 
     * @param albumArt
     *        Information about the album art that you want Elastic Transcoder
     *        to add to the file during transcoding. You can specify up to
     *        twenty album artworks for each output. Settings for each artwork
     *        must be defined in the job for the current output.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public CreateJobOutput withAlbumArt(JobAlbumArt albumArt) {
        setAlbumArt(albumArt);
        return this;
    }

    /**
     * <p>
     * You can create an output file that contains an excerpt from the input
     * file. This excerpt, called a clip, can come from the beginning, middle,
     * or end of the file. The Composition object contains settings for the
     * clips that make up an output file. For the current release, you can only
     * specify settings for a single clip per output file. The Composition
     * object cannot be null.
     * </p>
     * 
     * @return You can create an output file that contains an excerpt from the
     *         input file. This excerpt, called a clip, can come from the
     *         beginning, middle, or end of the file. The Composition object
     *         contains settings for the clips that make up an output file. For
     *         the current release, you can only specify settings for a single
     *         clip per output file. The Composition object cannot be null.
     */

    public java.util.List<Clip> getComposition() {
        if (composition == null) {
            composition = new com.amazonaws.internal.SdkInternalList<Clip>();
        }
        return composition;
    }

    /**
     * <p>
     * You can create an output file that contains an excerpt from the input
     * file. This excerpt, called a clip, can come from the beginning, middle,
     * or end of the file. The Composition object contains settings for the
     * clips that make up an output file. For the current release, you can only
     * specify settings for a single clip per output file. The Composition
     * object cannot be null.
     * </p>
     * 
     * @param composition
     *        You can create an output file that contains an excerpt from the
     *        input file. This excerpt, called a clip, can come from the
     *        beginning, middle, or end of the file. The Composition object
     *        contains settings for the clips that make up an output file. For
     *        the current release, you can only specify settings for a single
     *        clip per output file. The Composition object cannot be null.
     */

    public void setComposition(java.util.Collection<Clip> composition) {
        if (composition == null) {
            this.composition = null;
            return;
        }

        this.composition = new com.amazonaws.internal.SdkInternalList<Clip>(
                composition);
    }

    /**
     * <p>
     * You can create an output file that contains an excerpt from the input
     * file. This excerpt, called a clip, can come from the beginning, middle,
     * or end of the file. The Composition object contains settings for the
     * clips that make up an output file. For the current release, you can only
     * specify settings for a single clip per output file. The Composition
     * object cannot be null.
     * </p>
     * <p>
     * <b>NOTE:</b> This method appends the values to the existing list (if
     * any). Use {@link #setComposition(java.util.Collection)} or
     * {@link #withComposition(java.util.Collection)} if you want to override
     * the existing values.
     * </p>
     * 
     * @param composition
     *        You can create an output file that contains an excerpt from the
     *        input file. This excerpt, called a clip, can come from the
     *        beginning, middle, or end of the file. The Composition object
     *        contains settings for the clips that make up an output file. For
     *        the current release, you can only specify settings for a single
     *        clip per output file. The Composition object cannot be null.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public CreateJobOutput withComposition(Clip... composition) {
        if (this.composition == null) {
            setComposition(new com.amazonaws.internal.SdkInternalList<Clip>(
                    composition.length));
        }
        for (Clip ele : composition) {
            this.composition.add(ele);
        }
        return this;
    }

    /**
     * <p>
     * You can create an output file that contains an excerpt from the input
     * file. This excerpt, called a clip, can come from the beginning, middle,
     * or end of the file. The Composition object contains settings for the
     * clips that make up an output file. For the current release, you can only
     * specify settings for a single clip per output file. The Composition
     * object cannot be null.
     * </p>
     * 
     * @param composition
     *        You can create an output file that contains an excerpt from the
     *        input file. This excerpt, called a clip, can come from the
     *        beginning, middle, or end of the file. The Composition object
     *        contains settings for the clips that make up an output file. For
     *        the current release, you can only specify settings for a single
     *        clip per output file. The Composition object cannot be null.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public CreateJobOutput withComposition(
            java.util.Collection<Clip> composition) {
        setComposition(composition);
        return this;
    }

    /**
     * <p>
     * You can configure Elastic Transcoder to transcode captions, or subtitles,
     * from one format to another. All captions must be in UTF-8. Elastic
     * Transcoder supports two types of captions:
     * </p>
     * <ul>
     * <li>
     * <p>
     * <b>Embedded:</b> Embedded captions are included in the same file as the
     * audio and video. Elastic Transcoder supports only one embedded caption
     * per language, to a maximum of 300 embedded captions per file.
     * </p>
     * <p>
     * Valid input values include: <code>CEA-608 (EIA-608</code>, first
     * non-empty channel only), <code>CEA-708 (EIA-708</code>, first non-empty
     * channel only), and <code>mov-text</code>
     * </p>
     * <p>
     * Valid outputs include: <code>mov-text</code>
     * </p>
     * <p>
     * Elastic Transcoder supports a maximum of one embedded format per output.
     * </p>
     * </li>
     * <li>
     * <p>
     * <b>Sidecar:</b> Sidecar captions are kept in a separate metadata file
     * from the audio and video data. Sidecar captions require a player that is
     * capable of understanding the relationship between the video file and the
     * sidecar file. Elastic Transcoder supports only one sidecar caption per
     * language, to a maximum of 20 sidecar captions per file.
     * </p>
     * <p>
     * Valid input values include: <code>dfxp</code> (first div element only),
     * <code>ebu-tt</code>, <code>scc</code>, <code>smpt</code>,
     * <code>srt</code>, <code>ttml</code> (first div element only), and
     * <code>webvtt</code>
     * </p>
     * <p>
     * Valid outputs include: <code>dfxp</code> (first div element only),
     * <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.
     * </p>
     * </li>
     * </ul>
     * <p>
     * If you want ttml or smpte-tt compatible captions, specify dfxp as your
     * output format.
     * </p>
     * <p>
     * Elastic Transcoder does not support OCR (Optical Character Recognition),
     * does not accept pictures as a valid input for captions, and is not
     * available for audio-only transcoding. Elastic Transcoder does not
     * preserve text formatting (for example, italics) during the transcoding
     * process.
     * </p>
     * <p>
     * To remove captions or leave the captions empty, set <code>Captions</code>
     * to null. To pass through existing captions unchanged, set the
     * <code>MergePolicy</code> to <code>MergeRetain</code>, and pass in a null
     * <code>CaptionSources</code> array.
     * </p>
     * <p>
     * For more information on embedded files, see the Subtitles Wikipedia page.
     * </p>
     * <p>
     * For more information on sidecar files, see the Extensible Metadata
     * Platform and Sidecar file Wikipedia pages.
     * </p>
     * 
     * @param captions
     *        You can configure Elastic Transcoder to transcode captions, or
     *        subtitles, from one format to another. All captions must be in
     *        UTF-8. Elastic Transcoder supports two types of captions:</p>
     *        <ul>
     *        <li>
     *        <p>
     *        <b>Embedded:</b> Embedded captions are included in the same file
     *        as the audio and video. Elastic Transcoder supports only one
     *        embedded caption per language, to a maximum of 300 embedded
     *        captions per file.
     *        </p>
     *        <p>
     *        Valid input values include: <code>CEA-608 (EIA-608</code>, first
     *        non-empty channel only), <code>CEA-708 (EIA-708</code>, first
     *        non-empty channel only), and <code>mov-text</code>
     *        </p>
     *        <p>
     *        Valid outputs include: <code>mov-text</code>
     *        </p>
     *        <p>
     *        Elastic Transcoder supports a maximum of one embedded format per
     *        output.
     *        </p>
     *        </li>
     *        <li>
     *        <p>
     *        <b>Sidecar:</b> Sidecar captions are kept in a separate metadata
     *        file from the audio and video data. Sidecar captions require a
     *        player that is capable of understanding the relationship between
     *        the video file and the sidecar file. Elastic Transcoder supports
     *        only one sidecar caption per language, to a maximum of 20 sidecar
     *        captions per file.
     *        </p>
     *        <p>
     *        Valid input values include: <code>dfxp</code> (first div element
     *        only), <code>ebu-tt</code>, <code>scc</code>, <code>smpt</code>,
     *        <code>srt</code>, <code>ttml</code> (first div element only), and
     *        <code>webvtt</code>
     *        </p>
     *        <p>
     *        Valid outputs include: <code>dfxp</code> (first div element only),
     *        <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.
     *        </p>
     *        </li>
     *        </ul>
     *        <p>
     *        If you want ttml or smpte-tt compatible captions, specify dfxp as
     *        your output format.
     *        </p>
     *        <p>
     *        Elastic Transcoder does not support OCR (Optical Character
     *        Recognition), does not accept pictures as a valid input for
     *        captions, and is not available for audio-only transcoding. Elastic
     *        Transcoder does not preserve text formatting (for example,
     *        italics) during the transcoding process.
     *        </p>
     *        <p>
     *        To remove captions or leave the captions empty, set
     *        <code>Captions</code> to null. To pass through existing captions
     *        unchanged, set the <code>MergePolicy</code> to
     *        <code>MergeRetain</code>, and pass in a null
     *        <code>CaptionSources</code> array.
     *        </p>
     *        <p>
     *        For more information on embedded files, see the Subtitles
     *        Wikipedia page.
     *        </p>
     *        <p>
     *        For more information on sidecar files, see the Extensible Metadata
     *        Platform and Sidecar file Wikipedia pages.
     */

    public void setCaptions(Captions captions) {
        this.captions = captions;
    }

    /**
     * <p>
     * You can configure Elastic Transcoder to transcode captions, or subtitles,
     * from one format to another. All captions must be in UTF-8. Elastic
     * Transcoder supports two types of captions:
     * </p>
     * <ul>
     * <li>
     * <p>
     * <b>Embedded:</b> Embedded captions are included in the same file as the
     * audio and video. Elastic Transcoder supports only one embedded caption
     * per language, to a maximum of 300 embedded captions per file.
     * </p>
     * <p>
     * Valid input values include: <code>CEA-608 (EIA-608</code>, first
     * non-empty channel only), <code>CEA-708 (EIA-708</code>, first non-empty
     * channel only), and <code>mov-text</code>
     * </p>
     * <p>
     * Valid outputs include: <code>mov-text</code>
     * </p>
     * <p>
     * Elastic Transcoder supports a maximum of one embedded format per output.
     * </p>
     * </li>
     * <li>
     * <p>
     * <b>Sidecar:</b> Sidecar captions are kept in a separate metadata file
     * from the audio and video data. Sidecar captions require a player that is
     * capable of understanding the relationship between the video file and the
     * sidecar file. Elastic Transcoder supports only one sidecar caption per
     * language, to a maximum of 20 sidecar captions per file.
     * </p>
     * <p>
     * Valid input values include: <code>dfxp</code> (first div element only),
     * <code>ebu-tt</code>, <code>scc</code>, <code>smpt</code>,
     * <code>srt</code>, <code>ttml</code> (first div element only), and
     * <code>webvtt</code>
     * </p>
     * <p>
     * Valid outputs include: <code>dfxp</code> (first div element only),
     * <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.
     * </p>
     * </li>
     * </ul>
     * <p>
     * If you want ttml or smpte-tt compatible captions, specify dfxp as your
     * output format.
     * </p>
     * <p>
     * Elastic Transcoder does not support OCR (Optical Character Recognition),
     * does not accept pictures as a valid input for captions, and is not
     * available for audio-only transcoding. Elastic Transcoder does not
     * preserve text formatting (for example, italics) during the transcoding
     * process.
     * </p>
     * <p>
     * To remove captions or leave the captions empty, set <code>Captions</code>
     * to null. To pass through existing captions unchanged, set the
     * <code>MergePolicy</code> to <code>MergeRetain</code>, and pass in a null
     * <code>CaptionSources</code> array.
     * </p>
     * <p>
     * For more information on embedded files, see the Subtitles Wikipedia page.
     * </p>
     * <p>
     * For more information on sidecar files, see the Extensible Metadata
     * Platform and Sidecar file Wikipedia pages.
     * </p>
     * 
     * @return You can configure Elastic Transcoder to transcode captions, or
     *         subtitles, from one format to another. All captions must be in
     *         UTF-8. Elastic Transcoder supports two types of captions:</p>
     *         <ul>
     *         <li>
     *         <p>
     *         <b>Embedded:</b> Embedded captions are included in the same file
     *         as the audio and video. Elastic Transcoder supports only one
     *         embedded caption per language, to a maximum of 300 embedded
     *         captions per file.
     *         </p>
     *         <p>
     *         Valid input values include: <code>CEA-608 (EIA-608</code>, first
     *         non-empty channel only), <code>CEA-708 (EIA-708</code>, first
     *         non-empty channel only), and <code>mov-text</code>
     *         </p>
     *         <p>
     *         Valid outputs include: <code>mov-text</code>
     *         </p>
     *         <p>
     *         Elastic Transcoder supports a maximum of one embedded format per
     *         output.
     *         </p>
     *         </li>
     *         <li>
     *         <p>
     *         <b>Sidecar:</b> Sidecar captions are kept in a separate metadata
     *         file from the audio and video data. Sidecar captions require a
     *         player that is capable of understanding the relationship between
     *         the video file and the sidecar file. Elastic Transcoder supports
     *         only one sidecar caption per language, to a maximum of 20 sidecar
     *         captions per file.
     *         </p>
     *         <p>
     *         Valid input values include: <code>dfxp</code> (first div element
     *         only), <code>ebu-tt</code>, <code>scc</code>, <code>smpt</code>,
     *         <code>srt</code>, <code>ttml</code> (first div element only), and
     *         <code>webvtt</code>
     *         </p>
     *         <p>
     *         Valid outputs include: <code>dfxp</code> (first div element
     *         only), <code>scc</code>, <code>srt</code>, and
     *         <code>webvtt</code>.
     *         </p>
     *         </li>
     *         </ul>
     *         <p>
     *         If you want ttml or smpte-tt compatible captions, specify dfxp as
     *         your output format.
     *         </p>
     *         <p>
     *         Elastic Transcoder does not support OCR (Optical Character
     *         Recognition), does not accept pictures as a valid input for
     *         captions, and is not available for audio-only transcoding.
     *         Elastic Transcoder does not preserve text formatting (for
     *         example, italics) during the transcoding process.
     *         </p>
     *         <p>
     *         To remove captions or leave the captions empty, set
     *         <code>Captions</code> to null. To pass through existing captions
     *         unchanged, set the <code>MergePolicy</code> to
     *         <code>MergeRetain</code>, and pass in a null
     *         <code>CaptionSources</code> array.
     *         </p>
     *         <p>
     *         For more information on embedded files, see the Subtitles
     *         Wikipedia page.
     *         </p>
     *         <p>
     *         For more information on sidecar files, see the Extensible
     *         Metadata Platform and Sidecar file Wikipedia pages.
     */

    public Captions getCaptions() {
        return this.captions;
    }

    /**
     * <p>
     * You can configure Elastic Transcoder to transcode captions, or subtitles,
     * from one format to another. All captions must be in UTF-8. Elastic
     * Transcoder supports two types of captions:
     * </p>
     * <ul>
     * <li>
     * <p>
     * <b>Embedded:</b> Embedded captions are included in the same file as the
     * audio and video. Elastic Transcoder supports only one embedded caption
     * per language, to a maximum of 300 embedded captions per file.
     * </p>
     * <p>
     * Valid input values include: <code>CEA-608 (EIA-608</code>, first
     * non-empty channel only), <code>CEA-708 (EIA-708</code>, first non-empty
     * channel only), and <code>mov-text</code>
     * </p>
     * <p>
     * Valid outputs include: <code>mov-text</code>
     * </p>
     * <p>
     * Elastic Transcoder supports a maximum of one embedded format per output.
     * </p>
     * </li>
     * <li>
     * <p>
     * <b>Sidecar:</b> Sidecar captions are kept in a separate metadata file
     * from the audio and video data. Sidecar captions require a player that is
     * capable of understanding the relationship between the video file and the
     * sidecar file. Elastic Transcoder supports only one sidecar caption per
     * language, to a maximum of 20 sidecar captions per file.
     * </p>
     * <p>
     * Valid input values include: <code>dfxp</code> (first div element only),
     * <code>ebu-tt</code>, <code>scc</code>, <code>smpt</code>,
     * <code>srt</code>, <code>ttml</code> (first div element only), and
     * <code>webvtt</code>
     * </p>
     * <p>
     * Valid outputs include: <code>dfxp</code> (first div element only),
     * <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.
     * </p>
     * </li>
     * </ul>
     * <p>
     * If you want ttml or smpte-tt compatible captions, specify dfxp as your
     * output format.
     * </p>
     * <p>
     * Elastic Transcoder does not support OCR (Optical Character Recognition),
     * does not accept pictures as a valid input for captions, and is not
     * available for audio-only transcoding. Elastic Transcoder does not
     * preserve text formatting (for example, italics) during the transcoding
     * process.
     * </p>
     * <p>
     * To remove captions or leave the captions empty, set <code>Captions</code>
     * to null. To pass through existing captions unchanged, set the
     * <code>MergePolicy</code> to <code>MergeRetain</code>, and pass in a null
     * <code>CaptionSources</code> array.
     * </p>
     * <p>
     * For more information on embedded files, see the Subtitles Wikipedia page.
     * </p>
     * <p>
     * For more information on sidecar files, see the Extensible Metadata
     * Platform and Sidecar file Wikipedia pages.
     * </p>
     * 
     * @param captions
     *        You can configure Elastic Transcoder to transcode captions, or
     *        subtitles, from one format to another. All captions must be in
     *        UTF-8. Elastic Transcoder supports two types of captions:</p>
     *        <ul>
     *        <li>
     *        <p>
     *        <b>Embedded:</b> Embedded captions are included in the same file
     *        as the audio and video. Elastic Transcoder supports only one
     *        embedded caption per language, to a maximum of 300 embedded
     *        captions per file.
     *        </p>
     *        <p>
     *        Valid input values include: <code>CEA-608 (EIA-608</code>, first
     *        non-empty channel only), <code>CEA-708 (EIA-708</code>, first
     *        non-empty channel only), and <code>mov-text</code>
     *        </p>
     *        <p>
     *        Valid outputs include: <code>mov-text</code>
     *        </p>
     *        <p>
     *        Elastic Transcoder supports a maximum of one embedded format per
     *        output.
     *        </p>
     *        </li>
     *        <li>
     *        <p>
     *        <b>Sidecar:</b> Sidecar captions are kept in a separate metadata
     *        file from the audio and video data. Sidecar captions require a
     *        player that is capable of understanding the relationship between
     *        the video file and the sidecar file. Elastic Transcoder supports
     *        only one sidecar caption per language, to a maximum of 20 sidecar
     *        captions per file.
     *        </p>
     *        <p>
     *        Valid input values include: <code>dfxp</code> (first div element
     *        only), <code>ebu-tt</code>, <code>scc</code>, <code>smpt</code>,
     *        <code>srt</code>, <code>ttml</code> (first div element only), and
     *        <code>webvtt</code>
     *        </p>
     *        <p>
     *        Valid outputs include: <code>dfxp</code> (first div element only),
     *        <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.
     *        </p>
     *        </li>
     *        </ul>
     *        <p>
     *        If you want ttml or smpte-tt compatible captions, specify dfxp as
     *        your output format.
     *        </p>
     *        <p>
     *        Elastic Transcoder does not support OCR (Optical Character
     *        Recognition), does not accept pictures as a valid input for
     *        captions, and is not available for audio-only transcoding. Elastic
     *        Transcoder does not preserve text formatting (for example,
     *        italics) during the transcoding process.
     *        </p>
     *        <p>
     *        To remove captions or leave the captions empty, set
     *        <code>Captions</code> to null. To pass through existing captions
     *        unchanged, set the <code>MergePolicy</code> to
     *        <code>MergeRetain</code>, and pass in a null
     *        <code>CaptionSources</code> array.
     *        </p>
     *        <p>
     *        For more information on embedded files, see the Subtitles
     *        Wikipedia page.
     *        </p>
     *        <p>
     *        For more information on sidecar files, see the Extensible Metadata
     *        Platform and Sidecar file Wikipedia pages.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public CreateJobOutput withCaptions(Captions captions) {
        setCaptions(captions);
        return this;
    }

    /**
     * <p>
     * You can specify encryption settings for any output files that you want to
     * use for a transcoding job. This includes the output file and any
     * watermarks, thumbnails, album art, or captions that you want to use. You
     * must specify encryption settings for each file individually.
     * </p>
     * 
     * @param encryption
     *        You can specify encryption settings for any output files that you
     *        want to use for a transcoding job. This includes the output file
     *        and any watermarks, thumbnails, album art, or captions that you
     *        want to use. You must specify encryption settings for each file
     *        individually.
     */

    public void setEncryption(Encryption encryption) {
        this.encryption = encryption;
    }

    /**
     * <p>
     * You can specify encryption settings for any output files that you want to
     * use for a transcoding job. This includes the output file and any
     * watermarks, thumbnails, album art, or captions that you want to use. You
     * must specify encryption settings for each file individually.
     * </p>
     * 
     * @return You can specify encryption settings for any output files that you
     *         want to use for a transcoding job. This includes the output file
     *         and any watermarks, thumbnails, album art, or captions that you
     *         want to use. You must specify encryption settings for each file
     *         individually.
     */

    public Encryption getEncryption() {
        return this.encryption;
    }

    /**
     * <p>
     * You can specify encryption settings for any output files that you want to
     * use for a transcoding job. This includes the output file and any
     * watermarks, thumbnails, album art, or captions that you want to use. You
     * must specify encryption settings for each file individually.
     * </p>
     * 
     * @param encryption
     *        You can specify encryption settings for any output files that you
     *        want to use for a transcoding job. This includes the output file
     *        and any watermarks, thumbnails, album art, or captions that you
     *        want to use. You must specify encryption settings for each file
     *        individually.
     * @return Returns a reference to this object so that method calls can be
     *         chained together.
     */

    public CreateJobOutput withEncryption(Encryption encryption) {
        setEncryption(encryption);
        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 (getKey() != null)
            sb.append("Key: " + getKey() + ",");
        if (getThumbnailPattern() != null)
            sb.append("ThumbnailPattern: " + getThumbnailPattern() + ",");
        if (getThumbnailEncryption() != null)
            sb.append("ThumbnailEncryption: " + getThumbnailEncryption() + ",");
        if (getRotate() != null)
            sb.append("Rotate: " + getRotate() + ",");
        if (getPresetId() != null)
            sb.append("PresetId: " + getPresetId() + ",");
        if (getSegmentDuration() != null)
            sb.append("SegmentDuration: " + getSegmentDuration() + ",");
        if (getWatermarks() != null)
            sb.append("Watermarks: " + getWatermarks() + ",");
        if (getAlbumArt() != null)
            sb.append("AlbumArt: " + getAlbumArt() + ",");
        if (getComposition() != null)
            sb.append("Composition: " + getComposition() + ",");
        if (getCaptions() != null)
            sb.append("Captions: " + getCaptions() + ",");
        if (getEncryption() != null)
            sb.append("Encryption: " + getEncryption());
        sb.append("}");
        return sb.toString();
    }

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

        if (obj instanceof CreateJobOutput == false)
            return false;
        CreateJobOutput other = (CreateJobOutput) obj;
        if (other.getKey() == null ^ this.getKey() == null)
            return false;
        if (other.getKey() != null
                && other.getKey().equals(this.getKey()) == false)
            return false;
        if (other.getThumbnailPattern() == null
                ^ this.getThumbnailPattern() == null)
            return false;
        if (other.getThumbnailPattern() != null
                && other.getThumbnailPattern().equals(
                        this.getThumbnailPattern()) == false)
            return false;
        if (other.getThumbnailEncryption() == null
                ^ this.getThumbnailEncryption() == null)
            return false;
        if (other.getThumbnailEncryption() != null
                && other.getThumbnailEncryption().equals(
                        this.getThumbnailEncryption()) == false)
            return false;
        if (other.getRotate() == null ^ this.getRotate() == null)
            return false;
        if (other.getRotate() != null
                && other.getRotate().equals(this.getRotate()) == false)
            return false;
        if (other.getPresetId() == null ^ this.getPresetId() == null)
            return false;
        if (other.getPresetId() != null
                && other.getPresetId().equals(this.getPresetId()) == false)
            return false;
        if (other.getSegmentDuration() == null
                ^ this.getSegmentDuration() == null)
            return false;
        if (other.getSegmentDuration() != null
                && other.getSegmentDuration().equals(this.getSegmentDuration()) == false)
            return false;
        if (other.getWatermarks() == null ^ this.getWatermarks() == null)
            return false;
        if (other.getWatermarks() != null
                && other.getWatermarks().equals(this.getWatermarks()) == false)
            return false;
        if (other.getAlbumArt() == null ^ this.getAlbumArt() == null)
            return false;
        if (other.getAlbumArt() != null
                && other.getAlbumArt().equals(this.getAlbumArt()) == false)
            return false;
        if (other.getComposition() == null ^ this.getComposition() == null)
            return false;
        if (other.getComposition() != null
                && other.getComposition().equals(this.getComposition()) == false)
            return false;
        if (other.getCaptions() == null ^ this.getCaptions() == null)
            return false;
        if (other.getCaptions() != null
                && other.getCaptions().equals(this.getCaptions()) == false)
            return false;
        if (other.getEncryption() == null ^ this.getEncryption() == null)
            return false;
        if (other.getEncryption() != null
                && other.getEncryption().equals(this.getEncryption()) == false)
            return false;
        return true;
    }

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

        hashCode = prime * hashCode
                + ((getKey() == null) ? 0 : getKey().hashCode());
        hashCode = prime
                * hashCode
                + ((getThumbnailPattern() == null) ? 0 : getThumbnailPattern()
                        .hashCode());
        hashCode = prime
                * hashCode
                + ((getThumbnailEncryption() == null) ? 0
                        : getThumbnailEncryption().hashCode());
        hashCode = prime * hashCode
                + ((getRotate() == null) ? 0 : getRotate().hashCode());
        hashCode = prime * hashCode
                + ((getPresetId() == null) ? 0 : getPresetId().hashCode());
        hashCode = prime
                * hashCode
                + ((getSegmentDuration() == null) ? 0 : getSegmentDuration()
                        .hashCode());
        hashCode = prime * hashCode
                + ((getWatermarks() == null) ? 0 : getWatermarks().hashCode());
        hashCode = prime * hashCode
                + ((getAlbumArt() == null) ? 0 : getAlbumArt().hashCode());
        hashCode = prime
                * hashCode
                + ((getComposition() == null) ? 0 : getComposition().hashCode());
        hashCode = prime * hashCode
                + ((getCaptions() == null) ? 0 : getCaptions().hashCode());
        hashCode = prime * hashCode
                + ((getEncryption() == null) ? 0 : getEncryption().hashCode());
        return hashCode;
    }

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