= Manuel de *HoustonPatchbay*
:toc: left
:toc-title: Table des matières
:toclevels: 2
:imagesdir: ../en/images
:stylesheet: ../en/patchbay_manual.css

[.text-right]
image:flags/en.jpeg[EN, 30, 20, link=../en/manual.html] image:flags/fr.jpeg[FR, 40, 30, link=../fr/manual.html]

image:raysession.svg["icon", 100, 100] image:patchance.svg["icon", 100, 100] image:patchichi.svg["icon", 100, 100]

Bienvenue sur le manuel de HoustonPatchbay, la baie de brassage pour JACK utilisée dans RaySession, Patchance et Patchichi.

== Vue d'ensemble

image::patchbay_base.png[Vue d'ensemble de la baie de brassage]

Voilà à quoi peut ressembler votre baie de brassage. Ici il y a 7 boîtes :

* une boîte *system* comprenant vos ports correspondant aux entrées matérielles
* une boîte *system* comprenant vos ports correspondant aux sorties matérielles (enceintes, casque)
* une boîte *a2j* comprenant vos ports correspondant aux entrées MIDI
* une boîte *a2j* comprenant vos ports correspondant aux sorties MIDI
* une boîte *PulseAudio JACK Source*
* une boîte *PulseAudio JACK Sink*
* une boîte *Guitarix*

Ici les ponts A2J et pulse2jack sont lancés.
Vous observez que 4 de ces boîtes sont entourées d'une décoration (2 *system* et 2 *a2j*), ce sont les boîtes qui contiennent les ports matériels (votre interface audio, votre piano USB, n'importe quel contrôleur...).

'''

Certains ports audios sont regroupés en sous-groupes, que l'on appellera portgroups. Ces portgroups sont pour la plupart des paires stéréo détectées automatiquement par le nom des ports. C'est le cas ici pour :

* system:capture 1/2
* system:playback 1/2
* PulseAudio JACK Source:front L/R
* PulseAudio JACK Sink:front L/R
* Guitarix:out 0/1

Ces portgroups facilitent les connexions et permettent une meilleur lisibilité générale.

'''

Les lignes incurvées bleues correspondent aux connexions audios. Vous pouvez observer que :

* les ports audio d'entrées matérielles sont connectés à *PulseAudio JACK Source*
* les ports de *PulseAudio JACK Sink* sont connectés aux sorties matérielles
* seul le premier port de *system* est connecté à l'entrée (__in 0__) du logiciel *Guitarix*
* les ports audios de *Guitarix* sont connectés aux sorties matérielles

== Faire et défaire une connexion

Vous pouvez établir une connexion entre 2 ports pourvu qu'ils remplissent les conditions suivantes :

* les ports sont du même type (on ne peut pas connecter un port audio à un port MIDI)
* l'un est un port d'entrée, l'autre est un port de sortie

=== Méthode Intuitive

Pour connecter ou déconnecter deux ports, cliquez sur un port sans relâcher le bouton de la souris, glissez le curseur jusqu'au port désiré puis relachez le bouton de la souris.

=== Méthode Alternative

Faites un clic droit sur un port, celà affichera un menu déroulant, choisissez *Connecter* puis le port désiré. Cliquez ailleurs pour faire disparaître ce menu. L'avantage de cette méthode est qu'elle permet de connecter rapidement un port à plusieurs autres, le menu restant affiché pendant les connexions.

video::video/patchbay_simple_connect.mp4[width=640]

== Les options

Un clic droit n'importe où sur la baie de brassage permet d'en afficher le menu. Ce menu est également présent dans le menu de RaySession (menu *Baie de brassage*).
Il vous permettra de :

* basculer la baie de brassage en plein écran
* chercher une boîte par son nom
* Filtrer les ports: n'afficher que les ports AUDIO, MIDI, CV ou les trois
* régler le niveau de zoom
* rafraîchir le canevas: redemander à JACK la liste des ports existants et leurs connexions
* Préférences du canevas: afficher une fenêtre d'options +
    Tous les changements dans cette fenêtre prennent effet immédiatement. Survolez les cases pour afficher les infobulles.

