2002-12-06 01:45:39 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2001-10-18 11:48:46 +00:00
< html >
< head >
2002-12-06 01:45:39 +00:00
< meta http-equiv = Content-Type content = "text/html; charset=iso-8859-1" >
< title > Format de skins - MPlayer - Le lecteur vid<69> o pour Linux< / title >
< link rel = "stylesheet" type = "text/css" href = "default.css" >
< style type = "text/css" >
em.note {color: green;
font-style: normal;}
em.warn {color: red;
font-style: normal;}
2001-10-18 11:48:46 +00:00
< / style >
< / head >
2002-12-06 01:45:39 +00:00
< body >
< h1 align = "center" > Format de skins MPlayer< / h1 >
2001-10-18 11:48:46 +00:00
< hr >
< h2 > Sommaire< / h2 >
< ul type = disc >
2002-12-06 01:45:39 +00:00
< li > < a href = "#intro" > 1 Introduction< / a > < / li >
< li > < a href = "#overview" > 2 Aperç u< / a > < / li >
2001-10-18 11:48:46 +00:00
< ul type = circle >
2002-12-06 01:45:39 +00:00
< li > < a href = "#dirs" > 2.1 Ré pertoires< / a > < / li >
< li > < a href = "#images" > 2.2 Images< / a > < / li >
< li > < a href = "#components" > 2.3 Composants d'une skin< / a > < / li >
< li > < a href = "#files" > 2.4 Fichiers< / a > < / li >
2001-10-18 11:48:46 +00:00
< / ul >
2002-12-06 01:45:39 +00:00
< / li >
< li > < a href = "#skin" > 3 Le fichier < code > skin< / code > < / a > < / li >
2001-10-18 11:48:46 +00:00
< ul type = circle >
2002-12-06 01:45:39 +00:00
< li > < a href = "#mainwin" > 3.1 Fenê tre principale< / a > < / li >
< li > < a href = "#subwindow" > 3.2 Sous fenê tres< / a > < / li >
< li > < a href = "#skinmenu" > 3.3 Menu< / a > < / li >
2001-10-18 11:48:46 +00:00
< / ul >
2002-12-06 01:45:39 +00:00
< / li >
< li > < a href = "#fonts" > 4 Polices< / a > < / li >
2001-10-18 11:48:46 +00:00
< ul type = circle >
2002-12-06 01:45:39 +00:00
< li > < a href = "#symbols" > 4.1 Symboles< / a > < / li >
2001-10-18 11:48:46 +00:00
< / ul >
2002-12-06 01:45:39 +00:00
< / li >
< li > < a href = "#guimsg" > Appendice A: messages de la GUI< / a > < / li >
2001-10-18 11:48:46 +00:00
< / ul >
< hr >
< div align = center >
2002-12-06 01:45:39 +00:00
Derniè re modification: 24/05/2002
2001-10-18 11:48:46 +00:00
< / div >
< hr >
2002-12-06 01:45:39 +00:00
< h2 > < a name = "intro" > 1 Introduction< / a > < / h2 >
2001-10-18 11:48:46 +00:00
L'objectif de ce document est de dé crire le format de skins de MPlayer.
2002-12-06 01:45:39 +00:00
Les informations pré senté es ici peuvent s'avé rer fausses, du fait que
< ol type = "a" >
< li > ce n'est pas moi qui ait é crit la GUI< / li >
< li > cette GUI n'est pas terminé e,< / li >
< li > je peux me tromper.
< / ol >
Ne soyez donc pas surpris si quelque chose ne correspond pas à cette description.
2001-10-18 11:48:46 +00:00
< p >
Merci à < em > Zoltá n Ponekker< / em > pour son aide.
2002-12-06 01:45:39 +00:00
< / p >
2001-10-18 11:48:46 +00:00
< p >
< em > Andrá s Mohari < mayday@freemail.hu> < / em >
2002-12-06 01:45:39 +00:00
< / P >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
< h2 > < a name = "overview" > 2 Aperç u< / a > < / h2 >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
Ce n'est pas en rapport direct avec le format des skins, mais vous devez savoir que
MPlayer n'a < b > pas< / b > de skin par dé faut, donc < b > une skin au moins doit
ê tre installé e pour pouvoir utiliser la GUI.< / b >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
< h3 > < a name = "dirs" > 2.1 Ré pertoires< / a > < / h3 >
2001-10-18 11:48:46 +00:00
MPlayer cherche des skins dans ces ré pertoires (dans cet ordre):
< pre >
2002-12-06 01:45:39 +00:00
$(DATADIR)/Skin/
2001-10-18 11:48:46 +00:00
/usr/local/share/mplayer/Skin/
~/.mplayer/Skin/
< / pre >
< p >
2002-12-06 01:45:39 +00:00
Notez que le premier ré pertoire peut varier suivant la faç on dont MPlayer
a é té configuré (c.f. les arguments < code > --prefix< / code > et
< code > --datadir< / code > du script < code > configure< / code > ).
< / p >
2001-10-18 11:48:46 +00:00
Chaque skin est installé e dans son propre ré pertoire sous l'un des ré pertoires listé s ci-dessus, par exemple:
< pre >
2002-12-06 01:45:39 +00:00
$(PREFIX)/share/mplayer/Skin/default/
2001-10-18 11:48:46 +00:00
< / pre >
2002-12-06 01:45:39 +00:00
< h3 > < a name = "images" > 2.2 Format d'images< / a > < / h3 >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
Les images doivent ê tre en truecolor (24 ou 32 bpp) et enregistré es
au format PNG.
2001-10-18 11:48:46 +00:00
< p >
2002-12-06 01:45:39 +00:00
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 (< font color = "#FF00FF" > magenta< / font > ) 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.
< / p >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
< h3 > < a name = "components" > 2.3 Composants d'une skin< / a > < / h3 >
2001-10-18 11:48:46 +00:00
Les skins sont d'un format plutô t libre (contrairement aux formats fixes de
2002-12-06 01:45:39 +00:00
Winamp/XMMS, par exemple), donc il ne tient qu'a vous de cré er quelque chose
de bien.
2001-10-18 11:48:46 +00:00
< p >
Actuellement, trois fenê tres doivent ê tre dé coré es : la
2002-12-06 01:45:39 +00:00
< a href = "#mainwin" > fenê tre principale< / a > , la
< a href = "#subwindow" > sous-fenê tre< / a > et le < a href = "#skinmenu" > menu< / a >
(activable par un clic droit).
< / p >
2001-10-18 11:48:46 +00:00
< ul >
< li >
2002-12-06 01:45:39 +00:00
Vous controlez MPlayer par la < b > fenê tre principale< / b > . L'arriè re plan
est une image. Divers objets doivent venir se placer dans cette fenê tre :
< em > boutons< / em > , < em > podomè tres< / em > (ou des sliders si vous pré ferez)
et des < em > labels< / em > . Pour chaque objet, vous devez spé cifier sa taille et
sa position.
2001-10-18 11:48:46 +00:00
< p >
Un < b > bouton< / b > comprend trois é tats (pressé , relaché ,
dé sactivé ), donc l'image doit se diviser en trois parties, verticalement.
2002-12-06 01:45:39 +00:00
c.f. l'objet < a href = "#main.button" > bouton< / a > pour plus de dé tails.
< / p >
2001-10-18 11:48:46 +00:00
< p >
2002-12-06 01:45:39 +00:00
Un < b > podomè tre< / b > (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. < a href = "#main.hpotmeter" > hpotmeter< / a > et
< a href = "#main.potmeter" > potmeter< / a > pour plus de dé tails.
< / p >
2001-10-18 11:48:46 +00:00
< p >
2002-12-06 01:45:39 +00:00
Les < b > labels< / b > 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 < a href = "#fonts" > fichier de description de polices< / a > .
2001-10-18 11:48:46 +00:00
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 < em > ensemble< / em > .)
2002-12-06 01:45:39 +00:00
C.f. < a href = "#main.dlabel" > dlabel< / a > et < a href = "#main.slabel" > slabel< / a >
2001-10-18 11:48:46 +00:00
pour plus de dé tails.
2002-12-06 01:45:39 +00:00
< / p >
2001-10-18 11:48:46 +00:00
< p >
< em class = note >
< b > Note:< / b > toutes les images diposent de la couleur de transparence dé crite dans
2002-12-06 01:45:39 +00:00
la section < a href = "#images" > formats d'images< / a > . Si le serveur X ne supporte pas
l'extension Xshape, les parties transparantes seront noires. Si vous voulez utiliser
cette fonction, la largeur de l'image de la fen<65> tre principale devra <20> tre divisible par 8.
2001-10-18 11:48:46 +00:00
< / em >
2002-12-06 01:45:39 +00:00
< / p >
2001-10-18 11:48:46 +00:00
< / li >
< li >
2002-12-06 01:45:39 +00:00
La < b > sous-fenê tre< / b > contient la vidé o en elle mê me. Elle peut
affichier une image si aucun film n'est chargé (ce n'est jamais plaisant
d'avoir une fenê tre vide :-))
< em class = note > < b > Note:< / b > la couleur de transparence n'est < b > pas
autorisé e< / b > ici< / em >
2001-10-18 11:48:46 +00:00
< / li >
< li >
2002-12-06 01:45:39 +00:00
Le < b > menu< / b > est simplement un moyen de controler MPlayer 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<EFBFBD> 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 (Donc la seconde image ne s'affiche jamais complè tement.)
< p >
Une entré e de menu se dé finit par sa position et sa taille dans l'image
(c.f. la section
< a href = "#skinmenu" > menu< / a > pour plus de dé tails).
< / p >
2001-10-18 11:48:46 +00:00
< / li >
< / ul >
< p >
2002-12-06 01:45:39 +00:00
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 < a href = "#guimsg" > messages< / a > (events)
envoyé s. Pour chaque objet vous devez dé finir une action a ré aliser.
< / p >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
< h3 > < a name = "files" > 2.4 Fichiers< / a > < / h3 >
2001-10-18 11:48:46 +00:00
Vous aurez besoin des fichiers suivants pour construire une skin.
< ul >
< li >
2002-12-06 01:45:39 +00:00
Le fichier de configuration nommé < a href = "#skin" > skin< / a > indique à MPlayer
comment assembler les diffé rentes images et comment interpré ter les clics de
souris sur l'interface.
2001-10-18 11:48:46 +00:00
< / li >
< li > L'image de fond de la fenê tre principale.< / li >
2002-12-06 01:45:39 +00:00
< li > Les images correspondant aux objets de la fenê tre principale (y compris une
ou plusieurs polices et descripteurs né cessaires à l'affichage des
textes).< / li >
2001-10-18 11:48:46 +00:00
< li > L'image affiché e dans la sous-fenê tre (optionnel).< / li >
2002-12-06 01:45:39 +00:00
< li > Deux images pour le menu (né cessaires uniquement si vous voulez cré er
un menu).< / li >
2001-10-18 11:48:46 +00:00
< / ul >
2002-12-06 01:45:39 +00:00
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
< code > .fnt< / code > ).
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
< h2 > < a name = "skin" > 3 Le fichier < code > < b > skin< / b > < / code > < / a > < / h2 >
2001-10-18 11:48:46 +00:00
< p >
2002-12-06 01:45:39 +00:00
Comme mentionn<6E> plus haut, c'est le fichier de configuration de la skin.
Il est lu ligne par ligne; les lignes de commentaire dé marrent par le
caractè re '< code > ;< / code > ' en dé but de ligne (seuls les espaces et
tabulations sont autorisé es avant ce signe).
< / p >
2001-10-18 11:48:46 +00:00
< p >
2002-12-06 01:45:39 +00:00
Les fichiers se composent de sections. Chaque section dé crit la skin pour une
application et s'é crit sous la forme :
< / p >
< table border = 1 width = "100%" > < tr bgcolor = silver > < td > < pre >
2001-10-18 11:48:46 +00:00
section = < i > section name< / i >
.
.
.
end
< / pre > < / td > < / tr > < / table >
< p >
Actuellement il n'existe qu'une application, donc vous n'aurez besoin que d'une section:
dont le nom est < b > movieplayer< / b > .
2002-12-06 01:45:39 +00:00
< / p >
2001-10-18 11:48:46 +00:00
< p >
2002-12-06 01:45:39 +00:00
Dans cette section chaque fenê tre est dé crite par un bloc de la forme
suivante:
< / p >
< table border = 1 width = "100%" > < tr bgcolor = silver > < td > < pre >
2001-10-18 11:48:46 +00:00
window = < i > window name< / i >
.
.
.
end
< / pre > < / tr > < / td > < / table >
2002-12-06 01:45:39 +00:00
< p >
o<EFBFBD> < i > window name< / i > peut-ê tre l'un des types suivants :
< / p >
2001-10-18 11:48:46 +00:00
< ul >
< li > < b > main< / b > - pour la fenê tre principale< / li >
< li > < b > sub< / b > - pour la sous-fenê tre< / li >
< li > < b > menu< / b > - pour le menu< / li >
< / ul >
< p >
2002-12-06 01:45:39 +00:00
(Les blocs sub et menu sont optionnels --- vous n'avez pas d'obligation de
dé corer le menu et la sous-fenê tre.)
< / p >
2001-10-18 11:48:46 +00:00
< p >
Dans un bloc window, vous pouvez dé finir chaque objet sous la forme :
< / p >
2002-12-06 01:45:39 +00:00
< dl >
< dt >
< b > < code > item = parameter< / code > < / b >
< / dt >
< dd >
ou < code > item< / code > est une ligne identifiant le type d'objet de la GUI,
< code > parameter< / code > est une valeur numé rique ou textuelle (ou une liste
de valeurs sé paré es par des virgules).
< / dd >
< / dl >
2001-10-18 11:48:46 +00:00
< p >
Le fichier final doit donc ressembler à ceci :
2002-12-06 01:45:39 +00:00
< / p >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
< table border = 1 width = "100%" > < tr bgcolor = silver > < td > < pre >
2001-10-18 11:48:46 +00:00
section = movieplayer
window = main
; ... items for main window ...
end
2002-12-06 01:45:39 +00:00
2001-10-18 11:48:46 +00:00
window = sub
; ... items for subwindow ...
end
2002-12-06 01:45:39 +00:00
2001-10-18 11:48:46 +00:00
window = menu
; ... items for skin menu ...
end
end
< / pre > < / tr > < / td > < / table >
< p >
2002-12-06 01:45:39 +00:00
Le nom d'un fichier image doit ê tre donné sans distinction de
ré pertoire - les images seront cherché es dans le
ré pertoire < code > Skin< / code > . 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 < code > < filename> .< ext> < / code > ,
ou < code > < ext> < / code > sera respectivement < code > png< / code > et < i > PNG< / code >
dans cet ordre. La premiè re correspondance trouvé e sera utilisé e.
< / p >
2001-10-18 11:48:46 +00:00
< p >
2002-12-06 01:45:39 +00:00
Pour finir quelques mots sur le positionnement. La fen<65> tre principale et la sous-fen<65> tre
peuvent <20> tre plac<61> es dans des coins diff<66> rents de l'<27> cran en donnant les coordonn<6E> es
< code > X< / code > et < code > Y< / code > . < code > 0< / code > pour haut ou gauche, < code > -1< / code >
pour centre et < code > -2< / code > pour droite ou bas, comme montr<74> sur cette illustration:
< / p >
< pre >
(0, 0)----(-1, 0)----(-2, 0)
| | |
| | |
(0,-1)----(-1,-1)----(-2,-1)
| | |
| | |
(0,-2)----(-1,-2)----(-2,-2)
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
< / pre >
< table border = 1 cellpadding = 5 width = "100%" > < tr bgcolor = "#ffffcc" > < td >
2001-10-18 11:48:46 +00:00
Un exemple. Supposons que vous avez cré e une image
< i > main.png< / i > que vous voulez utiliser pour la fenê tre principale:
< blockquote >
< pre >
base = main, -1, -1
< / pre >
< / blockquote >
2002-12-06 01:45:39 +00:00
MPlayer essaie de charger les fichiers < code > main< / code > , < code > main.png< / code > , < code > main.PNG< / code > .
2001-10-18 11:48:46 +00:00
< br >
< / td > < / tr > < / table >
2002-12-06 01:45:39 +00:00
< h3 > < a name = "mainwin" > 3.1 Fenê tre principale< / a > < / h3 >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
Vous trouverez ci-dessous la liste des objets utilisables dans le bloc
2001-10-18 11:48:46 +00:00
'< code > window = main< / code > ' . . . '< code > end< / code > '.
< dl >
2002-12-06 01:45:39 +00:00
< dt > < a name = "main.base" >
< b > base = < code > image, X, Y< / code > < / b >
2001-10-18 11:48:46 +00:00
< / a > < / dt >
< dd >
Vous spé cifiez ici l'image de fond utilisé e dans la fenê tre principale.
2002-12-06 01:45:39 +00:00
La fenê tre apparaitra a la position < code > X,Y< / code > sur l'<27> cran. La fen<65> tre a la
taille de l'image.
< div >
2001-10-18 11:48:46 +00:00
< em class = warn >
2002-12-06 01:45:39 +00:00
< b > Attention :< / b > les ré gions transparentes (couleur #FF00FF) apparaitront en noir
sur les serveurs X n'ayant pas l'extension XShape. La largeur de l'image doit <20> tre
divisible par 8.
2001-10-18 11:48:46 +00:00
< / em >
2002-12-06 01:45:39 +00:00
< / div >
2001-10-18 11:48:46 +00:00
< / dd >
2002-12-06 01:45:39 +00:00
< dt > < a name = "main.button" >
< b > button = < code > button = image, X, Y, width, height, message< / code > < / b > < / a > < / dt >
2001-10-18 11:48:46 +00:00
< dd >
2002-12-06 01:45:39 +00:00
Place un bouton de taille < code > width< / code > * < code > height< / code > a la position
< code > X< / code > ,< code > Y< / code > . Le message sera gé né ré au clic sur ce bouton.
L'image appellé e par < code > image< / code > doit avoir trois é tats empilé s
verticalement (pour les trois é tats du bouton), comme ceci:
< pre >
+---------------+
| press<73> |
+---------------+
| relach<63> |
+---------------+
| d<> sactiv<69> |
+---------------+
< / pre >
2001-10-18 11:48:46 +00:00
< / dd >
2002-12-06 01:45:39 +00:00
< dt > < a name = "main.decoration" >
< b > < code > decoration = enable|disable< / code > < / b >
2001-10-18 11:48:46 +00:00
< / a > < / dt >
< dd >
2002-12-06 01:45:39 +00:00
Active ou dé sactive la dé coration du gestionnaire de fenê tre pour la
fenê tre principale. < b > Dé sactivé < / b > par dé faut.
2001-10-18 11:48:46 +00:00
< / dd >
< dt >
2002-12-06 01:45:39 +00:00
< a name = "main.hpotmeter" >
2001-10-18 11:48:46 +00:00
< b >
2002-12-06 01:45:39 +00:00
< code > hpotmeter = button, bwidth, bheight, phases, numphases, default, X, Y, width, height, message< / code >
2001-10-18 11:48:46 +00:00
< / b >
< / a >
< / dt >
< dd >
2002-12-06 01:45:39 +00:00
Place un podomè tre horizontal de taille < code > width (largeur)< / code > * < code > hight (hauteur)< / code >
a la position < code > X< / code > ,< code > Y< / code > . 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.) hpotmeter peut possé der un
bouton qui sera glissé horizontalement.
< div > Les paramè tres sont :< / div >
2001-10-18 11:48:46 +00:00
< ul >
2002-12-06 01:45:39 +00:00
< li > < code > button< / code > - l'image utilisé e pour le bouton
2001-10-18 11:48:46 +00:00
(doit avoir trois é tats superposé s, comme pour les
2002-12-06 01:45:39 +00:00
< a href = "#main.button" > boutons< / a > )< / li >
< li > < code > bwidth< / code > , < code > bheight< / code > - taille du bouton< / li >
< li > < code > phases< / code > - L'image utilisé e pour les diffé rentes phases du
podomè tre. Une valeur < code > NULL< / code > spé ciale peut-ê tre utilisé e
si vous ne voulez pas d'image. L'image doit ê tre divisé e en
< code > numphases< / code > parties verticalement comme ceci:
< pre >
+------------+
| phase #1 |
+------------+
| phase #2 |
+------------+
...
+------------+
| phase #n |
+------------+
< / pre >
2001-10-18 11:48:46 +00:00
< / li >
2002-12-06 01:45:39 +00:00
< li > < code > numphases< / code > - nombre d'é tats placé s dans l'image.< / li >
< li > < code > default< / code > - valeur par dé faut du podomè tre (dans un
intervalle de 0 a 100)< / li >
< li > < code > X< / code > , < code > y< / code > - position pour le podomè tre< / li >
< li > < code > width< / code > , < code > h< / code > - largeur et hauteur du podomè tre< / li >
< li > < code > message< / code > - le message gé né ré lors des changements
d'é tat de < code > hpotmeter< / code > < / li >
2001-10-18 11:48:46 +00:00
< / ul >
2002-12-06 01:45:39 +00:00
2001-10-18 11:48:46 +00:00
< em class = note >
2002-12-06 01:45:39 +00:00
< b > Note:< / b > il y aura é galement un podomè tre vertical (vpotmeter), qui
n'a pas encore é té programmé .
2001-10-18 11:48:46 +00:00
< / em >
2002-12-06 01:45:39 +00:00
< / dd >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
< dt > < a name = "main.potmeter" >
< b > < code > potmeter = phases, numphases, default, X, Y, width, height, message< / code > < / b >
2001-10-18 11:48:46 +00:00
< / a > < / dt >
< dd >
2002-12-06 01:45:39 +00:00
Un < code > hpotmeter< / code > sans boutons. (je suppose qu'il est censé tourner
en rond, mais il ré agit uniquement aux tractions horizontales.)
2001-10-18 11:48:46 +00:00
Pour une descritpion de ses paramè tres lisez
2002-12-06 01:45:39 +00:00
< a href = "#main.hpotmeter" > hpotmeter< / a > . Ses < code > é tats< / code > peuvent ê tre
< code > NULL< / code > , mais ce n'est pas vraiment utile, puisque vous ne pouvez pas voir
son niveau.
2001-10-18 11:48:46 +00:00
< / dd >
2002-12-06 01:45:39 +00:00
< dt > < a name = "main.font" >
< b > font = < code > fontfile, fontid< / code > < / b >
2001-10-18 11:48:46 +00:00
< / a > < / dt >
< dd >
2002-12-06 01:45:39 +00:00
Dé finit une police. < code > fontfile< / code > est le nom du descripteur de police
2001-10-18 11:48:46 +00:00
avec l'extension < code > .fnt< / code > (< b > inutile< / b > de pré ciser son extension ici).
2002-12-06 01:45:39 +00:00
< code > fontid< / code > ré fè re à la police
(c.f. < a href = "#main.dlabel" > dlabel< / a > et < a href = "#main.slabel" > slabel< / a > ).
2001-10-18 11:48:46 +00:00
Plus de 25 polices peuvent ê tre dé finies.
< / dd >
2002-12-06 01:45:39 +00:00
< dt > < a name = "main.slabel" >
< b > < code > slabel = X, Y, fontid, "text"< / code > < / b >
< / a > < / dt >
< dd >
Place un label statique <20> the position < code > X< / code > ,< code > Y< / code > .
< code > text< / code > est affich<63> en utilisant la police identifi<66> e par < code > fontid< / code > .
Le texte est juste une chaine brute (les variables < code > $x< / code > ne fonctionnent pas)
qui doit <20> tre mise entre doubles quotes (mais le caract<63> re < code > "< / code > ne peut pas
faire partie du texte). Le label est affich<63> en utilisant la police identifi<66> e par
< code > fontid< / code > .
< / dd >
< dt > < a name = "main.dlabel" >
< b > dlabel = < code > X, Y, length, align, fontid, "text"< / code > < / b >
2001-10-18 11:48:46 +00:00
< / a > < / dt >
< dd >
2002-12-06 01:45:39 +00:00
Place un label statique à la position < code > X< / code > ,< code > Y< / code > . Le label est
appelé dynamique parce que sont texte est rafraichi pé ridiquement..
La longeur maximum du label est dé finie par < code > length< / code > (sa
hauteur dé pend de la hauteur des caractè res). Si le texte a afficher
dé passe cette longeur il sera scrollé , au bien aligné dans l'espace
spé cifié par la valeur du paramè tre < code > align< / code > :
< code > 0< / code > pour droite, < code > 1< / code > pour centré , < code > 2< / code > pour gauche.
2001-10-18 11:48:46 +00:00
< br >
2002-12-06 01:45:39 +00:00
Le texte a afficher est donné par < code > text< / code > : il doit ê tre é crit entre guillemets doubles
(< code > "< / code > ) (mais le caractè re < code > "< / code > ne peut pas faire partie du texte).
Le texte s'affiche en utilisant la police spé cifié e par < code > fontid< / code > .
2001-10-18 11:48:46 +00:00
Vous pouvez utiliser les variables suivantes dans le texte :
< table valign = top border = 1 >
< tr align = center > < th > Variable< / th > < th align = left > Signification< / th > < / tr >
< tr > < td align = center > < kbd > $1< / kbd > < / td >
< td > temps de lecture en < em > hh:mm:ss< / em > < / td > < / tr >
< tr > < td align = center > < kbd > $2< / kbd > < / td >
< td > temps de lecture en < em > mmmm:ss< / em > < / td > < / tr >
< tr > < td align = center > < kbd > $3< / kbd > < / td >
< td > temps de lecture en < em > hh< / em > (heures)< / td > < / tr >
< tr > < td align = center > < kbd > $4< / kbd > < / td >
< td > temps de lecture en < em > mm< / em > (minutes)< / td > < / tr >
< tr > < td align = center > < kbd > $5< / kbd > < / td >
< td > temps de lecture en < em > ss< / em > (secondes)< / td > < / tr >
< tr > < td align = center > < kbd > $6< / kbd > < / td >
< td > longeur du film en < em > hh:mm:ss< / em > < / td > < / tr >
< tr > < td align = center > < kbd > $7< / kbd > < / td >
< td > longeur du film en < em > mmmm:ss< / em > < / td > < / tr >
< tr > < td align = center > < kbd > $8< / kbd > < / td >
< td > temps de lecture en < em > h:mm:ss< / em > < / td > < / tr >
< tr > < td align = center > < kbd > $v< / kbd > < / td >
< td > volume en < em > xxx.xx%< / em > < / td > < / tr >
< tr > < td align = center > < kbd > $V< / kbd > < / td >
< td > volume en < em > xxx.x< / em > < / td > < / tr >
< tr > < td align = center > < kbd > $b< / kbd > < / td >
< td > balance en < em > xxx.xx%< / em > < / td > < / tr >
< tr > < td align = center > < kbd > $B< / kbd > < / td >
< td > balance en < em > xxx.x< / em > < / td > < / tr >
< tr > < td align = center > < kbd > $$< / kbd > < / td >
< td > le caractè re < kbd > $< / kbd > < / td > < / tr >
< tr > < td align = center > < kbd > $a< / kbd > < / td >
< td > un caractè re dé pendant du type audio (aucun: < code > n< / code > ,
mono: < code > m< / code > , stereo: < code > t< / code > )< / td > < / tr >
< tr > < td align = center > < kbd > $t< / kbd > < / td >
< td > numé ro de piste (dans la playlist)< / td > < / tr >
< tr > < td align = center > < kbd > $o< / kbd > < / td >
< td > nom du fichier< / td > < / tr >
< tr > < td align = center > < kbd > $f< / kbd > < / td >
< td > nom du fichier en minuscule< / td > < / tr >
< tr > < td align = center > < kbd > $F< / kbd > < / td >
< td > nom du fichier en majuscule< / td > < / tr >
< tr > < td align = center > < kbd > $T< / kbd > < / td >
< td > un caractè re dé pendant du type de flux (fichier: < code > f< / code > ,
video CD: < code > v< / code > , DVD: < code > d< / code > , URL: < code > u< / code > )
< / td > < / tr >
< tr > < td align = center > < kbd > $p< / kbd > < / td >
2002-12-06 01:45:39 +00:00
< td > le caractè re "p" (si une vidé o est en lecture et que la police a le caractè re "p")
2001-10-18 11:48:46 +00:00
< / td > < / tr >
< tr > < td align = center > < kbd > $s< / kbd > < / td >
2002-12-06 01:45:39 +00:00
< td > le caractè re "s" (si une vidé o est stoppé e et que la police a le caractè re "s")
2001-10-18 11:48:46 +00:00
< / td > < / tr >
< tr > < td align = center > < kbd > $e< / kbd > < / td >
2002-12-06 01:45:39 +00:00
< td > le caractè re "e" (si une vidé o est en pause et que la police a le caractè re "e")
2001-10-18 11:48:46 +00:00
< / td > < / tr >
2002-12-06 01:45:39 +00:00
< / table >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
< em class = "note" >
< b > Note:< / b > les variables < kbd > $a< / kbd > , < kbd > $T< / kbd > , < kbd > $p< / kbd > , < kbd > $s< / kbd >
et < kbd > $e< / kbd > retournent 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 à < code > ||< / code > ). Vous pouvez avoir une police
pour les saractè res normaux et une autre pour les symboles.
Lisez la section sur les < a href = "#symbols" > symboles< / a > pour plus d'informations.
< / em >
2001-10-18 11:48:46 +00:00
< / dd >
2002-12-06 01:45:39 +00:00
< h3 > < a name = "subwindow" > 3.2 Sous-fenê tre< / a > < / h3 >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
Vous trouverez ci-dessous la liste des objets utilisables dans le bloc
2001-10-18 11:48:46 +00:00
'< code > window = sub< / code > ' . . . '< code > end< / code > '.
2002-12-06 01:45:39 +00:00
< dt > < a name = "sub.base" >
< b > base = < code > image, x, y, largeur, hauteur< / code > < / b >
2001-10-18 11:48:46 +00:00
< / a > < / dt >
< dd >
L'image qui s'affichera dans la fenê tre.
2002-12-06 01:45:39 +00:00
La fenê tre apparaî tra à la position < code > x< / code > ,< code > y< / code >
2001-10-18 11:48:46 +00:00
sur l'é cran (0,0 est le coin supé rieur gauche). Vous pouvez spé cifier -1 pour centre
2002-12-06 01:45:39 +00:00
et -2 pour droite. La fenê tre prendra la taille de l'image.
< code > largeur< / code > et < code > hauteur< / code > 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).
2001-10-18 11:48:46 +00:00
< / dd >
2002-12-06 01:45:39 +00:00
< dt > < a name = "sub.background" >
< b > background = < code > r, g, b< / code > < / b >
2001-10-18 11:48:46 +00:00
< / a > < / dt >
< dd >
Vous permet de dé finir la couleur de fond. Utile si l'image est plus petite que la fenê tre.
2002-12-06 01:45:39 +00:00
< code > r< / code > , < code > g< / code > et < code > b< / code > spé cifient les composantes rouge, verte et bleue de la couleur (d'une intervalle entre 0 et 255).
2001-10-18 11:48:46 +00:00
< / dd >
2002-12-06 01:45:39 +00:00
< h3 > < a name = "skinmenu" > 3.3 Menu< / a > < / h3 >
2001-10-18 11:48:46 +00:00
Comme mentionné pré cé demment, le menu s'affiche en utilisant deux images.
2002-12-06 01:45:39 +00:00
Les entré es normales du menu sont extraitres de l'image spé cifié e par
l'objet < code > base< / code > , tandis que l'entré e actuellement sé lectionné e
est extraite de l'image spé cifié e par l'objet < code > selected< / code > . Vous
devez dé finir la taille et la position de chaque entré e du menu par l'objet
< code > menu< / code > .
2001-10-18 11:48:46 +00:00
< p >
Ils correspondent aux objets utilisé s dans le bloc '< code > window = menu< / code > '
. . . '< code > end< / code > '.
2002-12-06 01:45:39 +00:00
< / p >
2001-10-18 11:48:46 +00:00
< dl >
2002-12-06 01:45:39 +00:00
< dt > < a name = "menu.base" >
< b > < code > base = image< / code > < / b >
2001-10-18 11:48:46 +00:00
< / a > < / dt >
< dd >
L'image utilisé e pour les entré es normales.
< / dd >
2002-12-06 01:45:39 +00:00
< dt > < a name = "menu.selected" >
< b > < code > selected = image< / code > < / b >
2001-10-18 11:48:46 +00:00
< / a > < / dt >
< dd >
L'image utilisé e pour les entré es selectionné es.
< / dd >
2002-12-06 01:45:39 +00:00
< dt > < a name = "menu.menu" >
< b > menu = < code > x, y, largeur, hauteur, message< / code > < / b >
2001-10-18 11:48:46 +00:00
< / a > < / dt >
< dd >
2002-12-06 01:45:39 +00:00
Dé finit la position < code > X< / code > ,< code > Y< / code > et la taille des entré es du
menu dans les images. < code > message< / code > est le message gé né ré
quand le bouton de la souris est relaché .
2001-10-18 11:48:46 +00:00
< / dd >
< / dl >
2002-12-06 01:45:39 +00:00
< h2 > < a name = "fonts" > 4 Polices< / a > < / h2 >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
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.
2001-10-18 11:48:46 +00:00
< p >
2002-12-06 01:45:39 +00:00
Les fichier descriptif des polices (avec l'extension < code > .fnt< / code > ) peut avoir des lignes
de commentaires commenç ant par '< code > ;< / code > '.
2001-10-18 11:48:46 +00:00
Le fichier doit avoir une ligne du type
2002-12-06 01:45:39 +00:00
< / p >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
< dl >
< dt > < a name = "font.image" >
< b > < code > image = image< / code > < / b >
< / a > < / dt >
< dd >
où < code > image< / code > est le nom de l'image qui sera utilisé e pour la police
2001-10-18 11:48:46 +00:00
(vous n'avez pas à dé finir d'extension).
2002-12-06 01:45:39 +00:00
< / dd >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
< dt > < a name = "font.char" >
< b > < code > "char" = X, Y, width, height< / code > < / b >
< / a > < / dt >
< dd >
Ici < code > X< / code > et < code > Y< / code > pré cisent la position du caractè re
< code > char< / code > dans l'image (0,0 est le coin supé rieur gauche).
< code > width< / code > et < code > height< / code > sont la largeur et la hauteur du caractè re
en pixels.
< / dd >
< / dl >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
Voici un exemple dé finissant les caractè res A, B, C utilisant la police
< code > font.png< / code > .
< table width = "100%" border = 1 > < tr bgcolor = silver > < td > < pre >
; peut ê tre "font" au lieu de "font.png"
2001-10-18 11:48:46 +00:00
image = font.png
; Trois caractè res suffisent, mais seulement pour une dé monstration. :-)
2002-12-06 01:45:39 +00:00
",A" = 0,0, 7,13
2001-10-18 11:48:46 +00:00
" B" = 7,0, 7,13
" C" = 14,0, 7,13
< / pre > < / td > < / tr > < / table >
2002-12-06 01:45:39 +00:00
< h3 > < a name = "symbols" > 4.1 Symboles< / a > < / h3 >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
Certains caractè res ont une sugnifaction spé ciale quand retourné s
par des variables utilisé es dans < a href = "#main.dlabel" > dlabel< / a > ; 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 'd').
2001-10-18 11:48:46 +00:00
< p >
2002-12-06 01:45:39 +00:00
La table ci-dessous liste les caractè res pouvant s'afficher comme des symboles
(et né cessitent donc une police diffé rente).
< / p >
2001-10-18 11:48:46 +00:00
< table >
< tr > < th align = center > Character< / th > < th align = left > Symbole< / th > < / tr >
< tr > < td align = center > < kbd > p< / kbd > < / td >
< td align = left > lecture< / td > < / tr >
< tr > < td align = center > < kbd > s< / kbd > < / td >
< td align = left > stop< / td > < / tr >
< tr > < td align = center > < kbd > e< / kbd > < / td >
< td align = left > pause< / td > < / tr >
< tr > < td align = center > < kbd > n< / kbd > < / td >
< td align = left > pas de son< / td > < / tr >
< tr > < td align = center > < kbd > m< / kbd > < / td >
< td align = left > son mono< / td > < / tr >
< tr > < td align = center > < kbd > t< / kbd > < / td >
< td align = left > son stereo< / td > < / tr >
< tr > < td align = center > < kbd > f< / kbd > < / td >
< td align = left > lecture depuis un fichier< / td > < / tr >
< tr > < td align = center > < kbd > v< / kbd > < / td >
< td align = left > lecture depuis un video CD< / td > < / tr >
< tr > < td align = center > < kbd > d< / kbd > < / td >
< td align = left > lecture depuis un DVD< / td > < / tr >
< tr > < td align = center > < kbd > u< / kbd > < / td >
< td align = left > lecture depuis une URL< / td > < / tr >
< / table >
2002-12-06 01:45:39 +00:00
< h2 > < a name = "guimsg" > Appendice A: messages de la GUI< / a > < / h2 >
2001-10-18 11:48:46 +00:00
2002-12-06 01:45:39 +00:00
Ce sont les messages qui peuvent ê tre gé né ré s par les boutons,
podomè tres et entré es du menu.
2001-10-18 11:48:46 +00:00
< p >
< em class = note >
2002-12-06 01:45:39 +00:00
< b > Note:< / b > 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.< / em >
< / p >
2001-10-18 11:48:46 +00:00
< p >
2002-12-06 01:45:39 +00:00
< code > Contrô le de lecture :< / code >
2001-10-18 11:48:46 +00:00
< blockquote >
< dl >
< dt > < b > evNext< / b >
< dd > Saute à la prochaine piste dans la playlist.
< dt > < b > evPause< / b >
< dd > Pause.
< dt > < b > evPauseSwitchToPlay< / b >
2002-12-06 01:45:39 +00:00
< dd > Associé à la commande < code > evPlaySwitchToPause< / code > . 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
< code > evPlaySwitchToPause< / code > s'affiche (pour indiquer que le bouton peut ê tre
pressé pour continuer la lecture).
2001-10-18 11:48:46 +00:00
< dt > < b > evPlay< / b >
< dd > Commence la lecture.
< dt > < b > evPlaySwitchToPause< / b >
2002-12-06 01:45:39 +00:00
< dd > Le contraire de < code > evPauseSwitchToPlay< / code > . Ce message dé marre la lecture
et l'image associé e au bouton < code > evPauseSwitchToPlay< / code > s'affiche (pour
indiquer que le bouton peut ê tre pressé pour mettre en pause la lecture).
2001-10-18 11:48:46 +00:00
< dt > < b > evPrev< / b >
< dd > Saute à la piste pré cedente dans la playlist.
< dt > < b > evStop< / b >
< dd > Stoppe la lecture.
< / dl >
< / blockquote >
2002-12-06 01:45:39 +00:00
< h3 > Avancé e dans le flux:< / h3 >
2001-10-18 11:48:46 +00:00
< blockquote >
< dl >
< dt > < b > evBackward10sec< / b >
< dt > < b > evBackward1min< / b >
< dt > < b > evBackward10min< / b >
< dd > Recule de 10 secondes / 1 minute / 10 minutes.
< dt > < b > evForward10sec< / b >
< dt > < b > evForward1min< / b >
< dt > < b > evForward10min< / b >
< dd > Avance de 10 secondes / 1 minute / 10 minutes.
< dt > < b > evSetMoviePosition< / b >
2002-12-06 01:45:39 +00:00
< dd > Se place à la position (utilisable avec un podomè tre; utilise la
valeur relative (0-100%) du podomè tre).
2001-10-18 11:48:46 +00:00
< / dl >
< / blockquote >
2002-12-06 01:45:39 +00:00
< h3 > Contrô le vidé o :< / h3 >
2001-10-18 11:48:46 +00:00
< blockquote >
< dl >
< dt > < b > evDoubleSize< / b >
< dd > Double la taille de la fenê tre vidé o.
< dt > < b > evFullScreen< / b >
< dd > Passe en mode plein é cran.
< dt > < b > evNormalSize< / b >
< dd > Met la vidé o à sa taille ré elle.
< / dl >
< / blockquote >
2002-12-06 01:45:39 +00:00
< h3 > Contô le audio :< / h3 >
2001-10-18 11:48:46 +00:00
< blockquote >
< dl >
< dt > < b > evDecAudioBufDelay< / b >
< dd > Diminue le dé lai du buffer audio.
< dt > < b > evDecBalance< / b >
< dd > Diminue la balance.
< dt > < b > evDecVolume< / b >
< dd > Diminue le volume.
< dt > < b > evIncAudioBufDelay< / b >
< dd > Augmente le dé lai du buffer audio.
< dt > < b > evIncBalance< / b >
< dd > Augmente la balance.
< dt > < b > evIncVolume< / b >
< dd > Augmente le volume.
< dt > < b > evMute< / b >
< dd > Active/dé sactive le son.
< dt > < b > evSetBalance< / b >
2002-12-06 01:45:39 +00:00
< dd > Fixe la balance (utilisable avec un podomè tre; utilise la valeur relative
(0-100%) du podomè tre).
2001-10-18 11:48:46 +00:00
< dt > < b > evSetVolume< / b >
2002-12-06 01:45:39 +00:00
< dd > Fixe le volume (utilisable avec un podomè tre; utilise la valeur relative
(0-100%) du podomè tre).
2001-10-18 11:48:46 +00:00
< / dl >
< / blockquote >
2002-12-06 01:45:39 +00:00
< h3 > Divers :< / h3 >
2001-10-18 11:48:46 +00:00
< blockquote >
< dl >
< dt > < b > evAbout< / b >
< dd > Ouvre la fenê tre 'A Propos'.
2002-12-06 01:45:39 +00:00
< dt > < b > evDropSubtitle< / b >
< dd > D<EFBFBD> sactive le sous-titre actuellement utilis<69> .
2002-06-24 11:07:50 +00:00
< dt > < b > evEqualizer< / b >
2001-10-18 11:48:46 +00:00
< dd > Active/dé sactive l'equalizer.
< dt > < b > evExit< / b >
< dd > Quite le programme.
< dt > < b > evIconify< / b >
< dd > Iconifie la fenê tre.
< dt > < b > evLoad< / b >
2002-12-06 01:45:39 +00:00
< dd > Charge un fichier (en ouvrant un mini navigateur de fichiers, où vous pouvez
choisir un fichier).
2001-10-18 11:48:46 +00:00
< dt > < b > evLoadPlay< / b >
2002-12-06 01:45:39 +00:00
< dd > Fait la mê me chose que < code > evLoad< / code > ,mais dé marre la lecture
automatiquement aprè s le chargement du fichier.
< dt > < b > evLoadSubtitle< / b >
< dd > Charge un fichier de sous-titres (avec un selectionneur de fichier)
< dt > < b > evLoadAudioFile< / b >
< dd > Charge un fichier audio (avec un selectionneur de fichier)
2001-10-18 11:48:46 +00:00
< dt > < b > evNone< / b >
2002-12-06 01:45:39 +00:00
< dd > Message vide, sans effet. (A part peut-<2D> tre dans les versions CVS :-))
2001-10-18 11:48:46 +00:00
< dt > < b > evPlayList< / b >
< dd > Ouvre/ferme la playlist.
2002-12-06 01:45:39 +00:00
< dt > < b > evPlayDVD< / b >
< dd > Essaie d'ouvrir le disque dans le lecteur DVDROM indiqu<71> .
< dt > < b > evPlayVCD< / b >
< dd > Essaie d'ouvrir le disque dans le lecteur CDROM indiqu<71> .
2001-10-18 11:48:46 +00:00
< dt > < b > evPreferences< / b >
< dd > Ouvre la fenê tre de preferences.
2002-12-06 01:45:39 +00:00
< dt > < b > evSetAspect< / b >
< dd > Fixe l'aspect de l'image.
< dt > < b > evSetURL< / b >
< dd > Ouvre la fen<65> tre de saisie d'URL.
2001-10-18 11:48:46 +00:00
< dt > < b > evSkinBrowser< / b >
< dd > Ouvre le navigateur de revê tements.
< / dl >
< / blockquote >
2002-12-06 01:45:39 +00:00
2001-10-18 11:48:46 +00:00
< / body >
< / html >
