annotate DOCS/xml/fr/skin.xml @ 36916:d41fbe8a8797

Add new dynamic label variable $U. This is the volume without decimal places (which makes more sense to me than $V and should have been the output of $V in the first place).

<?xml version="1.0" encoding="utf-8"?>
<!-- synced with 20310 -->
<appendix id="skin">
<title>Format de skins <application>MPlayer</application></title>

<sect1 id="skin-overview">
<title>Aperçu</title>
<para>
Ce n'est pas en rapport direct avec le format des skins, mais vous devez savoir
que <application>MPlayer</application> n'a <emphasis role="bold">pas</emphasis> de skin par défaut, donc
<emphasis role="bold">au moins une skin doit être installée pour pouvoir utiliser
la GUI.</emphasis>
</para>

<sect2 id="skin-overview-directories">
<title>Répertoires</title>
<para>
<application>MPlayer</application> cherche des skins dans ces répertoires (dans cet ordre):
<orderedlist>
<listitem><para>
<filename class="directory">$(DATADIR)/skins/</filename>
</para></listitem>
<listitem><para>
<filename class="directory">$(PREFIX)/share/mplayer/skins/</filename>
</para></listitem>
<listitem><para>
<filename class="directory">~/.mplayer/skins/</filename>
</para></listitem>
</orderedlist>
</para>

<para>
Notez que le premier répertoire peut varier suivant la façon dont <application>MPlayer</application> a été
configuré (voir les arguments <option>--prefix</option> et <option>--datadir</option>
du script <command>configure</command>).
</para>

<para>
Chaque skin est installée dans son propre répertoire sous l'un des répertoires
listés ci-dessus, par exemple:
<screen>$(PREFIX)/share/mplayer/skins/default/</screen>
</para>
</sect2>

<sect2 id="skin-overview-formats">
<title>Format d'images</title>
<para>Les images doivent être en truecolor (24 ou 32 bpp) et enregistrées au
format PNG.</para>
<para>
Dans la fenêtre principale et la barre de lecture (c.f. ci-dessous) vous pouvez
utiliser des images dotées de régions &quot;transparentes&quot;: les régions
remplies avec la couleur #FF00FF (magenta) deviennent transparentes dans <application>MPlayer</application>.
Cela signifie que vous pouvez obtenir des formes particulières pour vos fenêtres si votre
serveur X possède l'extension XShape.
</para>
</sect2>

<sect2 id="skin-overview-components">
<title>Composants d'une skin</title>
<para>
Les skins sont d'un format plutôt libre (contrairement aux formats fixes de
<application>Winamp</application>/<application>XMMS</application>, par exemple),
donc il ne tient qu'a vous de créer quelque chose de bien.
</para>

<para>
Actuellement, trois fenêtres doivent être décorées: la
<link linkend="skin-file-main">fenêtre principale</link>, la
<link linkend="skin-file-subwindow">sous-fenêtre</link>, la
<link linkend="skin-file-main">barre de lecture</link>, et le
<link linkend="skin-file-menu">menu</link> (activable par un clic droit).

<itemizedlist>
<listitem><para>
  Vous contrôlez <application>MPlayer</application> par la <emphasis role="bold">fenêtre principale</emphasis>
  et/ou la <emphasis role="bold">barre de lecture</emphasis>. L'arrière plan est
  une image. Divers objets peuvent (et doivent) venir se placer dans cette fenêtre:
  <emphasis>boutons</emphasis>, <emphasis>podomètres</emphasis>
  (sliders) et <emphasis>labels</emphasis>. Pour chaque objet, vous devez
  spécifier sa taille et sa position.
</para><para>
  Un <emphasis role="bold">bouton</emphasis> comprend trois états (pressé, relâché,
  désactivé), donc l'image doit se diviser en trois parties, verticalement. Voir
  l'objet <link linkend="skin-button">bouton</link> pour plus de détails.
</para><para>
  Un <emphasis role="bold">podomètre</emphasis> (principalement utilisé pour la
  barre d'avancement et le contrôle du volume/balance) peut posséder n'importe quel
  nombre d'états en empilant ces images, verticalement. Voir
  <link linkend="skin-hpotmeter">hpotmeter</link> et
  <link linkend="skin-potmeter">potmeter</link> pour plus de détails.
</para><para>
  Les <emphasis role="bold">labels</emphasis> sont un peu particuliers : les
  caractères nécessaires pour les dessiner sont récupérés depuis un fichier image,
  décrit par un <link linkend="skin-fonts">fichier de description de polices</link>.
  Ce dernier est un fichier texte brut spécifiant la position x,y ainsi que la
  taille de chaque caractère dans l'image (le fichier image et son descripteur
  forment une police <emphasis>ensemble</emphasis>). Voir <link linkend="skin-dlabel">dlabel</link>
  et <link linkend="skin-slabel">slabel</link> pour plus de détails.
