<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN">
<book lang="fr">
<bookinfo>

<title>Le Manuel de KMid</title>

<authorgroup>
<author>
	<firstname>Antonio</firstname>
	<surname>Larrosa Jiménez</surname>
	<affiliation>
		<address>
		<email><ulink url="mailto:larossa@kde.org">larrosa@kde.org</ulink>
		</email>
		</address>
	</affiliation>
</author>
</authorgroup>

<date>Version 1.7, 8/4/1999</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>

<abstract>
	<para>Ce manuel décrit KMid Version 1.7</para>
	<para>Lecteur multimédia midi/karaoké Kmid</para>
	<!-- Merge this with the previous paragraph; it comes from <META
	NAME="description" CONTENT="..."> -->
</abstract>

<keywordset>
	<keyword>KMid</keyword>
	<keyword>midi</keyword>
	<keyword>karaoké</keyword>
	<keyword>multimédia</keyword>
	<keyword>mid</keyword>
	<keyword>kar</keyword>
	<keyword>lecteur</keyword>
	<keyword>musique</keyword>
	<keyword>son</keyword>
	<keyword>fm</keyword>
	<keyword>awe</keyword>
	<keyword>gus</keyword>
</keywordset>
</bookinfo>

<chapter id="Introduction">
<title>Introduction</title>

<para>KMid est le lecteur multimédia midi/karaoké de KDE. Il offre certaines
caractéristiques non présentes dans les autres lecteurs midi sous Unix, comme
les graphiques en temps réel, et la coloration du texte pour le karaoké entre
autres. KMid fonctionne sur les systèmes d'exploitation Linux et FreeBSD. Il
utilise le gestionnaire audio OSS, donc il devrait fonctionner sur tous les
systèmes sur lesquels KDE et OSS se compilent. KMid supporte aussi le pilote
du "Linux Ultrasound Project", qui est nécessaire pour utiliser les cartes son
GUS (Gravis Ultra Sound).Je pense y ajouter le support pour le pilote ALSA dès
qu'il supportera les séquenceurs.</para>

<para>KMid affiche les paroles sur un écran en changeant leur couleur en même
temps que la musique est jouée, donc il est très facile de suivre les
chansons.</para>

<para>J'espère que vous trouverez KMid aussi agréable à utiliser que je l'ai
trouvé agréable à développer.</para>

<para><literal remap="tt">Antonio Larrosa Jiménez</literal>
<ulink url="mailto:larrosa@kde.org">larrosa@kde.org</ulink></para>

<sect1 id="caracteristiques-de-kmid">
<title>Caractéristiques de KMid</title>

<para>Voici les caractéristiques principales de KMid :</para>

<para>
<itemizedlist>
<listitem>

<para>Interface utilisateur <emphasis remap="bf">adaptée</emphasis> pour
afficher le texte karaoké avec une <emphasis remap="bf">coloration en temps
réel</emphasis> des paroles. </para></listitem><listitem>

<para>Vue graphique de ce qui est joué sur chaque canal midi, en colorant
les touches pressées sur des claviers (virtuels).</para></listitem>

<listitem>
<para>Le <emphasis remap="bf">mapper midi</emphasis> le
plus puissant que vous puissiez trouver sur n'importe quel système
d'exploitation</para></listitem>

<listitem>
<para><emphasis remap="bf">Glisser-déposer</emphasis> : vous pouvez
déposer dans KMid n'importe quel fichier midi depuis une fenêtre KFM.
</para></listitem>

<listitem>
<para>Vous pouvez <emphasis remap="bf">modifier le tempo</emphasis>
des morceaux pour les jouer plus lentement ou plus vite à volonté.
</para></listitem>

<listitem>
<para>Affichage d'une diode luminescente qui suit le rythme du
morceau.</para></listitem>

<listitem>
<para><emphasis remap="bf">Personnalisation des polices de
caractères</emphasis> pour le texte du karaoké affiché.</para></listitem>


<listitem>
<para>Support des deux standards pour placer des paroles dans les fichiers
midi, c'est-à-dire "lyrics" ou "text event" (avec détection automatique du
standard utilisé par le morceau).</para>
</listitem>

<listitem>
<para>Gestion des sessions. Si un morceau était joué alors que vous avez
quitté KDE, le même morceau sera joué la prochaine fois que vous vous
connecterez.</para></listitem>
<listitem>

<para>
<emphasis remap="bf">Volume ajustable</emphasis> en temps réel.</para>
</listitem>

<listitem>
<para>Il peut jouer les fichiers midi corrompu qui génèrent des fichiers core
(core dumps) avec les autres lecteurs !</para>
</listitem>

<listitem>
<para>Il peut ouvrir <emphasis remap="bf">les fichiers midi/karaoké
compressés avec gzip</emphasis> comme si c'étaient des fichiers ordinaires.
</para></listitem>

<listitem>
<para>Utilise environ <emphasis remap="bf">0.1%</emphasis> de mon
<emphasis remap="bf">CPU</emphasis> (dépend de la complexité du morceau).
</para></listitem>

<listitem>
<para>Supporte les synthétiseurs midi externes, AWE, FM et les cartes son GUS
(pour ces dernières, vous devez installer les pilotes LUP et gusd).
</para></listitem>

