View a markdown version of this page

AWS::MediaLive::Channel H265Settings - AWS CloudFormation
SyntaxProperties

This is the new CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.

AWS::MediaLive::Channel H265Settings

H265 Settings

The parent of this entity is VideoCodecSettings.

Syntax

To declare this entity in your CloudFormation template, use the following syntax:

JSON

{
  "AdaptiveQuantization" : String,
  "AfdSignaling" : String,
  "AlternativeTransferFunction" : String,
  "Bitrate" : Integer,
  "BufSize" : Integer,
  "ColorMetadata" : String,
  "ColorSpaceSettings" : H265ColorSpaceSettings,
  "Deblocking" : String,
  "FilterSettings" : H265FilterSettings,
  "FixedAfd" : String,
  "FlickerAq" : String,
  "FramerateDenominator" : Integer,
  "FramerateNumerator" : Integer,
  "GopBReference" : String,
  "GopClosedCadence" : Integer,
  "GopNumBFrames" : Integer,
  "GopSize" : Number,
  "GopSizeUnits" : String,
  "Level" : String,
  "LookAheadRateControl" : String,
  "MaxBitrate" : Integer,
  "MinBitrate" : Integer,
  "MinIInterval" : Integer,
  "MinQp" : Integer,
  "MvOverPictureBoundaries" : String,
  "MvTemporalPredictor" : String,
  "ParDenominator" : Integer,
  "ParNumerator" : Integer,
  "Profile" : String,
  "QvbrQualityLevel" : Integer,
  "RateControlMode" : String,
  "ScanType" : String,
  "SceneChangeDetect" : String,
  "Slices" : Integer,
  "SubgopLength" : String,
  "Tier" : String,
  "TileHeight" : Integer,
  "TilePadding" : String,
  "TileWidth" : Integer,
  "TimecodeBurninSettings" : TimecodeBurninSettings,
  "TimecodeInsertion" : String,
  "TreeblockSize" : String
}

Properties

AdaptiveQuantization

Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.

Required: No

Type: String

Update requires: No interruption

AfdSignaling

Indicates that AFD values will be written into the output stream. If afdSignaling is "auto", the system will try to preserve the input AFD value (in cases where multiple AFD values are valid). If set to "fixed", the AFD value will be the value configured in the fixedAfd parameter.

Required: No

Type: String

Update requires: No interruption

AlternativeTransferFunction

Whether or not EML should insert an Alternative Transfer Function SEI message to support backwards compatibility with non-HDR decoders and displays.

Required: No

Type: String

Update requires: No interruption

Bitrate

Average bitrate in bits/second. Required when the rate control mode is VBR or CBR. Not used for QVBR. In an MS Smooth output group, each output must have a unique value when its bitrate is rounded down to the nearest multiple of 1000.

Required: No

Type: Integer

Update requires: No interruption

BufSize

Size of buffer (HRD buffer model) in bits.

Required: No

Type: Integer

Update requires: No interruption

ColorMetadata

Includes colorspace metadata in the output.

Required: No

Type: String

Update requires: No interruption

ColorSpaceSettings

Color Space settings

Required: No

Type: H265ColorSpaceSettings

Update requires: No interruption

Deblocking

Enable or disable the deblocking filter for this codec. The filter reduces blocking artifacts at block boundaries, which improves overall video quality. If the filter is disabled, visible block edges might appear in the output, especially at lower bitrates.

Required: No

Type: String

Update requires: No interruption

FilterSettings

Optional filters that you can apply to an encode.

Required: No

Type: H265FilterSettings

Update requires: No interruption

FixedAfd

Four bit AFD value to write on all frames of video in the output stream. Only valid when afdSignaling is set to 'Fixed'.

Required: No

Type: String

Update requires: No interruption

FlickerAq

If set to enabled, adjust quantization within each frame to reduce flicker or 'pop' on I-frames.

Required: No

Type: String

Update requires: No interruption

FramerateDenominator

Framerate denominator.

Required: No

Type: Integer

Update requires: No interruption

FramerateNumerator

Framerate numerator - framerate is a fraction, e.g. 24000 / 1001 = 23.976 fps.

Required: No

Type: Integer

Update requires: No interruption

GopBReference

Allows the encoder to use a B-Frame as a reference frame as well. ENABLED: B-frames will also serve as reference frames. DISABLED: B-frames won't be reference frames. Must be DISABLED if resolution is greater than 1080p or when using tiled HEVC encoding.

Required: No

Type: String

Update requires: No interruption

GopClosedCadence

Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.

Required: No

Type: Integer

Update requires: No interruption

GopNumBFrames

Sets the number of B-frames between reference frames. Set to 2 if resolution is greater than 1080p or when using tiled HEVC encoding.

Required: No

Type: Integer

Update requires: No interruption

GopSize

GOP size (keyframe interval) in units of either frames or seconds per gopSizeUnits. If gopSizeUnits is frames, gopSize must be an integer and must be greater than or equal to 1. If gopSizeUnits is seconds, gopSize must be greater than 0, but need not be an integer.

Required: No

Type: Number

Update requires: No interruption

GopSizeUnits

