turnoff
Précédent | Opcodes et opérateurs de l'orchestre | Suivant

## turnoff

turnoff — Permet à un instrument de s'arrêter lui-même.

## Description

Permet à un instrument de s'arrêter lui-même ou d'arrêter une instance d'un autre instrument.

## Syntaxe

                turnoff

    turnoff inst

    turnoff knst

## Initialisation

inst -- descripteur d'instance d'un instrument à arrêter (obtenu d'un opcode nstance).

## Exécution

turnoff -- sans paramètre cette instruction de la phase d'exécution permet à un instrument de s'arrêter lui-même. Quelle soit de durée finie ou « tenue », la note en cours d'exécution par l'instrument est immédiatement enlevée de la liste des notes actives. Aucune autre note n'est affectée.

kinst -- descripteur d'instance d'un instrument à arrêter (obtenu d'un opcode nstance).

## Exemples

L'exemple suivant utilise l'opcode turnoff. Il provoque la fin d'une note lorsqu'un signal de contrôle dépasse un certain seuil (ici la fréquence de Nyquist). Il utilise le fichier turnoff.csd.

Exemple 987. Exemple de l'opcode turnoff.

Voir les sections Audio en Temps Réel et Options de la Ligne de Commande pour plus d'information sur l'utilisation des options de la ligne de commande.

    <CsoundSynthesizer>
    <CsOptions>
    ; Select audio/midi flags here according to platform
    ; Audio out   Audio in
    -odac           -iadc    ;;;RT audio I/O
    ; For Non-realtime ouput leave only the line below:
    ; -o turnoff.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>

    ; Initialize the global variables.
    sr = 44100
    kr = 4410
    ksmps = 10
    nchnls = 1

    ; Instrument #1.
    instr 1
      k1 expon 440, p3/10,880     ; begin gliss and continue
      if k1 < sr/2  kgoto contin  ; until Nyquist detected
        turnoff  ; then quit

    contin:
      a1 oscil 10000, k1, 1
      out a1
    endin

    </CsInstruments>
    <CsScore>

    ; Table #1: an ordinary sine wave.
    f 1 0 32768 10 1

    ; Play Instrument #1 for 4 seconds.
    i 1 0 4
    e

    </CsScore>
    </CsoundSynthesizer>

## Voir aussi

ihold turnoff2, turnon

Précédent | Niveau supérieur | Suivant
trsplit | Sommaire | turnoff2