Merge pull request #506 from andrewcsmith/patch-2
[supercollider.git] / HelpSource / Classes / Blip.schelp
blobed398b045bde76a617e388b8bb2ded829801ca4b
1 class:: Blip
2 summary:: Band limited impulse oscillator.
3 related:: Classes/Impulse
4 categories::  UGens>Generators>Deterministic
7 Description::
9 Band Limited ImPulse generator. All harmonics have equal amplitude.
10 This is the equivalent of 'buzz' in  emphasis::MusicN:: languages.
12 emphasis::Synth-O-Matic:: (1990) had an impulse generator
13 called blip, hence that name here rather than 'buzz'.
15 It is improved from other implementations in that it will crossfade
16 in a control period when the number of  harmonics changes,
17 so that there are no audible pops. It also eliminates the divide in
18 the formula by using a 1/sin table (with special precautions taken for
19 1/0).  The lookup tables are linearly interpolated for better quality.
21 warning::
22 This waveform in its raw form could be damaging to your ears at high
23 amplitudes or for long periods.
26 classmethods::
28 method::ar
30 argument::freq
31 Frequency in Hertz.
33 argument::numharm
34 Number of harmonics. This may be lowered internally if it would cause aliasing.
36 argument::mul
38 argument::add
40 Examples::
42 code::
43 // modulate frequency
44 { Blip.ar(XLine.kr(20000,200,6),100,0.2) }.play;
46 // modulate numharmonics
47 { Blip.ar(200,Line.kr(1,100,20),0.2) }.play;