Indicates if the gopSize is specified in frames or seconds. If seconds the system will convert the gopSize into a frame count at run time.

Required: No

Type: String

Update requires: No interruption

Level

H.265 Level.

Required: No

Type: String

Update requires: No interruption

LookAheadRateControl

Amount of lookahead. A value of low can decrease latency and memory usage, while high can produce better quality for certain content.

Required: No

Type: String

Update requires: No interruption

MaxBitrate

For QVBR: See the tooltip for Quality level

Required: No

Type: Integer

Update requires: No interruption

MinBitrate

Used for QVBR rate control mode only. Optional. Enter a minimum bitrate if you want to keep the output bitrate above a threshold, in order to prevent the downstream system from de-allocating network bandwidth for this output.

Required: No

Type: Integer

Update requires: No interruption

MinIInterval

Only meaningful if sceneChangeDetect is set to enabled. Defaults to 5 if multiplex rate control is used. Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1

Required: No

Type: Integer

Update requires: No interruption

MinQp

Sets the minimum QP. If you aren't familiar with quantization adjustment, leave the field empty. MediaLive will apply an appropriate value.

Required: No

Type: Integer

Update requires: No interruption

MvOverPictureBoundaries

If you are setting up the picture as a tile, you must set this to disabled. In all other configurations, you typically enter enabled.

Required: No

Type: String

Update requires: No interruption

MvTemporalPredictor

If you are setting up the picture as a tile, you must set this to disabled. In other configurations, you typically enter enabled.

Required: No

Type: String

Update requires: No interruption

ParDenominator

Pixel Aspect Ratio denominator.

Required: No

Type: Integer

Update requires: No interruption

ParNumerator

Pixel Aspect Ratio numerator.

Required: No

Type: Integer

Update requires: No interruption

Profile

H.265 Profile.

Required: No

Type: String

Update requires: No interruption

QvbrQualityLevel

Controls the target quality for the video encode. Applies only when the rate control mode is QVBR. Set values for the QVBR quality level field and Max bitrate field that suit your most important viewing devices. Recommended values are: - Primary screen: Quality level: 8 to 10. Max bitrate: 4M - PC or tablet: Quality level: 7. Max bitrate: 1.5M to 3M - Smartphone: Quality level: 6. Max bitrate: 1M to 1.5M

Required: No

Type: Integer

Update requires: No interruption

RateControlMode

Rate control mode. QVBR: Quality will match the specified quality level except when it is constrained by the maximum bitrate. Recommended if you or your viewers pay for bandwidth. CBR: Quality varies, depending on the video complexity. Recommended only if you distribute your assets to devices that cannot handle variable bitrates. Multiplex: This rate control mode is only supported (and is required) when the video is being delivered to a MediaLive Multiplex in which case the rate control configuration is controlled by the properties within the Multiplex Program.

Required: No

Type: String

Update requires: No interruption

ScanType

Sets the scan type of the output to progressive or top-field-first interlaced.

Required: No

Type: String

Update requires: No interruption

SceneChangeDetect

Scene change detection.

Required: No

Type: String

Update requires: No interruption

Slices

Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures. This field is optional; when no value is specified the encoder will choose the number of slices based on encode resolution.

Required: No

Type: Integer

Update requires: No interruption

SubgopLength

Sets the number of B-frames in each sub-GOP. FIXED: Use the value in Num B-frames. DYNAMIC: Optimizes the number of B-frames in each sub-GOP to improve visual quality. Must be FIXED if resolution is greater than 1080p or when using tiled HEVC encoding.

Required: No

Type: String

Update requires: No interruption

Tier

H.265 Tier.

Required: No

Type: String

Update requires: No interruption

TileHeight

Set this field to set up the picture as a tile. You must also set TileWidth. The tile height must result in 22 or fewer rows in the frame. The tile width must result in 20 or fewer columns in the frame. And finally, the product of the column count and row count must be 64 or less. If the tile width and height are specified, MediaLive will override the video codec slices field with a value that MediaLive calculates.

Required: No

Type: Integer

Update requires: No interruption

TilePadding

Set to padded to force MediaLive to add padding to the frame, to obtain a frame that is a whole multiple of the tile size. If you are setting up the picture as a tile, you must enter padded. In all other configurations, you typically enter none.

Required: No

Type: String

Update requires: No interruption

TileWidth

Set this field to set up the picture as a tile. See TileHeight for more information.

Required: No

Type: Integer

Update requires: No interruption

TimecodeBurninSettings

Timecode burn-in settings for the H.265 codec.

Required: No

Type: TimecodeBurninSettings

Update requires: No interruption

TimecodeInsertion

Determines how timecodes should be inserted into the video elementary stream. - 'disabled': Do not include timecodes - 'picTimingSei': Pass through picture timing SEI messages from the source specified in Timecode Config

Required: No

Type: String

Update requires: No interruption

TreeblockSize

Select the tree block size used for encoding. If you enter auto, the encoder will pick the best size. If you are setting up the picture as a tile, you must set this to 32x32. In all other configurations, you typically enter auto.

Required: No

Type: String

Update requires: No interruption