The Alternative Csound Reference Manual
Previous |  | Next

# mute

mute -- Mutes/unmutes new instances of a given instrument.

## Description

Mutes/unmutes new instances of a given instrument.

## Syntax

mute insnum [, iswitch]

mute "insname" [, iswitch]

## Initialization

insnum -- instrument number. Equivalent to p1 in a score i statement.

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

iswitch (optional, default=0) -- represents a switch to mute/unmute an instrument. A value of 0 will mute new instances of an instrument, other values will unmute them. The default value is 0.

## Performance

All new instances of instrument inst will me muted (iswitch = 0) or unmuted (iswitch not equal to 0). There is no difficulty with muting muted instruments or unmuting unmuted instruments. The mechanism is the same as used by the score q statement. For example, it is possible to mute in the score and unmute in some instrument.

Muting/Unmuting is indicated by a message (depending on message level).

## Examples

Here is an example of the mute opcode. It uses the files mute.orc and mute.sco.

Example 1. Example of the mute opcode.

    /* mute.orc */
    ; Initialize the global variables.
    sr = 44100
    kr = 4410
    ksmps = 10
    nchnls = 1

    ; Mute Instrument #2.
    mute 2

    ; Instrument #1.
    instr 1
      a1 oscils 10000, 440, 0
      out a1
    endin

    ; Instrument #2.
    instr 2
      a1 oscils 10000, 880, 0
      out a1
    endin
    /* mute.orc */

    /* mute.sco */
    ; Play Instrument #1 for one second.
    i 1 0 1
    ; Play Instrument #2 for one second.
    i 2 0 1
    e
    /* mute.sco */

## Credits

Example written by Kevin Conder.

New in version 4.22

Previous | Home | Next
multitap | Up | mxadsr