/AWS1/CL_MDLAUDIONORMALIZATI00¶
Audio Normalization Settings
CONSTRUCTOR¶
IMPORTING¶
Optional arguments:¶
iv_algorithm TYPE /AWS1/MDLAUDIONORMALIZATIONALG /AWS1/MDLAUDIONORMALIZATIONALG¶
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.
iv_algorithmcontrol TYPE /AWS1/MDLAUDIONORMALIZATIONA00 /AWS1/MDLAUDIONORMALIZATIONA00¶
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.
iv_targetlkfs TYPE /AWS1/RT_DOUBLE_AS_STRING /AWS1/RT_DOUBLE_AS_STRING¶
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.
iv_peakcalculation TYPE /AWS1/MDLAUDIONORMPEAKCALC /AWS1/MDLAUDIONORMPEAKCALC¶
If set to TRUE_PEAK, calculate the TruePeak for each output's audio track loudness.
iv_peaklimiterthreshold TYPE /AWS1/RT_DOUBLE_AS_STRING /AWS1/RT_DOUBLE_AS_STRING¶
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.
Queryable Attributes¶
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.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ALGORITHM() |
Getter for ALGORITHM, with configurable default |
ASK_ALGORITHM() |
Getter for ALGORITHM w/ exceptions if field has no value |
HAS_ALGORITHM() |
Determine if ALGORITHM has a value |
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.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ALGORITHMCONTROL() |
Getter for ALGORITHMCONTROL, with configurable default |
ASK_ALGORITHMCONTROL() |
Getter for ALGORITHMCONTROL w/ exceptions if field has no va |
HAS_ALGORITHMCONTROL() |
Determine if ALGORITHMCONTROL has a value |
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.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_TARGETLKFS() |
Getter for TARGETLKFS, with configurable default |
ASK_TARGETLKFS() |
Getter for TARGETLKFS w/ exceptions if field has no value |
STR_TARGETLKFS() |
String format for TARGETLKFS, with configurable default |
HAS_TARGETLKFS() |
Determine if TARGETLKFS has a value |
PeakCalculation¶
If set to TRUE_PEAK, calculate the TruePeak for each output's audio track loudness.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PEAKCALCULATION() |
Getter for PEAKCALCULATION, with configurable default |
ASK_PEAKCALCULATION() |
Getter for PEAKCALCULATION w/ exceptions if field has no val |
HAS_PEAKCALCULATION() |
Determine if PEAKCALCULATION has a value |
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.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PEAKLIMITERTHRESHOLD() |
Getter for PEAKLIMITERTHRESHOLD, with configurable default |
ASK_PEAKLIMITERTHRESHOLD() |
Getter for PEAKLIMITERTHRESHOLD w/ exceptions if field has n |
STR_PEAKLIMITERTHRESHOLD() |
String format for PEAKLIMITERTHRESHOLD, with configurable de |
HAS_PEAKLIMITERTHRESHOLD() |
Determine if PEAKLIMITERTHRESHOLD has a value |