</para>
<note><para>
  Toutes les images disposent de la couleur de transparence décrite dans la section
  <link linkend="skin-overview-formats">formats d'images</link>. Si le serveur X ne
  supporte pas l'extension Xshape, les parties transparentes seront noires. Si vous
  voulez utiliser cette fonction, la largeur de l'image de la fenêtre principale
  devra être divisible par 8.
</para></note>
</listitem>

<listitem><para>
  La <emphasis role="bold">sous-fenêtre</emphasis> contient la vidéo en elle même.
  Elle peut afficher une image si aucun film n'est chargé (ce n'est jamais plaisant
  d'avoir une fenêtre vide :-)) <emphasis role="bold">Note:</emphasis> la couleur
  de transparence n'est <emphasis role="bold">pas autorisée</emphasis> ici.
</para></listitem>

<listitem><para>
  Le <emphasis role="bold">menu</emphasis> est simplement un moyen de contrôler
  <application>MPlayer</application> par des entrées graphiques. Deux images sont nécessaires pour le menu:
  l'une d'elle, l'image de base, affiche le menu dans son été normal, l'autre est
  utilisée pour afficher les entrées sélectionnées. Quand vous faites apparaître le
  menu, la première image s'affiche. Si vous passez la souris sur les entrées du
  menu, l'entrée sélectionnée est copiée depuis la seconde image, et uniquement la
  partie concernée par cette sélection (la seconde image ne s'affiche jamais
  complètement.)
</para><para>
  Une entrée de menu se définit par sa position et sa taille dans l'image (voir la
  section <link linkend="skin-file-menu">menu</link> pour plus de détails).
</para></listitem>
</itemizedlist>
</para>

<para>
  Une chose essentielle n'a pas encore été mentionnée : pour que les boutons,
  podomètres et entrées du menu fonctionnent, <application>MPlayer</application> doit savoir quoi en faire.
  Ceci dépend des <link linkend="skin-gui">messages</link> (events) envoyés. Pour
  chacun de ces objets vous devez définir le message à afficher quand on clique
  dessus.
</para>
</sect2>

<sect2 id="skin-files">
<title>Fichiers</title>
<para>
Vous aurez besoin des fichiers suivants pour construire une skin:
<itemizedlist>
<listitem><para>
  Le fichier de configuration nommé <link linkend="skin-file">skin</link> indique
  à <application>MPlayer</application> comment assembler les différentes images et comment interpréter les
  clics de souris sur l'interface.
</para></listitem>
<listitem><para>
  L'image de fond de la fenêtre principale.