<listitem>
<para>Fonctionne sous Linux et FreeBSD (et peut être d'autres Unix...).
</para></listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="Generalusage">
<title>Utilisation</title>
<sect1 id="Openingsongs">
<title>Ouvrir des morceaux</title>

<para>Il y a différentes façons d'ouvrir les morceaux. Tout d'abord, vous
pouvez sélectionner <literal remap="tt">Ouvrir...</literal> dans le menu
<literal remap="tt">Fichier</literal>, alors une bo&icirc;te de dialogue d'ouverture
apparaît, dans laquelle vous pouvez sélectionner le morceau que vous voulez
ouvrir.</para>

<para>Vous pouvez glisser un fichier depuis une fenêtre KFM et le déposer dans
la fenêtre de KMid. Vous pouvez aussi utiliser le Glisser-déposer pour
plusieurs morceaux simultanément.</para>

<para>Si vous spécifiez un morceau à la ligne de commande en lançant KMid,
il sera aussi ouvert.</para>

<para>La dernière façon est de sélectionner un morceau dans la liste des
morceaux de la collection courante.</para>
</sect1>

<sect1 id="Playingsongs">
<title>Jouer des morceaux</title>

<para>Pour jouer un morceau, ouvrez-le d'abord, et appuyez sur le bouton
"Lecture" de la barre d'outils, ou cliquez sur <literal remap="tt">Play
(voir po)</literal> du menu <literal remap="tt">Chanson</literal>, ou
appuyez simplement sur la touche <literal remap="tt">espace</literal>.
Notez que si vous ouvrez un fichier en utilisant le Glisser-déposer, KMid
commencera à le jouer automatiquement (si vous déposez plusieurs fichiers, ils
seront placés dans une collection et seront joués dans l'ordre).</para>

<para>Une fois que Kmid joue un morceau, vous pouvez déplacer la barre de
transport (time slider), en pressant avec le bouton du milieu de la souris,
pour aller à une position spécifique.</para>

<para>Si un morceau est joué trop rapidement ou trop lentement pour vous, vous
pouvez cliquez sur les flèches de part et d'autre de l'écran LCD
(Liquid Crystal Display) du tempo pour le faire jouer plus
vite ou moins vite. Pour revenir au tempo par défaut, double cliquez sur
l'écran LCD du tempo.</para>

<para>La touche <literal remap="tt">espace</literal> est utilisée pour deux
choses : si vous pressez sur espace lorsqu'un morceau est joué, tout se
passera comme si vous aviez appuyé sur le bouton pause ou si vous aviez cliqué
sur <literal remap="tt">Pause</literal> dans le menu <literal
remap="tt">Chanson</literal>, c'est à dire que la lecture du fichier
midi sera stoppée momentanément. Si vous appuyez sur la touche <literal
remap="tt">espace</literal> alors qu'aucun morceau n'est joué, Kmid en
jouera un.</para>
</sect1>

<sect1 id="Displayinglyrics">
<title>Affichage des paroles</title>

<para>Il y a deux moyens pour placer des paroles dans une chanson, en utilisant
soit des <literal remap="tt">Text events</literal>, soit des <literal
remap="tt">Lyrics events</literal>, certaines chansons utilisent les premiers,
d'autres les seconds, certaines utilisent les deux, et d'autres ne contiennent
pas de paroles :-). KMid vous permet de choisir le type d'événements que vous
désirez afficher, et même mieux, il a une option pour déterminer
automatiquement le type d'événements utilisés par la chanson, donc vous n'avez
pas à changer le type manuellement. Ainsi, si vous cliquez sur <literal
remap="tt">Choix automatique du texte</literal> dans le menu <literal
remap="tt">Options</literal>, le texte du karaoké sera sélectionné
automatiquement, mais vous pouvez quand même changer le type de texte affiché
si vous le souhaitez.</para>

<para>Pour sélectionner quel type vous voulez voir, vous pouvez utiliser les
entrées appropriées dans le menu <literal remap="tt">Options</literal>, ou
simplement appuyer sur les touches <literal
remap="tt">1</literal> ou <literal remap="tt">2</literal> pour voir les
<literal remap="tt">Text events</literal> ou <literal remap="tt">Lyrics
events</literal> respectivement.</para>
</sect1>
</chapter>

<chapter id="Collections">
<title>Collections</title>

<para>Une collection est une liste de fichiers midi que vous placez dans un
ensemble, et qui seront joués l'un après l'autre. Cette section va vous aider à
les utiliser, et vous donnera quelques trucs utiles pour en faire bon
usage.</para>

<sect1 id="Creatingacollection">
<title>Création d'une collection</title>

<para>Pour créer une collection, ouvrez d'abord la boîte de dialogue <literal
remap="tt">Gestionnaire de Collection</literal>, en sélectionnant <literal
remap="tt">Organiser...</literal> dans le menu <literal
remap="tt">Collections</literal>. Cliquez alors sur le bouton <literal
remap="tt">Nouveau</literal>, et écrivez le nom que vous voulez donner à la
collection.</para>

<para>Vous pouvez aussi copier une collection entière en la sélectionnant et en
cliquant sur le bouton <literal remap="tt">Copier</literal>, et on vous
demandera le nom de la nouvelle collection, qui contient initialement les mêmes
chansons que la collection sélectionnée.</para>

<para>Dès lors que vous avez plusieurs collections, vous pouvez changer la
collection courante à partir du <literal
remap="tt">Gestionnaire de Collection</literal>, en la sélectionnant.
</para></sect1>

<sect1 id="TheTemporaryCollection">
<title>La collection temporaire</title>

<para>La collection temporaire est une collection qui est utilisée pour stocker
les chansons que vous voulez jouer mais que vous ne voulez pas placer dans une
collection.</para>

<para>Cette collection <emphasis remap="bf">n'est pas enregistrée</emphasis>
lorsque vous quittez l'application, gardez ceci à l'esprit si vous y ajoutez
beaucoup de chansons.</para>

<para>Continuez à lire cette section pour une meilleure compréhension du rôle
de la collection temporaire.</para>
</sect1>

<sect1 id="AddingsongstoacollectionhowtouseAutoAdd">
<title>Ajout de chansons à une collection (ou comment utiliser l'option
<literal remap="tt"></literal>'Ajouter automatiquement à la
collection')</title>

<para>Il y a plusieurs façons d'ajouter une chanson à une collection.</para>

<para>Tout d'abord, pour chacune de ces méthodes, vous devez avoir
préalablement sélectionné la collection à laquelle vous voulez ajouter une
chanson dans le <literal remap="tt">Gestionnaire de Collection</literal>.
Cliquez alors, sur le bouton 'ajouter' pour ajouter une chanson, une boîte de
dialogue d'ouverture de fichier apparaîtra alors afin que vous choisissiez
la chanson à ajouter.</para>

<para>L'autre méthode dépend de l'état de l'option 'Ajouter automatiquement à
la collection'.</para>

<para>Si l'option <literal remap="tt">Ajouter automatiquement à
la collection</literal> est activée, lorsque vous ouvrez une chanson (en
utilisant <literal remap="tt">Fichier &amp;verbar; Ouvrir...</literal> ou le
glisser-déposer), elle sera ajoutée à la collection courante sans
l'intervention de l'utilisateur. Si cette option n'est pas active lorsque vous
ouvrez une chanson, la collection temporaire sera activée et vidée et la ou les
chansons ouvertes y seront ajoutées.</para> </sect1>

<sect1 id="Removingsongsfromcollections">
<title>Suppression de chansons des collections</title>

<para>Pour enlever une chanson d'une collection, ouvrez simplement le <literal
remap="tt">Gestionnaire de Collection</literal>, sélectionnez la collection
adéquate, et la chanson que vous voulez enlever, puis cliquez sur le bouton
<literal remap="tt">Enlever</literal>.</para></sect1>

<sect1 id="Playinginorderoratrandom">
<title>Jouer les chansons dans l'ordre, ou au hasard</title>

<para>Vous pouvez sélectionner l'ordre dans lequel les chansons seront jouées.
Lorsque vous sélectionnez <literal remap="tt">Dans l'ordre</literal> dans le
menu <literal remap="tt">Collections</literal>, les chansons seront jouées dans
l'ordre dans lequel elles ont été déposées dans la collection. Lorsque vous
sélectionnez <literal remap="tt">Aléatoire</literal>, KMid génère une variable
aléatoire avec une distribution discrète uniforme pour jouer les chansons de la
collection de manière vraiment aléatoire. Il donnera des valeurs à cette
variable aléatoire lorsqu'il génère la liste qui contient l'ordre de lecture
des chansons (vous voulez certainement lire les chansons au hasard, mais vous
ne voulez pas écouter deux fois la même chanson, et vous voulez réécouter la
dernière chanson jouée lorsque vous appuyez sur le bouton 'chanson précédente',
n'est-ce pas ? :-)).</para>

<para>La liste aléatoire selon laquelle les chansons de la collection seront
jouées sera générée de nouveau chaque fois que vous ajoutez ou enlevez un
fichier dans la collection active, et chaque fois que vous sélectionnez
<literal remap="tt">Aléatoire</literal> dans le menu <literal
remap="tt">Collections</literal>.</para></sect1>

<sect1 id="Selectingasongfromacollection">
<title>Sélectionner une chanson dans une collection.</title>

<para>Vous pouvez sélectionner une chanson à jouer dans le <literal
remap="tt">Gestionnaire de Collection</literal>, ou en utilisant la liste
déroulante qui se trouve au-dessus du texte du karaoké.</para>

<para>Vous pouvez aussi passer à la chanson suivante en utilisant <literal
remap="tt">Chanson suivante</literal> dans le menu <literal
remap="tt">Chanson</literal>, ou le bouton <literal
remap="tt">Chanson suivante</literal> de la barre d'outils, ou en appuyant sur
la touche <literal remap="tt">flèche vers la droite</literal>.</para>

<para>Pour passer à la chanson précédente, utilisez <literal
remap="tt">Chanson précédente</literal> dans le menu <literal
remap="tt">Chanson</literal>, ou le bouton <literal
remap="tt">Chanson précédente</literal> de la barre d'outils, ou en appuyant
sur la touche <literal remap="tt">flèche vers la gauche</literal>.</para>
</sect1>

<sect1 id="Deletingacollection">
<title>Suppression d'une collection</title>

<para>Pour supprimer une collection, ouvrez simplement le <literal
remap="tt">Gestionnaire de Collection</literal>, sélectionnez la collection que
vous voulez supprimer, et cliquez sur <literal remap="tt">Supprimer</literal>.
Facile, n'est-ce pas ?</para>

<para>Gardez à l'esprit que vous ne pouvez pas supprimer la <literal
remap="tt">Collection temporaire</literal>, puisque de toutes façons, elle
n'est pas enregistrée lorsque vous quittez KMid.</para></sect1>
</chapter>

<chapter id="MidiMaps">
<title>Maps midi</title>
<sect1 id="Whatisamidimap">
<title>Qu'est-ce qu'une map midi ?</title>

<para>Une map midi est quelque chose qui transforme des événements midi en
d'autres événements midi.</para>

<para>Ceci est absolument nécessaire si votre synthétiseur ne comprend pas les
événements standards (c'est-à-dire si votre synthétiseur n'est pas compatible
Général Midi), dans ce cas, une map midi va traduire les événements Général
Midi dans des événements compréhensibles par le synthétiseur.</para>

<para>Vous pouvez par exemple faire une map midi qui convertit tous les
événements <literal remap="tt">Changement de programme à Bright Piano</literal>
vers des événements <literal remap="tt">Changement de programme à
Trumpet</literal>, ainsi lorsqu'une chanson essaie de jouer avec un piano, elle
jouera avec une trompette à la place.</para>

<para>Cela peut sembler bizarre (pourquoi vouloir jouer avec une trompette
alors que la chanson est faite pour être jouée avec un piano ?), mais c'est
très utile. Le standard GM spécifie que lorsqu'un clavier midi recoit un
événement de changement de programme <literal remap="tt">0</literal>, il
va changer le son actuel en <literal remap="tt">Grand Piano</literal>, mais un
synthétiseur plus vieux va changer le son actuel vers <literal remap="tt">Electric
Guitar</literal> par exemple. Ce vieux clavier aurait dû recevoir un
changement de programme <literal remap="tt">3</literal> (par exemple) pour
changer le son actuel en <literal remap="tt">Piano</literal>. C'est ici
qu'intervient la map midi, en changeant tous les <literal remap="tt">changement
de programme 0</literal> en <literal remap="tt">changement de programme
3</literal> permettant ainsi au synthétiseur de jouer avec le bon
instrument.</para> </sect1>

<sect1 id="DoIneedamidimap">
<title>Ai-je besoin d'une map midi ?</title>

<para>Si vous n'avez pas de synthétiseur externe, NON.</para>

<para>Si vous n'avez qu'une carte son, vous n'avez pas besoin de map midi car
toutes les cartes son sont compatibles GM (ceci inclut les cartes AWE, GUS, les
cartes FM, etc).</para>

<para>Si vous jouez de la musique avec un synthétiseur externe, et si il n'est
pas compatible GM, vous devrez utiliser une map midi pour votre clavier. Même
si vous passez une journée entière pour faire votre map midi, en essayant
différentes valeurs pour toutes les options, vous serez grandement récompensé
lorsque vous l'aurez fini, car vous aurez alors trouvé toutes les possibilités
cachées de votre clavier. Par exemple, j'ai un Yamaha PSS-790 bas de gamme, qui
n'est pas compatible GM, et n'a pas autant d'instruments qu'un synthétiseur GM,
mais avec le mapper midi de KMid, il sonne même mieux que certaines cartes son
(y-compris la AWE :-)), grâce à la grande qualité sonore des synthétiseurs
externes (mêmes sur des synthés non compatibles GM).</para></sect1>

<sect1 id="Creatingamidimap">
<title>Création d'une map midi</title>

<para>Il n'y a aucun programme pour générer des maps midi, donc vous devrez
éditer un fichier à la main (en utilisant votre éditeur de texte
préféré).</para>

<para>Une map midi est un fichier texte qui contient toutes les traductions
nécessaires qui seront effectuées lors de la lecture de la séquence.</para>

<para>Elle est constituée de quatre sections : <literal
remap="tt">PATCHMAP</literal>, <literal remap="tt">KEYMAP</literal>, <literal
remap="tt">CHANNELMAP</literal> et <literal
remap="tt">OPTIONS</literal>.</para>

<para>Chaque section ne doit apparaître qu'une seule fois, sauf la section <literal
remap="tt">KEYMAP</literal> qui peut apparaître autant de fois que nécessaire,
pourvu que chaque occurrence utilise un identificateur (TextID) différent
(continuez à lire pour plus de détails).</para>

<para>La structure générale d'un fichier map est la suivante : </para>

<para><screen>DEFINE PATCHMAP
...
END

DEFINE KEYMAP "Nom de la Keymap"
...
END

DEFINE KEYMAP "Autre Keymap"
...
END

DEFINE CHANNELMAP
...
END

OPTIONS
...
END
</screen>
</para>

<para>Vous pouvez voir que le mot <literal remap="tt">DEFINE</literal> est
utilisé pour spécifier quelle section est commencée (sauf pour <literal
remap="tt">OPTIONS</literal>), et <literal remap="tt">END</literal> est placé à
la fin de chaque section.</para>

<para>Vous pouvez placer des commentaires en commen&ccedil;ant la ligne avec le
caractère <literal remap="tt">&amp;num;</literal>.</para>

<para>S'il vous plaît, n'oubliez pas de m'envoyer vos fichiers map par courrier
électronique, pour que les versions futures de KMid incluent le support d'un
nombre plus important de claviers non compatibles Général Midi.</para>

<sect2 id="ThePATCHMAPsection">
<title>La section <literal remap="tt">PATCHMAP</literal></title>

<para>Cette section est utilisée pour spécifier comment les sons vont être
redirigés du standard GM vers les spécifications de votre clavier. Son
utilisation est la suivante : </para>

<para><screen>(Nom du son GM)=(N) [AllKeysTo M]
</screen>
</para>

<para>o&ugrave; <literal remap="tt">N</literal> est le numéro que votre clavier doit
recevoir pour utiliser le son équivalent au standard GM.</para>

<para>Notez que ce qui se trouve à gauche du signe égal est ignoré, donc on
suppose que les sons GM sont dans l'ordre (de 0 à 127), et donc vous ne pouvez
pas changer l'ordre des lignes ni omettre un des 128 instruments.</para>

<para>L'option <literal remap="tt">AllKeysTo M</literal> est utilisée pour
transformer toutes les notes qui utilisent cet instrument vers la touche
<literal remap="tt">M</literal>. Par exemple, supposons que votre clavier midi
n'ait pas le son "gun shot" (son GM 127) et vous voulez le remplacer par un son
de percussion (par exemple la touche 60), qui ressemble au son "gun shot",
alors vous pouvez placer à la ligne 127 de votre section<literal
remap="tt">PATCHMAP</literal> : </para>

<para><screen>Gunshot =100 AllKeysTo 60
</screen>
</para>

<para>Ainsi lorsqu'un fichier midi tente de jouer une note avec le son 127 (gun
shot), il sera redirigé vers le son 100 (le kit de percussions de votre
clavier) et jouera la note 60 (indépendamment de la touche qui a été
initialement jouée).</para>

<para>Notez que lorsque j'utilise l'expression "son de percussion", je veux
dire le son avec lequel chaque touche joue une percussion différente, comme par
exemple, une cymbale, un tom, des maracas etc, et non pas un unique son de
percussion disponible sur certains claviers, et dont la hauteur varie avec la
touche qui a été frappée.</para>
</sect2>

<sect2 id="TheKEYMAPsection">
<title>La section <literal remap="tt">KEYMAP</literal></title>

<para>La section <literal remap="tt">KEYMAP</literal> est utilisée pour
spécifier la fa&ccedil;on dont les touches seront mappées (c'est-à-dire assignées à
d'autres événements midi), dans un canal midi donné ou pour un instrument
donné. Son utilisation est la suivante :</para>

<para><screen>DEFINE KEYMAP "Nom de la Keymap"
C 0 =0
C#0 =1
D 0 =2
...
END
</screen>
</para>

<para>Tout comme pour la section <literal remap="tt">PATCHMAP</literal>,
l'ordre des lignes est très important, et elles doivent toutes être présentes
(les 128 touches).</para>

<para>Comme vous pouvez définir plusieurs keymaps pour différents canaux
midi et instruments, vous devez donner un nom différent à chacune à la première
ligne.</para>

<para>Les keymaps sont utilisées principalement pour mapper les
touches sur le canal de percussions. Jetez un coup d'oeil aux "maps"
fournies avec le logiciel pour voir quelques exemples.</para>
</sect2>

<sect2 id="TheCHANNELMAPsection">
<title>La section <literal remap="tt">CHANNELMAP</literal></title>

<para>Cette section peut-être utilisée pour mapper des canaux midi vers
d'autres canaux midi. Par exemple, si vous voulez échanger le premier et le
deuxième canal, vous pouvez le faire facilement en écrivant la section <literal
remap="tt">CHANNELMAP</literal>.</para>

<para>Ceci est cependant plus utile pour les claviers qui utilisent le son de
percussions sur un canal fixe (le standard GM utilise le canal 10, d'autres
utilisent le canal 16 ou 9 encore).</para>

<para>Notez que les instruments midi utilisent 16 canaux midi, ainsi la section
<literal remap="tt">CHANNELMAP</literal> comporte 16 lignes, de 0 à 15, comme
suit :</para>

<para>
<screen>(N) = (M) [Keymap "Name"] [ForcePatch x]
</screen>
</para>

<para>où <literal remap="tt">N</literal> est le canal qui est redirigé vers le
canal <literal remap="tt">M</literal>. Si l'option <literal
remap="tt">Keymap</literal> est utilisée, la Keymap nommée <literal
remap="tt">Name</literal> sera utilisée sur ce canal (cette Keymap doit
avoir été définie au préalable dans le fichier !). Si l'option <literal
remap="tt">ForcePatch</literal> est utilisée, tous les événements qui tenteront
de changer le son utilisé sur ce canal seront ignorés, et le son <literal
remap="tt">x</literal> sera utilisé à la place.</para>

<para>L'option <literal remap="tt">ForcePatch</literal> peut-être utile par
exemple pour toujours utiliser le kit de batterie sur le canal de canal de
percussions.</para>
</sect2>

<sect2 id="TheOPTIONSsection">
<title>La section <literal remap="tt">OPTIONS</literal></title>

<para>La section <literal remap="tt">OPTIONS</literal> contient des options qui
peuvent être très utiles :</para>

<para><screen>OPTIONS
PitchBenderRatio = r
MapExpressionToVolumeEvents
END
</screen>
</para>

<para>Vous pouvez spécifier les deux options, une seule, ou aucune.</para>

<para>La valeur du <literal remap="tt">PitchBenderRatio r</literal> contient le
facteur par lequel les événements de pitch bend sont multipliés (NdT : le pitch
bend est une variation de la hauteur du son, la plupart du temps contrôlée par
un joystick ou une molette, situé(e) à gauche du clavier sur les
synthétiseurs). Cela signifie que lorsqu'un fichier midi envoie un événement de
pitch bend avec la valeur <literal remap="tt">n</literal>, la valeur réelle qui
sera envoyée est <literal remap="tt">n*(r/4096)</literal> (la valeur <literal
remap="tt">4096</literal> est choisie de telle sorte qu'il n'y ait que des
valeurs entières dans les fichiers map).</para>

<para>Ceci est utile car le standard GM spécifie que lorsqu'un clavier midi
recoit un événement de 'pitch bend' avec la valeur 4096, il doit faire varier
la hauteur du son d'une note vers le haut, mais certains claviers tentent
d'augmenter la hauteur du son de plusieurs notes (voire d'une octave !)
lorsqu'ils re&ccedil;oivent la valeur 4096. Ceci peut être facilement résolu en
essayant différentes valeurs de telle sorte qu'au lieu d'envoyer la valeur
4096, KMid envoie la valeur appropriée.</para>

<para>Lorsque l'option <literal
remap="tt">MapExpressionToVolumeEvents</literal> est activée dans un fichier
map, et si un fichier midi envoie un événement 'expression', KMid enverra un
événement 'volume' qui est compris par un ensemble plus large de claviers non
GM, et qui produit un effet similaire. Il y a beaucoup de fichiers midi qui
utilisent les événements 'expression' pour diminuer progressivement le volume à
la fin des morceaux, et si vous sentez que le volume de la musique devrait
baisser de plus en plus, vous pouvez activer cette option et voir si c'est ce
dont vous aviez besoin. Il est en effet possible que votre synthétiseur ignore
les événements 'expression'.</para>
</sect2>
</sect1>

<sect1 id="Usingmidimaps">
<title>Utilisation des maps midi</title>

<para>Pour utiliser une map midi, ouvrez simplement la boîte de dialogue
<literal remap="tt">Configuration Midi</literal> en sélectionnant <literal
remap="tt">Configuration Midi</literal> dans le menu <literal
remap="tt">Options</literal></para>

<para>Cliquez alors sur le bouton <literal remap="tt">Parcourir...</literal>,
sélectionnez le fichier map à l'aide de la boîte de dialogue d'ouverture de
fichiers et en avant la musique ! :-)</para>
</sect1>
</chapter>

