Débuter avec Csound
Précédent | Préface | Suivant

## Débuter avec Csound

### Téléchargement

Si vous n'avez pas déjà installé Csound (ou si vous avez une ancienne version) téléchargez la version de Csound adaptée à votre plate-forme depuis la page de téléchargement de Csound sur Github. Les programmes d'installation pour Windows ont un suffixe '.exe' et ceux pour le Mac '.dmg'. Si le nom du programme d'installation se termine en '-d' cela veut dire qu'il a été construit avec la double précision (64-bit) qui produit une sortie de meilleure qualité que la simple précision (32-bit). Les versions en simple précision produisent une sortie plus rapide, ce qui peut être important si l'on utilise Csound en temps réel. Vous pouvez aussi télécharger les sources et les compiler, mais cela réclame plus d'expertise (voir la section Construire Csound).

Il est aussi utile de télécharger la version la plus récente de ce manuel, que vous trouverez également sur ce site.

### Exécution

Il y a différentes manières d'exécuter Csound. Comme Csound est un programme en ligne de commande (DOS dans la terminologie Windows), double-cliquer sur l'exécutable de Csound n'aura aucun effet. On doit appeler Csound soit depuis un terminal (ou invite DOS), soit depuis un frontal. Pour utiliser Csound en ligne de commande, vous devez ouvrir un terminal (une invite de commande DOS sous Windows ou un terminal sous MacOS). L'utilisation de Csound en ligne de commande pouvant sembler difficile si vous n'avez jamais utilisé de terminal, vous voudrez peut-être essayer un des frontaux, soit QuteCsound, qui est inclus dans les distributions récentes, soit un autre frontal. Un frontal est un programme graphique qui facilite l'exécution de Csound. La plupart des frontaux comprennent des éditeurs de texte permettant d'éditer les fichiers csound, et plusieurs d'entre eux offrent d'autres possibilités intéressantes.

Que ce soit avec un frontal ou en ligne de commande, l'exécution de Csound nécessite deux choses :

- Un fichier Csound ('.csd' ou bien un fichier '.orc' et un fichier '.sco')
- Une liste d'options de ligne de commande qui configurent l'exécution. Ils déterminent des éléments comme le nom et le format du fichier de sortie, si l'audio en temps réel et MIDI sont actifs, quelle carte son utiliser, la taille des tampons, les types de messages imprimés, etc. On peut inclure ces options dans le fichier '.csd' lui-même ; ainsi dans le cas des exemples inclus dans ce manuel, vous ne devriez pas avoir à vous en soucier. Les programmes frontaux ont souvent des boîtes de dialogue permettant de fixer les options de ligne de commande. On peut trouver la liste complète et très longue des options de ligne de commande ici, mais vous voudrez peut-être la consulter plus tard...

Consultez la section Configuration si vous rencontrez des problèmes avec Csound.

Cette documentation comprend de nombreux fichiers '.csd' que vous pouvez tester, et qui devraient fonctionner directement depuis la ligne de commande ou depuis n'importe quel frontal. oscil.csd est un exemple simple que l'on peut trouver dans le répertoire des exemples de cette documentation. Votre frontal devrait vous permettre de choisir le fichier, et il devrait avoir un bouton "Jouer" ou "Restituer" permettant d'entendre ce fichier. Si l'on veut manipuler ce fichier pour expérimentation, il vaut mieux utiliser la commande "Enregistrer sous..." du frontal pour copier le fichier dans un autre répertoire du disque dur, tel qu'un répertoire "partition csound" créé à cet effet.

| Note pour les utilisateurs de MacCsound
Il peut être nécessaire d'effacer toutes les lignes de la balise des options de commande afin de faire fonctionner les exemples du manuel.

Vous pouvez aussi essayer les exemples à partir de la ligne de commande en vous déplaçant dans le répertoire des exemples du manuel avec ce type de commande sous Windows (en supposant que le manuel est situé en c:\Program Files\Csound\manual\) :

    cd "c:\Program Files\Csound\manual\examples"

ou quelque chose comme :

    cd /manualdirectory/manual/examples

pour les terminaux Mac ou linux et en tapant ensuite :

    csound oscil.csd

Les fichiers exemples étant configurés pour fonctionner en temps réel par défaut, vous devriez avoir entendu une onde sinusoïdale de 2 secondes.

### Ecrire vos propres fichiers .csd

Un fichier .csd ressemble à ceci (ce fichier est oscils.csd) :

    <CsoundSynthesizer>
    <CsOptions>
    ; Select audio/midi flags here according to platform
    -odac    ;;;realtime audio out
    ;-iadc    ;;;uncomment -iadc if realtime audio input is needed too
    ; For Non-realtime ouput leave only the line below:
    ; -o oscils.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>

    sr = 44100
    ksmps = 32
    nchnls = 2
    0dbfs  = 1

    instr 1

    iflg = p4
    asig oscils .7, 220, 0, iflg
         outs asig, asig

    endin
    </CsInstruments>
    <CsScore>

    i 1 0 2 0
    i 1 3 2 2	;double precision
    e
    </CsScore>
    </CsoundSynthesizer>

Les fichiers .csd de Csound comprennent 3 sections principales entre les balises <CsSynthesizer> et </CsSynthesizer> :

- CsOptions - Contient les options de ligne de commande spécifiques à ce fichier particulier. Ces options peuvent aussi être définies dans le fichier .csound6rc que l'on peut modifier avec un éditeur de texte, ou directement dans la ligne de commande. Certains frontaux offrent également des moyens de spécifier les options globales ou locales.
- CsInstruments - Contient les instruments ou processus disponibles dans ce fichier. Les instruments sont définis en utilisant les opcodes instr et endin. La section CsInstruments contient aussi l'en-tête de l'orchestre qui définit des choses comme le taux d'échantillonnage, le nombre d'échantillons dans une période de contrôle et le nombre de canaux de sortie.
- CsScore - Contient les "notes" à jouer et, en option, la définition de ftables. Les notes sont crées en utilisant l'instruction i, et les ftables sont crées en utilisant l'instruction f. Plusieurs autres instructions de partition sont disponibles.

Notez que tout ce qui suit un point-virgule (;) jusqu'à la fin de la ligne est un commentaire, et est ignoré par Csound.

Vous pouvez écrire les fichiers csd dans n'importe quel éditeur de texte pur comme notepad ou textedit. Si vous utilisez un traitement de texte (non recommandé), assurez vous de sauvegarder le fichier en texte pur (et non en texte enrichi). De nombreux frontaux proposent des capacités d'édition avancées avec coloration syntaxique et complétion automatique du code.

Vous pouvez trouver ici un tutoriel détaillé pour débuter avec Csound, écrit par Michael Gogins.

Précédent | Niveau supérieur | Suivant
Mentions de copyright | Sommaire | Les nouveautés de Csound 6.16.0