</para></listitem>
<listitem><para>
  Les images correspondants aux objets de la fenêtre principale (y compris une ou
  plusieurs polices et descripteurs nécessaires à l'affichage des textes).
</para></listitem>
<listitem><para>
  L'image affichée dans la sous-fenêtre (optionnel).
</para></listitem>
<listitem><para>
  Deux images pour le menu (nécessaires uniquement si vous voulez créer un menu).
</para></listitem>
</itemizedlist>
  A l'exception du fichier de configuration, vous pouvez nommer les fichiers comme
  bon vous semble (mais notez que les descripteurs de polices doivent avoir une
  extension <filename>.fnt</filename>).
</para>
</sect2>
</sect1>

<sect1 id="skin-file">
<title>Le fichier skin</title>
<para>
Comme mentionné plus haut, c'est le fichier de configuration de la skin. Il est
lu ligne par ligne; les lignes de commentaires démarrent par le caractère
'<literal>;</literal>' en début de ligne (seuls les espaces et tabulations sont
autorisées avant ce signe).
</para>

<para>
Les fichiers se composent de sections. Chaque section décrit la skin pour une
application et s'écrit sous la forme:
<programlisting>
section = <replaceable>nom de la section</replaceable>
.
.
.
end
</programlisting>
</para>

<para>
Actuellement il n'existe qu'une application, donc vous n'aurez besoin que d'une
section: dont le nom est <emphasis role="bold">movieplayer</emphasis>.
</para>

<para>
Dans cette section chaque fenêtre est décrite par un bloc de la forme suivante:
<programlisting>
window = <replaceable>nom de la fenêtre</replaceable>
.
.
.
end
</programlisting>
</para>

<para>
Où <replaceable></replaceable> peut-être l'un des types suivants:
<itemizedlist>
<listitem><para><emphasis role="bold">main</emphasis> - pour la fenêtre principale</para></listitem>
<listitem><para><emphasis role="bold">sub</emphasis> - pour la sous-fenêtre</para></listitem>
<listitem><para><emphasis role="bold">menu</emphasis> - pour le menu</para></listitem>
<listitem><para><emphasis role="bold">playbar</emphasis> - barre de lecture</para></listitem>
</itemizedlist>
</para>

<para>
(Les blocs sub et menu sont optionnels - vous n'avez pas l'obligation de décorer
le menu et la sous-fenêtre.)
</para>

<para>
Dans un bloc window, vous pouvez définir chaque objet sous la forme:
<programlisting>objet = paramètre</programlisting>
Où <literal>objet</literal> est une ligne identifiant le type d'objet de la GUI,
<literal>paramètre</literal> est une valeur numérique ou textuelle (ou une liste
de valeurs séparées par des virgules).
</para>

<para>
Le fichier final doit donc ressembler à ceci:
<programlisting>
section = movieplayer
  window = main
  ; ... objets de la fenêtre principale ...
  end

  window = sub
  ; ... objets de la sous-fenêtre ...
  end

  window = menu
  ; ... objets du menu ...
  end

  window = playbar
  ; ... objets de la la barre de lecture ...
  end
end
</programlisting>
</para>

<para>
Le nom d'un fichier image doit être donné sans distinction de répertoire - les
images seront cherchées dans le répertoire <filename class="directory">skins</filename>.
Vous pouvez (mais ce n'est pas obligatoire) spécifier l'extension du fichier. Si
le fichier n'existe pas, <application>MPlayer</application> essaie de charger le fichier
<filename>&lt;nomfichier&gt;.&lt;ext&gt;</filename>, où <literal>png</literal>
et <literal>PNG</literal> sera respectivement <filename>&lt;ext&gt;</filename>
(dans cet ordre). La première correspondance trouvée sera utilisée.
</para>

<para>
Pour finir quelques mots sur le positionnement. La fenêtre principale et la
sous-fenêtre peuvent être placées dans des coins différents de l'écran en donnant
les coordonnées <literal>X</literal> et <literal>Y</literal>. <literal>0</literal>
pour haut ou gauche, <literal>-1</literal> pour centre et <literal>-2</literal>
pour droite ou bas, comme montré sur cette illustration:
</para>
<informalfigure>
<screen>
(0, 0)----(-1, 0)----(-2, 0)
  |          |          |
  |          |          |
(0,-1)----(-1,-1)----(-2,-1)
  |          |          |
  |          |          |
(0,-2)----(-1,-2)----(-2,-2)
</screen>
</informalfigure>

<para>

Un exemple. Supposons que vous avez crée une image <filename>main.png</filename>
que vous voulez utiliser pour la fenêtre principale:
<programlisting>base = main, -1, -1</programlisting>
MPlayer essaie de charger les fichiers <filename>main</filename>,
<filename>main.png</filename>, <filename>main.PNG</filename>.
</para>


<sect2 id="skin-file-main">
<title>Fenêtre principale et barre de lecture</title>
<para>
Vous trouverez ci-dessous la liste des objets utilisables dans les blocs
'<literal>window = main</literal>' ... '<literal>end</literal>',
et '<literal>window = playbar</literal>' ... '<literal>end</literal>'.
</para>

<variablelist>
<varlistentry>
  <term><literal>
  <anchor id="skin-main-base"/>base = image, X, Y
  </literal></term>
  <listitem><para>
  Vous spécifiez ici l'image de fond utilisée dans la fenêtre principale. La
  fenêtre apparaîtra a la position <literal>X,Y</literal> sur l'écran. La fenêtre
  aura la taille de l'image.
    </para>
    <note><para>Ces coordonnées ne fonctionnent actuellement pas pour la fenêtre
    d'affichage.</para></note>
    <warning><para>Les régions transparentes (couleur #FF00FF) apparaîtront en noir
    sur les serveurs X n'ayant pas l'extension XShape. La largeur de l'image doit
    être divisible par 8.</para></warning>
    </listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-button"/>button = image, X, Y, largeur, hauteur, message
  </literal></term>
  <listitem><para>
Place un bouton de taille <literal>largeur</literal> * <literal>hauteur</literal>
a la position <literal>X,Y</literal>. Le <literal>message</literal> sera généré
au clic sur ce bouton. L'image appelée par <literal>image</literal> doit avoir
trois états empilés verticalement (pour les trois états du bouton), comme ceci:

</para>
<informalfigure>
<screen>
+------------+
|  pressé    |
+------------+
|  relâché   |
+------------+
|  désactivé |
+------------+
</screen>
</informalfigure>
  </listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-decoration"/>decoration = enable|disable
  </literal></term>
  <listitem><para>
Active (enable) ou désactive (disable) la décoration du gestionnaire de fenêtre
pour la fenêtre principale. <emphasis role="bold">disable</emphasis> par défaut.
    </para>
    <note><para>Cela ne fonctionne pas pour la fenêtre d'affichage, il n'y en a pas
    besoin.</para></note>
  </listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-hpotmeter"/>hpotmeter = button, blargeur, bhauteur, phases, numphases, default, X, Y, largeur, hauteur, message
  </literal></term>
  <listitem><para>

    </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-vpotmeter"/>vpotmeter = button, blargeur, bhauteur, phases, numphases, default, X, Y, largeur, hauteur, message
  </literal></term>
  <listitem><para>

Place un podomètre horizontal (hpotmeter) ou vertical (vpotmeter) de taille
<literal>largeur</literal> * <literal>hauteur</literal> à la position
<literal>X,Y</literal>. L'image peut être divisée en différentes parties pour les
différentes phases du podomètre (par exemple, vous pouvez en avoir un pour le
contrôle du volume qui passe du vert au rouge quand sa valeur passe du minimum au
maximum). <literal>hpotmeter</literal> peut posséder un bouton qui sera glissé
horizontalement.
    </para>
    <itemizedlist>
    <listitem><para><literal>button</literal> - l'image utilisée pour le bouton (doit
    avoir trois états superposés, comme pour les
    <link linkend="skin-button">boutons</link>)
    </para></listitem>
    <listitem><para><literal>blargeur</literal>,<literal>bhauteur</literal> - taille
    du bouton
    </para></listitem>
   <listitem><para><literal>phases</literal> - l'image utilisée pour les différentes
   phases du podomètre. Une valeur <literal>NULL</literal> spéciale peut-être
   utilisée si vous ne voulez pas d'image. L'image doit être divisée en
   <literal>numphasesparts</literal> verticalement comme ceci:
    </para>
<informalfigure>
<screen>
+------------+
|  phase #1  |
+------------+
|  phase #2  |
+------------+
     ...
+------------+
|  phase #n  |
+------------+
</screen>
</informalfigure>
    </listitem>
    <listitem><para><literal>numphases</literal> - nombre d'états placés dans l'image <literal>phases</literal>.
    </para></listitem>
    <listitem><para><literal>default</literal> - valeur par défaut du podomètre (dans
    un intervalle de <literal>0</literal> à <literal>100</literal>)
    </para></listitem>
    <listitem><para><literal>X</literal>,<literal>Y</literal> - position du hpotmeter
    </para></listitem>
    <listitem><para><literal>largeur</literal>,<literal>hauteur</literal> -
    largeur et hauteur du <literal>hpotmeter</literal>
    </para></listitem>
    <listitem><para><literal>message</literal> - le message généré lors des
    changements d'état de <literal>hpotmeter</literal>
    </para></listitem>
    </itemizedlist>

    </listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-potmeter"/>potmeter = phases, numphases, default, X, Y, largeur, hauteur, message
  </literal></term>
  <listitem><para>
Un <literal>hpotmeter</literal> sans bouton. (je suppose qu'il est censé tourner
en rond, mais il réagit uniquement aux tractions horizontales.) Pour une
description de ses paramètres lisez <link linkend="skin-hpotmeter">hpotmeter</link>.
Ses <literal>phases</literal> peuvent être fixées à <literal>NULL</literal>, mais ce n'est
pas vraiment utile, puisque vous ne pouvez pas voir son niveau.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-font"/>font = fontfile, fontid
  </literal></term>
  <listitem><para>
Définit une police. <literal>fontfile</literal> est le nom du descripteur de
police avec l'extension <filename>.fnt</filename> (inutile de préciser son
extension ici). <literal>fontid</literal> réfère à la police (c.f.
<link linkend="skin-dlabel">dlabel</link> et <link linkend="skin-slabel">slabel</link>).
Jusqu'à 25 polices peuvent être définies.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-slabel"/>slabel = X, Y, fontid, &quot;texte&quot;
  </literal></term>
  <listitem><para>
Place un label dynamique à la position <literal>X,Y</literal>. <literal>texte</literal>
est affiché en utilisant la police identifiée par <literal>fontid</literal>. Le
texte est juste une chaîne brute (les variables <literal>$x</literal> ne
fonctionnent pas) qui doit être mise entre doubles quotes (mais le caractère
&quot; ne peut pas faire partie du texte). Le label est affiché en utilisant la
police identifiée par <literal>fontid</literal>.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-dlabel"/>dlabel = X, Y, longueur, align, fontid, &quot;texte&quot;
  </literal></term>
  <listitem>
<para>
Place un label statique à la position <literal>X,Y</literal>. Le label est appelé
dynamique parce que son texte est rafraîchi périodiquement. La longueur maximum du
label est définie par <literal>longueur</literal> (sa hauteur dépend de la hauteur
des caractères). Si le texte a afficher dépasse cette longueur il sera scrollé, ou
bien aligné dans l'espace spécifié par la valeur du paramètre
<literal>align</literal>: <literal>0</literal> pour droite,
<literal>1</literal> pour centre, et <literal>2</literal> pour gauche.
</para>
<para>
Le texte à afficher est donné par <literal>texte</literal>: il doit être écrit
entre doubles quotes (mais le caractère &quot; ne peut pas faire partie du texte).
Le texte s'affiche en utilisant la police spécifiée par <literal>fontid</literal>.
Vous pouvez utiliser les variables suivantes dans le texte:
</para>

<informaltable>
<tgroup cols="2">
<thead>
  <row><entry>Variable</entry><entry>Signification</entry></row>
</thead>
<tbody>
<row>
<entry>$1</entry>
<entry>temps de lecture au format <emphasis>hh:mm:ss</emphasis></entry>
</row>
<row>
<entry>$2</entry>
<entry>temps de lecture au format <emphasis>mmmm:ss</emphasis></entry>
</row>
<row>
<entry>$3</entry>
<entry>temps de lecture au format <emphasis>hh</emphasis> (heures)</entry>
</row>
<row>
<entry>$4</entry>
<entry>temps de lecture au format <emphasis>mm</emphasis> (minutes)</entry>
</row>
<row>
<entry>$5</entry>
<entry>temps de lecture au format <emphasis>ss</emphasis> (secondes)</entry>
</row>
<row>
<entry>$6</entry>
<entry>longueur du film au format <emphasis>hh:mm:ss</emphasis></entry>
</row>
<row>
<entry>$7</entry>
<entry>longueur du film au format <emphasis>mmmm:ss</emphasis></entry>
</row>
<row>
<entry>$8</entry>
<entry>temps de lecture au format <emphasis>h:mm:ss</emphasis></entry>
</row>
<row>
<entry>$v</entry>
<entry>volume au format <emphasis>xxx.xx</emphasis>%</entry>
</row>
<row>
<entry>$V</entry>
<entry>volume au format <emphasis>xxx.x</emphasis></entry>
</row>
<row>
<entry>$U</entry>
<entry>volume au format <emphasis>xxx</emphasis></entry>
</row>
<row>
<entry>$b</entry>
<entry>balance au format <emphasis>xxx.xx</emphasis>%</entry>
</row>
<row>
<entry>$B</entry>
<entry>balance au format <emphasis>xxx.x</emphasis></entry>
</row>
<row>
<entry>$D</entry>
<entry>balance au format <emphasis>xxx</emphasis></entry>
</row>
<row>
<entry>$$</entry>
<entry>le caractère $</entry>
</row>
<row>
<entry>$a</entry>
<entry>un caractère dépendant du type audio (aucun: <literal>n</literal>,
mono: <literal>m</literal>, stéréo: <literal>t</literal>)</entry>
</row>
<row>
<entry>$t</entry>
<entry>numéro de piste (dans la playlist)</entry>
</row>
<row>
<entry>$o</entry>
<entry>nom du fichier</entry>
</row>
<row>
<entry>$f</entry>
<entry>nom du fichier en minuscule</entry>
</row>
<row>
<entry>$F</entry>
<entry>nom du fichier en majuscule</entry>
</row>
<row>
<entry>$T</entry>
<entry>un caractère dépendant du type de flux (fichier: <literal>f</literal>,
Video CD: <literal>v</literal>, DVD: <literal>d</literal>, URL: <literal>u</literal>)</entry>
</row>
<row>
<entry>$p</entry>
<entry>le caractère <keycap>p</keycap> (si une vidéo est en lecture et que la
police a le caractère <keycap>p</keycap>)</entry>
</row>
<row>
<entry>$s</entry>
<entry>le caractère <keycap>s</keycap> (si une vidéo est stoppée et que la police
a le caractère <keycap>s</keycap>)</entry>
</row>
<row>
<entry>$e</entry>
<entry>le caractère <keycap>e</keycap> (si une vidéo est en pause et que la police
a le caractère <keycap>e</keycap>)</entry>
</row>
<row>
<entry>$x</entry>
<entry>largeur du film</entry>
</row>
<row>
<entry>$y</entry>
<entry>hauteur du film</entry>
</row>
<row>
<entry>$C</entry>
<entry>nom du codec utilisé</entry>
</row>

</tbody>
</tgroup>
</informaltable>
</listitem>

</varlistentry>
</variablelist>

<note><para>
Les variables <literal>$a, $T, $p, $s</literal> et <literal>$e</literal>
<keycap>e</keycap> retournent toutes des caractères pouvant s'afficher comme des
symboles spéciaux (par exemple, <keycap>e</keycap> est le symbole de pause qui
ressemble généralement à ||). Vous pouvez avoir une police pour les caractères
normaux et une autre pour les symboles. Lisez la section sur les
<link linkend="skin-fonts-symbols">symboles</link> pour plus d'informations.
</para></note>
</sect2>

<sect2 id="skin-file-subwindow">
<title>Sous-fenêtre</title>
<para>
Vous trouverez ci-dessous la liste des objets utilisables dans le bloc
'<literal>window = sub</literal>' . . . '<literal>end</literal>'.
</para>

<variablelist>
<varlistentry>
  <term><literal>
  <anchor id="skin-sub-base"/>base = image, X, Y, largeur, hauteur
  </literal></term>
  <listitem><para>
L'image qui s'affichera dans la fenêtre. La fenêtre apparaîtra à la position
<literal>X,Y</literal> sur l'écran (<literal>0,0</literal> est le coin supérieur
gauche). Vous pouvez spécifier <literal>-1</literal> pour centre et <literal>-2</literal>
pour droite (<literal>X</literal>) et bas (<literal>Y</literal>). La fenêtre prendra
la taille de l'image. <literal>largeur</literal> et <literal>hauteur</literal>
donnent la taille de la fenêtre; ces paramètres sont optionnels (si ils sont
absents, le fenêtre prend la taille de l'image).
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-background"/>background = R, V, B
  </literal></term>
  <listitem><para>
Vous permet de définir la couleur de fond. Utile si l'image est plus petite que la
fenêtre. <literal>R</literal>, <literal>V</literal> et <literal>B</literal>
spécifient les composantes rouge, verte et bleue de la couleur (d'un intervalle
entre 0 et 255).
    </para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="skin-file-menu">
<title>Menu</title>
<para>
Comme mentionné précédemment, le menu s'affiche en utilisant deux images. Les
entrées normales du menu sont extraites de l'image spécifiée par l'objet
<literal>base</literal>, tandis que l'entrée actuellement sélectionnée est
extraite de l'image spécifiée par l'objet <literal>selected</literal>. Vous devez
définir la taille et la position de chaque entrée du menu par l'objet
<literal>menu</literal>.
</para>

<para>
Ils correspondent aux objets utilisés dans le bloc
'<literal>window = menu</literal>'. . .'<literal>end</literal>'.
</para>

<variablelist>
<varlistentry>
  <term><literal>
  <anchor id="skin-menu-base"/>base = image
  </literal></term>
  <listitem><para>
L'image utilisée pour les entrées normales.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-selected"/>selected = image
  </literal></term>
  <listitem><para>
L'image utilisée pour les entrées sélectionnées.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-menu"/>menu = X, Y, largeur, hauteur, message
  </literal></term>
  <listitem><para>
Définit la position <literal>X,Y</literal> et la taille des entrées du menu dans
les images. <literal>message</literal> est le message généré quand le bouton de la
souris est relâché.
    </para></listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

<sect1 id="skin-fonts">
<title>Polices</title>
<para>
Comme mentionné dans la section sur les parties de la skin, une police est définie
par une image et un fichier de description. Vous pouvez placer les caractères
n'importe ou sur l'image, mais vous devez vous assurer que leur position et taille
correspondent précisément au fichier de description.
</para>

<para>
Le fichier descriptif des polices (avec l'extension <filename>.fnt</filename>)
peut avoir des lignes de commentaires commençant par  '<literal>;</literal>'.
Le fichier doit avoir une ligne du type
<anchor id="skin-font-image"/>
<programlisting>image = <replaceable>image</replaceable></programlisting>
Où <literal><replaceable>image</replaceable></literal> est le nom de l'image qui
sera utilisée pour la police (vous n'avez pas à définir d'extension).
<anchor id="skin-font-char"/>
<programlisting>&quot;char&quot; = X, Y, largeur, hauteur</programlisting>
Ici <literal>X</literal> et <literal>Y</literal> précisent la position du caractère
<literal>char</literal> dans l'image (<literal>0,0</literal> est le coin supérieur
gauche). <literal>largeur</literal> et <literal>hauteur</literal> sont les
dimensions du caractère en pixels.
</para>

<para>
Voici un exemple définissant les caractères A, B, C utilisant <filename>font.png</filename>.
<programlisting>
; Peut être &quot;font&quot; au lieu de &quot;font.png&quot;.
image = font.png

; Trois caractères suffisent pour une démonstration. :-)
&quot;A&quot; =  0,0, 7,13
&quot;B&quot; =  7,0, 7,13
&quot;C&quot; = 14,0, 7,13
</programlisting>
</para>

