farmpad v.1.3.1 ©2008 Farm Audio
traduction française : M.A.N.U.
-----------------------------

Dans ce readme:
- Quoi de neuf
- Installation
- Utiliser farmpad
- Options de ligne de commande
- Utiliser les fichiers de configuration
- N° de contrôleurs par défaut
- N° de switch par défaut
- Matériel requis
- Licence
- Contact
- Informations supplémentaires
- Historique des mises à jour

------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------

Description
farmpad est une application gratuite pour OS X qui vous permettra de d'adapter entièrement votre Korg padKontrol à votre façon de travailler. Avec farmpad, vous pouvez utiliser les pads pour envoyer des messages on/off, des notes midi, des control change, etc. Vous pouvez transformer tous les boutons de configuration du farmpad comme des switches et triggers supplémentaires, et le potentiomètre "setting section" peut également être utilisé comme un encodeur rotatif. Les contrôles peuvent être entièrement personnalisés et sauvegardés sous forme de fichiers de configuration, au format texte. Une version Windows est prévue dans le futur, quand la version OS X sera complète.

------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------

Quoi de neuf
- 128 scènes.
- Les messages program change reçus peuvent sélectionner les scènes.
- Meilleur format de configuration - faire ses propres patches est plus facile. (Voir la commande 'fixed')
- Contrôles fixés - les contrôles peuvent faire partie de différentes scènes. (Voir la commande 'selectscene')
- Le pad XY peut agir comme un simple switch.
- L'encodeur rotatif peut sélectionner des scènes et envoyer des messages MIDI program change.

------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------

Installation
Démarrer l'installeur qui copiera l'executable farmpad vers où vous voulez. Vous devez entrer votre mot de passe OS X durant la procédure d'installation.

------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------

Utiliser farmpad
- Connecter votre padKontrol à votre mac.
- Ouvrez le Terminal et lancez farmpad (tapez "farmpad" et appuyez sur entrée)
- Vous devriez les lumières du padKontrol clignoter deux fois. Le padKontrol est maintenant connecté.
- Tous les pads et switches du padKontrol sont maintenant en mode toggle (on/off) qui transmettent un message 0 pour off et un message 127 pour on. Les autres contrôles du padKontrol - Les deux potentiomètres, le pad XY et l'encodeur rotatif peuvent bien sûr envoyer des messages MIDI.
- Vous devez sélectionner 'farmpad' comme entrée midi dans votre DAW pour recevoir les informations midi.
- Appuyez sur Ctrl+C pour sortir de farmpad et pour retrouver l'usage normal de votre padKontrol.

-----------------------------------------------------------------------------------------
-----------------------------------------------------------------------------------------

Options de ligne de commande
Utiliser ces options vous permet de changer la façon dont votre farmpad se comporte.

-t: texte LED - Enregistre un texte LED dans le padKontrol. Le texte peut contenir jusqu'à 128 caractères. ex : farmpad -t "mourir tue"

-v: mode verbeux - affiche des informations supplémentaires dans le Terminal quand farmpad est utilisé.

-c: charger un fichier de configuration - charger les options de personnalisation du padKontrol à partir d'un fichier texte. Voir la section "Utiliser les fichiers de configuration" plus bas pour plus d'informations.

-s/-sX: scene switches (groupes de scènes) - les groupes de scènes sont utilisés pour naviguer rapidement entre les différentes scènes. Maintenez enfoncé le switch puis enfoncez le pad correspondant à la scène que vous voulez utiliser. -s and -s1 correspondent au groupe 1, qui vous permettra ensuite de sélectionner les scènes 1 à 16. s-2 correspond au groupe 2, qui vous permettra ensuite de sélectionner les scènes 17 à 32. -s3 pour les scènes 33 à 48, etc. 8 groupes de scènes sont disponibles pour naviguer dans les 128 scènes.

