vco — Implementation of a band limited, analog modeled oscillator.
Implementation of a band limited, analog modeled oscillator, based on integration of band limited impulses. vco can be used to simulate a variety of analog wave forms.
iwave -- determines the waveform:
iwave = 1 - sawtooth
iwave = 2 - square/PWM
iwave = 3 - triangle/saw/ramp
ifn (optional, default = 1) -- Must point to a valid table which contains a sine wave. Csound will report an error if this parameter is not set and table 1 does not exist.
imaxd (optional, default = 1) -- is the maximum delay time. A time of 1/ifqc may be required for the PWM and triangle waveform. To bend the pitch down this value must be as large as 1/(minimum frequency).
ileak (optional, default = 0) -- if ileak is between zero and one (0 < ileak < 1) then ileak is used as the leaky integrator value. Otherwise a leaky integrator value of .999 is used for the saw and square waves and .995 is used for the triangle wave. This can be used to “flatten” the square wave or “straighten” the saw wave at low frequencies by setting ileak to .99999 or a similar value. This should give a hollower sounding square wave.
inyx (optional, default = .5) -- this is used to determine the number of harmonics in the band limited pulse. All overtones up to sr * inyx will be used. The default gives sr * .5 (sr/2). For sr/4 use inyx = .25. This can generate a “fatter” sound in some cases.
iphs (optional, default = 0) -- this is a phase value. There is an artifact (bug-like feature) in vco which occurs during the first half cycle of the square wave which causes the waveform to be greater in magnitude than all others. The value of iphs has an effect on this artifact. In particular setting iphs to .5 will cause the first half cycle of the square wave to resemble a small triangle wave. This may be more desirable than the large wave artifact which is the current default.
iskip (optional, default = 0) -- if non zero skip the initialisation of the filter. (New in Csound version 4.23f13 and 5.0)
kpw -- determines either the pulse width (if iwave is 2) or the saw/ramp character (if iwave is 3) The value of kpw should be greater than 0 and less than 1. A value of 0.5 will generate either a square wave (if iwave is 2) or a triangle wave (if iwave is 3).
xamp -- determines the amplitude
xcps -- is the frequency of the wave in cycles per second.
Here is an example of the vco opcode. It uses the file vco.csd.
Example 1152. Example of the vco opcode.
See the sections Real-time Audio and Command Line Flags for more information on using command line flags.
<CsoundSynthesizer> <CsOptions> ; Select audio/midi flags here according to platform -odac ;;;realtime audio out ;-iadc ;;;uncomment -iadc if realtime audio input is needed too ; For Non-realtime ouput leave only the line below: ;-o vco.wav -W ;;; for file output any platform </CsOptions> <CsInstruments> sr = 44100 ksmps = 32 nchnls = 2 0dbfs = 1 instr 1 kamp = .4 kcps = cpspch(p4) iwave = p5 ; Select the wave form kpw init 0.5 ; Set the pulse-width/saw-ramp character. ifn = 1 asig vco kamp, kcps, iwave, kpw, ifn outs asig, asig endin </CsInstruments> <CsScore> f 1 0 65536 10 1 ; a sine wave. ; pitch-class waveform i 1 00 02 05.00 1 ; saw i 1 02 02 05.00 2 ; square i 1 04 02 05.00 3 ; tri/saw/ramp i 1 06 02 07.00 1 i 1 08 02 07.00 2 i 1 10 02 07.00 3 i 1 12 02 09.00 1 i 1 14 02 09.00 2 i 1 16 02 09.00 3 i 1 18 02 11.00 1 i 1 20 02 11.00 2 i 1 22 02 11.00 3 e </CsScore> </CsoundSynthesizer>