<sect2 id="skin-fonts-symbols">
<title>Symboles</title>
<para>
Certains caractères ont une signification spéciale quand ils sont retournés par des
variables utilisées dans <link linkend="skin-dlabel">dlabel</link>. Ces caractères
sont censés s'afficher comme des symboles (par exemple, dans le cas d'une lecture
DVD, vous pouvez afficher un beau logo DVD a la place du caractère '<literal>d</literal>').
</para>
<para>
La table ci-dessous liste les caractères pouvant s'afficher comme des symboles (et
nécessitent donc une police différente).
</para>

<informaltable>
<tgroup cols="2">
<thead>
  <row><entry>Caractère</entry><entry>Symbole</entry></row>
</thead>
<tbody>
<row><entry><keycap>p</keycap></entry><entry>lecture</entry></row>
<row><entry><keycap>s</keycap></entry><entry>stop</entry></row>
<row><entry><keycap>e</keycap></entry><entry>pause</entry></row>
<row><entry><keycap>n</keycap></entry><entry>pas de son</entry></row>
<row><entry><keycap>m</keycap></entry><entry>son mono</entry></row>
<row><entry><keycap>t</keycap></entry><entry>son stéréo</entry></row>
<row><entry><keycap>f</keycap></entry><entry>lecture depuis un fichier</entry></row>
<row><entry><keycap>v</keycap></entry><entry>lecture depuis un Video CD</entry></row>
<row><entry><keycap>d</keycap></entry><entry>lecture depuis un DVD</entry></row>
<row><entry><keycap>u</keycap></entry><entry>lecture depuis une URL</entry></row>
</tbody>
</tgroup>
</informaltable>
</sect2>
</sect1>