<chapter id="Advancedfeatures">
<title>Caractéristiques avancées</title>

<sect1 id="TheChannelView">
<title>La vue 'Canaux'</title>

<para>La vue 'Canaux' est est une fenêtre dans laquelle vous pouvez voir un
ensemble de claviers (un par canal midi). Sur ces claviers, les notes jouées
par chaque instrument sont colorées de telle sorte que vous voyiez ce
que joue chaque instrument.</para>

<sect2 id="Changinginstruments">
<title>Changer d'instrument</title>

<para>Vous pouvez utiliser la vue 'Canaux' pour changer l'instrument joué sur
chacun des canaux midi. Sur chaque canal il y a une liste déroulante dans
laquelle vous pouvez sélectionner l'instrument. Une fois que vous l'avez
changé, le bouton vert placé à côté de la liste déroulante passera au rouge
pour indiquer que ce n'est pas l'instrument par défaut.</para>

<para>Si vous voulez revenir à l'instrument par défaut, cliquez sur le bouton
rouge, et il sera automatiquement rappelé.</para> </sect2>

<sect2 id="Changingthelookmode">
<title>Changer l'apparence</title>

<para>La vue 'Canaux' possède deux façons (pour l'instant) d'afficher les notes
jouées, vous pouvez les sélectionner à partir de <literal
remap="tt">Options des Canaux...</literal> dans le menu <literal
remap="tt">Options</literal>.</para>

<para>Vous pouvez choisir entre un mode dans lequel les touches sont
frappées, comme s'il s'agissait d'un piano normal (<literal remap="tt">3D
look</literal>), et un mode dans lequel les touches sont colorées en rouge,
afin de les identifier facilement (<literal remap="tt">3D - filled</literal>).
Si vous jouez du piano, ou n'importe quel autre instrument de musique, vous
pouvez utiliser cette vue pour apprendre vous-même à jouer une chanson. J'ai
utilisé cette technique et c'est vraiment agréable pour apprendre de nouvelles
compositions moyennant une diminution du tempo).</para></sect2></sect1>

