clear — Zeroes a list of audio signals.
avar1, avar2, avar3, ... -- signals to be zeroed
avar[] -- array of signals to be cleared.
kvar[] ... -- array of k-values to be cleared.
Note | |
---|---|
Before version 6.13 this opcode was not compatible with multicore operations if used with a global variable. |
clear sets every sample of each of the given audio signals to zero when it is performed. This is equivalent to writing avarN = 0 in the orchestra for each of the specified variables. Typically, clear is used with global variables that combine multiple signals from different sources and change with each k-pass (performance loop) through all of the active instrument instances. After the final usage of such a variable and before the next k-pass, it is necessary to clear the variable so that it does not add the next cycle's signals to the previous result. clear is especially useful in combination with vincr (variable increment) and they are intended to be used together with file output opcodes such as fout
Here is an example of the clear opcode. Play clear.csd
Example 143. Example of the clear opcode.
<CsoundSynthesizer> <CsOptions> ; Select audio/midi flags here according to platform -odac ;;;realtime audio out ;-iadc ;;;uncomment -iadc if RT audio input is needed too ; For Non-realtime ouput leave only the line below: ; -o clear.wav -W ;;; for file output any platform </CsOptions> <CsInstruments> sr = 44100 ksmps = 32 nchnls = 2 0dbfs = 1 gaReverb init 0 instr 1 idur = p3 kpitch = p4 a1 diskin2 "fox.wav", kpitch a1 = a1*.5 ;reduce volume vincr gaReverb, a1 endin instr 99 ; global reverb al, ar reverbsc gaReverb, gaReverb, .8, 10000 outs gaReverb+al, gaReverb+ar clear gaReverb endin </CsInstruments> <CsScore> i1 0 3 1 i99 0 5 e </CsScore> </CsoundSynthesizer>
See the fout opcode for another example.