<sect1 id="skin-gui">
<title>Messages de la GUI</title>
<para>
Ce sont les messages qui peuvent être générés par les boutons, podomètres et
entrées du menu.
</para>

<variablelist>
<varlistentry>
  <term><emphasis role="bold">evNone</emphasis></term>
  <listitem><para>
Message vide, sans effet. (à part peut-être dans les versions CVS :-)).
    </para></listitem>
</varlistentry>
</variablelist>

<variablelist>
<title>Contrôle de lecture:</title>
<varlistentry>
  <term><emphasis role="bold">evPlay</emphasis></term>
  <listitem><para>
Commence la lecture.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evStop</emphasis></term>
  <listitem><para>
Stoppe la lecture.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evPause</emphasis></term>
  <listitem><para>
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evPrev</emphasis></term>
  <listitem><para>
Saute à la piste précédente dans la playlist.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evNext</emphasis></term>
  <listitem><para>
Saute à la prochaine piste dans la playlist.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evLoad</emphasis></term>
  <listitem><para>
Charge un fichier (en ouvrant un mini navigateur de fichiers, où vous pouvez
choisir un fichier).
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evLoadPlay</emphasis></term>
  <listitem><para>
Fait la même chose que <literal>evLoad</literal>, mais démarre la lecture
automatiquement après le chargement du fichier.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evLoadAudioFile</emphasis></term>
  <listitem><para>