ex: 'farmpad -s 17 -s2 18' - Enregistre le switch 17 (ROLL) comme le scene switch pour les scènes 1 à 16, et le switch 18 (FLAM) comme le scene switch pour les scènes 17 à 32.

Voir la section 'N° de switches' plus bas pour plus d'informations sur les identifications des différents switches. 

-----------------------------------------------------------------------------------------
-----------------------------------------------------------------------------------------

Utiliser les fichiers de configuration
Vous pouvez personnaliser le comportement de farmpad en utilisant un fichier de configuration.

Les fichiers de configuration sont de simples fichiers texte qui contiennent des commandes qui change la façon dont farmpad commande votre padKontrol. Un fichier de configuration contient une commande par ligne, qui généralement suit cet ordre:

- Sélectionner la scène à éditer
- Sélectionner le contrôle à éditer
- Editer les options de contrôle
- Sélectionner une/un autre scène/contrôle, puis recommencer...

Les options que vous changez dans le fichier de configuration sont appliquées aux options par défaut que farmpad charge dans le padKontrol. 
ex: pour changer uniquement le numéro de contrôleur du pad 16 et laisser le reste tel quel, vous pouvez ajouter quelque chose comme ça dans votre fichier de configuration (voir plus bas pour une explication complète des différentes instructions) :

// changer le n° de contrôle midi du pad 16 ('//' : ligne de commentaire, n'agit pas sur le padKontrol mais vous permet de tout noter)
pad:16
	control:100
	channel:12

Il y a quelques fichiers d'exemple dans le dossier "Examples Configurations". Vous pouvez sauver vos fichiers de configuration n'importe où dans votre mac. Pour les ouvrir : spécifiez le chemin du fichier dans le Terminal en ouvrant farmpad. 

ex: farmpad -c ~/farmpad/config.txt 

--- Note du traducteur ---

Le symbole ~ est obtenu en appuyant sur alt+n et contient tout le chemin jusqu'au dossier d'utilisateur.

ex: farmpad -c ~/farmpad/config.txt signifie la même chose que :
      farmpad -c Macintosh HD/Utilisateurs/Jean-Paul/farmpad/config.txt 

- Paramètres globaux 

[EncoderSelectsScene] - L'encodeur rotatif (Setting Section) sélectionne les différentes scènes.

[EncoderSelectsProgram] - L'encodeur rotatif envoie des messages Program Change. Par défaut, les messages sont envoyés sur le canal 1 - pour les envoyer sur un autre canal, utilisez le format [EncoderSelectsProgram:X] et remplacez le 'X' par le n° de canal.

sceneswitch: - le switch charge le groupe de scènes n°1. Voir la section à propos de la commande '-s' pour plus d'informations. 
ex: 'sceneselect:12'  le switch 12 ('X') sélectionne le groupe de scènes n°1.

sceneswitch_#: - le switch charge le groupe de scènes n°#. '#' est à remplacer par le numéro de groupe que vous voulez assigner au switch.
ex: 'sceneselect4:17' : assigne le groupe de scènes n°4 au switch 17 (ROLL).

Commentaires : Tout ce que vous écrivez après les caractères '//'  sur une ligne est ignoré par farmpad et permet de vous repérer dans votre fichier.

 - Sélectionner une scène

Pour sélectionner une scène pour l'édition, utilisez la commande 'scene'. A titre d'exemple, pour éditer la scène 2 ajouter la commande :

scene:2

Toutes les commandes suivant la commande de sélection de scène sont appliquées à cette scène. Pour éditer plusieurs scènes à la fois, vous pouvez lister les scènes en les séparant par des virgules. Ex : pour éditer les scènes 2, 4 et 6 :

scene:2,4,6

Si vous voulez éditer beaucoup de scènes en même temps et que vous n'avez pas envie de les lister une par une :

scene:1-5,11-15

Si vous voulez éditer toutes les scènes à la fois, utilisez la commande:

scene:all

- Editer une scène

