Manuel de LibraZiK-4 - Créer une session RaySession avancée
Nous avons vu dans le tutoriel précédent 1) comment utiliser RaySession pour une session de travail simple.
Nous allons étudier un exemple plus complexe dans ce tutoriel où nous allons utiliser RaySession avec Hydrogen, ZynAddSubFX et Ardour afin de créer une session RaySession qu'il sera possible de rappeler ultérieurement et qui relancera toutes les applications, leurs pré-réglages, ainsi que leurs connexions en un seul coup.
Les prérequis sont :
Avant toute chose, assurez-vous avec Cadence que JACK soit lancé. Ce n'est pas primordial pour RaySession en lui même, mais pour Hydrogen, Ardour et ZynAddSubFX, si !
Il nous faut maintenant préparer une session RaySession.
Pour cela, lancez RaySession : Menu LZK → Applications → Son et vidéo → Outils JACK → RaySession
Vous arrivez à présent sur la fenêtre principale de RaySession : 
Cliquez sur le bouton “Nouvelle session” (en haut à gauche) puis nommez votre session dans la fenêtre de dialogue qui apparaît : 
Laissez le modèle “avec mémoire du patch de JACK”, puis cliquez sur le bouton “OK”.
Un client est apparu dans la liste des clients de RaySession qui s'appelle Connexions JACK. C'est lui qui sauvegardera les connexions de JACK.
Lancez Catia afin de voir vos connexions JACK : Menu LZK → Applications → Son et vidéo → Outils JACK → Catia
Vous devez y voir les connexions matérielles de votre système (entrées et sorties de carte son) : 
Si vous souhaitez faire apparaître le clavier MIDI USB 3), allez dans le menu Catia → Outils → Pont ALSA-MIDI → Démarrer le pont :
Nous allons à présent lancer la première application dans la session RaySession.
Pour cela, cliquez sur le bouton “Application” (ou Ctrl+A). Vous verrez alors apparaître cette fenêtre de dialogue : 
Dans cette fenêtre ainsi ouverte, déroulez la liste des applications jusqu'à apercevoir “Hydrogen”, puis double-cliquez sur dessus.
La fenêtre de dialogue des applications se ferme, le logiciel Hydrogen se lance et le client “Hydrogen” a été ajouté à la liste des clients de RaySession.
Si vous revenez à la fenêtre de Catia, vous voyez maintenant les ports de connexion audio et MIDI du logiciel Hydrogen qui sont apparus et dont les deux ports audio se sont automatiquement connectés au matériel audio : 
Lancez le synthétiseur logiciel ZynAddSubFX et la STAN Ardour de la même manière que vous avez lancé Hydrogen. Les ports audio de Ardour s'auto-connecteront également au matériel audio. Il faudra en revanche connecter dans Catia les sorties audio de ZynAddSubFX au matériel audio.
Nous allons ici faire un exemple pour une application ne figurant pas dans la liste d'applications de la fenêtre de dialogue des applications de RaySession. L'exemple choisi est le logiciel Pluma, un simple éditeur de fichier texte dans lequel nous pourrions souhaiter mettre des notes lors de la création d'un morceau par exemple.
Cliquez sur le bouton “Exécutable”, puis rentrez la commande pluma dans le champ d'édition. Décochez la case “Protocole NSM”. Puis cliquez sur le bouton “OK”. 
Un nouveau client nommé Pluma apparaît dans la liste des clients de RaySession et une nouvelle fenêtre de dialogue apparaît : c'est la fenêtre d'édition des propriétés du client ouverte sur l'onglet Ray-Hack (pseudo-protocole qui sert à gérer les clients non compatibles NSM dans la session).
Le logiciel “pluma” s'ouvre.
Dans Pluma, avant de taper quoique ce soit, enregistrez tout de suite le document vide. Ici, “Fichier → Enregistrer” est grisé, utilisez donc “Fichier → Enregistrer sous…”.
Normalement, la fenêtre de dialogue propose d'enregistrer le fichier au bon endroit, mais si ce n'est pas le cas, vérifiez que vous êtes bien dans ~/Ray Sessions/LZK_RS premier pas/LZK_RS premier pas.pluma/.
Nommez le fichier EXACTEMENT comme la session, plus un point, plus une extension.
Ce qui donne : ~/Ray Sessions/LZK_RS premier pas/LZK_RS premier pas.pluma/LZK_RS premier pas.txt
Retournez à la fenêtre d'édition des propriétés du client. En haut à droite de cette fenêtre, cliquez sur le bouton “Naviguer”. Une fenêtre de sélection de fichier apparaît dans le dossier du proxy. Si vous avez enregistré correctement votre fichier dans pluma, vous le voyez, il s'appelle “LZK_RS premier pas.txt”. Double-cliquez dessus.
Si tout s'est bien passé, alors la fenêtre d'édition des propriétés du client doit ressembler à ceci : 
Vous pouvez désormais cliquer en bas à droite de cette fenêtre sur le bouton “Arrêter”, ce qui aura pour effet d'arrêter pluma.
Cochez les deux cases “Demander à l'utilisateur de fermer lui même le programme à la fermeture de la session” ainsi que “Essayer de fermer gracieusement la fenêtre”. Cliquez sur “Sauvegarder les changements”, la fenêtre des propriétés se ferme, puis relancez Pluma depuis la fenêtre principale de RaySession.
Votre client devrait ressembler à ceci : 
Notez que le bouton de sauvegarde possède un point d'exclamation (gris ou orange). Cela signifie qu'il n'y pas de moyen pour RaySession de sauvegarder son état, le fichier de texte dans Pluma ne sera donc pas sauvegardé automatiquement lorsque vous sauvegardez la session RaySession et il vous faudra vous en occuper vous-même.
Voilà, c'était long et fastidieux ?
→ Oui, un peu.
Et il faudra le refaire à chaque fois ?
→ Non, car RaySession est pensé intelligemment ! 
Faites un clic droit sur le client Pluma, puis sélectionnez “Sauvegarder comme modèle d'application”. Dans la fenêtre de dialogue qui apparaît, nommez votre modèle “Notes texte”, puis cliquer sur le bouton “Créer le modèle”.
Dorénavant, lorsque vous voudrez lancer Pluma dans une session RaySession, vous n'aurez qu'à chercher Notes texte après avoir cliqué sur “Application” et bien pensé à cocher la case “Utilisateur”.
Dans Pluma, nous pouvons maintenant y mettre quelques notes utiles. 5)
Dans Ardour, créez deux pistes audio stéréo, l'une pour l'audio fourni par Hydrogen (stéréo), l'autre pour l'audio (stéréo aussi) fourni par ZynAddSubFx. Les deux nouvelles pistes stéréo apparaissent dans Catia.
Pour aider à la clarification, cliquez-droit sur le nom “Ardour” en haut du bloc d'Ardour dans Catia et sélectionnez “Split”. Le bloc Ardour se séparera en deux, un bloc pour les entrées et un autre pour les sorties, ce qui permettra d'organiser le canevas de Catia plus clairement : 
Il nous faut maintenant connecter les flux des applications. Pour cela, dans le canevas de Catia, cliquez sans relâcher sur “out_1” de ZynAddSubFX et aller brancher son câble qui apparaît en bougeant le curseur avec la souris vers la piste “ZynAddSubFX/audio_in 1” du bloc Ardour. Une fois arrivé à bon port, relâchez le clic pour que le câblage soit validé.
Répéter l'opération pour la sortie “out_2” de ZynAddSubFX vers la piste “ZynAddSubFX/audio_in 2” du bloc Ardour, ainsi que pour brancher les “out_L” et “out_R” du bloc Hydrogen vers les ports de connexion “Hydrogen/audio_in 1” et “Hydrogen/audio_in 2” du bloc d'Ardour.
Profitons en pour connecter le clavier MIDI à l'entrée MIDI de ZynAddSubFX, pour cela connectez la sortie MIDI du clavier (ici Keystudio MIDI 1) à l'entrée midi ZynAddSubFX .
Maintenant dans Ardour, réglez les pistes de Hydrogen et de ZynAddSubFX sur “Disque” puisque les sorties de Hydrogen et de ZynAddSubFX sont déjà connectées au matériel audio.
En réglant ces pistes sur “Disque”, cela signifie qu'Ardour ne transmettra que le son déjà enregistré.
Dans Ardour, activez la synchronisation positionnelle externe sur le transport JACK en cliquant sur le bouton “Int” pour faire apparaître “JACK” à la place :
Dans Hydrogen, vérifiez que la synchronisation au transport JACK est bien activée en cliquant (si besoin) sur le bouton “J. TRANS” :
À partir de là, vous pouvez contrôler la lecture, le stop,…etc des logiciels à partir des boutons de contrôle d'Ardour, d'Hydrogen, ou de Catia.
Pour ce tutoriel, nous allons créer ici une rythmique simple sur deux mesures en chargeant le kit de batterie “The Black Pearl 1.0” d'Hydrogen.
Dans la fenêtre de ZynAddSubFX, nous cliquons sur “BASS” dans la colonne “BANK”, et choisissons “WAH BASS” dans la colonne “PRESET”.
Nous allons également augmenter le “Volume” général de ZynAddSubFX car il est un peu faiblard par rapport à la rythmique d'Hydrogen. Mettons le à 90.
Voilà, nous venons de paramétrer un tas de choses comme :
Nous allons fermer cette session RaySession puis la relancer et ainsi constater que tout est rechargé automatiquement.
Pour cela, cliquez sur le bouton rond rouge troué d'une croix en haut à droite de RaySession. C'est le bouton qui permet de fermer la session (en la sauvegardant au préalable).
Maintenant, cliquez sur “Ouvrir une session”, choisissez votre session “LZK_RS premier pas” et là, la magie opère !
Vous voudrez peut être :
Si vous avez un soucis et que vous n'arrivez pas à vous en sortir, contactez-nous.
