# Manuel de Hydrogen

Antonio
Piraino
Alessandro
Cominu
03/nov/2003

Hydrogen est un synthétiseur logiciel utilisable soit indépendament, comme émulateur d'une boite à rythme basée sur des motifs, soit via un synthétiseur ou séquenceur logiciel MIDI externe.

## Introduction

### Téléchargement

La dernière version stable de Hydrogen est disponible à l'adresse http://hydrogen.sourceforge.net

Vous pouvez également télécharger directement les sources depuis les snapshots CVS avec :

    bash$ cvs -z3 -d:pserver:anonymous@cvs.hydrogen.sourceforge.net:/cvsroot/hydrogen co libhydrogen

    bash$ cvs -z3 -d:pserver:anonymous@cvs.hydrogen.sourceforge.net:/cvsroot/hydrogen co hydrogen

### Compilation

Après avoir téléchargé et décompressé les archives .tar.gz, il n'y a plus qu'à tapper :

    bash$ cd hydrogen-*
    bash$ ./configure
    bash$ make
    bash$ su -c "make install"

Avant de compiler, vérifiez si vous ne souhaitez pas utiliser l'une des options additionnelles avec :

    bash$ ./configure --help

### Configuration du pilote audio

Il est très important de choisir le bon pilote audio pour votre système car ce choix peut avoir une importance non négligeable sur les performances générales du logiciel. Vous avez le choix entre les pilotes OSS et Jack.

#### Le pilote OSS

Le pilote OSS utilise /dev/dsp et est basé sur l'interface OSS qui est utilisable avec la pluspart des cartes sons disponibles sous Linux. Cela dit, l'utilisation de OSS bloque /dev/dsp jusqu'à ce que Hydrogen soit fermé, rendant son utilisation par d'autres logiciels impossible.

#### Le pilote Jack

Le pilote Jack nécessite que son serveur (Jack Audio Connection Kit) soit actif pour fonctionner. Il s'agit d'un serveur audio professionel qui permet une latence très faible et des échanges avec d'autres logiciels musicaux. Nous vous recommandons fortement son usage si vous voulez tirer le meilleur d'Hydrogen.

## Interface graphique

### La bare d'outils principale

Avant de nous occuper des deux fenêtres principales, jetons un coup d'oeil sur la barre d'outils :

- Joue un morceau ou un motif [Hotkey = Spacebar]

- Stoppe un morceau ou un motif [Hotkey = Spacebar]

- Active le mode 'Motif'.

- Active le mode 'Morceau'.