Charge un fichier audio (avec un sélecteur de fichier)
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evLoadSubtitle</emphasis></term>
  <listitem><para>
Charge un fichier de sous-titres (avec un sélecteur de fichier)
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evDropSubtitle</emphasis></term>
  <listitem><para>
Désactive le sous-titre actuellement utilisé.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evPlaylist</emphasis></term>
  <listitem><para>
Ouvre/ferme la playlist.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evPlayVCD</emphasis></term>
  <listitem><para>
Essaie d'ouvrir le disque dans le lecteur CD-ROM indiqué.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evPlayDVD</emphasis></term>
  <listitem><para>
Essaie d'ouvrir le disque dans le lecteur DVD-ROM indiqué.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evLoadURL</emphasis></term>
  <listitem><para>
Ouvre la fenêtre de saisie d'URL.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evPlaySwitchToPause</emphasis></term>
  <listitem><para>
Le contraire de <literal>evPauseSwitchToPlay</literal>. Ce message démarre la
lecture et l'image associée au bouton <literal>evPauseSwitchToPlay</literal>
s'affiche (pour indiquer que le bouton peut être pressé pour mettre en pause la lecture).
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evPauseSwitchToPlay</emphasis></term>
  <listitem><para>
Associé à la commande <literal>evPlaySwitchToPause</literal>. Ils s'utilisent pour
avoir un bouton play/pause commun. Les deux messages peuvent être assignés aux
boutons affichés exactement à la même position dans la fenêtre. Ces messages mettent
la lecture en pause et le bouton <literal>evPlaySwitchToPause</literal> s'affiche
(pour indiquer que le bouton peut être pressé pour continuer la lecture).
    </para></listitem>
