<page
    xmlns="http://projectmallard.org/1.0/"
    xmlns:its="http://www.w3.org/2005/11/its"
    type="guide"
    id="limiter">
    <info>
        <link type="guide" xref="index#plugins"/>
    </info>
    <title>Limiter and Auto Volume</title>
    <p>
        A limiter allows signals below a specified input power or level to pass
        unaffected while attenuating (lowering) the peaks of stronger signals that
        exceed this threshold.
    </p>
    <p>
        PulseEffects uses the limiter developed by Calf Studio. We only attached to it a
        routine to automatically set its input gain. This is what we call auto volume.
    </p>
    <section>
        <title>Limiter</title>
        <terms>
            <item>
                <title>
                    <em style="strong" its:withinText="nested">Input Gain</em>
                </title>
                <p>
                    Raises audio volume before it is sent ot the compression stage.
                </p>
            </item>
            <item>
                <title>
                    <em style="strong" its:withinText="nested">Limit</em>
                </title>
                <p>
                    No signal above this level will pass through the limiter.
                </p>
            </item>
            <item>
                <title>
                    <em style="strong" its:withinText="nested">Lookahead</em>
                </title>
                <p>
                    The Limiter will reach its attenuation level in this amount of time (output will
                    be delayed two times this time).
                </p>
            </item>
            <item>
                <title>
                    <em style="strong" its:withinText="nested">Release</em>
                </title>
                <p>
                    Stop the attenuation after this amount of milliseconds.
                </p>
            </item>
            <item>
                <title>
                    <em style="strong" its:withinText="nested">Oversampling</em>
                </title>
                <p>
                    Increase the signal sampling to better detect the peaks. The signal is
                    downsampled after processing.
                </p>
            </item>
            <item>
                <title>
                    <em style="strong" its:withinText="nested">ASC</em>
                </title>
                <p>
                    When gain reduction is always needed ASC takes care of releasing to an average
                    reduction level rather than reaching a reduction of 0 in the release time.
                </p>
            </item>
            <item>
                <title>
                    <em style="strong" its:withinText="nested">ASC Level</em>
                </title>
                <p>
                    Select how much the release time is affected by ASC, 0 means nearly no changes
                    in release time while 1 produces higher release times.
                </p>
            </item>
        </terms>
    </section>
    <section>
        <title>Auto Volume</title>
        <terms>
            <item>
                <title>
                    <em style="strong" its:withinText="nested">Window</em>
                </title>
                <p>
                    The amount of time taken to measure the maximum audio peak.
                </p>
            </item>
            <item>
                <title>
                    <em style="strong" its:withinText="nested">Target</em>
                </title>
                <p>
                    The desired peak value.
                </p>
            </item>
            <item>
                <title>
                    <em style="strong" its:withinText="nested">Tolerance</em>
                </title>
                <p>
                    Maximum tolerated difference between the target level and the current peak
                    level.
                </p>
            </item>
            <item>
                <title>
                    <em style="strong" its:withinText="nested">Threshold</em>
                </title>
                <p>
                    Auto volume works only when the audio level is above the threshold.
                </p>
            </item>
        </terms>
    </section>
    <section>
        <title>References</title>
        <list>
            <item>
                <p>
                    <link href="https://en.wikipedia.org/wiki/Limiter" its:translate="no">
                        https://en.wikipedia.org/wiki/Limiter
                    </link>
                </p>
            </item>
            <item>
                <p>
                    <link href="https://calf-studio-gear.org/doc/Limiter.html" its:translate="no">
                        https://calf-studio-gear.org/doc/Limiter.html
                    </link>
                </p>
            </item>
        </list>
    </section>
</page>