aws-sdk-mediaconvert 1.137.0 → 1.138.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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