</varlistentry>
</variablelist>

<variablelist>
<title>Déplacement dans le flux:</title>
<varlistentry>
  <term><emphasis role="bold">evBackward10sec</emphasis></term>
  <listitem><para>
Recule de 10 secondes.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evBackward1min</emphasis></term>
  <listitem><para>
Recule de 1 minute.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evBackward10min</emphasis></term>
  <listitem><para>
Recule de 10 minutes.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evForward10sec</emphasis></term>
  <listitem><para>
Avance de 10 secondes.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evForward1min</emphasis></term>
  <listitem><para>
Avance de 1 minute.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evForward10min</emphasis></term>
  <listitem><para>
Avance de 10 minutes.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evSetMoviePosition</emphasis></term>
  <listitem><para>
Se place à la position (utilisable avec un podomètre; utilise la valeur relative
(0-100%) du podomètre).
    </para></listitem>
</varlistentry>
</variablelist>

<variablelist>
<title>Contrôle vidéo:</title>
<varlistentry>
  <term><emphasis role="bold">evHalfSize</emphasis></term>
  <listitem><para>
Réduit de moitié la taille de la fenêtre vidéo.
  </para></listitem>
</varlistentry>
<varlistentry>
  <term><emphasis role="bold">evDoubleSize</emphasis></term>
  <listitem><para>