== Raccourcis à connaître

* Un double clic n'importe où permet de basculer la baie de brassage en plein écran.
* __Ctrl+Molette de la souris__ permet de zoomer/dézoomer.
* __Alt+Molette de la souris__ permet déplacer la vue horizontallement.
* Le bouton de la molette permet de déplacer la vue
* __Ctrl+bouton du milieu de la souris__ permet de couper toutes les connexions passant sous le curseur
* __Ctrl+F__ permet de chercher une boîte par son nom

=== Connexions en rafale

Il est possible de connecter un port ou un portgroup à différents ports assez rapidement. Il suffit de terminer ses connexions par un clic droit. Une video sera bien plus explicite.

video::video/patchbay_rafal_connections.mp4[width=640]

Ici nous voulons connecter les multiple sorties d'Hydrogen à des tranches de Jack-Mixer. Dans la video les ronds bleus apparaissent avec un clic droit.

=== Passer les connexions d'un port à un autre

Il est parfois moins fastidieux de passer des connexions d'un port à un autre plutôt que de tout défaire pour tout refaire. Pour ce faire, partez du port qui contient les connexions et faites comme si vous vouliez faire une connexion, mais allez vers le port vers lequel vous souhaitez basculer les connexions.

* Celà ne fonctionne que si le port de destination ne contient aucune connexion
* Celà fonctionne de port à port ou de portgroup à portgroup mais pas de port à portgroup

video::video/patchbay_fast_cut_paste.mp4[width=640]

Dans cette video nous avons un cas assez complexe où la source est branchée dans *3 Band Splitter*.
Les basses et les aigües (_Output 1_ et _Output 5_) sont envoyés directement dans *EQ6Q Mono* tandis que les medium (_Output 3_) passent d'abord par la distortion *GxTubeScreamer*. Nous voulons insérer la reverb *Dragonfly Room Reverb* avant l'égualisation *EQ6Q Mono*.

'''

Notez qu'avec la connexion par clic droit et le passage de connexions d'un port à l'autre, il est très rapide d'intégrer un nouveau greffon dans une chaîne, comme ici où nous branchons *Plujain Ramp Live* entre *Dragonfly Room Reverb* et *EQ6Q Mono*.

video::video/fast_new_plugin.mp4[width=640]

== Ports spéciaux
=== Les ports A2J (ou Midi-Bridge)

image::patchbay_a2j.png[ports a2j]

Les ports MIDI fournis par le pont A2J (Alsa To Jack) (ou Midi-Bridge avec Pipewire) présentent un trou à leur extrêmité pour les reconnaître. Leur véritable nom est un nom à ralonges, mais c'est à peu près la seule chose qui diffère avec les autres ports MIDI.

=== Les ports de tension de contrôle (ports CV)

image::patchbay_CV.png[ports CV]

les ports de tension de contrôle, appellés communément ports CV (Control Voltage) ont le même fonctionnement que les ports audio classiques, cependant, ils sont faits pour piloter un ou plusieurs paramètres avec une précision bien plus importante que les ports MIDI. Comme leur flux n'est pas fait pour être écouté, il n'est pas possible de connecter simplement un port CV de sortie vers une entrée audio classique, celà pourrait endommager votre casque, vos enceintes, et peut-être même bien vos oreilles. +
Si vous souhaitez quand même le faire, faites un clic droit sur l'un des ports, puis *Connecter*, puis le menu *DANGEREUX*. +
Vous ne pourrez pas dire que vous n'étiez pas prévenu, et il est quasiment impossible de faire ça par erreur.

En revanche, connecter un port de sortie audio classique vers un port CV d'entrée est tout à fait possible, ça ne pose aucun problème.

== Éditer un thème

Vous avez la possibilité d'éditer les couleurs d'un thème. C'est plutôt facile et rapide à faire.

Pour plus d'informations, consultez link:../en/theme_edit.html[l'aide sur l'édition des themes].