mediaconvert/aws.sdk.kotlin.services.mediaconvert.model/CodecMetadata

CodecMetadata

Codec-specific parameters parsed from the video essence headers. This information provides detailed technical specifications about how the video was encoded, including profile settings, resolution details, and color space information that can help you understand the source video characteristics and make informed encoding decisions.

Types

Builder

class Builder

Companion

object Companion

Properties

bitDepth

val bitDepth: Int?

The number of bits used per color component in the video essence such as 8, 10, or 12 bits. Standard range (SDR) video typically uses 8-bit, while 10-bit is common for high dynamic range (HDR).

chromaSubsampling

val chromaSubsampling: String?

The chroma subsampling format used in the video encoding, such as "4:2:0" or "4:4:4". This describes how color information is sampled relative to brightness information. Different subsampling ratios affect video quality and file size, with "4:4:4" providing the highest color fidelity and "4:2:0" being most common for standard video.

codedFrameRate

val codedFrameRate: FrameRate?

The frame rate of the video or audio track, expressed as a fraction with numerator and denominator values.

colorPrimaries

val colorPrimaries: ColorPrimaries?

The color space primaries of the video track, defining the red, green, and blue color coordinates used for the video. This information helps ensure accurate color reproduction during playback and transcoding.

height

val height: Int?

The height in pixels as coded by the codec. This represents the actual encoded video height as specified in the video stream headers.

level

val level: String?

The codec level or tier that specifies the maximum processing requirements and capabilities. Levels define constraints such as maximum bit rate, frame rate, and resolution.

matrixCoefficients

val matrixCoefficients: MatrixCoefficients?

The color space matrix coefficients of the video track, defining how RGB color values are converted to and from YUV color space. This affects color accuracy during encoding and decoding processes.

profile

val profile: String?

The codec profile used to encode the video. Profiles define specific feature sets and capabilities within a codec standard. For example, H.264 profiles include Baseline, Main, and High, each supporting different encoding features and complexity levels.

scanType

val scanType: String?

The scanning method specified in the video essence, indicating whether the video uses progressive or interlaced scanning.

transferCharacteristics

val transferCharacteristics: TransferCharacteristics?

The color space transfer characteristics of the video track, defining the relationship between linear light values and the encoded signal values. This affects brightness and contrast reproduction.

width

val width: Int?

The width in pixels as coded by the codec. This represents the actual encoded video width as specified in the video stream headers.

Functions

copy

inline fun copy(block: CodecMetadata.Builder.() -> Unit = {}): CodecMetadata

equals

open operator override fun equals(other: Any?): Boolean

hashCode

open override fun hashCode(): Int

toString

open override fun toString(): String