aws-sdk-mediaconvert 1.137.0 → 1.138.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -43,7 +43,13 @@ module Aws::MediaConvert
43
43
  # @return [Integer]
44
44
  #
45
45
  # @!attribute [rw] codec_profile
46
- # AAC Profile.
46
+ # Specify the AAC profile. For the widest player compatibility and
47
+ # where higher bitrates are acceptable: Keep the default profile, LC
48
+ # (AAC-LC) For improved audio performance at lower bitrates: Choose
49
+ # HEV1 or HEV2. HEV1 (AAC-HE v1) adds spectral band replication to
50
+ # improve speech audio at low bitrates. HEV2 (AAC-HE v2) adds
51
+ # parametric stereo, which optimizes for encoding stereo audio at very
52
+ # low bitrates.
47
53
  # @return [String]
48
54
  #
49
55
  # @!attribute [rw] coding_mode
@@ -59,7 +65,11 @@ module Aws::MediaConvert
59
65
  # @return [String]
60
66
  #
61
67
  # @!attribute [rw] rate_control_mode
62
- # Rate Control Mode.
68
+ # Specify the AAC rate control mode. For a constant bitrate: Choose
69
+ # CBR. Your AAC output bitrate will be equal to the value that you
70
+ # choose for Bitrate. For a variable bitrate: Choose VBR. Your AAC
71
+ # output bitrate will vary according to your audio content and the
72
+ # value that you choose for Bitrate quality.
63
73
  # @return [String]
64
74
  #
65
75
  # @!attribute [rw] raw_format
@@ -69,15 +79,10 @@ module Aws::MediaConvert
69
79
  # @return [String]
70
80
  #
71
81
  # @!attribute [rw] sample_rate
72
- # Specify the Sample rate in Hz. Valid sample rates depend on the
73
- # Profile and Coding mode that you select. The following list shows
74
- # valid sample rates for each Profile and Coding mode. * LC Profile,
75
- # Coding mode 1.0, 2.0, and Receiver Mix: 8000, 12000, 16000, 22050,
76
- # 24000, 32000, 44100, 48000, 88200, 96000. * LC Profile, Coding mode
77
- # 5.1: 32000, 44100, 48000, 96000. * HEV1 Profile, Coding mode 1.0
78
- # and Receiver Mix: 22050, 24000, 32000, 44100, 48000. * HEV1
79
- # Profile, Coding mode 2.0 and 5.1: 32000, 44100, 48000, 96000. *
80
- # HEV2 Profile, Coding mode 2.0: 22050, 24000, 32000, 44100, 48000.
82
+ # Specify the AAC sample rate in samples per second (Hz). Valid sample
83
+ # rates depend on the AAC profile and Coding mode that you select. For
84
+ # a list of supported sample rates, see:
85
+ # https://docs.aws.amazon.com/mediaconvert/latest/ug/aac-support.html
81
86
  # @return [Integer]
82
87
  #
83
88
  # @!attribute [rw] specification
@@ -86,7 +91,9 @@ module Aws::MediaConvert
86
91
  # @return [String]
87
92
  #
88
93
  # @!attribute [rw] vbr_quality
89
- # VBR Quality Level - Only used if rate\_control\_mode is VBR.
94
+ # Specify the quality of your variable bitrate (VBR) AAC audio. For a
95
+ # list of approximate VBR bitrates, see:
96
+ # https://docs.aws.amazon.com/mediaconvert/latest/ug/aac-support.html#aac\_vbr
90
97
  # @return [String]
91
98
  #
92
99
  # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/AacSettings AWS API Documentation
@@ -693,7 +700,10 @@ module Aws::MediaConvert
693
700
  # timestamps. No corrections are made to already-aligned frames.
694
701
  # Frame-level correction may affect the pitch of corrected frames, and
695
702
  # is recommended for atonal audio content such as speech or
696
- # percussion.
703
+ # percussion. * Force: Apply audio duration correction, either Track
704
+ # or Frame depending on your input, regardless of the accuracy of your
705
+ # input's STTS table. Your output audio and video may not be aligned
706
+ # or it may contain audio artifacts.
697
707
  # @return [String]
698
708
  #