<sect1 id="TheTempoLCD">

<title>L'écran LCD de tempo</title>

<para>Il affiche le tempo avec lequel le morceau est joué, c'est-à-dire la
vitesse du morceau. Plus le numéro est élevé, plus vite est jouée la
chanson.</para>

<para>Vous pouvez aussi changer le tempo de la chanson, ainsi si la chanson est
trop rapide pour que vous puissiez suivre les paroles, vous pouvez la ralentir.
Pour changer le tempo, vous pouvez utiliser les flèches situées de part et
d'autre du LCD.</para>

<para>Si vous avez changé le tempo, vous pouvez revenir au tempo par défaut en
double cliquant sur le LCD.</para></sect1>

</chapter>

<chapter id="Keybindings">
<title>Raccourcis clavier</title>

<para><itemizedlist>
<listitem>
<para><literal remap="tt">Espace</literal> - Joue la chanson chargée s'il
n'est pas en train de jouer, ou se met en pause s'il était en train de
jouer.</para> </listitem> <listitem>

<para><literal remap="tt">Retour Arrière</literal> - Stoppe la lecture</para>
</listitem>
<listitem>
<para><literal remap="tt">Flèche vers la droite</literal> - Chanson
suivante dans la collection courante</para>
</listitem> <listitem>

<para><literal remap="tt">Flèche vers la gauche</literal> - Chanson
précédente dans la collection courante</para> </listitem>
<listitem>
<para><literal remap="tt">Flèche vers le haut</literal> - Remonte d'une
ligne dans les paroles</para></listitem>
<listitem>
<para><literal remap="tt">Flèche vers le bas</literal> - Descend d'une
ligne dans les paroles</para></listitem>
<listitem>
<para><literal remap="tt">Page vers le haut</literal> - Remonte d'une
page dans les paroles</para></listitem>
<listitem>
<para><literal remap="tt">Page vers le bas</literal> - Descend d'une
page dans les paroles</para></listitem>
<listitem>
<para><literal remap="tt">1</literal> - Affiche les événements de type
"text"</para>
</listitem>
<listitem> <para><literal remap="tt">2</literal> - Affiche les
événements de type "lyrics" </para>
</listitem>
<listitem>
<para><literal remap="tt">Contr&ocirc;le-O</literal> - Ouvre une chanson</para>
</listitem>
<listitem>
<para><literal remap="tt">Contr&ocirc;le-Q</literal> - Quitte KMid</para>
</listitem>
<listitem>
<para><literal remap="tt">F1</literal> - Ouvre cette documentation</para></listitem>
</itemizedlist>
</para>
</chapter>

