xin

xin — Passse des variables à un bloc d'opcode défini par l'utilisateur.

Description

Les opcodes xin et xout copient des variables vers et depuis la définition de l'opcode, permettant la communication avec l'instrument appelant.

Les types des variables d'entrée et de sortie sont définis par les paramètres intypes et outtypes.

[Note] Notes

  • xin et xout ne doivent être appelés qu'une fois, et xin doit précéder xout, sinon il pourra y avoir une erreur d'initialisation et une désactivation de l'instrument courant.

  • Ces opcodes ne sont exécutés que pendant l'initialisation. La copie pendant l'exécution se fait par l'appel de l'opcode défini par l'utilisateur. Cela veut dire que si l'on veut ignorer xin ou xout avec kgoto, cela ne marche pas alors que igoto affecte à la fois les opérations de l'initialisation et de l'exécution.

Syntaxe

xinarg1 [, xinarg2] ... [xinargN] xin

Exécution

xinarg1, xinarg2, ... - arguments d'entrée. Le nombre et le type des variables doit concorder avec la déclaration intypes de l'opcode défini par l'utilisateur. Cependant xin ne vérifie pas si l'utilisation des variables d'initialisation et du taux de contrôle est correcte.

La syntaxe d'un bloc d'opcode défini par l'utilisateur est la suivante :

opcode  name, outtypes, intypes
xinarg1 [, xinarg2] [, xinarg3] ... [xinargN]  xin
[setksmps  iksmps]
... the rest of the instrument's code.
xout  xoutarg1 [, xoutarg2] [, xoutarg3] ... [xoutargN]
endop
      

On peut alors utiliser le nouvel opcode avec la syntaxe usuelle :


[xinarg1] [, xinarg2] ... [xinargN]  name  [xoutarg1] [, xoutarg2] ... [xoutargN] [, iksmps]
      

Exemples

Voir l'exemple de l'opcode opcode.

Voir aussi

endop, opcode, setksmps, xout

Crédits

Auteur : Istvan Varga, 2002 ; basé sur du code par Matt J. Ingalls

Nouveau dans la version 4.22