pyinit Opcodes

pyinit — Initialise l'interpréteur Python.

Syntaxe

          
            pyinit
          
        

Description

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.

Crédits

Copyright (c) 2002 Maurizio Umberto Puxeddu. Tous droits réservés. Certaines parties, copyright (c) 2004 et 2005 Michael Gogins et (c) 2013, V. Lazzarini.