Returns the number of channels of a GEN01 table, determined from the header of the original file. If the original file has no header or the table was not created by these GEN01, ftchnls returns -1.
Here is an example of the ftchnls opcode. It uses the files ftchnls.orc, ftchnls.sco, and mary.wav.
Example 163. Example of the ftchnls opcode.
/* ftchnls.orc */ ; Initialize the global variables. sr = 44100 kr = 4410 ksmps = 10 nchnls = 1 ; Instrument #1. instr 1 ; Print out the number of channels in Table #1. ichnls = ftchnls(1) print ichnls endin /* ftchnls.orc */
/* ftchnls.sco */ ; Table #1: Use an audio file, Csound will determine its size. f 1 0 0 1 "mary.wav" 0 0 0 ; Play Instrument #1 for 1 second. i 1 0 1 e /* ftchnls.sco */
Since the audio file “mary.wav” is monophonic (1 channel), its output should include a line like this:
instr 1: ichnls = 1.000