Interface AudioNormalizationSettings.Builder

All Superinterfaces:
Buildable, CopyableBuilder<AudioNormalizationSettings.Builder,AudioNormalizationSettings>, SdkBuilder<AudioNormalizationSettings.Builder,AudioNormalizationSettings>, SdkPojo
Enclosing class:
AudioNormalizationSettings

public static interface AudioNormalizationSettings.Builder extends SdkPojo, CopyableBuilder<AudioNormalizationSettings.Builder,AudioNormalizationSettings>
  • Method Details

    • 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

      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 enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.
      Parameters:
      algorithmControl - When enabled the output audio is corrected using the chosen algorithm. If disabled, 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

      When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.
      Parameters:
      algorithmControl - When enabled the output audio is corrected using the chosen algorithm. If disabled, 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:
    • correctionGateLevel

      AudioNormalizationSettings.Builder correctionGateLevel(Integer correctionGateLevel)
      Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected.
      Parameters:
      correctionGateLevel - Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • loudnessLogging

      AudioNormalizationSettings.Builder loudnessLogging(String loudnessLogging)
      If set to LOG, log each output's audio track loudness to a CSV file.
      Parameters:
      loudnessLogging - If set to LOG, log each output's audio track loudness to a CSV file.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • loudnessLogging

      If set to LOG, log each output's audio track loudness to a CSV file.
      Parameters:
      loudnessLogging - If set to LOG, log each output's audio track loudness to a CSV file.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • peakCalculation

      AudioNormalizationSettings.Builder peakCalculation(String peakCalculation)
      If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness.
      Parameters:
      peakCalculation - If set to TRUE_PEAK, calculate and log 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

      If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness.
      Parameters:
      peakCalculation - If set to TRUE_PEAK, calculate and log 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:
    • targetLkfs

      When you use Audio normalization, optionally use this setting to specify a target loudness. If you don't specify a value here, the encoder chooses a value for you, based on the algorithm that you choose for Algorithm. If you choose algorithm 1770-1, the encoder will choose -24 LKFS; otherwise, the encoder will choose -23 LKFS.
      Parameters:
      targetLkfs - When you use Audio normalization, optionally use this setting to specify a target loudness. If you don't specify a value here, the encoder chooses a value for you, based on the algorithm that you choose for Algorithm. If you choose algorithm 1770-1, the encoder will choose -24 LKFS; otherwise, the encoder will choose -23 LKFS.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • truePeakLimiterThreshold

      AudioNormalizationSettings.Builder truePeakLimiterThreshold(Double truePeakLimiterThreshold)
      Specify the True-peak limiter threshold in decibels relative to full scale (dBFS). The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Enter a value from 0 to -8. Leave blank to use the default value 0.
      Parameters:
      truePeakLimiterThreshold - Specify the True-peak limiter threshold in decibels relative to full scale (dBFS). The peak inter-audio sample loudness in your output will be limited to the value that you specify, without affecting the overall target LKFS. Enter a value from 0 to -8. Leave blank to use the default value 0.
      Returns:
      Returns a reference to this object so that method calls can be chained together.