<chapter id="Installation">

<title>Installation</title>

<sect1 id="HowtoobtainKMid">

<title>Comment obtenir KMid</title>

<para>KMid est une application de la distribution KDE <ulink
url="http://www.kde.org">http://www.kde.org</ulink>. KMid se trouve dans le
paquetage KDEmultimedia, que vous pouvez trouver à l'adresse <ulink
url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, le site
ftp principal du projet KDE. Vous pouvez aussi le télécharger depuis un des
sites ftp miroirs dont la liste se situe à l'adresse <ulink
url="http://www.kde.org/mirrors.html">http://www.kde.org/mirrors.html</ulink>.
</para>

<para>En outre, KMid peut-être trouvé sur son site internet, qui se situe à
l'adresse <ulink url="http://www.arrakis.es/~rlarrosa/kmid.html">
http://www.arrakis.es/~rlarrosa/kmid.html</ulink>. Sur ce site, vous pouvez
suivre son développement, voir quelques informations, quelques captures
d'écran, une liste de sites depuis laquelle vous pouvez télécharger des
chansons pour karaoké, etc.</para> </sect1>

<sect1 id="Requirements">
<title>Prérequis</title>

<para>Pour fonctionner, KMid nécessite :</para>

<para><itemizedlist>
<listitem>
<para>KDE. Bon, vous l'avez probablement déjà :-)
</para>
</listitem>
<listitem>
<para>Une carte son.
Une bonne carte son et/ou un synthétiseur externe sont recommandés, car la
qualité sonore en dépend beaucoup, ce n'est pas la même
chose de jouer de la musique avec une carte FM et une carte AWE.</para>

