Grazie a Zoltán Ponekker per il suo aiuto.
András Mohari <mayday@freemail.hu>
/usr/local/share/mplayer/Skin/
~/.mplayer/Skin/
Nota che il primo path può variare a seconda di come è stato configurato MPlayer
(vedi l'argomento --datadir dello script configure).
Ogni skin è installata in una sua propria directory sotto una delle directory elencate sopra, per esempio:
/usr/local/share/mplayer/Skin/default/
Nella finestra principale (vedi sotto) puoi usare immagini con `trasparenze': regioni riempite col colore #FF00FF (magenta) sono del tutto trasparenti quando viste con MPlayer. Questo significa che puoi anche ottenere finestre con una certa forma se il tuo server X ha l'estensione XShape.
Attualmente ci sono tre finestre da essere decorate: la finestra principale, la sotto finestra e il menu della skin (che può essere attivata con il tasto destro).
Un bottone ha tre stati (premuto, rilasciato, disabilitato), quindi la sua immagine deve essere divisa in tre parti verticalmente. Vedi l'oggetto bottone per dettagli.
Uno slider (usati principalmente per la barra di ricerca e il controllo di volume/bilanciamento) può avere qualsiasi numero di fasi dividendo la sua immagine in differenti parti una sotto l'altra. Vedi hslider e slider per dettagli.
Le etichette sono un po' speciali: i caratteri necessari a disegnarli sono presi da un file immagine, e i caratteri nell'immagine sono descritti da un file per la descrizione del font. Questo è un normale file di testo che specifica la posizione x,y e la dimensione di ogni carattere nell'immagine. (Quindi il file d'immagine e il suo file di descrizione del font formano un font insieme.) Vedi dlabel e slabel per dettagli.
Nota: tutte le immagini possono avere la piena trasparenza come descritto nella sezione sui formati immagine.
Una voce del menu è definita dalla sua posizione e dimensione nell'immagine (vedi la sezione sul menu della skin per dettagli).
C'è una cosa importante non ancora menzionata: per far funzionare bottoni, slider e voci del menu, MPlayer deve sapere cosa fare se sono cliccati. Questo è fatto tramite messaggi (eventi). Per questi oggetti devi definire i messaggi che devono essere generati quando vengono attivati.
skin
Come menzionato sopra, questo è il file di configurazione della skin.
E' orientato alla linea; le linee di commento iniziano col carattere ';'
all'inizio della linea (solo spazi e tab sono permessi prima del
';').
Il file è fatto di sezioni. Ogni sezione descrive la skin per un'applicazione e ha la seguente forma:
section = nome sezione . . . end |
Attualmente c'è solo una applicazione, quindi hai bisogno solo di una sezione: il suo nome è movieplayer.
Dentro questa sezione ogni finestra è descritta da un blocco nella seguente forma:
window = nome finestra . . . end |
(I blocchi sub e menu sono opzionali---non devi per forza creare un menu o decorare la sotto finestra.)
Dentro un blocco finestra, puoi definire ogni oggetto della finestra con una linea in questa forma:
oggetto = parametro
dove oggetto è unastringa che identifica il tipo di oggetto della GUI, parametro è un valore numerico o testuale (o una lista di valori separati da virgole).
mettendo insieme quanto sopra, l'intero file appare così:
section = movieplayer window = main ; ... oggetti della finestra principale ... end window = sub ; ... oggetti della sotto finestra ... end window = menu ; ... oggetti del menu della skin ... end end |
In fine alcune parole su come specificare le immagini per i vari oggetti.
Il nome di un file immagine deve essere dato senza il percorso---
le immagini vengono cercate nella directory della skin. Puoi (ma non è necessario)
specificare l'estensione del file. Se il file non esiste, MPlayer cerca di
caricare il file <nomefile>.<est>, dove tga,
TGA, bmp, BMP, png e PNG sono provati
al posto di <est> (in questo ordine). Il primo file corrispondente sarà usato.
Ecco un esempio per rendere le cose chiare. Supponi di avere un'immagine chiamata
main.png che usi per la finestra principale:
MPlayer cerca di caricare main, main.tga, main.TGA,
main.bmp ecc, quindi verrà trovata main.png.
Se (per sbaglio) scrivi
allora saranno cercati main.bmp, main.bmp.tga, main.bmp.TGA,
main.bmp.bmp e MPlayer alla fine rinuncerà
perchè non c'è nessun main.bmp nella directory, ma main.png.
|
window = main' . . . 'end'
Avvertimento: le zone trasparenti dell' immagine (colore #FF00FF) appaiono nere se il server X non supporta l'estensione XShape.
+------------+ | premuto | +------------+ | rilasciato | +------------+ |disabilitato| +------------+ |
+------------+
| fase #1 |
+------------+
| fase #2 |
+------------+
...
+------------+
| fase #n |
+------------+
|
NULL, ma è proprio inutile, infatti non puoi vedere dove
è situato lo slider.
.fnt (non c'è bisogno di specificare l'estensione
qui).
fontid è usato per riferirsi al font
(vedi dlabel e slabel).
Possono essere definiti fino a 25 font.
") (ma le " non possono essere parte del
testo). L'etichetta è visualizzata usando il font identificato da fontid.
Puoi usare le seguenti variabili nel testo.
| Variabile | Significato |
|---|---|
| $1 | tempo in formato hh:mm:ss |
| $2 | tempo in formato mmmm:ss |
| $3 | tempo in formato hh (ore) |
| $4 | tempo in formato mm (minuti) |
| $5 | tempo in formato ss (secondi) |
| $6 | lunghezza filmato nel formato hh:mm:ss |
| $7 | lunghezza filmato nel formato mmmm:ss |
| $8 | tempo in formato h:mm:ss |
| $v | volume in formato xxx.xx% |
| $V | volume in formato xxx.x |
| $b | bilanciamento in formato xxx.xx% |
| $B | bilanciamento in formato xxx.x |
| $$ | il carattere $ |
| $a | un carattere a seconda del tipo di audio (nessuno: n,
mono: m, stereo: t) |
| $t | numero traccia (nella playlist) |
| $o | nomefile |
| $f | nomefile in minuscolo |
| $F | nomefile in maiuscolo |
| $T | un carattere a seconda del tipo di stream (file: f,
video CD: v, DVD: d, URL: u)
|
| $p | il carattere "p" (se si sta leggendo un filmato e il font ha il carattere "p") |
| $s | il carattere "s" (se non si sta leggendo un filmato e il font ha il carattere "s") |
| $e | il carattere "e" (se il filmato è in pausa e il font ha il carattere "e") |
Nota: Le variabili $a, $T, $p, $s
e $e ritornano tutte caratteri che dovrebbero essere visualizzati
come simboli speciali (per esempio, "e" è per il simbolo della pausa che di solito
appare come ||). Dovresti avere un font per i caratteri normali
e un altro per i simboli.
Vedi la sezione sui simboli per altre informazioni.
" non possono essere parte del testo).
window = sub' . . . 'end'.
Questi sono gli oggetti che possono essere usati nel blocco 'window = menu'
. . . 'end'.
Il file di descrizione del font (con estensione .fnt) può avere linee di commento
che iniziano con ';'.
Il file deve avere una linea nella forma
image = immagine
dove immagine è il nome del file immagine da usare per il font (non devi specificare l'estensione). La linea sopra è seguita dalle linee di definizione del carattere nella forma:
"car" = x, y, l, a
Qui x e y specificano la posizione del carattere car nell'immagine (0,0 è l'angolo in alto a sinistra). l e a sono la larghezza e l'altezza del carattere (in pixel, naturalmente).
Ecco un esempio che definisce i caratteri A, B, C usando font.png.
; può essere "font" invece di "font.png" image = font.png ; Tre caratteri sono abbastanza solo per una dimostrazione. :-) "A" = 0,0, 7,13 "B" = 7,0, 7,13 "C" = 14,0, 7,13 |
La tabella seguente elenca tutti i caratteri che possono essere usati per visualizzare simboli (e quindi richiedono un font differente).
| Carattere | Simbolo |
|---|---|
| p | play |
| s | stop |
| e | pausa |
| n | muto |
| m | suono mono |
| t | suono stereo |
| f | lo stream è un file |
| v | lo stream è un video CD |
| d | lo stream è un DVD |
| u | lo stream è una URL |
Nota: attualmente sono usati solo 'p', 's', 'e', 'n', 'm' e 't'.
Nota: alcuni messaggi possono non funzionare come ci si aspetta (o non funzionare del tutto). Come sai, la GUI è in sviluppo.
Controllo riproduzione:
- evNext
- Salta alla prossima traccia della playlist.
- evPause
- Pausa la riproduzione.
- evPauseSwitchToPlay
- Forma un interruttore logico insieme a evPlaySwitchToPause. Possono essere usati per avere un bottone comune di play/pausa. Entrambi i messaggi dovrebbero venire assegnati a bottoni visualizzati nella stessa posizione della finestra. Questo messaggio mette in pausa la riproduzione e viene mostrata l'immagine per il bottone evPlaySwitchToPause (ad indicare che il bottone può essere premuto per continuare la riproduzione).
- evPlay
- Inizia la riproduzione.
- evPlaySwitchToPause
- L'opposto di evPauseSwitchToPlay. Questo messaggio inizia la riproduzione ed è mostrata l'immagine per il bottone evPauseSwitchToPlay (ad indicare che il bottone può essere premuto per mettere in pausa).
- evPrev
- Salta alla traccia precedente nella playlist.
- evStop
- Ferma la riproduzione.
Ricerca nello stream:
- evBackward10sec
- evBackward1min
- evBackward10min
- Per andare indietro di 10 secondi / 1 minuto / 10 minuti.
- evForward10sec
- evForward1min
- evForward10min
- Per andare avanti di 10 secondi / 1 minuto / 10 minuti.
- evSetMoviePosition
- Per andare alla posizione (può essere usato da uno slider; è usato il valore relativo (0-100%) dello slider).
Controllo video:
- evDoubleSize
- Raddoppia le dimensioni della finestra del filmato.
- evFullScreen
- Manda a pieno schermo e vice versa.
- evNormalSize
- Regola la finestra del filmato alle sue dimensioni normali.
Controllo audio:
- evDecAudioBufDelay
- Diminuisce il ritardo del buffer audio.
- evDecBalance
- Diminuisce il bilanciamento.
- evDecVolume
- Diminuisce il volume.
- evIncAudioBufDelay
- Aumenta il ritardo del buffer audio.
- evIncBalance
- Aumenta il bilanciamento.
- evIncVolume
- Aumenta il volume.
- evMute
- Regola il suono su muto e vice versa.
- evSetBalance
- Regola il bilanciamento (può essere usato da uno slider; è usato il valore relativo (0-100%) dello slider).
- evSetVolume
- Regola il volume (può essere usato da uno slider; è usato il valore relativo (0-100%) dello slider).
Vari:
- evAbout
- Apre la finestra "about".
- evEqualeaser
- Accende/spegne l'equalizzatore.
- evExit
- Esce dal programma.
- evIconify
- Riduce ad icona la finestra.
- evLoad
- Carica un file (aprendo una finestra del file browser, dove puoi scegliere un file).
- evLoadPlay
- Fa la stessa cosa di evLoad, ma inizia automaticamente la riproduzione dopo il caricamento del file.
- evNone
- Messaggio vuoto, non ha nessun effetto. (Eccetto forse nella versione CVS. :-))
- evPlayList
- Apre/chiude la finestra della playlist.
- evPreferences
- Apre la finestra delle preferenze.
- evSkinBrowser
- Apre la finestra dello skin browser.