Merci à Zoltán Ponekker pour son aide.
András Mohari <mayday@freemail.hu>
/usr/local/share/mplayer/Skin/
~/.mplayer/Skin/
Notez que le premier répertoire peut varier suivant la façon dont MPlayer a été configuré
(c.f. l'argument --datadir du script configure).
Chaque skin est installée dans son propre répertoire sous l'un des répertoires listés ci-dessus, par exemple:
/usr/local/share/mplayer/Skin/default/
Dans la fenêtre principale (c.f. ci-dessous) vous pouvez utiliser des images dotées de régions "transparentes" : les régions remplies avec la couleur #FF00FF (magenta) deviennent transparentes dans MPlayer. De même, vous pouvez obtenir des formes particulières pour vos fenêtres si votre serveur X possède l'extension XShape.
Actuellement, trois fenêtres doivent être décorées : la fenêtre principale, la sous-fenêtre et le menu (activable par un clic droit).
Un bouton comprend trois états (pressé, relaché, désactivé), donc l'image doit se diviser en trois parties, verticalement. c.f. l'objet bouton pour plus de détails.
Un podomètre (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. C.f. hpotmeter et potmeter pour plus de détails.
Les labels sont un peut particuliers : les caractères nécessaires pour les dessiner sont récupérés depuis un fichier image, décrit par un fichier de description de polices. Ce dernier est un fichier texte brut spécifiant la position x,y ainsi que la taille de chaque caractère dans l'image. (donc le fichier image et son descripteur forment une police ensemble.) C.f. dlabel et slabel pour plus de détails.
Note: toutes les images diposent de la couleur de transparence décrite dans la section formats d'images.
Une entrée de menu se définit par sa position et sa taille dans l'image (c.f. la section menu pour plus de détails).
Une chose essentielle n'a pas encore été mentionnée : pour que les boutons podomètres et entrées du menu fonctionnent, MPlayer doit savoir quoi en faire. Ceci dépend des messages (events) envoyés. Pour chaque objet vous devez définir une action a réaliser.
skin
Il est lu ligne par ligne; les lignes de commentaire démarrent par le caractère ';' en début de ligne (seuls les espace et tabulations sont autorisées avant ce signe).
Les fichiers se composent de sections. Chaque section décrit la skin pour une application et s'écrit sous la forme :
section = section name . . . end |
Actuellement il n'existe qu'une application, donc vous n'aurez besoin que d'une section: dont le nom est movieplayer.
Dans cette section chaque fenêtre est décrite par un bloc de la forme suivante :
window = window name . . . end |
(Les bloace sub et menu sont optionnels --- vous n'avez pas d'obligation de décorer le menu et la sous-fenêtre.)
Dans un bloc window, vous pouvez définir chaque objet sous la forme :
item = parameter
ou item est une ligne identifiant le type d'objet de la GUI, parameter est une valeur numérique ou textuelle (ou une liste de valeurs séparées par des virgules).
Le fichier final doit donc ressembler à ceci :
section = movieplayer window = main ; ... items for main window ... end window = sub ; ... items for subwindow ... end window = menu ; ... items for skin menu ... end end |
Quelques précisions sur l'appel des images dans la configuration.
Le nom d'un fichier image doit être donné sans distinction de répertoire ---
les images seront cherchées dans le même répertoire que le fichier de configuration. Vous pouvez (mais ce n'est pas obligatoire)
spécifier l'extension du fichier. Si le fichier n'existe pas, MPlayer essaie de charger le fichier <filename>.<ext>, ou <ext> sera respectivement tga,TGA, bmp, BMP, png et PNG dans cet ordre. La première correspondance trouvée sera utilisée.
Un exemple. Supposons que vous avez crée une image
main.png que vous voulez utiliser pour la fenêtre principale:
MPlayer essaie de charger main, main.tga, main.TGA,
main.bmp etc, donc main.png sera trouvé.
Si (par accident) vous écrivez
alors main.bmp, main.bmp.tga, main.bmp.TGA,
main.bmp.bmp seront recherchés et MPlayer et MPlayer abandonnera
parce qu'il ne trouvera pas de main.bmp dans le répertoire, mais main.png.
|
window = main' . . . 'end'.
Attention : les régions transparentes (couleur #FF00FF) apparaitront en noir sur les serveurs X n'ayant pas l'extension XShape.
+--------+ | pressé | +--------+ | relaché | +--------+ | désactivé | +--------+ |
+--------+
| état #1 |
+--------+
| état #2 |
+--------+
...
+--------+
| état #n |
+--------+
|
NULL, mais ce n'est pas vraiment utile, puisque vous ne pouvez pas voir son niveau.
.fnt (inutile de préciser son extension ici).
fontid réfère à la police
(c.f. dlabel et slabel).
Plus de 25 polices peuvent être définies.
") (mais le caractère "ne peut pas faire partie du texte).
Le texte s'affiche en utilisant la police spécifiée par fontid.
Vous pouvez utiliser les variables suivantes dans le texte :
| Variable | Signification |
|---|---|
| $1 | temps de lecture en hh:mm:ss |
| $2 | temps de lecture en mmmm:ss |
| $3 | temps de lecture en hh(heures) |
| $4 | temps de lecture en mm(minutes) |
| $5 | temps de lecture en ss(secondes) |
| $6 | longeur du film en hh:mm:ss |
| $7 | longeur du film en mmmm:ss |
| $8 | temps de lecture en h:mm:ss |
| $v | volume en xxx.xx% |
| $V | volume en xxx.x |
| $b | balance en xxx.xx% |
| $B | balance en xxx.x |
| $$ | le caractère $ |
| $a | un caractère dépendant du type audio (aucun: n,
mono: m, stereo: t) |
| $t | numéro de piste (dans la playlist) |
| $o | nom du fichier |
| $f | nom du fichier en minuscule |
| $F | nom du fichier en majuscule |
| $T | un caractère dépendant du type de flux (fichier: f,
video CD: v, DVD: d, URL: u)
|
| $p | le caractère "p" (si une vidéo est en lecture et que la police a le caractère "p") |
| $s | le caractère "s" (si une vidéo est stoppée et que la police a le caractère "s") |
| $e | le caractère "e" (si une vidéo est en pause et que la police a le caractère "e") |
Note: les variables $a, $T, $p, $s
et $eretournent toutres des caractères pouvant s'afficher comme des symboles spéciaux (par exemple, "e" est le symbole de pause qui ressemble généralement à ||). Vous pouvez avoir une police pour les saractères normaux et une autre pour les symboles.
Lisez la section sur les symboles pour plus d'informations.
" ne doit pas faire partie du texte).
window = sub' . . . 'end'.
Ils correspondent aux objets utilisés dans le bloc 'window = menu'
. . . 'end'.
Les fichier descriptif des polices (avec l'extension .fnt) peut avoir des lignes de commentaires commençant par ';'.
Le fichier doit avoir une ligne du type
image = image
où image est le nom de l'image qui sera utilisée pour la police (vous n'avez pas à définir d'extension). Cette ligne est suivie par une définition de caractère du type :
"char" = x, y, w, h
Ici x et y précisent la position du caractère char dans l'image (0,0 est le coin supérieur gauche). w et h sont la largeur et la hauteur du caractère (en pixels, bien sûr).
Voici un exemple définissant les caractères A, B, C utilisant la police font.png.
; peut être "font" au lieu de "font.png" image = font.png ; Trois caractères suffisent, mais seulement pour une démonstration. :-) "A" = 0,0, 7,13 "B" = 7,0, 7,13 "C" = 14,0, 7,13 |
La table ci-dessous liste les caractères pouvant s'afficher comme des symboles (et nécessitent donc une police différente).
| Character | Symbole |
|---|---|
| p | lecture |
| s | stop |
| e | pause |
| n | pas de son |
| m | son mono |
| t | son stereo |
| f | lecture depuis un fichier |
| v | lecture depuis un video CD |
| d | lecture depuis un DVD |
| u | lecture depuis une URL |
Note: actuellement uniquement 'p', 's', 'e', 'n', 'm' et 't' sont utilisables.
Note: certains messages peuvent ne pas fonctionner comme prévu (ou ne pas fonctionner du tout). Comme vous le savez, la GUI est en cours de développement.
Contrôle de lecture :
- evNext
- Saute à la prochaine piste dans la playlist.
- evPause
- Pause.
- evPauseSwitchToPlay
- Associé à la commande evPlaySwitchToPause. Ils s'utilisent pour avoir un bouton play/pause commun. Les deux messages peuvent être assignés aux boutons affiches exactement à la même position dans la fenêtre. Ces message mettent la lecture en pause et le bouton evPlaySwitchToPause s'affiche (pour indiquer que le bouton peut être pressé pour continuer la lecture).
- evPlay
- Commence la lecture.
- evPlaySwitchToPause
- Le contraire de evPauseSwitchToPlay. Ce message démarre la lecture et l'image associée au bouton evPauseSwitchToPlay s'affiche (pour indiquer que le bouton peut être pressé pour mettre en pause la lecture).
- evPrev
- Saute à la piste précedente dans la playlist.
- evStop
- Stoppe la lecture.
Avancée dans le flux:
- evBackward10sec
- evBackward1min
- evBackward10min
- Recule de 10 secondes / 1 minute / 10 minutes.
- evForward10sec
- evForward1min
- evForward10min
- Avance de 10 secondes / 1 minute / 10 minutes.
- evSetMoviePosition
- Se place à la position (utilisable avec un podomètre; utilise la valeur relative (0-100%) du podomètre).
Contrôle vidéo :
- evDoubleSize
- Double la taille de la fenêtre vidéo.
- evFullScreen
- Passe en mode plein écran.
- evNormalSize
- Met la vidéo à sa taille réelle.
Contôle audio :
- evDecAudioBufDelay
- Diminue le délai du buffer audio.
- evDecBalance
- Diminue la balance.
- evDecVolume
- Diminue le volume.
- evIncAudioBufDelay
- Augmente le délai du buffer audio.
- evIncBalance
- Augmente la balance.
- evIncVolume
- Augmente le volume.
- evMute
- Active/désactive le son.
- evSetBalance
- Fixe la balance (utilisable avec un podomètre; utilise la valeur relative (0-100%) du podomètre).
- evSetVolume
- Fixe le volume (utilisable avec un podomètre; utilise la valeur relative (0-100%) du podomètre).
Divers :
- evAbout
- Ouvre la fenêtre 'A Propos'.
- evEqualeaser
- Active/désactive l'equalizer.
- evExit
- Quite le programme.
- evIconify
- Iconifie la fenêtre.
- evLoad
- Charge un fichier (en ouvrant un mini navigateur de fichiers, où vous pouvez choisir un fichier).
- evLoadPlay
- Fait la même chose que evLoad,mais démarre la lecture automatiquement après le chargement du fichier.
- evNone
- Message vide, sans effet. (A part peut-re dans les versions CVS :-))
- evPlayList
- Ouvre/ferme la playlist.
- evPreferences
- Ouvre la fenêtre de preferences.
- evSkinBrowser
- Ouvre le navigateur de revêtements.