<para>Si vous n'avez pas de carte son, vous pouvez tout de même compiler KMid
en définissant <literal
remap="tt">MODE&amp;lowbar;DEMO&amp;lowbar;ONLYVISUAL</literal> et il fonctionnera
comme si vous en aviez une (mais vous n'aurez pas de musique, évidemment :-(
).</para>

</listitem>
</itemizedlist>
</para>
</sect1>
<sect1 id="Compilationandinstallation">
<title>Compilation et installation</title>

<para>Si vous avez téléchargé le paquetage KDEmultimedia, ou juste le paquetage
KMid, pour compiler KMid vous devez taper <literal
remap="tt">configure</literal>, puis <literal remap="tt">make</literal>, et
enfin, pour l'installer, <literal remap="tt">make install</literal>
(probablement en root).</para>

<para>J'y ai inclu quelques exemples qui se trouvent dans <literal
remap="tt">$KDEDIR/share/apps/kmid</literal></para>

<para>Si vous rencontrez des problèmes, n'hésitez pas à contacter l'une des
listes de discussion de KDE, ou envoyez-moi un message directement.</para>
</sect1>
</chapter>

<chapter id="FrequentlyAskedQuestionsFAQ">
<title>Foire Aux Questions (FAQ)</title>

<para><itemizedlist>
<listitem>
<para><literal remap="tt">Q : </literal> Qu'est-ce qu'un fichier midi
exactement ?
<literal remap="tt">R : </literal>Un fichier midi est un fichier qui contient
les informations sur la façon de jouer une chanson, c'est-à-dire qu'il contient
simplement les notes, le rythme, le tempo, etc. Ceci implique que le même
fichier midi, joué avec des appareils différents, peut produire des résultats
très différents, tout comme une partition donnée peut être interprétée de
manière très différente par deux musiciens.</para></listitem>

