Interface AudioNormalizationSettings.Builder

All Superinterfaces:
Buildable, CopyableBuilder<AudioNormalizationSettings.Builder,AudioNormalizationSettings>, SdkBuilder<AudioNormalizationSettings.Builder,AudioNormalizationSettings>, SdkPojo
Enclosing class:
AudioNormalizationSettings
@Mutable @NotThreadSafe public static interface AudioNormalizationSettings.Builder extends SdkPojo, CopyableBuilder<AudioNormalizationSettings.Builder,AudioNormalizationSettings>

  • Method Details

    • algorithm

      AudioNormalizationSettings.Builder algorithm(String algorithm)
      Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.
      Parameters:
      algorithm - Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • algorithm

      AudioNormalizationSettings.Builder algorithm(AudioNormalizationAlgorithm algorithm)
      Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.
      Parameters:
      algorithm - Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • algorithmControl

      AudioNormalizationSettings.Builder algorithmControl(String algorithmControl)
      When set to correctAudio the output audio is corrected using the chosen algorithm. If set to measureOnly, the audio will be measured but not adjusted.
      Parameters:
      algorithmControl - When set to correctAudio the output audio is corrected using the chosen algorithm. If set to measureOnly, the audio will be measured but not adjusted.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • algorithmControl

      AudioNormalizationSettings.Builder algorithmControl(AudioNormalizationAlgorithmControl algorithmControl)
      When set to correctAudio the output audio is corrected using the chosen algorithm. If set to measureOnly, the audio will be measured but not adjusted.
      Parameters:
      algorithmControl - When set to correctAudio the output audio is corrected using the chosen algorithm. If set to measureOnly, the audio will be measured but not adjusted.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • targetLkfs

      AudioNormalizationSettings.Builder targetLkfs(Double targetLkfs)
      Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act recommends a target of -24 LKFS. The EBU R-128 specification recommends a target of -23 LKFS.
      Parameters:
      targetLkfs - Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act recommends a target of -24 LKFS. The EBU R-128 specification recommends a target of -23 LKFS.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • peakCalculation

      AudioNormalizationSettings.Builder peakCalculation(String peakCalculation)
      If set to TRUE_PEAK, calculate the TruePeak for each output's audio track loudness.
      Parameters:
      peakCalculation - If set to TRUE_PEAK, calculate the TruePeak for each output's audio track loudness.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • peakCalculation

      AudioNormalizationSettings.Builder peakCalculation(AudioNormalizationPeakCalculation peakCalculation)
      If set to TRUE_PEAK, calculate the TruePeak for each output's audio track loudness.
      Parameters:
      peakCalculation - If set to TRUE_PEAK, calculate the TruePeak for each output's audio track loudness.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • peakLimiterThreshold

      AudioNormalizationSettings.Builder peakLimiterThreshold(Double peakLimiterThreshold)
      Peak limiter threshold in decibels relative to true peak (dBTP) if TRUE_PEAK is enabled. If TRUE_PEAK is not enabled a full scale (dbFS) value is used. The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Leave blank to use the default value 0.
      Parameters:
      peakLimiterThreshold - Peak limiter threshold in decibels relative to true peak (dBTP) if TRUE_PEAK is enabled. If TRUE_PEAK is not enabled a full scale (dbFS) value is used. The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Leave blank to use the default value 0.
      Returns:
      Returns a reference to this object so that method calls can be chained together.