pyinit — Initialise l'interpréteur Python.
Opcode du greffon py. Ce greffon se trouve dans le répertoire des greffons et il doit être installé séparément. Le répertoire des greffons est ici : https://github.com/csound/plugins
Dans Csound, il faut d'abord invoquer l'opcode pyinit dans l'en-tête de l'orchestre pour initialiser l'interpréteur Python, avant d'utiliser n'importe quel autre des opcodes Python.
Mais si l'on utilise les opcodes Python dans la version CsoundAC de Csound
ou depuis un frontal en python utilisant le module csnd6,
il n'est pas nécessaire d'invoquer pyinit, car
l'interpréteur est déjà initialisé. Dans ce cas, CsoundAC (ou le module
python csnd6) crée automatiquement une interface Python à l'API de Csound.
Dans CsoundAC cela existe sous la forme d'une
instance globale de la classe CsoundAC.CppSound
, nommée
csound
. Dans un frontal en python qui importe le module
csnd6, le nom de la variable contenant l'instance de Csound dépend du code
du frontal. Ainsi, le code Python écrit dans l'orchestre de
Csound a accès à l'objet global csound
.
L'instance courante de Csound dans laquelle pyinit a été appelé est mémorisée dans une variable globale de python appelée _CSOUND_. Celle-ci contient l'adresse mémoire de l'instance et l'on peut l'utiliser avec le module csnd6 via l'appel csoundGetInstance(instance). Cette fonction python retourne un objet que l'on peut utiliser avec toutes les fonctions de l'API de Csound.