<listitem>

<para><literal remap="tt">Q : </literal>Je peux avoir une qualité sonore bien
supérieure avec un lecteur mp3/d'échantillons, pourquoi utiliser KMid ?
<literal remap="tt">R : </literal>Bon, je ne peux forcer personne à utiliser
KMid, mais un fichier midi classique occupe 50 ko, alors qu'un fichier mp3
typique occupe 4Mo (ça correspond à un rapport de compression de 1:80 :-). De
plus, avec un bon synthétiseur, vous pouvez obtenir un son de qualité
comparable. Plus encore, avec un fichier midi, vous pouvez changer les
instruments individuellement, changer la vitesse de la chanson etc. donc vous
avez globalement plus de contrôles.</para></listitem>

<listitem>

<para><literal remap="tt">Q : </literal>Je ne parviens pas à faire fonctionner
ma carte AWE avec KMid, qu'est-ce que je peux faire ? <literal
remap="tt">R : </literal>Cela peut arriver si vous utilisez une distribution
binaire (rpm, deb) de KMid. Ceci est dû au fait que KMid a été compilé sans le
support awe. Si &ccedil;a ne fonctionne pas, alors vous devez télécharger une
distribution du code source (par exemple à partir <ulink
url="http://www.arrakis.es/~rlarrosa/kmid.html">du site internet de
KMid)</ulink></para></listitem>

<listitem>
<para><literal remap="tt">Q : </literal>Je voudrais ajouter un répertoire
entier à une collection, mais ajouter les fichiers midi un par un n'est pas
très cool. <literal remap="tt">R : </literal>Je suis d'accord, c'est pourquoi
KMid supporte le glisser-déposer. Ouvrez simplement, dans KFM, le répertoire
que vous voulez ajouter, sélectionnez tous les fichiers, glissez les et
déposez les dans KMid. Assurez-vous d'avoir activé l'option <literal
remap="tt">Ajouter automatiquement à la collection</literal> au préalable, afin
que les fichiers sélectionnés soient ajoutés à la collection courante. Si vous
ne l'activez pas, les fichiers seront ajoutés à la collection
temporaire.</para></listitem>

<listitem>
<para><literal remap="tt">Q : </literal>Je n'arrive pas à suivre les paroles,
ça va trop vite ! <literal remap="tt">R : </literal> Vous pouvez cliquer sur la
flèche vers la gauche de l'écran LCD de tempo pour jouer la chanson moins vite.
Souvenez-vous que vous pouvez double cliquer sur le LCD pour revenir au tempo
par défaut.</para></listitem></itemizedlist></para>
</chapter>

<chapter id="Finalnotes">
<title>Notes</title>
<sect1 id="Sometipsandtricks">
<title>Quelques trucs et astuces</title>

<para>J'ai inclus quelques astuces afin que vous tiriez le meilleur parti
de toutes les fonctionnalités de KMid :</para>