699
709
  # @!attribute [rw] custom_language_code
@@ -2947,6 +2957,14 @@ module Aws::MediaConvert
2947
2957
  # feature, see the AWS Elemental MediaConvert User Guide.
2948
2958
  # @return [Array<Types::HopDestination>]
2949
2959
  #
2960
+ # @!attribute [rw] job_engine_version
2961
+ # Use Job engine versions to run jobs for your production workflow on
2962
+ # one version, while you test and validate the latest version. To
2963
+ # specify a Job engine version: Enter a date in a YYYY-MM-DD format.
2964
+ # For a list of valid Job engine versions, submit a ListVersions
2965
+ # request. To not specify a Job engine version: Leave blank.
2966
+ # @return [String]
2967
+ #
2950
2968
  # @!attribute [rw] job_template
2951
2969
  # Optional. When you create a job, you can either specify a job
2952
2970
  # template or specify the transcoding settings individually.
@@ -3014,6 +3032,7 @@ module Aws::MediaConvert
3014
3032
  :billing_tags_source,
3015
3033
  :client_request_token,
3016
3034
  :hop_destinations,
3035
+ :job_engine_version,
3017
3036
  :job_template,
3018
3037
  :priority,
3019
3038
  :queue,
@@ -4900,6 +4919,19 @@ module Aws::MediaConvert
4900
4919
  # If your caption source is IMSC in an IMF package, use
4901
4920
  # TrackSourceSettings instead of FileSoureSettings.
4902
4921
  #
4922
+ # @!attribute [rw] byte_rate_limit
4923
+ # Choose whether to limit the byte rate at which your SCC input
4924
+ # captions are inserted into your output. To not limit the caption
4925
+ # rate: We recommend that you keep the default value, Disabled.
4926
+ # MediaConvert inserts captions in your output according to the byte
4927
+ # rates listed in the EIA-608 specification, typically 2 or 3 caption
4928
+ # bytes per frame depending on your output frame rate. To limit your
4929
+ # output caption rate: Choose Enabled. Choose this option if your
4930
+ # downstream systems require a maximum of 2 caption bytes per frame.
4931
+ # Note that this setting has no effect when your output frame rate is
4932
+ # 30 or 60.
4933
+ # @return [String]
4934
+ #
4903
4935
  # @!attribute [rw] convert_608_to_708
4904
4936
  # Specify whether this set of input captions appears in your outputs
4905
4937
  # in both 608 and 708 format. If you choose Upconvert, MediaConvert
@@ -4959,6 +4991,7 @@ module Aws::MediaConvert
4959
4991
  # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/FileSourceSettings AWS API Documentation
4960
4992
  #
