massign
Prev | Orchestra Opcodes and Operators | Next

## massign

massign — Assigns a MIDI channel number to a Csound instrument.

## Description

Assigns a MIDI channel number to a Csound instrument.

## Syntax

    massign ichnl, insnum[, ireset]

    massign ichnl, "insname"[, ireset]

## Initialization

ichnl -- MIDI channel number (1-16).

insnum -- Csound orchestra instrument number. If zero or negative, the channel is muted (i.e. it doesn't trigger a csound instrument, though information will still be received by opcodes like midiin).

“insname” -- A string (in double-quotes) representing a named instrument.

ireset -- If non-zero resets the controllers; default is to reset.

## Performance

Assigns a MIDI channel number to a Csound instrument. Also useful to make sure a certain instrument (if its number is from 1 to 16) will not be triggered by midi noteon messages (if using something midiin to interpret midi information). In this case set insnum to 0 or a negative number.

If ichan is set to 0, the value of insnum is used for all channels. This way you can route all MIDI channels to a single Csound instrument. You can also disable triggering of instruments from MIDI note events from all channels with the following line:

    massign 0,0

This can be useful if you are doing all MIDI evaluation within Csound with an always on instrument(e.g. using midiin and turnon) to avoid doubling the instrument when a note is played.

## Examples

Here is an example of the massign opcode. It uses the file massign.csd.

Example 430. Example of the massign 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  -+rtmidi=virtual -M0    ;;;realtime audio out and realtime midi in
    ;-iadc    ;;;uncomment -iadc if realtime audio input is needed too
    ; For Non-realtime ouput leave only the line below:
    ;-o massign.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>

    sr = 44100
    ksmps = 32
    nchnls = 2
    0dbfs  = 1

    giengine fluidEngine
    ; soundfont path to manual/examples
    isfnum	 fluidLoad "19Trumpet.sf2", giengine, 1
    	 fluidProgramSelect giengine, 1, isfnum, 0, 56

    massign 0,0	;disable triggering of all instruments on all channels, but
    massign 12,10	;assign instr. 10 to midi channel 12
    massign 3,30	;assign instr. 30 to midi channel 3

    instr 10
    ; only on midi channel 12
    	mididefault   60, p3
    	midinoteonkey p4, p5
    ikey	init p4
    ivel	init p5
    	fluidNote giengine, 1, ikey, ivel
    endin

    instr 30
    ; only on midi channel 3
    icps cpsmidi
    asig oscils .6, icps, 0
         outs asig, asig
    endin

    instr 99
    ; output sound from fluidengine
    imvol  init 7
    asigl, asigr fluidOut giengine
           outs asigl*imvol, asigr*imvol
    endin
    </CsInstruments>
    <CsScore>

    i 10 0 2 60 100 ;play one note from score and...
    i 30 2 2
    i 99 0 60	;play virtual keyboard for 60 sec.
    e

    </CsScore>
    </CsoundSynthesizer>

## See Also

ctrlinit

## Credits

Author: Barry L. Vercoe - Mike Berry
MIT, Cambridge, Mass.

New in Csound version 3.47

ireset parameter new in Csound5

Thanks goes to Rasmus Ekman for pointing out the correct MIDI channel range.

Prev | Up | Next
marimba | Home | max