Double la taille de la fenêtre vidéo.
    </para></listitem>
</varlistentry>
<varlistentry>
  <term><emphasis role="bold">evFullScreen</emphasis></term>
  <listitem><para>
Passe en mode plein écran.
    </para></listitem>
</varlistentry>
<varlistentry>
  <term><emphasis role="bold">evNormalSize</emphasis></term>
  <listitem><para>
Met la vidéo à sa taille réelle.
    </para></listitem>
</varlistentry>
<varlistentry>
  <term><emphasis role="bold">evSetAspect</emphasis></term>
  <listitem><para>
    </para></listitem>
</varlistentry>
</variablelist>

<variablelist>
<title>Contrôle audio:</title>
<varlistentry>
  <term><emphasis role="bold">evDecVolume</emphasis></term>
  <listitem><para>
Diminue le volume.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evIncVolume</emphasis></term>
  <listitem><para>
Augmente le volume.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evSetVolume</emphasis></term>
  <listitem><para>
Fixe le volume (utilisable avec un podomètre; utilise la valeur relative (0-100%)
du podomètre).
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evMute</emphasis></term>
  <listitem><para>
Active/désactive le son.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evSetBalance</emphasis></term>
  <listitem><para>
Fixe la balance (utilisable avec un podomètre; utilise la valeur relative (0-100%)
du podomètre).
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evEqualizer</emphasis></term>
  <listitem><para>
Active/désactive l'équalizer.
    </para></listitem>
</varlistentry>
</variablelist>

<variablelist>
<title>Divers:</title>
<varlistentry>
  <term><emphasis role="bold">evAbout</emphasis></term>
  <listitem><para>
Ouvre la fenêtre 'A Propos'.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evPreferences</emphasis></term>
  <listitem><para>
Ouvre la fenêtre de préférences.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evSkinBrowser</emphasis></term>
  <listitem><para>
Ouvre le navigateur de skins.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evIconify</emphasis></term>
  <listitem><para>
Iconifie la fenêtre.
    </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evExit</emphasis></term>
  <listitem><para>
Quitte le programme.
    </para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="skin-quality">
<title>Créer des skins de qualité</title>

<para>
Vous avez lu toute la doc expliquant comment faire un skin pour la GUI de
<application>MPlayer</application>, fait de votre mieux avec
<application>Gimp</application> et souhaitez nous soumettre votre skin?
Lisez les guidelines pour éviter les erreurs communes et produire
un skin de haute qualité.
</para>

<para>
Nous voulons des skins que nous puissions ajouter à notre repository pour se
conformer à certain standards de qualité. Il y a aussi un nombre de choses que
vous pouvez faire pour rendre notre vie plus simple.
</para>

<para>
En tant qu'exemple, vous pouvez jeter un oeil à la skin <systemitem>Blue</systemitem>,
elle satisfait tous les critères listé ci-dessous depuis la version 1.5.
</para>

<itemizedlist>
<listitem><para>Chaque skin devra joindre un fichier
<filename>README</filename> qui contiendra les informations sur
vous, l'auteur, le copyright et les notices de licence et n'importe quoi d'autre
que vous souhaitiez ajouter. Si vous désirez avoir un changelog, ce fichier est
le bon endroit.</para></listitem>

<listitem><para>Il devrez y avoir un fichier <filename>VERSION</filename>
avec rien de plus que le numéro de version de la skin sur une simple
ligne (e.g. 1.0).</para></listitem>

<listitem><para>Les contrôles horizontaux et verticaux (sliders comme le volume
ou la position) devront avoir le centre du bouton proprement centré sur
le milieu du slider. Il devra être possible de bouger le bouton aux deux
extrémités du slider, mais pas de le dépasser.</para></listitem>

<listitem><para>Les éléments de la skin devront avoir les bonnes tailles déclarées
dans le fichier de la skin. Si cela n'est pas le cas vous pouvez cliquer en
dehors e.g. un bouton et encore le déclencher ou cliquer à l'intérieur de sa
zone et ne pas le déclencher.</para></listitem>

<listitem><para>le fichier <filename>skin</filename> devra être prettyprinted
et ne pas contenir d'onglets. Prettyprinted signifie que les chiffres devront
s'aligner de façon ordonnée dans les colonnes</para></listitem>
</itemizedlist>

</sect1>
</appendix>