4961
4993
  class FileSourceSettings < Struct.new(
4994
+ :byte_rate_limit,
4962
4995
  :convert_608_to_708,
4963
4996
  :convert_paint_to_pop,
4964
4997
  :framerate,
@@ -5508,23 +5541,25 @@ module Aws::MediaConvert
5508
5541
  # @return [Integer]
5509
5542
  #
5510
5543
  # @!attribute [rw] min_i_interval
5511
- # Use this setting only when you also enable Scene change detection.
5512
- # This setting determines how the encoder manages the spacing between
5513
- # I-frames that it inserts as part of the I-frame cadence and the
5514
- # I-frames that it inserts for Scene change detection. We recommend
5515
- # that you have the transcoder automatically choose this value for you
5516
- # based on characteristics of your input video. To enable this
5517
- # automatic behavior, do this by keeping the default empty value. When
5518
- # you explicitly specify a value for this setting, the encoder
5519
- # determines whether to skip a cadence-driven I-frame by the value you
5520
- # set. For example, if you set Min I interval to 5 and a
5521
- # cadence-driven I-frame would fall within 5 frames of a scene-change
5522
- # I-frame, then the encoder skips the cadence-driven I-frame. In this
5523
- # way, one GOP is shrunk slightly and one GOP is stretched slightly.
5524
- # When the cadence-driven I-frames are farther from the scene-change
5525
- # I-frame than the value you set, then the encoder leaves all I-frames
5526
- # in place and the GOPs surrounding the scene change are smaller than
5527
- # the usual cadence GOPs.
5544
+ # Specify the minimum number of frames allowed between two IDR-frames
5545
+ # in your output. This includes frames created at the start of a GOP
5546
+ # or a scene change. Use Min I-Interval to improve video compression
5547
+ # by varying GOP size when two IDR-frames would be created near each
5548
+ # other. For example, if a regular cadence-driven IDR-frame would fall
5549
+ # within 5 frames of a scene-change IDR-frame, and you set Min
5550
+ # I-interval to 5, then the encoder would only write an IDR-frame for
5551
+ # the scene-change. In this way, one GOP is shortened or extended. If
5552
+ # a cadence-driven IDR-frame would be further than 5 frames from a
5553
+ # scene-change IDR-frame, then the encoder leaves all IDR-frames in
5554
+ # place. To use an automatically determined interval: We recommend
5555
+ # that you keep this value blank. This allows for MediaConvert to use
5556
+ # an optimal setting according to the characteristics of your input
5557
+ # video, and results in better video compression. To manually specify
5558
+ # an interval: Enter a value from 1 to 30. Use when your downstream
5559
+ # systems have specific GOP size requirements. To disable GOP size
5560
+ # variance: Enter 0. MediaConvert will only create IDR-frames at the
5561
+ # start of your output's cadence-driven GOP. Use when your downstream
5562
+ # systems require a regular GOP size.
5528
5563
  # @return [Integer]
5529
5564
  #
5530
5565
  # @!attribute [rw] number_b_frames_between_reference_frames
@@ -5594,6 +5629,19 @@ module Aws::MediaConvert
5594
5629
  # Places a PPS header on each encoded picture, even if repeated.
5595
5630
  # @return [String]
5596
5631
  #
5632
+ # @!attribute [rw] saliency_aware_encoding
5633
+ # Specify whether to apply Saliency aware encoding to your output. Use
5634
+ # to improve the perceptual video quality of your output by allocating
5635
+ # more encoding bits to the prominent or noticeable parts of your
5636
+ # content. To apply saliency aware encoding, when possible: We
5637
+ # recommend that you choose Preferred. The effects of Saliency aware
5638
+ # encoding are best seen in lower bitrate outputs. When you choose
5639
+ # Preferred, note that Saliency aware encoding will only apply to
5640
+ # outputs that are 720p or higher in resolution. To not apply saliency
5641
+ # aware encoding, prioritizing encoding speed over perceptual video
5642
+ # quality: Choose Disabled.
5643
+ # @return [String]
5644
+ #
5597
5645
  # @!attribute [rw] scan_type_conversion_mode
5598
5646
  # Use this setting for interlaced outputs, when your output frame rate
5599
5647
  # is half of your input frame rate. In this situation, choose
@@ -5764,6 +5812,7 @@ module Aws::MediaConvert
5764
5812
  :qvbr_settings,
5765
5813
  :rate_control_mode,
5766
5814
  :repeat_pps,
5815
+ :saliency_aware_encoding,
5767
5816
  :scan_type_conversion_mode,
5768
5817
  :scene_change_detect,
5769
5818
  :slices,
@@ -6039,23 +6088,25 @@ module Aws::MediaConvert
6039
6088
  # @return [Integer]
6040
6089
  #
6041
6090
  # @!attribute [rw] min_i_interval
6042
- # Use this setting only when you also enable Scene change detection.
6043
- # This setting determines how the encoder manages the spacing between
6044
- # I-frames that it inserts as part of the I-frame cadence and the
6045
- # I-frames that it inserts for Scene change detection. We recommend
6046
- # that you have the transcoder automatically choose this value for you
6047
- # based on characteristics of your input video. To enable this
6048
- # automatic behavior, do this by keeping the default empty value. When
6049
- # you explicitly specify a value for this setting, the encoder
6050
- # determines whether to skip a cadence-driven I-frame by the value you
6051
- # set. For example, if you set Min I interval to 5 and a
6052
- # cadence-driven I-frame would fall within 5 frames of a scene-change
6053
- # I-frame, then the encoder skips the cadence-driven I-frame. In this
6054
- # way, one GOP is shrunk slightly and one GOP is stretched slightly.
6055
- # When the cadence-driven I-frames are farther from the scene-change
6056
- # I-frame than the value you set, then the encoder leaves all I-frames
6057
- # in place and the GOPs surrounding the scene change are smaller than
6058
- # the usual cadence GOPs.
6091
+ # Specify the minimum number of frames allowed between two IDR-frames
6092
+ # in your output. This includes frames created at the start of a GOP
6093
+ # or a scene change. Use Min I-Interval to improve video compression
6094
+ # by varying GOP size when two IDR-frames would be created near each
6095
+ # other. For example, if a regular cadence-driven IDR-frame would fall
6096
+ # within 5 frames of a scene-change IDR-frame, and you set Min
6097
+ # I-interval to 5, then the encoder would only write an IDR-frame for
6098
+ # the scene-change. In this way, one GOP is shortened or extended. If
6099
+ # a cadence-driven IDR-frame would be further than 5 frames from a
6100
+ # scene-change IDR-frame, then the encoder leaves all IDR-frames in
6101
+ # place. To use an automatically determined interval: We recommend
6102
+ # that you keep this value blank. This allows for MediaConvert to use
6103
+ # an optimal setting according to the characteristics of your input
6104
+ # video, and results in better video compression. To manually specify
6105
+ # an interval: Enter a value from 1 to 30. Use when your downstream
6106
+ # systems have specific GOP size requirements. To disable GOP size
6107
+ # variance: Enter 0. MediaConvert will only create IDR-frames at the
6108
+ # start of your output's cadence-driven GOP. Use when your downstream
6109
+ # systems require a regular GOP size.
6059
6110
  # @return [Integer]
6060
6111
  #
6061
6112
  # @!attribute [rw] number_b_frames_between_reference_frames
@@ -7888,6 +7939,22 @@ module Aws::MediaConvert
7888
7939
  # MediaConvert resources
7889
7940
  # @return [String]
7890
7941
  #
7942
+ # @!attribute [rw] job_engine_version_requested
7943
+ # The Job engine version that you requested for your job. Valid
7944
+ # versions are in a YYYY-MM-DD format.
7945
+ # @return [String]
7946
+ #
7947
+ # @!attribute [rw] job_engine_version_used
7948
+ # The Job engine version that your job used. Job engine versions are
7949
+ # in a YYYY-MM-DD format. When you request an expired version, the
7950
+ # response for this property will be empty. Requests to create jobs
7951
+ # with an expired version result in a regular job, as if no specific
7952
+ # Job engine version was requested. When you request an invalid
7953
+ # version, the response for this property will be empty. Requests to
7954
+ # create jobs with an invalid version result in a 400 error message,
7955
+ # and no job is created.
7956
+ # @return [String]
7957
+ #
7891
7958
  # @!attribute [rw] job_percent_complete
7892
7959
  # An estimate of how far your job has progressed. This estimate is
7893
7960
  # shown as a percentage of the total time from when your job leaves
@@ -7997,6 +8064,8 @@ module Aws::MediaConvert
7997
8064
  :error_message,
7998
8065
  :hop_destinations,
7999
8066
  :id,
8067
+ :job_engine_version_requested,
8068
+ :job_engine_version_used,
8000
8069
  :job_percent_complete,
8001
8070
  :job_template,
8002
8071
  :messages,
@@ -8017,6 +8086,31 @@ module Aws::MediaConvert
8017
8086
  include Aws::Structure
8018
8087
  end
8019
8088
 
8089
+ # Use Job engine versions to run jobs for your production workflow on
8090
+ # one version, while you test and validate the latest version. Job
8091
+ # engine versions are in a YYYY-MM-DD format.
8092
+ #
8093
+ # @!attribute [rw] expiration_date
8094
+ # The date that this Job engine version expires. Requests to create
8095
+ # jobs with an expired version result in a regular job, as if no
8096
+ # specific Job engine version was requested.
8097
+ # @return [Time]
8098
+ #
8099
+ # @!attribute [rw] version
8100
+ # Use Job engine versions to run jobs for your production workflow on
8101
+ # one version, while you test and validate the latest version. Job
8102
+ # engine versions are in a YYYY-MM-DD format.
8103
+ # @return [String]
8104
+ #
8105
+ # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/JobEngineVersion AWS API Documentation
8106
+ #
8107
+ class JobEngineVersion < Struct.new(
8108
+ :expiration_date,
8109
+ :version)
8110
+ SENSITIVE = []
8111
+ include Aws::Structure
8112
+ end
8113
+
8020
8114
  # Provides messages from the service about jobs that you have already
8021
8115
  # successfully submitted.
8022
8116
  #
@@ -8782,6 +8876,50 @@ module Aws::MediaConvert
8782
8876
  include Aws::Structure
8783
8877
  end
8784
8878
 
8879
+ # Retrieve a JSON array of all available Job engine versions and the
8880
+ # date they expire. Job engine versions are in YYYY-MM-DD format.
8881
+ #
8882
+ # @!attribute [rw] max_results
8883
+ # Optional. Number of valid Job engine versions, up to twenty, that
8884
+ # will be returned at one time.
8885
+ # @return [Integer]
8886
+ #
8887
+ # @!attribute [rw] next_token
8888
+ # Optional. Use this string, provided with the response to a previous
8889
+ # request, to request the next batch of Job engine versions.
8890
+ # @return [String]
8891
+ #
8892
+ # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/ListVersionsRequest AWS API Documentation
8893
+ #
8894
+ class ListVersionsRequest < Struct.new(
8895
+ :max_results,
8896
+ :next_token)
8897
+ SENSITIVE = []
8898
+ include Aws::Structure
8899
+ end
8900
+
8901
+ # Successful list versions requests will return a JSON for available Job
8902
+ # engine versions.
8903
+ #
8904
+ # @!attribute [rw] next_token
8905
+ # Optional. Use this string, provided with the response to a previous
8906
+ # request, to request the next batch of Job engine versions.
8907
+ # @return [String]
8908
+ #
8909
+ # @!attribute [rw] versions
8910
+ # Retrieve a JSON array of all available Job engine versions and the
8911
+ # date they expire.
8912
+ # @return [Array<Types::JobEngineVersion>]
8913
+ #
8914
+ # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/ListVersionsResponse AWS API Documentation
8915
+ #
8916
+ class ListVersionsResponse < Struct.new(
8917
+ :next_token,
8918
+ :versions)
8919
+ SENSITIVE = []
8920
+ include Aws::Structure
8921
+ end
8922
+
8785
8923
  # Settings for SCTE-35 signals from ESAM. Include this in your job
8786
8924
  # settings to put SCTE-35 markers in your HLS and transport stream
8787
8925
  # outputs at the insertion points that you specify in an ESAM XML
@@ -9951,20 +10089,22 @@ module Aws::MediaConvert
9951
10089
  # @return [Integer]
9952
10090
  #
9953
10091
  # @!attribute [rw] min_i_interval
9954
- # Use this setting only when you also enable Scene change detection.
9955
- # This setting determines how the encoder manages the spacing between
9956
- # I-frames that it inserts as part of the I-frame cadence and the
9957
- # I-frames that it inserts for Scene change detection. When you
9958
- # specify a value for this setting, the encoder determines whether to
9959
- # skip a cadence-driven I-frame by the value you set. For example, if
9960
- # you set Min I interval to 5 and a cadence-driven I-frame would fall
9961
- # within 5 frames of a scene-change I-frame, then the encoder skips
9962
- # the cadence-driven I-frame. In this way, one GOP is shrunk slightly
9963
- # and one GOP is stretched slightly. When the cadence-driven I-frames
9964
- # are farther from the scene-change I-frame than the value you set,
9965
- # then the encoder leaves all I-frames in place and the GOPs
9966
- # surrounding the scene change are smaller than the usual cadence
9967
- # GOPs.
10092
+ # Specify the minimum number of frames allowed between two IDR-frames
10093
+ # in your output. This includes frames created at the start of a GOP
10094
+ # or a scene change. Use Min I-Interval to improve video compression
10095
+ # by varying GOP size when two IDR-frames would be created near each
10096
+ # other. For example, if a regular cadence-driven IDR-frame would fall
10097
+ # within 5 frames of a scene-change IDR-frame, and you set Min
10098
+ # I-interval to 5, then the encoder would only write an IDR-frame for
10099
+ # the scene-change. In this way, one GOP is shortened or extended. If
10100
+ # a cadence-driven IDR-frame would be further than 5 frames from a
10101
+ # scene-change IDR-frame, then the encoder leaves all IDR-frames in
10102
+ # place. To manually specify an interval: Enter a value from 1 to 30.
10103
+ # Use when your downstream systems have specific GOP size
10104
+ # requirements. To disable GOP size variance: Enter 0. MediaConvert
10105
+ # will only create IDR-frames at the start of your output's
10106
+ # cadence-driven GOP. Use when your downstream systems require a
10107
+ # regular GOP size.
9968
10108
  # @return [Integer]
9969
10109
  #
9970
10110
  # @!attribute [rw] number_b_frames_between_reference_frames
@@ -12897,41 +13037,69 @@ module Aws::MediaConvert
12897
13037
  # https://docs.aws.amazon.com/mediaconvert/latest/ug/video-overlays.html
12898
13038
  #
12899
13039
  # @!attribute [rw] end_timecode
12900
- # Enter the end timecode in the underlying input video for this
12901
- # overlay. Your overlay will be active through this frame. To display
12902
- # your video overlay for the duration of the underlying video: Leave
12903
- # blank. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the
12904
- # hour, MM is the minute, SS is the second, and FF is the frame
12905
- # number. When entering this value, take into account your choice for
12906
- # the underlying Input timecode source. For example, if you have
12907
- # embedded timecodes that start at 01:00:00:00 and you want your
12908
- # overlay to end ten minutes into the video, enter 01:10:00:00.
12909
- # @return [String]
13040
+ # Enter the end timecode in the base input video for this overlay.
13041
+ # Your overlay will be active through this frame. To display your
13042
+ # video overlay for the duration of the base input video: Leave blank.
13043
+ # Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM
13044
+ # is the minute, SS isthe second, and FF is the frame number. When
13045
+ # entering this value, take into account your choice for the base
13046
+ # input video's timecode source. For example, if you have embedded
13047
+ # timecodes that start at 01:00:00:00 and you want your overlay to end
13048
+ # ten minutes into the video, enter 01:10:00:00.
13049
+ # @return [String]
13050
+ #
13051
+ # @!attribute [rw] initial_position
13052
+ # Specify the Initial position of your video overlay. To specify the
13053
+ # Initial position of your video overlay, including distance from the
13054
+ # left or top edge of the base input video's frame, or size: Enter a
13055
+ # value for X position, Y position, Width, or Height. To use the full
13056
+ # frame of the base input video: Leave blank.
13057
+ # @return [Types::VideoOverlayPosition]
12910
13058
  #
12911
13059
  # @!attribute [rw] input
12912
13060
  # Input settings for Video overlay. You can include one or more video
12913
13061
  # overlays in sequence at different times that you specify.
12914
13062
  # @return [Types::VideoOverlayInput]
12915
13063
  #
13064
+ # @!attribute [rw] playback
13065
+ # Specify whether your video overlay repeats or plays only once. To
13066
+ # repeat your video overlay on a loop: Keep the default value, Repeat.
13067
+ # Your overlay will repeat for the duration of the base input video.
13068
+ # To playback your video overlay only once: Choose Once. With either
13069
+ # option, you can end playback at a time that you specify by entering
13070
+ # a value for End timecode.
13071
+ # @return [String]
13072
+ #
12916
13073
  # @!attribute [rw] start_timecode
12917
- # Enter the start timecode in the underlying input video for this
12918
- # overlay. Your overlay will be active starting with this frame. To
12919
- # display your video overlay starting at the beginning of the
12920
- # underlying video: Leave blank. Use the format HH:MM:SS:FF or
12921
- # HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the
12922
- # second, and FF is the frame number. When entering this value, take
12923
- # into account your choice for the underlying Input timecode source.
12924
- # For example, if you have embedded timecodes that start at
12925
- # 01:00:00:00 and you want your overlay to begin five minutes into the
12926
- # video, enter 01:05:00:00.
13074
+ # Enter the start timecode in the base input video for this overlay.
13075
+ # Your overlay will be active starting with this frame. To display
13076
+ # your video overlay starting at the beginning of the base input
13077
+ # video: Leave blank. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where
13078
+ # HH is the hour, MM is the minute, SS is the second, and FF is the
13079
+ # frame number. When entering this value, take into account your
13080
+ # choice for the base input video's timecode source. For example, if
13081
+ # you have embedded timecodes that start at 01:00:00:00 and you want
13082
+ # your overlay to begin five minutes into the video, enter
13083
+ # 01:05:00:00.
12927
13084
  # @return [String]
12928
13085
  #
13086
+ # @!attribute [rw] transitions
13087
+ # Specify one or more transitions for your video overlay. Use
13088
+ # Transitions to reposition or resize your overlay over time. To use
13089
+ # the same position and size for the duration of your video overlay:
13090
+ # Leave blank. To specify a Transition: Enter a value for Start
13091
+ # timecode, End Timecode, X Position, Y Position, Width, or Height.
13092
+ # @return [Array<Types::VideoOverlayTransition>]
13093
+ #
12929
13094
  # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/VideoOverlay AWS API Documentation
12930
13095
  #
12931
13096
  class VideoOverlay < Struct.new(
12932
13097
  :end_timecode,
13098
+ :initial_position,
12933
13099
  :input,
12934
- :start_timecode)
13100
+ :playback,
13101
+ :start_timecode,
13102
+ :transitions)
12935
13103
  SENSITIVE = []