- Change le tempo (échelle : 40-300 bpm) [Vous pouvez également le faire à l'aide des touches +/- du clavier et de la molette de la souris !]

- Indicateur de charge CPU.

- Indicateur d'évènements MIDI.

- Cliquez pour activer le mode Jack esclave : Hydrogen fonctionnera comme 'esclave' d'un autre programme maître (ex. Ardour). Cet applet est utilisable uniquement si vous utilisez le pilote audio Jack.

Autres raccourcis clavier utiles (non configurables pour l'instant) :

- [CTRL + O] = Ouvrir un morceau

- [CTRL + S] = Enregistrer un morceau

- [Backspace] = Relancer le morceau (ou motif) depuis le début.

### Editeur de Morceau

La fenêtre "Editeur de morceau" (Fig. 1) montre le morceau en cours d'édition ; chaque ligne représentant un motif, ce qui permet de les combiner pour créer le morceau, la lecture d'un motif étant représentée par une croix. Avec ce système, même un changement mineur (par example une ouverture de charleston sur le quatrième temps) oblige à créer une nouvelle ligne. Vous pouvez ajouter ou supprimer ces croix seulement de manière séquentielle, et une fois créées, elles ne peuvent être effacées que si une autre est présente dans la même colonne (par exemple si vous voulez choisir un autre motif parmi ceux créés). Pour laisser un blanc de une mesure, utilisez un motif vide !

La fenêtre comprend également 5 boutons :

Crée un nouveau motif (vous demande un nom)

Déplace le motif sélectionné d'un rang vers le bas

Déplace le motif sélectionné d'un rang vers le haut

Ouvre le menu permettant de modifier les propriétés du morceau (nom, auteur, commentaires), d'effacer la séquence de motifs ou tous les motifs du morceau.

Joue le morceau en boucle

Sous ces boutons, vous trouverez une liste des motifs créés et quand ils seront joués. Cliquez sur une case vide pour jouer le motif (apparition d'une croix) ou sur une case contenant une croix pour l'effacer. Cliquer avec le bouton droit de la souris sur un motif ouvrira un menu permettant de modifier son nom, de le copier ou de le supprimer. Notez qu'il est impossible de créer deux motifs portant le même nom !

Fig. 1 L'éditeur de morceau

### Editeur de motif

La fenêtre "Editeur de motif" (Fig. 2) permet de créer ou de modifier le motif actif, d'ajouter ou de supprimer des notes et de régler l'intensité des notes. Le menu déroulant "Résolution de la grille" sert à modifier la résolution pour pouvoir ajouter des notes de valeur plus faible. Il est possible de la règler sur les modes 4 (noires), 8 (croches), 16 (doubles croches), 32 (triples croches) et 64 (quadruples croches) ou sur les modes ternaires correspondants 4T (triolets de noires), 8T (triolets de croches), 16T (triolets de doubles), 32T (triolets de triples) et 64T (triolets de quadruples). Vous pouvez également régler la durée effective du motif grâce au menu "Taille du motif" situé en haut à droite de la fenètre (attention, il est gradué en demi-temps !). Sélectionner un instrument qui a au moins une note fera apparaitre des barres verticales en dessous de chacune d'entre elles dans la partie la plus inférieure de la fenêtre. Elles servent à modifier l'intensité des notes. Le bouton

(entendre les notes ajoutées) active ou désactive la préaudition des notes ajoutées au motif.

Fig. 2 L'éditeur de motif

Vous pouvez également enregistrer directement une partie en cliquant sur

qui active l'enregistrement direct depuis une source MIDI ou le clavier selon la liste suivante (touche/instrument) :

Notez que le nom de l'instrument dépend du drumkit utilisé. Cette liste concerne GMKit, le kit par défaut. La position de l'instrument, cependant, reste la même.

- Z = Kick (grosse caisse)

- X = Snare Jazz (caisse claire jazz)

- C = Snare Rock (caisse claire rock)

- V = Tom Low (tom grave)

- B = Tom Mid (tom médium)

- N = Tom Hi (tom basse)

- M = Cowbell (cloche)

- Q = Ride Jazz

- W = Ride Rock

- E = Instrument No. 17 (non assigné actuellement)

- R = Instrument No. 18 (non assigné actuellement)

- T = Instrument No. 20 (non assigné actuellement)

- Y = Instrument No. 22 (non assigné actuellement)

- U = Instrument No. 24 (non assigné actuellement)

- S = Stick (clap baguettes)

- D = Hand Clap (clap mains)

- G = Closed HH (charleston fermée)

- H = Pedal HH (charleston au pied)

- J = Open HH (charleston ouvert)

- 2 = Crash

- 3 = Crash Jazz

- 5 = Instrument No. 19 (non assigné actuellement)

- 6 = Instrument No. 21 (non assigné actuellement)

- 7 = Instrument No. 23 (non assigné actuellement)

Un mode Quantize très utile est activable en cliquant sur

. Lorsqu'il est activé, vos sons se placeront automatiquement sur les valeurs autorisées par la grille sélectionnée.

Voici une référence rapide adaptant la liste ci-dessus à un clavier MIDI.

### Table de mixage

La fenêtre "Table de mixage" (Fig. 3) est utile pour règler le volume global du kit de percussions ou celui de chaque instrument du kit. Elle affiche le niveau actuel (cliquez sur

pour le désactiver, utile sur des vieux CPUs) et le volume maximal autorisé (utilisez le bouton pour le modifier), permet de modifier le panoramique

, de jouer une piste seule

, couper une piste

, charger un sample au format WAV/AU/AIFF pour un instrument

ou prévisualiser cet instrument

. Ce dernier boutons s'illumine lorsque l'instrument est joué. Selectionner un instrument dans l'éditeur de motif provoque l'affichage d'une bordure verte autours de celui-ci dans la table de mixage.

Double cliquer sur le nom d'un instrument ouvrira une boite de dialogue pour modifier ses propriétés. Cliquer sur FX (dans la colonne de gauche) vous permettra d'appliquer quelques effets.

Fig. 3 La table de mixage

Ces quatre boutons ronds dans chaque piste sont les niveaux pour les plug-ins LADSPA. Lisez la section suivante pour plus d'informations sur ces derniers.

### Les plug-ins LADSPA

Hydrogen peut appliquer des effets aux sons en utilisant n'importe quel plug-in LADSPA. Vous devez pour cela avoir installé les sources de LADSPA (tarball/rpm/apt disponibles à l'adresse http://www.ladspa.org). Installez ensuite un ou plusieurs de ces plug-ins à l'aide de la commande "make && make install" :

- Des plug-ins SWH sont disponibles à l'adresse http://plugin.org.uk. Notez que pour les compiler, vous aurez besoin de l'archive de FFTW disponible sur http://www.fftw.org.

- CMT téléchargeables sur http://www.ladspa.org.

- TAP téléchargeables sur http://tap-plugins.sf.net.

Une fois quelques plug-ins installée, ouvrez Fichier -> Préférences -> Général et vérifiez si le chemin est correct (l'installation depuis les sources se fait par défaut dans /usr/local/lib/ladspa, par example), puis ouvrez un morceau auquel vous aimeriez ajouter un effet et sélectionnez un instrument. Dans la table de mixage, cliquez sur

et sélectionnez une des quatre pistes d'effets disponibles (Fig. 3a). Cliquez sur le bouton

, puis sur Choisir effet: ceci ouvrira une autre fenêtre (Fig. 3b) qui vous permettra de choisir un effet parmi ceux installés, ils sont listés par ordre alphabétique et par catégorie. Ensuite Activez l'effet, ajustez les niveaux si vous voulez et retournez à la table de mixage : lancez le morceau et éclatez vous ! Chaque bouton rond dans la piste de la table de mixage contrôle le niveau d'un effet de haut en bas : le premier est l'effet 0, tle deuxième l'effet 1 et ainsi de suite. Si vous voulez rapidement activer ou désactiver l'effet, cliquez sur

.

Fig. 3a La boite de dialogue "Propriétés de l'effet LADSPA".

Fig. 3b Selectionnez un effet.

### Menu

Depuis les menus déroulants, vous pouvez sélectionner : Fichier-->'Enregistrer sous...' pour sauvegarder le morceau en cours au format .h2song, Fichier-->Exporter pour l'exporter au format WAV, Fichier-->

Préférences, Fenêtres-->

Montrer les informations du système audio et Fenêtres-->

Montrer le gestionnaire du kit de batterie.

#### Préférences

Depuis cet onglet (Fig. 4), vous pouvez configurer le pilote audio (OSS ou Jack) en changeant son la taille de son tampon ou son taux d'échantillonage ainsi qu'activer ou désactiver le métronome et régler son volume.Vous pouvez également activer certaines options comme "se connecter à la sortie audio par défaut" qui connecte simplement la sortie ALSA aux ports par défaut (décochez la case si vous voulez connecter la sortie jack à d'autre ports sans les déconnecter) ou activer la sortie des pistes, utile si vous voulez appliquer des effets à un instrument avec jack-rack. Gardez également un oeil sur la valeur "Nombre maximum de notes" : selon votre processeur vous pourriez vouloir éviter qu'un trop grand nombre de notes ne soit jouées simultanément afin d'éviter un plantage de l'application. Cliquer sur "Système Midi" (Fig. 5) ouvrira un onglet vous permettant de choisir un périphérique d'entrée MIDI, ainsi qu'une piste de sortie spécifique ou toutes les pistes, alors que l'onglet "Apparence" (Fig. 6) vous permettra de modifier la taille de la police, le comportement des fenêtres (Parent-Enfant ou Vue Générale) et la vitesse de décroissance des vumètres de la table de mixage, ainsi que le thème QT utilisé pour les fenêtres.

Fig. 4 L'onglet "Système audio"

Fig. 5 L'onglet "Système Midi"

Fig. 6 L'onglet "Apparence"

#### Informations du système audio

Cette option du menu fenêtres (Fig. 7) fera apparaitre une fenêtre contenant des informations d'ordre général sur Hydrogen et le pilote audio. Le tampon et le taux d'échantillonage du pilote Jack sont configurables si le serveur est lancé depuis la console.

Fig. 7 La fenêtre "Informations du système audio. Mieux que les CPUmètres des vieux PC et que les répertoires /proc surchargés ;)

#### Gestionnaire de kit de batterie (drumkit)

Le gersionnaire de kit de batterie affiche toutes les options sur les kits de batterie, dont les groupes de samples (wav) qui seront associés à chaque piste disponible afin d'obtenir un groove correspondant au genre musical (disco, rock, hip hop, etc ...). Pour se faire une idée de comment utiliser ces kits, il est recommandé d'écouter le fichier d'example .h2song correspondant.

A partir du premier écran (Fig. 8) il est possible de charger/supprimer un kit, avec une courte description. Ici (Fig. 9) vous pouvez enregistrer les infos sur le drumkit utilisé et là (Fig. 10) importer un kit au format .h2drumkit (Fig. 11) ao l'exporter (Fig. 12).

Fig. 8 Charger un kit. Choisissez parmi les différents installés.

Fig. 9 Sauvegarder un kit.

Fig. 10 Importer un kit.

Fig. 11 Exporter un kit.

## Créer un nouveau morceau

### Mode "Morceau" contre mode "Motif"

Hydrogen a 2 modes principaux : le mode "Motif" (accessible en cliquant sur

) et le mode "Morceau" (accessible en cliquant sur

pour Song). Quand vous travaillez en mode "Motif", le motif actif est continuellement répété, afin de permettre d'entendre les changements qui lui sont apportés, alors que le mode "Morceau" joue les motifs dans l'ordre spécifié dans l'éditeur de morceau, ce qui est utile lors du travail sur la structure de la musique.

### Un nouveau motif

Nous allons démarrer à partir d'un morceau vide avec un motif vierge, comme lors de la création d'un nouveau morceau par défaut (Fig. 12). Cliquez sur Fichier --> Nouveau. Le mode "Motif" devrait être automatiquement sélectionné. Il est possible de changer le nom du motif (par défaut "Empty Pattern") comme indiqué précédemment.

Fig. 12 C'est parti ! Hydrogen prèt à l'emploi. Remarquez l'affichage de la charge CPU et l'applet MIDI.

Cliquez sur

et ajoutez des notes dans l'éditeur de motif en cliquant avec le bouton gauche de la souris (ajustez la résolution de la grille et le tempo si nécessaire : la résolution par défaut est 32 et le tempo 120 bpm sur une échelle de 40 à 300). Cliquez sur

pour interrompre la lecture. Pour créer un nouveau motif, cliquez simplement sur

et ajoutez des notes comme indiqué précédemment, après avoir vérifié que vous avez bien sélectionné le bon motif Remarquez également que si, par exemple, vous sélectionnez une résolution de 16, remplissez le motif puis optez pour une résolution plus faible (disons 8), vous ne pourrez plus supprimer les notes en dehors de la grille.

Fig. 13 L'éditeur de motif

### Un nouveau morceau

Une fois les motifs créés, pour les copier, coller, supprimer ou déplacer dans l'éditeur de morceau (Fig. 14), vous devez utiliser les boutons de la fenêtre "Editeur de morceau"

,

ainsi que la commande copier/supprimer qui apparait lors d'un clic droit sur le motif sélectionné.

Fig. 14 Insertion de notes dans un motif

### Utiliser la table de mixage

Il est toujours possible de se servit de la table de mixage, même lors de la création ou de la lecture de motifs.

Elle est composée de 32 pistes indépendantes (Fig. 15), chacune d'entre elles correspondant à un instrument, ainsi que d'une piste "Volume général" et de boutons pour régler les effets. Chaque ligne se compose de quatre boutons (

), d'un réglage de l'echo et de la stéréo (pan) (

), d'un afficheur du volume maximal atteint , d'un réglage du volume et du nom de la piste. Cliquer sur

jouera l'instrument correspondant en solo. Le bouton "Couper"

, rend simplement cet instrument inaudible. Le nombre indiquant le volume maximal atteint par cet instrument doit toujours être compris entre 0.0 et 1.0, sinon, il produira un son déformé (en particulier avec OSS). Il est alors nécessaire de réduire son volume..

Enfin, vous disposez d'un réglage du volume pour chaque instrument et d'un vumètre qui vous aideront à faire votre mix.

Fig. 15 Détails de la table de mixage