CreateJobOutput.java

/*
 * Copyright 2010-2015 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 {

    /**
     * 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>
     * <b>Constraints:</b><br/>
     * <b>Length: </b>1 - 255<br/>
     */
    private String key;

    /**
     * Whether you want Elastic Transcoder to create thumbnails for your
     * videos and, if so, how you want Elastic Transcoder to name the files.
     * <p>If you don't want Elastic Transcoder to create thumbnails, specify
     * "". <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:
     * <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. <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>. </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.
     * </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>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>(^$)|(^.*\{count\}.*$)<br/>
     */
    private String thumbnailPattern;

    /**
     * The encryption settings, if any, that you want Elastic Transcoder to
     * apply to your thumbnail.
     */
    private Encryption thumbnailEncryption;

    /**
     * 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>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>(^auto$)|(^0$)|(^90$)|(^180$)|(^270$)<br/>
     */
    private String rotate;

    /**
     * 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>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>^\d{13}-\w{6}$<br/>
     */
    private String presetId;

    /**
     * <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>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>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>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>^\d{1,5}(\.\d{0,5})?$<br/>
     */
    private String segmentDuration;

    /**
     * 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.
     */
    private com.amazonaws.internal.ListWithAutoConstructFlag<JobWatermark> watermarks;

    /**
     * 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.
     */
    private JobAlbumArt albumArt;

    /**
     * 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.
     */
    private com.amazonaws.internal.ListWithAutoConstructFlag<Clip> composition;

    /**
     * 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: <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>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>Valid outputs include: <code>mov-text</code>
     * <p>Elastic Transcoder supports a maximum of one embedded format per
     * output.</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>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>Valid outputs include: <code>dfxp</code> (first div element only),
     * <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.</li>
     * </ul> <p> If you want ttml or smpte-tt compatible captions, specify
     * dfxp as your output format. <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>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>For more information on embedded
     * files, see the Subtitles Wikipedia page. <p>For more information on
     * sidecar files, see the Extensible Metadata Platform and Sidecar file
     * Wikipedia pages.
     */
    private Captions captions;

    /**
     * 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.
     */
    private Encryption encryption;

    /**
     * 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>
     * <b>Constraints:</b><br/>
     * <b>Length: </b>1 - 255<br/>
     *
     * @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 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.
     * <p>
     * <b>Constraints:</b><br/>
     * <b>Length: </b>1 - 255<br/>
     *
     * @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;
    }
    
    /**
     * 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>
     * Returns a reference to this object so that method calls can be chained together.
     * <p>
     * <b>Constraints:</b><br/>
     * <b>Length: </b>1 - 255<br/>
     *
     * @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 A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withKey(String key) {
        this.key = key;
        return this;
    }

    /**
     * Whether you want Elastic Transcoder to create thumbnails for your
     * videos and, if so, how you want Elastic Transcoder to name the files.
     * <p>If you don't want Elastic Transcoder to create thumbnails, specify
     * "". <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:
     * <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. <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>. </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.
     * </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>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>(^$)|(^.*\{count\}.*$)<br/>
     *
     * @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>If you don't want Elastic Transcoder to create thumbnails, specify
     *         "". <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:
     *         <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. <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>. </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.
     *         </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 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>If you don't want Elastic Transcoder to create thumbnails, specify
     * "". <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:
     * <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. <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>. </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.
     * </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>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>(^$)|(^.*\{count\}.*$)<br/>
     *
     * @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>If you don't want Elastic Transcoder to create thumbnails, specify
     *         "". <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:
     *         <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. <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>. </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.
     *         </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;
    }
    
    /**
     * Whether you want Elastic Transcoder to create thumbnails for your
     * videos and, if so, how you want Elastic Transcoder to name the files.
     * <p>If you don't want Elastic Transcoder to create thumbnails, specify
     * "". <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:
     * <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. <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>. </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.
     * </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>
     * Returns a reference to this object so that method calls can be chained together.
     * <p>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>(^$)|(^.*\{count\}.*$)<br/>
     *
     * @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>If you don't want Elastic Transcoder to create thumbnails, specify
     *         "". <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:
     *         <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. <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>. </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.
     *         </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 A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withThumbnailPattern(String thumbnailPattern) {
        this.thumbnailPattern = thumbnailPattern;
        return this;
    }

    /**
     * The encryption settings, if any, that you want Elastic Transcoder to
     * apply to your thumbnail.
     *
     * @return The encryption settings, if any, that you want Elastic Transcoder to
     *         apply to your thumbnail.
     */
    public Encryption getThumbnailEncryption() {
        return thumbnailEncryption;
    }
    
    /**
     * The encryption settings, if any, that you want Elastic Transcoder to
     * apply to your thumbnail.
     *
     * @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;
    }
    
    /**
     * The encryption settings, if any, that you want Elastic Transcoder to
     * apply to your thumbnail.
     * <p>
     * Returns a reference to this object so that method calls can be chained together.
     *
     * @param thumbnailEncryption The encryption settings, if any, that you want Elastic Transcoder to
     *         apply to your thumbnail.
     *
     * @return A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withThumbnailEncryption(Encryption thumbnailEncryption) {
        this.thumbnailEncryption = thumbnailEncryption;
        return this;
    }

    /**
     * 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>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>(^auto$)|(^0$)|(^90$)|(^180$)|(^270$)<br/>
     *
     * @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 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.
     * <p>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>(^auto$)|(^0$)|(^90$)|(^180$)|(^270$)<br/>
     *
     * @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;
    }
    
    /**
     * 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>
     * Returns a reference to this object so that method calls can be chained together.
     * <p>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>(^auto$)|(^0$)|(^90$)|(^180$)|(^270$)<br/>
     *
     * @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 A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withRotate(String rotate) {
        this.rotate = rotate;
        return this;
    }

    /**
     * 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>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>^\d{13}-\w{6}$<br/>
     *
     * @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 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.
     * <p>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>^\d{13}-\w{6}$<br/>
     *
     * @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;
    }
    
    /**
     * 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>
     * Returns a reference to this object so that method calls can be chained together.
     * <p>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>^\d{13}-\w{6}$<br/>
     *
     * @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 A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withPresetId(String presetId) {
        this.presetId = presetId;
        return this;
    }

    /**
     * <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>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>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>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>^\d{1,5}(\.\d{0,5})?$<br/>
     *
     * @return <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>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>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.
     */
    public String getSegmentDuration() {
        return segmentDuration;
    }
    
    /**
     * <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>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>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>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>^\d{1,5}(\.\d{0,5})?$<br/>
     *
     * @param segmentDuration <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>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>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.
     */
    public void setSegmentDuration(String segmentDuration) {
        this.segmentDuration = segmentDuration;
    }
    
    /**
     * <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>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>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>
     * Returns a reference to this object so that method calls can be chained together.
     * <p>
     * <b>Constraints:</b><br/>
     * <b>Pattern: </b>^\d{1,5}(\.\d{0,5})?$<br/>
     *
     * @param segmentDuration <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>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>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.
     *
     * @return A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withSegmentDuration(String segmentDuration) {
        this.segmentDuration = segmentDuration;
        return this;
    }

    /**
     * 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 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.ListWithAutoConstructFlag<JobWatermark>();
              watermarks.setAutoConstruct(true);
        }
        return 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.
     *
     * @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;
        }
        com.amazonaws.internal.ListWithAutoConstructFlag<JobWatermark> watermarksCopy = new com.amazonaws.internal.ListWithAutoConstructFlag<JobWatermark>(watermarks.size());
        watermarksCopy.addAll(watermarks);
        this.watermarks = watermarksCopy;
    }
    
    /**
     * 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>
     * Returns a reference to this object so that method calls can be chained together.
     *
     * @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 A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withWatermarks(JobWatermark... watermarks) {
        if (getWatermarks() == null) setWatermarks(new java.util.ArrayList<JobWatermark>(watermarks.length));
        for (JobWatermark value : watermarks) {
            getWatermarks().add(value);
        }
        return this;
    }
    
    /**
     * 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>
     * Returns a reference to this object so that method calls can be chained together.
     *
     * @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 A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withWatermarks(java.util.Collection<JobWatermark> watermarks) {
        if (watermarks == null) {
            this.watermarks = null;
        } else {
            com.amazonaws.internal.ListWithAutoConstructFlag<JobWatermark> watermarksCopy = new com.amazonaws.internal.ListWithAutoConstructFlag<JobWatermark>(watermarks.size());
            watermarksCopy.addAll(watermarks);
            this.watermarks = watermarksCopy;
        }

        return this;
    }

    /**
     * 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 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 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.
     *
     * @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;
    }
    
    /**
     * 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>
     * Returns a reference to this object so that method calls can be chained together.
     *
     * @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 A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withAlbumArt(JobAlbumArt albumArt) {
        this.albumArt = albumArt;
        return this;
    }

    /**
     * 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 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.ListWithAutoConstructFlag<Clip>();
              composition.setAutoConstruct(true);
        }
        return 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.
     *
     * @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;
        }
        com.amazonaws.internal.ListWithAutoConstructFlag<Clip> compositionCopy = new com.amazonaws.internal.ListWithAutoConstructFlag<Clip>(composition.size());
        compositionCopy.addAll(composition);
        this.composition = compositionCopy;
    }
    
    /**
     * 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>
     * Returns a reference to this object so that method calls can be chained together.
     *
     * @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 A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withComposition(Clip... composition) {
        if (getComposition() == null) setComposition(new java.util.ArrayList<Clip>(composition.length));
        for (Clip value : composition) {
            getComposition().add(value);
        }
        return this;
    }
    
    /**
     * 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>
     * Returns a reference to this object so that method calls can be chained together.
     *
     * @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 A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withComposition(java.util.Collection<Clip> composition) {
        if (composition == null) {
            this.composition = null;
        } else {
            com.amazonaws.internal.ListWithAutoConstructFlag<Clip> compositionCopy = new com.amazonaws.internal.ListWithAutoConstructFlag<Clip>(composition.size());
            compositionCopy.addAll(composition);
            this.composition = compositionCopy;
        }

        return this;
    }

    /**
     * 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: <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>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>Valid outputs include: <code>mov-text</code>
     * <p>Elastic Transcoder supports a maximum of one embedded format per
     * output.</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>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>Valid outputs include: <code>dfxp</code> (first div element only),
     * <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.</li>
     * </ul> <p> If you want ttml or smpte-tt compatible captions, specify
     * dfxp as your output format. <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>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>For more information on embedded
     * files, see the Subtitles Wikipedia page. <p>For more information on
     * sidecar files, see the Extensible Metadata Platform and Sidecar file
     * Wikipedia pages.
     *
     * @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: <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>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>Valid outputs include: <code>mov-text</code>
     *         <p>Elastic Transcoder supports a maximum of one embedded format per
     *         output.</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>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>Valid outputs include: <code>dfxp</code> (first div element only),
     *         <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.</li>
     *         </ul> <p> If you want ttml or smpte-tt compatible captions, specify
     *         dfxp as your output format. <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>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>For more information on embedded
     *         files, see the Subtitles Wikipedia page. <p>For more information on
     *         sidecar files, see the Extensible Metadata Platform and Sidecar file
     *         Wikipedia pages.
     */
    public Captions getCaptions() {
        return 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: <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>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>Valid outputs include: <code>mov-text</code>
     * <p>Elastic Transcoder supports a maximum of one embedded format per
     * output.</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>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>Valid outputs include: <code>dfxp</code> (first div element only),
     * <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.</li>
     * </ul> <p> If you want ttml or smpte-tt compatible captions, specify
     * dfxp as your output format. <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>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>For more information on embedded
     * files, see the Subtitles Wikipedia page. <p>For more information on
     * sidecar files, see the Extensible Metadata Platform and Sidecar file
     * Wikipedia pages.
     *
     * @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: <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>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>Valid outputs include: <code>mov-text</code>
     *         <p>Elastic Transcoder supports a maximum of one embedded format per
     *         output.</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>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>Valid outputs include: <code>dfxp</code> (first div element only),
     *         <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.</li>
     *         </ul> <p> If you want ttml or smpte-tt compatible captions, specify
     *         dfxp as your output format. <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>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>For more information on embedded
     *         files, see the Subtitles Wikipedia page. <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;
    }
    
    /**
     * 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: <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>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>Valid outputs include: <code>mov-text</code>
     * <p>Elastic Transcoder supports a maximum of one embedded format per
     * output.</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>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>Valid outputs include: <code>dfxp</code> (first div element only),
     * <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.</li>
     * </ul> <p> If you want ttml or smpte-tt compatible captions, specify
     * dfxp as your output format. <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>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>For more information on embedded
     * files, see the Subtitles Wikipedia page. <p>For more information on
     * sidecar files, see the Extensible Metadata Platform and Sidecar file
     * Wikipedia pages.
     * <p>
     * Returns a reference to this object so that method calls can be chained together.
     *
     * @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: <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>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>Valid outputs include: <code>mov-text</code>
     *         <p>Elastic Transcoder supports a maximum of one embedded format per
     *         output.</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>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>Valid outputs include: <code>dfxp</code> (first div element only),
     *         <code>scc</code>, <code>srt</code>, and <code>webvtt</code>.</li>
     *         </ul> <p> If you want ttml or smpte-tt compatible captions, specify
     *         dfxp as your output format. <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>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>For more information on embedded
     *         files, see the Subtitles Wikipedia page. <p>For more information on
     *         sidecar files, see the Extensible Metadata Platform and Sidecar file
     *         Wikipedia pages.
     *
     * @return A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withCaptions(Captions captions) {
        this.captions = captions;
        return this;
    }

    /**
     * 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 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 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.
     *
     * @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;
    }
    
    /**
     * 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>
     * Returns a reference to this object so that method calls can be chained together.
     *
     * @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 A reference to this updated object so that method calls can be chained
     *         together.
     */
    public CreateJobOutput withEncryption(Encryption encryption) {
        this.encryption = 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 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 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 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);
        }
        
    }

}