The Alternative Csound Reference Manual
Previous |  | Next

# ftchnls

ftchnls -- Returns the number of channels in a stored function table.

## Description

Returns the number of channels in a stored function table.

## Syntax

ftchnls(x) (init-rate args only)

## Performance

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.

## Examples

Here is an example of the ftchnls opcode. It uses the files ftchnls.orc, ftchnls.sco, and mary.wav.

Example 1. 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

## See Also

ftlen, ftlptim, ftsr, nsamp

## Credits

Author: Chris McCormick
Perth, Australia
December 2001

Example written by Kevin Conder.

Previous | Home | Next
frac | Up | ftgen