Interface CodecMetadata.Builder

  • Method Details

    • bitDepth

      CodecMetadata.Builder bitDepth(Integer bitDepth)
      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).
      Parameters:
      bitDepth - 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).
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • chromaSubsampling

      CodecMetadata.Builder chromaSubsampling(String chromaSubsampling)
      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.
      Parameters:
      chromaSubsampling - 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • codedFrameRate

      CodecMetadata.Builder codedFrameRate(FrameRate codedFrameRate)
      The frame rate of the video or audio track, expressed as a fraction with numerator and denominator values.
      Parameters:
      codedFrameRate - The frame rate of the video or audio track, expressed as a fraction with numerator and denominator values.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • codedFrameRate

      default CodecMetadata.Builder codedFrameRate(Consumer<FrameRate.Builder> codedFrameRate)
      The frame rate of the video or audio track, expressed as a fraction with numerator and denominator values. This is a convenience method that creates an instance of the FrameRate.Builder avoiding the need to create one manually via FrameRate.builder().

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to codedFrameRate(FrameRate).

      Parameters:
      codedFrameRate - a consumer that will call methods on FrameRate.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • colorPrimaries

      CodecMetadata.Builder colorPrimaries(String 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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • colorPrimaries

      CodecMetadata.Builder colorPrimaries(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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • height

      The height in pixels as coded by the codec. This represents the actual encoded video height as specified in the video stream headers.
      Parameters:
      height - The height in pixels as coded by the codec. This represents the actual encoded video height as specified in the video stream headers.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • level

      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.
      Parameters:
      level - 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • matrixCoefficients

      CodecMetadata.Builder matrixCoefficients(String 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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • matrixCoefficients

      CodecMetadata.Builder matrixCoefficients(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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • profile

      CodecMetadata.Builder profile(String profile)
      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.
      Parameters:
      profile - 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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • scanType

      CodecMetadata.Builder scanType(String scanType)
      The scanning method specified in the video essence, indicating whether the video uses progressive or interlaced scanning.
      Parameters:
      scanType - The scanning method specified in the video essence, indicating whether the video uses progressive or interlaced scanning.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • transferCharacteristics

      CodecMetadata.Builder transferCharacteristics(String 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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • transferCharacteristics

      CodecMetadata.Builder transferCharacteristics(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.
      Parameters:
      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.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • width

      The width in pixels as coded by the codec. This represents the actual encoded video width as specified in the video stream headers.
      Parameters:
      width - The width in pixels as coded by the codec. This represents the actual encoded video width as specified in the video stream headers.
      Returns:
      Returns a reference to this object so that method calls can be chained together.