<para><itemizedlist>
<listitem>
<para><literal remap="tt">Ouvrir des fichiers.</literal>
Je garde toujours un bureau KDE avec une fenêtre KFM dans le répertoire de mes
fichiers midi, et KMid sur le bureau (s'il joue un fichier midi) ou
cloué (s'il joue un fichier karaoké :-)). Ainsi, lorsque la collection
courante se termine, ou si je veux jouer certains fichiers, je vais simplement
dans la fenêtre KFM, je sélectionne les fichiers désirés et je les glisse dans
la fenêtre de KMid.</para>

<para>Supposons que vous vouliez jouer des fichiers midi, mais sans les ajouter
dans une collection. Il suffit de désactiver l'option <literal
remap="tt">Ajouter automatiquement à la collection</literal> dans le menu
<literal remap="tt">Collections</literal>, et ouvrez les fichiers, ils seront
ajoutés à la collection temporaire.</para>
</listitem>

<listitem>
<para><literal remap="tt">Autre méthode pour créer une nouvelle
collection</literal> Supposons que vous ayez les fichiers midi A.mid, B.mid et
C.mid. Tout d'abord, vous ne voulez jouer que le premier fichier midi, donc
vous désélectionnez l'option <literal remap="tt">Ajouter automatiquement à la
collection</literal> et ouvrez A.mid. Vous avez alors une collection temporaire
avec un seul fichier midi.</para>

<para>Vous décidez alors de jouer aussi B et C, et de faire une collection
avec, que faites-vous ?</para>

<para>Facile, sélectionnez <literal remap="tt">Ajouter automatiquement à la
collection</literal> et ouvrez B.mid et C.mid (par une des multiples méthodes),
ils seront automatiquement ajoutés à la collection temporaire, qui contiendra
alors A.mid, B.mid et C.mid. à ce moment, vous pouvez ouvrir la boîte de
dialogue <literal remap="tt">Gestionnaire de Collections</literal>,
sélectionnez la collection temporaire, et cliquez sur le bouton <literal
remap="tt">Copier</literal>. Entrez alors le nom de la nouvelle collection, et
c'est bon. Vous avez alors une nouvelle collection, qui contient les fichiers
midi A, B et C, et qui ne sera pas effacé lorsque vous fermez KMid.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="HallofKMidsfriends">
<title>Panthéon des amis de KMid</title>

<para>Voici quelques personnes qui m'ont envoyé des fichiers midi ou une carte
postale, merci à tous ! écouter ces chansons et regarder des cartes postales
m'encourage à programmer toujours plus sur kMid.</para>

<para><itemizedlist>
<listitem>
<para>Ola Sigurdson - <literal remap="tt">Taking Care of Business</literal>
(Bachman Turner Overdrive)</para> </listitem>
<listitem>
<para>EG Lim - Une chouette carte postale de Penang.</para> </listitem>
<listitem>
<para>Guenther Starnberger - <literal remap="tt">Amadeus</literal> (Falco) et
<literal remap="tt">Schrei Nach Liebe</literal> (Die Aerzte)</para> </listitem>
<listitem>
<para>Leandro Terrés - <literal remap="tt">All That She Wants</literal>
et <literal remap="tt">The Sign</literal> (Ace of Base)</para> </listitem>
<listitem>
<para>Nick Stoic - Deux fichiers midi</para>
</listitem>
</itemizedlist>
</para>
</sect1>
<sect1 id="Abouttheauthor">
<title>à propos de l'auteur</title>

<para>KMid a été écrit par Antonio Larrosa Jiménez, à M&aacute;laga
(Espagne). Je suis étudiant en mathématiques à l'université de Malaga,
actuellement je suis en licence, donc je n'ai pas autant de temps libre pour
mes passions, mais j'essaie toujours d'en avoir :-) . Mes loisirs sont :
la programmation, collectionner les fichiers midi, jouer de la musique et
démontrer des théorèmes ;-) .</para>

<para>Si vous voulez avoir où télécharger des fichiers midi/karaoké, si vous
avez des questions, un bogue à décrire, une idée ou une fonctionnalité que vous
voudriez voir dans KMid, ou si vous voulez simplement me rendre heureux,
n'hésitez pas à m'envoyer un courrier électronique à : <ulink
url="mailto:larrosa@kde.org">larrosa@kde.org</ulink> ou <ulink
url="mailto:antlarr@arrakis.es">antlarr@arrakis.es</ulink></para>

<para>ou un courrier postal à :
<screen> Antonio Larrosa Jimenez
Rio Arnoya 10 5B
Malaga (Spain)
</screen>
</para>

<para>Vous me rendriez vraiment heureux en m'envoyant une carte postale de
l'endroit o&ugrave; vous vivez, ou un fichier midi/karaoké d'un groupe de musique
locale de votre pays. Tous ceux qui m'enverront une carte postale ou un fichier
midi auront leur nom dans le panthéon des amis de KMid de ce fichier (s'ils ne
s'y opposent pas). Contactez-moi avant de m'envoyer un fichier midi parce que
je l'ai peut-être déjà.</para>

<para>Je voudrais insister sur le fait que KMid a été développé entièrement
durant mon temps libre, sans aucun support financier d'une quelconque
entreprise ou d'un particulier. Donc gardez à l'esprit lorsque vous l'utilisez,
que la seule chose qui m'a motivé pour le faire est le retour que je pourrais
avoir des utilisateurs (une carte postale ou juste un courrier
électronique).</para>

<para>Je voudrais remercier les personnes suivantes pour l'aide qu'elles ont
apportée au développement de KMid :
<itemizedlist>
<listitem>
<para><ulink url="mailto:P.J.Leonard@bath.ac.uk">Paul J. Leonard</ulink> -
support des cartes AWE</para> </listitem>
<listitem>
<para><ulink url="mailto:szoli@digo.inf.elte.hu">Sebestyen Zoltan</ulink> -
portage sur FreeBSD et test du AWE</para> </listitem>
<listitem>
<para><ulink url="mailto:esken@kde.org">Christian Esken</ulink> - pour les
efforts d'organisation de la branche multimédia de KDE</para></listitem>
<listitem>
<para><ulink url="mailto:coolo@kde.org">Stephan Kulow</ulink> -
Pour les scripts Configure et son aide sur automake et CVS</para>
</listitem>
<listitem> <para>Jaroslav Kysela - pour son aide sur le support du Linux
Ultrasound Project driver</para></listitem><listitem>
<para>Takashi Iwai and Joseph H. Buehler - pour la correction des
problèmes de pitch avec les cartes AWE</para> </listitem> <listitem>
<para>Adrian Knoth - pour m'avoir donné de bonnes nouvelles et beaucoup
de suggestions</para></listitem>
<listitem>
<para>Kevin Street - patch pour le support FreeBSD 3.0</para>
</listitem>
<listitem>
<para>Merci aussi à Jose Luis Sanchez pour avoir testé le support GUS, Ignacio
Garcia pour avoir testé le support AWE, Hans Petter Bieker, Ola Sigurdson, Marc
Diefenbruch, Peter Gritsch, Magnus Pfeffer, Urko Lusa, Peter-Paul Witta,
Thorsten Westheider, Ulrich Cordes et tous ceux qui m'ont envoyé un patch,
un rapport de bogue ou simplement un courrier électronique
d'encouragement.</para></listitem>

<listitem>
<para>Et bien sûr à tous ces fabuleux musiciens sur le net qui nous font de
magnifiques fichiers midi et karaoké.</para>
</listitem>
</itemizedlist>
</para>
<para>La traduction française a été réalisée par
<ulink url="mailto:ludovic.grossard@libertysurf.fr">Ludovic
Grossard</ulink></para>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
