mpv/DOCS/it/skin.html

796 lines
28 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<!-- Sync with english version 1.15 -->
<head>
<title>Creare Skin - MPlayer - Movie Player per Linux</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>MPlayer skin format</title>
<style type="text/css">
body {font-family : Verdana, Arial, Helvetica, sans-serif;
font-size : 14px;
background : white;}
em.note {color: green;
font-style: normal;}
em.warn {color: red;
font-style: normal;}
</style>
</head>
<body>
<h1>Appendice D - Formato skin di MPlayer</h1>
<p>Il proposito di questo documento è di descrivere il formato delle skin di
MPlayer. Le informazioni qui contenute possono essere errate, in quanto</p>
<ol type="a">
<li>non sono stato io a scrivere la GUI.</li>
<li>la GUI non è finita.</li>
<li>posso sbagliarmi.</li>
</ol>
<p>Quindi non sorprenderti se qualcosa non funziona come descritto qui.</p>
<p>Grazie a <em>Zoltán Ponekker</em> per il suo aiuto.</p>
<p><em>András Mohari &lt;mayday@freemail.hu&gt;</em></p>
<h2><a name="overview">D.1 Generale</a></h2>
<p>Non ha niente a che fare col formato delle skin, ma dovresti sapere
che MPlayer <b>non</b> include una skin, quindi <b>devi installare almeno
una skin per poter usare la GUI.</b></p>
<h3><a name="dirs">D.1.1 Directory</a></h3>
<p>Le directory in cui si cerca per le skin sono (in ordine):
<pre>
$(DATADIR)/Skin/
$(PREFIX)/share/mplayer/Skin/
~/.mplayer/Skin/
</pre>
<p>Nota che il primo path può variare a seconda di come è stato configurato
MPlayer (vedi le opzioni <code>--datadir</code> e <code>--prefix</code> dello
script <code>configure</code>).</p>
<p>Ogni skin è installata in una sua propria directory sotto una delle directory
elencate sopra, per esempio:
<pre>
$(PREFIX)/share/mplayer/Skin/default/
</pre>
<h3><a name="images">D.1.2 Formati delle immagini</a></h3>
<p>Le immagini devono essere PNG in truecolor (24 o 32 bpp).</p>
<p>Nella finestra principale e nella playbar (vedi sotto) puoi usare immagini
con `trasparenze': le aree riempite col colore #FF00FF
(<font color="#FF00FF">magenta</font>) sono del tutto trasparenti quando viste
con MPlayer. Questo significa che puoi anche ottenere finestre sagomate se il
tuo server X ha l'estensione XShape.</p>
<h3><a name="components">D.1.3 Parti di una skin</a></h3>
<p>Le skin sono del tutto in formato libero (non come le skin a formato fisso
di Winamp/XMMS, per esempio), quindi sta a te creare qualcosa di grandioso.</p>
<p>Attualmente ci sono tre finestre da decorare: la
<a href="#mainwin">finestra principale</a>, la <a href="#subwindow">sotto finestra</a>
ed il <a href="#skinmenu">menu della skin</a> (che può essere attivato con il
tasto destro).</p>
<ul>
<li><p>La <b>finestra principale</b> e/o la <b>playbar</b> sono usate per
controllare MPlayer. Lo sfondo della finestra è un'immagine. Vari oggetti
possono (e devono) essere piazzati nella finestra: <em>bottoni</em>,
<em>slider</em> ed <em>etichette</em>. Per ogni oggetto, devi specificare la
posizione e dimensione.</p>
<p>Un <b>bottone</b> ha tre stati (premuto, rilasciato, disabilitato), quindi
la sua immagine deve essere divisa in tre parti verticalmente. Vedi l'oggetto
<a href="#main.button">bottone</a> per dettagli.</p>
<p>Uno <b>slider</b> (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
<a href="#main.hpotmeter">hslider</a> e <a href="#main.potmeter">slider</a>
per dettagli.</p>
<p>Le <b>etichette</b> sono un po' speciali: i caratteri necessari a disegnarle
sono presi da un file immagine, e i caratteri nell'immagine sono descritti da
un <a href="#fonts">file per la descrizione del font</a>. 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 <em>insieme</em>.) Vedi <a href="#main.dlabel">dlabel</a> e
<a href="#main.slabel">slabel</a> per dettagli.</p>
<p><em class=note><b>Nota:</b> tutte le immagini possono avere la piena
trasparenza come descritto nella sezione sui <a href="#images">formati
immagine</a>.</em></p>
</li>
<li>La <b>sotto finestra</b> è dove appare il filmato. Può mostrare una
specifica immagine se non c'è nessun video caricato (è noioso avere una
finestra vuota :-)) <em class=note><b>Nota:</b> la trasparenza <b>non è
permessa</b> qui.</em></li>
<li>Il <b>menu della skin</b> è solo un modo per controllare MPlayer per mezzo
delle voci del menu. Sono necessarie due immagini per il menu: una è l'immagine
di base che mostra il menu nel suo stato normale, l'altra è usata per mostrare
le voci selezionate. Quando attivi il menu, viene mostrata la prima immagine.
Se muovi il mouse sulle voci del menu, la voce attualmente selezionata è
copiata dalla seconda immagine sotto il puntatore del mouse (la seconda
immagine non è mai mostrata interamente).<p>
<p>Una voce del menu è definita dalla sua posizione e dimensione nell'immagine
(vedi la sezione sul <a href="#skinmenu">menu della skin</a> per dettagli).</p>
</li>
</ul>
<p>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 <a href="#guimsg">messaggi</a> (eventi). Per questi oggetti
devi definire i messaggi che devono essere generati quando vengono attivati.</p>
<h3><a name="files">D.1.4 File</a></h3>
<p>Devi avere i seguenti file per fare una skin:</p>
<ul>
<li>Il file di configurazione chiamato <a href="#skin">skin</a> dice a MPlayer
come mettere insieme le diverse parti della skin e cosa fare se si clicca da
qualche parte nella finestra.</li>
<li>L'immagine di sfondo della finestra principale.</li>
<li>Immagini per gli oggetti della finestra principale (inclusi uno o più file
di descrizione dei font necessari per disegnare le etichette).</li>
<li>l'immagine da mostrare nella sotto finestra (opzionale).</li>
<li>Due immagini per il menu della skin (ne hai bisogno solo se vuoi creare un
menu).</li>
</ul>
<p>Con l'eccezione del file di configurazione della skin, puoi nominare gli
altri file come vuoi (ma nota che i file di descrizione dei font devono avere
l'estensione .fnt).</p>
<h2><a name="skin">D.2 Il file skin</a></h2>
<p>Come menzionato sopra, questo è il file di configurazione della skin. E'
orientato alla linea; le linee di commento iniziano col carattere
'<code>;</code>' all'inizio della linea (solo spazi e tab sono permessi prima
del'<code>;</code>').</p>
<p>Il file è fatto di sezioni. Ogni sezione descrive la skin per un'applicazione
ed ha la seguente forma:</p>
<table border=1 width="100%">
<tr bgcolor=silver>
<td>
<pre>
section = <i>nome sezione</i>
.
.
.
end
</pre>
</td>
</tr>
</table>
<p>Attualmente c'è solo una applicazione, quindi hai bisogno solo di una
sezione: il suo nome è <b>movieplayer</b>.</p>
<p>Dentro questa sezione ogni finestra è descritta da un blocco nella seguente
forma:</p>
<table border=1 width="100%">
<tr bgcolor=silver>
<td>
<pre>
window = <i>nome finestra</i>
.
.
.
end
</pre>
</tr>
</td>
</table>
<p>dove <i>nome finestra</i> può essere una di queste stringhe:</p>
<ul>
<li><b>main</b> - per la finestra principale</li>
<li><b>sub</b> - per la sotto finestra</li>
<li><b>menu</b> - per il menu della skin</li>
<li><b>olaybar</b> - playbar</li>
</ul>
<p>(I blocchi sub e menu sono opzionali - non devi per forza creare un menu o
decorare la sotto finestra.)</p>
<p>Dentro un blocco finestra, puoi definire ogni oggetto della finestra con una
linea in questa forma:</p>
<dl>
<dt><b><code>oggetto = parametro</code></b></dt>
<dd>dove <code>oggetto</code> è una stringa che identifica il tipo di oggetto
della GUI, <code>parametro</code> è un valore numerico o testuale (o una lista
di valori separati da virgole).</dd>
</dl>
<p>mettendo insieme quanto sopra, l'intero file appare così:</p>
<table border=1 width="100%">
<tr bgcolor=silver>
<td>
<pre>
section = movieplayer
window = main
; ... oggetti della finestra principale ...
end
window = sub
; ... oggetti della sotto finestra ...
end
window = menu
; ... oggetti del menu ...
end
window = playbar
; ... oggetti della palybar ...
end
end
</pre>
</td>
</tr>
</table>
<p>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 <i>&lt;nomefile&gt;.&lt;est&gt;</i>, dove <code>png</code> e
<code>PNG</code> sono provati al posto di <i>&lt;est&gt;</i> (in questo ordine).
Il primo file corrispondente sarà usato.</p>
<p>Infine qualche parola sul posizionamento. La finestra principale e la
sottofinestra possono essere posizionate in diversi angoli dello schermo
impostando le coordinate <code>X</code> e <code>Y</code>. <code>0</code> è in
alto o sinistra, <code>-1</code> è centro e <code>-2</code> è destra o in
basso, come mostrato qui:</p>
<pre>
(0, 0)----(-1, 0)----(-2, 0)
| | |
| | |
(0,-1)----(-1,-1)----(-2,-1)
| | |
| | |
(0,-2)----(-1,-2)----(-2,-2)
</pre>
<table border=1 cellpadding=5 width="100%">
<tr bgcolor="#ffffcc">
<td>Ecco un esempio per rendere le cose chiare. Supponi di avere un'immagine
chiamata <code>main.png</code> che usi per la finestra principale:
<blockquote>
<code> base = main, -1, -1</code>
</blockquote>
MPlayer cerca di caricare <code>main</code>, <code>main.png</code>,
<code>main.PNG</code>.
</td>
</tr>
</table>
<h3><a name="mainwin">D.2.1 Finestra principale e playbar</a></h3>
<p>Sotto puoi vedere la lista degli oggetti che possono essere usati nei blocchi
'<code>window = main</code>' .&nbsp;.&nbsp;. '<code>end</code>', e
'<code>window = playbar</code>' .&nbsp;.&nbsp;. '<code>end</code>'.</p>
<dl>
<dt><a name="main.base"><b><code>base = immagine, X, Y</code></b></a></dt>
<dd>Permette di specificare l'immagine di sfondo da usare per la finestra
principale. La finestra apparirà sullo schermo alla posizione
<code>X, Y</code> data. La finestra sarà larga quanto l'immagine.
<div><em class=warn><b>Nota:</b> al momento queste coordinate non funzionano
per la finestra display.</em></div>
<div><em class="warn"><b>Attenzione:</b> le zone trasparenti dell' immagine
(colore #FF00FF) appaiono nere se il server X non supporta l'estensione
XShape. La larghezza dell'immagine deve essere divisibile per 8.</em></div>
</dd>
<dt><a name="main.button"><b><code>button = immagine, X, Y, larghezza, altezza,
messaggio</code></b></a></dt>
<dd>Posiziona un bottone di dimensioni <code>larghezza</code> *
<code>altezza</code> alla posizione <code>X</code>, <code>Y</code>. Il
<code>messaggio</code> specificato è generato quando viene cliccato il bottone.
L'immagine data da <i>immagine</i> deve avere tre parti una sotto l'altra
(secondo i possibili stati del bottone), in questo modo:
<pre>
+------------+
| premuto |
+------------+
| rilasciato |
+------------+
|disabilitato|
+------------+
</pre>
</dd>
<dt><a name="main.decoration"><b><code>decoration = enable|disable</code></b>
</a></dt>
<dd>Abilita o disabilita la decorazione della finestra principale. Il default
è <b>disable</b>.
<div><em class="warn"><b>Nota:</b> non funziona per la finestra display, non
ce n'è bisogno.</em></div>
</dd>
<dt><a name="main.hpotmeter"><b><code>hpotmeter = <i>bott, lungb, altb, fasi,
numfasi, default, X, Y, lung, alt, msg</code></b></a></dt>
<dd>Inserisce uno slider orizzontale (hpotmeter) o verticale (vpotmeter) di
dimensioni <code>lung</code> * <code>alt</code> alla posizione <code>X</code>,
<code>Y</code>. L'immagine può essere divisa in diverse parti per le diverse
fasi dello slider (per esempio, puoi avere uno slider per il controllo volume
che cambia da verde a rosso al cambiare del suo valore dal minimo al massimo).
<code>hpotmeter</code> può avere un bottone che si può trascinare
orizzontalmente.
<div>I parametri sono:</div>
<ul>
<li><code>bott</code> - l'immagine da usare per il bottone (deve avere tre
parti una sotto l'altra, come nel caso del <a href="#main.button">bottone
</a>)</li>
<li><code>lunghb</code>, <code>altb</code> - dimensione del bottone</li>
<li><code>fasi</code> - L'immagine da usare per le differenti fasi dello
slider. il valore speciale <code>NULL</code> può essere usato se non vuoi
un 'immagine. L'immagine deve essere divisa in <code>numfasi</code> parti
verticalmente in questo modo:
<pre>
+------------+
| fase #1 |
+------------+
| fase #2 |
+------------+
...
+------------+
| fase #n |
+------------+
</pre>
</li>
<li><code>numfasi</code> - numero di fasi inserite nell'immagine
<code>fasi</code></li>
<li><code>default</code> - valore di default dello slider (da 0 a 100)</li>
<li><code>X</code>, <code>y</code> - posizione dello slider</li>
<li><code>lungh</code>, <code>alt</code> - larghezza e altezza dello slider</li>
<li><code>messaggio</code> - il messaggio da generare quando viene cambiato il
valore dello slider</li>
</ul>
</dd>
<dt><a name="main.potmeter"><b><code>potmeter = fasi, numfasi, default, X, Y, l,
a, msg</code></b></a></dt>
<dd>Un <code>hpotmeter</code>slider senza bottone. (Penso sia inteso per essere
girato, ma reagisce solo al trascinamento orizzontale.) Per la descrizione dei
parametri vedi <a href="#main.hpotmeter">hpotmeter</a>. <code>fasi</code> può
essere <code>NULL</code>, ma è proprio inutile, infatti non puoi vedere dove
è situato lo slider.</dd>
<dt><a name="main.font"><b><code>font = filefont, fontid</code></b></a></dt>
<dd>Definisce un font. <code>filefont</code> è il nome di un file che descrive
un font con estensione <code>.fnt</code> (<b>non c'è bisogno</b> di specificare
l'estensione qui). <code>fontid</code> è usato per riferirsi al font (vedi
<a href="#main.dlabel">dlabel</a> e <a href="#main.slabel">slabel</a>).
Possono essere definiti fino a 25 font.</dd>
<dt><a name="main.slabel"><b><code>slabel = X, Y, fontid, "testo"</code></b>
</a></dt>
<dd>Posiziona una etichetta statica in <code>X</code>, <code>Y</code>. Il testo
è una pura stringa (le variabili <code>$x</code> non funzionano) che deve
essere racchiuso tra virgolette (le <code>"</code> non possono essere parte del
testo). Il testo è visualizzato usando il font identificato da
<code>fontid</code>.</dd>
<dt><a name="main.dlabel"><b><code>dlabel = X, Y, lunghezza, allineamento,
fontid, "testo"</code></b></a></dt>
<dd>Posiziona una etichetta dinamica in <code>X</code>, <code>Y</code>.
L'etichetta è detta dinamica perchè il suo testo è aggiornato periodicamente.
La lunghezza massima dell'etichetta è data da <code>lunghezza</code> (la sua
altezza è quella di un carattere). Se il testo da visualizzare è più largo,
allora sarà fatto ruotare, altrimenti è allineato nello spazio specificato
tramite il valore del parametro <code>allineamento</code>: 0 per destra, 1
per centro, 2 per sinistra.<br>
Il testo da mostrare è dato da <code>testo</code>: deve essere scritto tra
virgolette (<code>"</code>) (ma le <code>"</code> non possono essere parte
del testo). L'etichetta è visualizzata usando il font identificato da
<code>fontid</code>.Puoi usare le seguenti variabili nel testo:
<table align=center border=1>
<tr align=center><th>Variabile</th><th align=left>Significato</th></tr>
<tr><td align=center><kbd>$1</kbd></td>
<td>tempo in formato <em>hh:mm:ss</em></td></tr>
<tr><td align=center><kbd>$2</kbd></td>
<td>tempo in formato <em>mmmm:ss</em></td></tr>
<tr><td align=center><kbd>$3</kbd></td>
<td>tempo in formato <em>hh</em> (ore)</td></tr>
<tr><td align=center><kbd>$4</kbd></td>
<td>tempo in formato <em>mm</em> (minuti)</td></tr>
<tr><td align=center><kbd>$5</kbd></td>
<td>tempo in formato <em>ss</em> (secondi)</td></tr>
<tr><td align=center><kbd>$6</kbd></td>
<td>lunghezza filmato nel formato <em>hh:mm:ss</em></td></tr>
<tr><td align=center><kbd>$7</kbd></td>
<td>lunghezza filmato nel formato <em>mmmm:ss</em></td></tr>
<tr><td align=center><kbd>$8</kbd></td>
<td>tempo in formato <em>h:mm:ss</em></td></tr>
<tr><td align=center><kbd>$v</kbd></td>
<td>volume in formato <em>xxx.xx%</em></td></tr>
<tr><td align=center><kbd>$V</kbd></td>
<td>volume in formato <em>xxx.x</em></td></tr>
<tr><td align=center><kbd>$b</kbd></td>
<td>bilanciamento in formato <em>xxx.xx%</em></td></tr>
<tr><td align=center><kbd>$B</kbd></td>
<td>bilanciamento in formato <em>xxx.x</em></td></tr>
<tr><td align=center><kbd>$$</kbd></td>
<td>il carattere <kbd>$</kbd></td></tr>
<tr><td align=center><kbd>$a</kbd></td>
<td>un carattere a seconda del tipo di audio (nessuno: <code>n</code>,
mono: <code>m</code>, stereo: <code>t</code>)</td></tr>
<tr><td align=center><kbd>$t</kbd></td>
<td>numero traccia (nella playlist)</td></tr>
<tr><td align=center><kbd>$o</kbd></td>
<td>nomefile</td></tr>
<tr><td align=center><kbd>$f</kbd></td>
<td>nomefile in minuscolo</td></tr>
<tr><td align=center><kbd>$F</kbd></td>
<td>nomefile in maiuscolo</td></tr>
<tr><td align=center><kbd>$T</kbd></td>
<td>un carattere a seconda del tipo di stream (file: <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>
<td>il carattere "p" (se si sta leggendo un filmato e il font ha il carattere
"p")
</td></tr>
<tr><td align=center><kbd>$s</kbd></td>
<td>il carattere "s" (se non si sta leggendo un filmato e il font ha il carattere
"s")
</td></tr>
<tr><td align=center><kbd>$e</kbd></td>
<td>il carattere "e" (se il filmato è in pausa e il font ha il carattere
"e")
</td></tr>
<tr><td align=center><kbd>$x</kbd></td>
<td>larghezza del filmato
</td></tr>
<tr><td align=center><kbd>$y</kbd></td>
<td>altezza del filmato
</td></tr>
<tr><td align=center><kbd>$C</kbd></td>
<td>nome del codec utilizzato
</td></tr>
</table>
<em class="note"<b>Nota:</b> Le variabili <kbd>$a</kbd>, <kbd>$T</kbd>,
<kbd>$p</kbd>, <kbd>$s</kbd> e <kbd>$e</kbd> ritornano tutte caratteri che
dovrebbero essere visualizzati come simboli speciali (per esempio, "e" è per
il simbolo della pausa che di solito appare come <code>||</code>). Dovresti
avere un font per i caratteri normali e un altro per i simboli. Vedi la
sezione sui <a href="#symbols">simboli</a> per altre informazioni.</em>
</dd>
</dl>
<h3><a name="subwindow">D.2.2 Sotto finestra</a></h3>
<p>I seguenti oggetti possono essere usati nel blocco
'<code>window = sub</code>' .&nbsp;.&nbsp;. '<code>end</code>'.</p>
<dl>
<dt><a name="sub.base"><b><code>base = immagine, X, Y, larghezza, altezza
</code></b></a></dt>
<dd>L'immagine da visualizzare nella finestra. La finestra apparirà alla
posizione <code>X</code>, <code>Y</code> data sullo schermo (<code>0,0</code>
è l'angolo in alto a sinistra). Puoi specificare <code>-1</code> per centro e
<code>-2</code> per destra (<code>X</code>) e sotto (<code>Y</code>). La
finestra sarà grande quanto l'immagine. <code>larghezza</code> e
<code>altezza</code> danno la dimensione della finestra; sono opzionali (se
mancano, la finestra è grande quanto l'immagine).</dd>
<dt><a name="sub.background"><b><code>background = R, G, B</code></b></a></dt>
<dd>Permette di definire il colore di sfondo. Utile se l'immagine è più piccola
della finestra. <code>R</code>, <code>G</code> e <code>B</code> specificano le
componenti rossa, verde e blu del colore (ognuno è un numero decimale compreso
tra 0 e 255).</dd>
</dl>
<h3><a name="skinmenu">D.2.3 Menu della skin</a></h3>
<p>Come menzionato prima, il menu è visualizzato usando due immagini. Le
normali voci del menu sono prese dall'immagine specificata dall'oggetto
<code>base</code>, mentre la voce attualmente selezionata è presa dall'immagine
specificata dall'oggetto <code>selected</code>. Devi definire la posizione e la
dimensione di ogni voce del menu tramite l'oggetto <code>menu</code>.</p>
<p>Questi sono gli oggetti che possono essere usati nel blocco '<code>window =
menu</code>' .&nbsp;.&nbsp;. '<code>end</code>'.</p>
<dl>
<dt><a name="menu.base"><b><code>base = immagine</code></b></a></dt>
<dd>L'immagine delle normali voci del menu.</dd>
<dt><a name="menu.selected"><b><code>selected = immagine</code></b></a></dt>
<dd>L'immagine che mostra il menu con tutte le voci selezionate.</dd>
<dt><a name="menu.menu"><b><code>menu = X, Y, larghezza, altezza,
messaggio</code></b></a></dt>
<dd>Definisce la posizione <code>X</code>, <code>Y</xode> e la grandezza di
una voce del menu nelle immagini. <code>messaggio</code> è il messaggio da
generare quando il bottone del mouse è rilasciato sopra la voce.</dd>
</dl>
<h2><a name="fonts">D.3 Font</a></h2>
<p>Come detto nella sezione sulle varie parti di una skin, un font è definito
da un'immagine e un file di descrizione. Puoi mettere i caratteri ovunque
nell'immagine, ma assicurati che la loro posizione e dimensione sia data
esattamente nel file di descrizione.</p>
<p>Il file di descrizione del font (con estensione <code>.fnt</code>) può avere
linee di commento che iniziano con '<code>;</code>'. Il file deve avere una
linea nella forma</p>
<dl>
<dt><a name="font.image"><b><code>image = immagine</code></b></a></dt>
<dd>Dove <code>immagine</code> è il nome del file immagine da usare per il
font (non devi specificare l'estensione).</dd>
<dt><a name="font.char"><b><code>car = X, Y, l, a</code></b></a></dt>
<dd>Qui <code>X</code> e <code>Y</code> specificano la posizione del carattere
<code>car</code> nell'immagine (<code>0,0</code>) è l'angolo in alto a
sinistra). <code>l</code> e <code>a</code> sono le dimensioni del carattere in
pixel.</dd>
</dl>
<p>Questo esempio definisce i caratteri A, B, C usando <code>font.png</code>.</p>
<table width="100%" border=1>
<tr bgcolor=silver>
<td>
<pre>
; 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
</pre>
</td>
</tr>
</table>
<h3><a name="symbols">D.3..1 Simboli</a></h3>
<p>Alcuni caratteri hanno significati speciali quando ritornati da alcune
variabili usate in <a href="#main.dlabel">dlabel</a>; questi caratteri vengono
visualizzati come simboli in modo che code come il logo DVD possano essere
visualizzate invece del carattere 'd'.)</p>
<p>La tabella seguente elenca tutti i caratteri che possono essere usati per
visualizzare simboli (e quindi richiedono un font differente).</p>
<table align="center" border="1">
<tr><th align=center>Carattere</th><th align=left>Simbolo</th></tr>
<tr><td align=center><kbd>p</kbd></td>
<td align=left>play</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>pausa</td></tr>
<tr><td align=center><kbd>n</kbd></td>
<td align=left>muto</td></tr>
<tr><td align=center><kbd>m</kbd></td>
<td align=left>suono mono</td></tr>
<tr><td align=center><kbd>t</kbd></td>
<td align=left>suono stereo</td></tr>
<tr><td align=center><kbd>f</kbd></td>
<td align=left>lo stream è un file</td></tr>
<tr><td align=center><kbd>v</kbd></td>
<td align=left>lo stream è un video CD</td></tr>
<tr><td align=center><kbd>d</kbd></td>
<td align=left>lo stream è un DVD</td></tr>
<tr><td align=center><kbd>u</kbd></td>
<td align=left>lo stream è una URL</td></tr>
</table>
<h2><a name="guimsg">D.4 Messaggi della GUI</a></h2>
<p>Questi sono i messaggi che possono essere generati da bottoni, slider e voci
del menu.</p>
<p><em class="note"><b>Nota:</b> alcuni messaggi possono non funzionare come ci
si aspetta (o non funzionare del tutto). Come sai, la GUI è in sviluppo.</em></p>
<h3>Controllo riproduzione:</h3>
<blockquote>
<dl>
<dt><b>evNext</b></dt>
<dd>Salta alla prossima traccia della playlist.</dd>
<dt><b>evPause</b></dt>
<dd>Pausa la riproduzione.</dd>
<dt><b>evPauseSwitchToPlay</b></dt>
<dd>Forma un interruttore logico insieme a <code>evPlaySwitchToPause</code>.
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 <code>evPlaySwitchToPause</code> (ad
indicare che il bottone può essere premuto per continuare la riproduzione).</dd>
<dt><b>evPlay</b></dt>
<dd>Inizia la riproduzione.</dd>
<dt><b>evPlaySwitchToPause</b></dt>
<dd>L'opposto di <code>evPauseSwitchToPlay</code>. Questo messaggio inizia la
riproduzione ed è mostrata l'immagine per il bottone
<code>evPauseSwitchToPlay</code> (ad indicare che il bottone può essere
premuto per mettere in pausa).</dd>
<dt><b>evPrev</b></dt>
<dd>Salta alla traccia precedente nella playlist.</dd>
<dt><b>evStop</b></dt>
<dd>Ferma la riproduzione.</dd>
</dl>
</blockquote>
<h3>Ricerca nello stream:</h3>
<blockquote>
<dl>
<dt><b>evBackward10sec</b></dt>
<dt><b>evBackward1min</b></dt>
<dt><b>evBackward10min</b></dt>
<dd>Per andare indietro di 10 secondi / 1 minuto / 10 minuti.</dd>
<dt><b>evForward10sec</b></dt>
<dt><b>evForward1min</b></dt>
<dt><b>evForward10min</b></dt>
<dd>Per andare avanti di 10 secondi / 1 minuto / 10 minuti.</dd>
<dt><b>evSetMoviePosition</b></dt>
<dd>Per andare alla posizione (può essere usato da uno slider; è usato il
valore relativo (0-100%) dello slider).</dd>
</dl>
</blockquote>
<h3>Controllo video:</h3>
<blockquote>
<dl>
<dt><b>evDoubleSize</b></dt>
<dd>Raddoppia le dimensioni della finestra del filmato.</dd>
<dt><b>evFullScreen</b></dt>
<dd>Manda a pieno schermo e vice versa.</dd>
<dt><b>evNormalSize</b></dt>
<dd>Regola la finestra del filmato alle sue dimensioni normali.</dd>
</dl>
</blockquote>
<h3>Controllo audio:</h3>
<blockquote>
<dl>
<dt><b>evDecAudioBufDelay</b></dt>
<dd>Diminuisce il ritardo del buffer audio.</dd>
<dt><b>evDecBalance</b></dt>
<dd>Diminuisce il bilanciamento.</dd>
<dt><b>evDecVolume</b></dt>
<dd>Diminuisce il volume.</dd>
<dt><b>evIncAudioBufDelay</b></dt>
<dd>Aumenta il ritardo del buffer audio.</dd>
<dt><b>evIncBalance</b></dt>
<dd>Aumenta il bilanciamento.</dd>
<dt><b>evIncVolume</b></dt>
<dd>Aumenta il volume.</dd>
<dt><b>evMute</b></dt>
<dd>Regola il suono su muto e vice versa.</dd>
<dt><b>evSetBalance</b></dt>
<dd>Regola il bilanciamento (può essere usato da uno slider; è usato il valore
relativo (0-100%) dello slider).</dd>
<dt><b>evSetVolume</b></dt>
<dd>Regola il volume (può essere usato da uno slider; è usato il valore
relativo (0-100%) dello slider).</dd>
</dl>
</blockquote>
<h3>Vari:</h3>
<blockquote>
<dl>
<dt><b>evAbout</b></dt>
<dd>Apre la finestra "about".</dd>
<dt><b>evDropSubtitle</b></dt>
<dd>Disabilita il sottotitolo attualmente in uso.</dd>
<dt><b>evEqualizer</b></dt>
<dd>Accende/spegne l'equalizzatore.</dd>
<dt><b>evExit</b></dt>
<dd>Esce dal programma.</dd>
<dt><b>evIconify</b></dt>
<dd>Riduce ad icona la finestra.</dd>
<dt><b>evLoad</b></dt>
<dd>Carica un file (aprendo una finestra del file browser, dove puoi scegliere
un file).</dt>
<dt><b>evLoadPlay</b></dt>
<dd>Fa la stessa cosa di <code>evLoad</code>, ma inizia automaticamente la
riproduzione dopo il caricamento del file.</dd>
<dt><b>evLoadSubtitle</b></dt>
<dd>Carica un file di sottotitolo (con il fileselector)</dd>
<dt><b>evLoadAudioFile</b></dt>
<dd>Carica un file audio (con il fileselector)</dd>
<dt><b>evNone</b></dt>
<dd>Messaggio vuoto, non ha nessun effetto. (Eccetto forse nella versione CVS.
:-))</dd>
<dt><b>evPlaylist</b></dt>
<dd>Apre/chiude la finestra della playlist.</dd>
<dt><b>evPlayDVD</b></dt>
<dd>Prova a leggere il disco nel drive DVD-ROM dato.</dd>
<dt><b>evPlayVCD</b></dt>
<dd>Prova a leggere il disco nel drive CD-ROM dato.</dd>
<dt><b>evPreferences</b></dt>
<dd>Apre la finestra delle preferenze.</dd>
<dt><b>evSetAspect</b></dt>
<dd>Imposta le proporzioni dell'immagine mostrata.</dd>
<dt><b>evSetURL</b></dt>
<dd>Mostra la finestra di dialogo dell' URL.</dd>
<dt><b>evSkinBrowser</b></dt>
<dd>Apre la finestra dello skin browser.</dd>
</dl>
</blockquote>
</body>
</html>