led: - enregistre un texte LED qui s'affichera à la sélection de la scène sur votre padKontrol. ex: 'led:888' affichera le texte "888" au chargement de la scène. Notez que les espaces sont reconnus. Ecrire 'led:888 ' fera afficher au padKontrol le texte '888 ' et le fera défiler, sa capacité étant de 3 caractères.

-  Sélectionner un contrôle

Pour sélectionner le contrôle à éditer, utilisez les commandes suivantes :
pad: - sélectionne le pad que vous voulez éditer. Vous pouvez sélectionner plusieurs pads à la fois en utilisant la même méthode qu'avec les scènes (voir plus haut). ex: 'pad:1,5,9,13' 'pad:13-16' 'pad:all'
switch: - sélectionne le switch que vous voulez éditer. Vous pouvez sélectionner plusieurs switches à la fois en utilisant la même méthode qu'avec les pads et scènes (voir plus haut).
knob_1: - sélectionne le potentiomètre 1.
knob_2: - sélectionne le potentiomètre 2.
xypad_x: - sélectionne l'axe X du pad XY.
xypad_y: - sélectionne l'axe Y du pad XY.
xypad_switch: - utiliser le pad XY comme un switch.
encoder: - sélectionne l'encodeur rotatif.
pedal: - sélectionne la pédale d'expression.

- Options de contrôle

Les options d'édition de contrôle suivantes sont disponibles :

fixed: - fixe les contrôles sélectionnés dans une ou plusieurs scènes. ex: 'fixed:1-5' place les contrôles sélectionnés dans les scènes 1 à 5.
channel: - éditer le canal midi du contrôle.
control: - éditer le n° de control change (MIDI CC). Valeurs de 1 à 127 ou 'off' pour ne pas transmettre de CC.
note: - note midi du contrôle. Vous pouvez entrer les notes de deux manières : 'note:C3' ou 'note:64'
minvalue: - valeur minimum du contrôle. Nombre compris entre 0 et 127. 'minvalue:50'
maxvalue: - valeur maximum du contrôle. Nombre compris entre 0 et 127. 'maxvalue:127'
default: - définit la valeur par défaut d'un switch ou d'un pad. Peut être 'on' ou 'off'. ex : default:on'
group: - ajoute le pad ou switch à un groupe. Dans un groupe de pads, un seul pad peut être pressé à la fois. Le presser désactivera les autres.
noteshift: - augmente ou diminue la note éditée. En demi-tons. ex:'noteshift:1' 'noteshift:-1'
programshift: - envoie une valeur program change. ex: 'programshift:-4' decendra de 4 programmes par rapport au programme actif.
selectscene: - quand le switch est pressé, le padKontrol charge la scène spécifiée. ex: 'selectscene:100' fera sélectionner la scène 100 au contrôle.

mode: - définit le mode du pad, ou du switch. ex: 'mode:switch'. Les modes disponibles sont les suivants :
	'switch' - définit le pad comme un switch on/off. C'est la valeur par défaut.
	'trigger' - définit le pad comme un trigger standard, le pad envoie la valeur 'on' quand il est pressé et la valeur 'off' quand il est relâché.
	'retrigger' - pour qu'un pad envoie la valeur 'on' jusqu'à ce qu'il soit désactivé par un autre pad de son groupe.
	'groupmaster' - pour qu'un pad s'allume quand un autre contrôle du même groupe est activé. Le presser désactivera tous les contrôles du groupe - c'est très utile quand on utilise des groupes de pads en mode retrigger.
	'sustain' - le pad agira comme une pédale de sustain.
	'none' - désactive le pad.

velocity: - définit la courbe/réponse du pad. ex: 'velocity:soft'. Les valeurs disponibles sont les suivantes :
	'flat' - La vélocité avec laquelle le pad a été frappé est envoyée directement. C'est la réponse par défaut pour tous les modes, excepté 'switch'.
	'soft' - Donne au pad une vélocité douce.
	'hard' - Donne au pad une vélocité dure.
	'fixed' - Donne au pad une vélocité fixe - un coup sur le pad enverra toujours la 'maxvalue'. C'est la réponse par défaut du mode 'switch'.

