H264Settings

public struct H264Settings : AWSShape

Undocumented

  • Declaration

    Swift

    public static var _members: [AWSShapeMember]
  • Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality.

    Declaration

    Swift

    public let adaptiveQuantization: H264AdaptiveQuantization?
  • Specify the average bitrate in bits per second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.

    Declaration

    Swift

    public let bitrate: Int?
  • Specify an H.264 level that is consistent with your output video settings. If you aren’t sure what level to specify, choose Auto (AUTO).

    Declaration

    Swift

    public let codecLevel: H264CodecLevel?
  • H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License.

    Declaration

    Swift

    public let codecProfile: H264CodecProfile?
  • Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames).

    Declaration

    Swift

    public let dynamicSubGop: H264DynamicSubGop?
  • Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC.

    Declaration

    Swift

    public let entropyEncoding: H264EntropyEncoding?
  • Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs.

    Declaration

    Swift

    public let fieldEncoding: H264FieldEncoding?
  • Adjust quantization within each frame to reduce flicker or ‘pop’ on I-frames.

    Declaration

    Swift

    public let flickerAdaptiveQuantization: H264FlickerAdaptiveQuantization?
  • If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator.

    Declaration

    Swift

    public let framerateControl: H264FramerateControl?
  • Optional. Specify how the transcoder performs framerate conversion. The default behavior is to use duplicate drop conversion.

    Declaration

    Swift

    public let framerateConversionAlgorithm: H264FramerateConversionAlgorithm?
  • When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.

    Declaration

    Swift

    public let framerateDenominator: Int?
  • Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.

    Declaration

    Swift

    public let framerateNumerator: Int?
  • If enable, use reference B frames for GOP structures that have B frames > 1.

    Declaration

    Swift

    public let gopBReference: H264GopBReference?
  • 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.

    Declaration

    Swift

    public let gopClosedCadence: Int?
  • GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.

    Declaration

    Swift

    public let gopSize: Double?
  • Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time.

    Declaration

    Swift

    public let gopSizeUnits: H264GopSizeUnits?
  • Percentage of the buffer that should initially be filled (HRD buffer model).

    Declaration

    Swift

    public let hrdBufferInitialFillPercentage: Int?
  • Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.

    Declaration

    Swift

    public let hrdBufferSize: Int?
  • Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows.

    • If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of “top field first” and “bottom field first”.
    • If the source is progressive, the output will be interlaced with “top field first” or “bottom field first” polarity, depending on which of the Follow options you chose.

    Declaration

    Swift

    public let interlaceMode: H264InterlaceMode?
  • Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.

    Declaration

    Swift

    public let maxBitrate: Int?
  • 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. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1

    Declaration

    Swift

    public let minIInterval: Int?
  • Number of B-frames between reference frames.

    Declaration

    Swift

    public let numberBFramesBetweenReferenceFrames: Int?
  • Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.

    Declaration

    Swift

    public let numberReferenceFrames: Int?
  • Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZE_FROM_SOURCE), uses the PAR from your input video for your output. To specify a different PAR in the console, choose any value other than Follow source. To specify a different PAR by editing the JSON job specification, choose SPECIFIED. When you choose SPECIFIED for this setting, you must also specify values for the parNumerator and parDenominator settings.

    Declaration

    Swift

    public let parControl: H264ParControl?
  • Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parDenominator is 33.

    Declaration

    Swift

    public let parDenominator: Int?
  • Required when you set Pixel aspect ratio (parControl) to SPECIFIED. On the console, this corresponds to any value other than Follow source. When you specify an output pixel aspect ratio (PAR) that is different from your input video PAR, provide your output PAR as a ratio. For example, for D1/DV NTSC widescreen, you would specify the ratio 40:33. In this example, the value for parNumerator is 40.

    Declaration

    Swift

    public let parNumerator: Int?
  • Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is faster, lower quality, single-pass encoding.

    Declaration

    Swift

    public let qualityTuningLevel: H264QualityTuningLevel?
  • Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don’t define Rate control mode.

    Declaration

    Swift

    public let qvbrSettings: H264QvbrSettings?
  • Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR).

    Declaration

    Swift

    public let rateControlMode: H264RateControlMode?
  • Places a PPS header on each encoded picture, even if repeated.

    Declaration

    Swift

    public let repeatPps: H264RepeatPps?
  • Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default. If this output uses QVBR, choose Transition detection (TRANSITION_DETECTION) for further video quality improvement. For more information about QVBR, see https://docs.aws.amazon.com/console/mediaconvert/cbr-vbr-qvbr.

    Declaration

    Swift

    public let sceneChangeDetect: H264SceneChangeDetect?
  • 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.

    Declaration

    Swift

    public let slices: Int?
  • Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly.

    Declaration

    Swift

    public let slowPal: H264SlowPal?
  • Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.

    Declaration

    Swift

    public let softness: Int?
  • Adjust quantization within each frame based on spatial variation of content complexity.

    Declaration

    Swift

    public let spatialAdaptiveQuantization: H264SpatialAdaptiveQuantization?
  • Produces a bitstream compliant with SMPTE RP-2027.

    Declaration

    Swift

    public let syntax: H264Syntax?
  • This field applies only if the Streams > Advanced > Framerate (framerate) field is set to 29.970. This field works with the Streams > Advanced > Preprocessors > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i.

    Declaration

    Swift

    public let telecine: H264Telecine?
  • Adjust quantization within each frame based on temporal variation of content complexity.

    Declaration

    Swift

    public let temporalAdaptiveQuantization: H264TemporalAdaptiveQuantization?
  • Inserts timecode for each frame as 4 bytes of an unregistered SEI message.

    Declaration

    Swift

    public let unregisteredSeiTimecode: H264UnregisteredSeiTimecode?
  • Undocumented

    Declaration

    Swift

    public init(adaptiveQuantization: H264AdaptiveQuantization? = nil, bitrate: Int? = nil, codecLevel: H264CodecLevel? = nil, codecProfile: H264CodecProfile? = nil, dynamicSubGop: H264DynamicSubGop? = nil, entropyEncoding: H264EntropyEncoding? = nil, fieldEncoding: H264FieldEncoding? = nil, flickerAdaptiveQuantization: H264FlickerAdaptiveQuantization? = nil, framerateControl: H264FramerateControl? = nil, framerateConversionAlgorithm: H264FramerateConversionAlgorithm? = nil, framerateDenominator: Int? = nil, framerateNumerator: Int? = nil, gopBReference: H264GopBReference? = nil, gopClosedCadence: Int? = nil, gopSize: Double? = nil, gopSizeUnits: H264GopSizeUnits? = nil, hrdBufferInitialFillPercentage: Int? = nil, hrdBufferSize: Int? = nil, interlaceMode: H264InterlaceMode? = nil, maxBitrate: Int? = nil, minIInterval: Int? = nil, numberBFramesBetweenReferenceFrames: Int? = nil, numberReferenceFrames: Int? = nil, parControl: H264ParControl? = nil, parDenominator: Int? = nil, parNumerator: Int? = nil, qualityTuningLevel: H264QualityTuningLevel? = nil, qvbrSettings: H264QvbrSettings? = nil, rateControlMode: H264RateControlMode? = nil, repeatPps: H264RepeatPps? = nil, sceneChangeDetect: H264SceneChangeDetect? = nil, slices: Int? = nil, slowPal: H264SlowPal? = nil, softness: Int? = nil, spatialAdaptiveQuantization: H264SpatialAdaptiveQuantization? = nil, syntax: H264Syntax? = nil, telecine: H264Telecine? = nil, temporalAdaptiveQuantization: H264TemporalAdaptiveQuantization? = nil, unregisteredSeiTimecode: H264UnregisteredSeiTimecode? = nil)
  • Declaration

    Swift

    public func validate(name: String) throws