12936
13104
  include Aws::Structure
12937
13105
  end
@@ -12940,10 +13108,9 @@ module Aws::MediaConvert
12940
13108
  # overlays in sequence at different times that you specify.
12941
13109
  #
12942
13110
  # @!attribute [rw] file_input
12943
- # Specify the input file S3, HTTP, or HTTPS URI for your video
12944
- # overlay. For consistency in color and formatting in your output
12945
- # video image, we recommend that you specify a video with similar
12946
- # characteristics as the underlying input video.
13111
+ # Specify the input file S3, HTTP, or HTTPS URL for your video
13112
+ # overlay. To specify one or more Transitions for your base input
13113
+ # video instead: Leave blank.
12947
13114
  # @return [String]
12948
13115
  #
12949
13116
  # @!attribute [rw] input_clippings
@@ -13005,6 +13172,116 @@ module Aws::MediaConvert
13005
13172
  include Aws::Structure
13006
13173
  end
13007
13174
 
13175
+ # position of video overlay
13176
+ #
13177
+ # @!attribute [rw] height
13178
+ # To scale your video overlay to the same height as the base input
13179
+ # video: Leave blank. To scale the height of your video overlay to a
13180
+ # different height: Enter an integer representing the Unit type that
13181
+ # you choose, either Pixels or Percentage. For example, when you enter
13182
+ # 360 and choose Pixels, your video overlay will be rendered with a
13183
+ # height of 360. When you enter 50, choose Percentage, and your
13184
+ # overlay's source has a height of 1080, your video overlay will be
13185
+ # rendered with a height of 540. To scale your overlay to a specific
13186
+ # height while automatically maintaining its original aspect ratio,
13187
+ # enter a value for Height and leave Width blank.
13188
+ # @return [Integer]
13189
+ #
13190
+ # @!attribute [rw] unit
13191
+ # Specify the Unit type to use when you enter a value for X position,
13192
+ # Y position, Width, or Height. You can choose Pixels or Percentage.
13193
+ # Leave blank to use the default value, Pixels.
13194
+ # @return [String]
13195
+ #
13196
+ # @!attribute [rw] width
13197
+ # To scale your video overlay to the same width as the base input
13198
+ # video: Leave blank. To scale the width of your video overlay to a
13199
+ # different width: Enter an integer representing the Unit type that
13200
+ # you choose, either Pixels or Percentage. For example, when you enter
13201
+ # 640 and choose Pixels, your video overlay will scale to a height of
13202
+ # 640 pixels. When you enter 50, choose Percentage, and your
13203
+ # overlay's source has a width of 1920, your video overlay will scale
13204
+ # to a width of 960. To scale your overlay to a specific width while
13205
+ # automatically maintaining its original aspect ratio, enter a value
13206
+ # for Width and leave Height blank.
13207
+ # @return [Integer]
13208
+ #
13209
+ # @!attribute [rw] x_position
13210
+ # To position the left edge of your video overlay along the left edge
13211
+ # of the base input video's frame: Keep blank, or enter 0. To
13212
+ # position the left edge of your video overlay to the right, relative
13213
+ # to the left edge of the base input video's frame: Enter an integer
13214
+ # representing the Unit type that you choose, either Pixels or
13215
+ # Percentage. For example, when you enter 10 and choose Pixels, your
13216
+ # video overlay will be positioned 10 pixels from the left edge of the
13217
+ # base input video's frame. When you enter 10, choose Percentage, and
13218
+ # your base input video is 1920x1080, your video overlay will be
13219
+ # positioned 192 pixels from the left edge of the base input video's
13220
+ # frame.
13221
+ # @return [Integer]
13222
+ #
13223
+ # @!attribute [rw] y_position
13224
+ # To position the top edge of your video overlay along the top edge of
13225
+ # the base input video's frame: Keep blank, or enter 0. To position
13226
+ # the top edge of your video overlay down, relative to the top edge of
13227
+ # the base input video's frame: Enter an integer representing the
13228
+ # Unit type that you choose, either Pixels or Percentage. For example,
13229
+ # when you enter 10 and choose Pixels, your video overlay will be
13230
+ # positioned 10 pixels from the top edge of the base input video's
13231
+ # frame. When you enter 10, choose Percentage, and your underlying
13232
+ # video is 1920x1080, your video overlay will be positioned 108 pixels
13233
+ # from the top edge of the base input video's frame.
13234
+ # @return [Integer]
13235
+ #
13236
+ # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/VideoOverlayPosition AWS API Documentation
13237
+ #
13238
+ class VideoOverlayPosition < Struct.new(
13239
+ :height,
13240
+ :unit,
13241
+ :width,
13242
+ :x_position,
13243
+ :y_position)
13244
+ SENSITIVE = []
13245
+ include Aws::Structure
13246
+ end
13247
+
13248
+ # Specify one or more Transitions for your video overlay. Use
13249
+ # Transitions to reposition or resize your overlay over time. To use the
13250
+ # same position and size for the duration of your video overlay: Leave
13251
+ # blank. To specify a Transition: Enter a value for Start timecode, End
13252
+ # Timecode, X Position, Y Position, Width, or Height.
13253
+ #
13254
+ # @!attribute [rw] end_position
13255
+ # Specify the ending position for this transition, relative to the
13256
+ # base input video's frame. Your video overlay will move smoothly to
13257
+ # this position, beginning at this transition's Start timecode and
13258
+ # ending at this transition's End timecode.
13259
+ # @return [Types::VideoOverlayPosition]
13260
+ #
13261
+ # @!attribute [rw] end_timecode
13262
+ # Specify the timecode for when this transition ends. Use the format
13263
+ # HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute,
13264
+ # SS is the second, and FF is the frame number. When entering this
13265
+ # value, take into account your choice for Timecode source.
13266
+ # @return [String]
13267
+ #
13268
+ # @!attribute [rw] start_timecode
13269
+ # Specify the timecode for when this transition begins. Use the format
13270
+ # HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute,
13271
+ # SS is the second, and FF is the frame number. When entering this
13272
+ # value, take into account your choice for Timecode source.
13273
+ # @return [String]
13274
+ #
13275
+ # @see http://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29/VideoOverlayTransition AWS API Documentation
13276
+ #
13277
+ class VideoOverlayTransition < Struct.new(
13278
+ :end_position,
13279
+ :end_timecode,
13280
+ :start_timecode)
13281
+ SENSITIVE = []
13282
+ include Aws::Structure
13283
+ end
13284
+
13008
13285
  # Find additional transcoding features under Preprocessors. Enable the
13009
13286
  # features at each output individually. These features are disabled by
13010
13287
  # default.
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-mediaconvert/customizations'
52
52
  # @!group service
53
53
  module Aws::MediaConvert
54
54
 
55
- GEM_VERSION = '1.137.0'
55
+ GEM_VERSION = '1.138.0'
56
56
 
57
57
  end