------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------

N° de contrôles MIDI par défaut
Voici les n° de contrôles MIDI par défaut des contrôles du pK. 

Ces valeurs peuvent être personnalisées en utilisant un fichier de configuration, voir "Fichiers de configuration' plus haut.

Pads:         50-65
Switches:   70-88
XY Pad:      90-91
Knob 1:      92
Knob 2:      93
Encodeur:   94
Pédale:       95

------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------

N° de switch
1:    Scene
2:    Message
3:    Setting
4:    Note/CC#
5:    Midi Ch
6:    Sw Type
7:    Rel. Val.
8:    Velocity
9:    Port
10:  Fixed Velocity
11:  Prog Chance
12:  X
13:  Y
14:  Knob 1 Assign
15:  Knob 2 Assign
16:  Pedal
17:  Roll
18:  Flam
19:  Hold

------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------

Matériel requis
Un Korg padKontrol.
Un ordinateur Macintosh sous OS 10.4 ou plus récent.

------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------

Licence
Conditions d'utilisation :

Ce programme est mis à votre disposition en tant que tuneware - l'utilisation est complètement gratuite, mais si vous trouvez farmpad utile et que vous avez envie d'envoyer une sorte de remerciement, envoyez un lien pointant vers une de vos productions, ou bien enregistrements, live sets et mixes, à l'adresse de contact plus bas.

Nous ne pouvons pas être tenus pour responsables de tout type de problème qui pourrait survenir dans le cadre de l'utilisation de ce programme.

------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------

Contact
Si vous voulez nous faire part de retours, bugs ou suggestions, envoyez un courrier à : farmpad (at) farmaudio.com

------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------

Informations supplémentaires
http://www.farmaudio.com/farmpad
http://www.korg.com/padkontrol

------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------

Historique des mises à jour

1.3
128 scènes.
Les program change peuvent sélectionner les scènes.
Format de configuration amélioré - Faire ses propres patches devient plus facile.
Contrôles fixes - les contrôles peuvent maintenant faire partie de scènes différentes.
Les contrôles peuvent sélectionner une scène spécifique.
Le pad XY peut agir comme un switch.
L'encodeur rotatif peut naviguer dans les scènes et envoyer des messages MIDI program change.

1.2.1
Sur les pads en mode switch, la vélocité est fixe par défaut.
Bug fix : l'utilisation d'un switch parasitait la pédale.

1.2
Option noteshift - peut être utilisé pour un comportement de style octave plus/moins
Courbes de vélocité - la vélocité peut être définie comme plus douce ou plus dure que la vélocité par défaut, ou avoir une vélocité fixe.
Program change - un pad peut envoyer un message MIDI program change.
Mode sustain.

1.1
64 scènes.
Ajout d'un support pour pédale.
Ajout d'un support 'remote control' - les contrôles de farmpad peuvent être activés ou désactivés via midi.
Ajout des valeurs Min/Max - voir les paramètres de configuration 'minvalue/maxvalue'
Le pad XY n'envoie plus de valeurs en double.
Un switch de sélection de scène reste maintenant allumé quand la scène active fait partie de son étendue de scènes. // Approximatif

1.0.1
Bug fix - les nombres de canaux midi définis dans les fichiers de configuration étaient toujours plus élevés d'1 à l'arrivée.

1.0
Ajout d'un support pour les scènes (16 scènes, le canal midi par défaut de chaque scène est le même que le numéro de la scène), et texte LCD défilant.

0.9.1
Ajout de nouveaux modes : 'retrigger' et 'groupmaster'.

0.9
Ajout de groupes de pads/switches - assignez une rangée de pads à un groupe, et seulement l'un deux pourra être activé à la fois.