rsc3/doc-schelp/HelpSource/Classes/Normalizer.scrbl

74 lines
1.2 KiB
Racket

#lang scribble/manual
@(require (for-label racket))
@title{Normalizer}
Flattens dynamics.@section{related}
Classes/Amplitude, Classes/Compander, Classes/CompanderD, Classes/Limiter
@section{categories}
UGens>Dynamics
@section{description}
Normalizes the input amplitude to the given level. Normalizer will not
overshoot like link::Classes/Compander:: will, but it needs to look
ahead in the audio. Thus there is a delay equal to twice the value
of the
@racketblock[dur:: parameter.
]
@section{classmethods}
@section{method}
ar
@section{argument}
in
The signal to be processed.
@section{argument}
level
The peak output amplitude level to which to normalize the input.
@section{argument}
dur
The buffer delay time. Shorter times will produce smaller delays
and quicker transient response times, but may introduce amplitude
modulation artifacts.
@section{Examples}
@racketblock[
(
// example signal to process
Synth.play({
var z;
z = Decay2.ar(
Impulse.ar(8, LFSaw.kr(0.25, -0.6, 0.7)),
0.001, 0.3, FSinOsc.ar(500));
}, 0.8)
)
(
Synth.play({
var z;
z = Decay2.ar(
Impulse.ar(8, LFSaw.kr(0.25, -0.6, 0.7)),
0.001, 0.3, FSinOsc.ar(500));
[z, Normalizer.ar(z, 0.4, 0.01)]
}, 0.5)
)
::
]