Mercurial > mplayer.hg
annotate DOCS/it/skin.html @ 9644:0fe056bdb135
vop -> vf change, small fixes. The Polish documentation should be checked for correctness.
| author | jonas |
|---|---|
| date | Sat, 22 Mar 2003 12:02:27 +0000 |
| parents | a604236b0dd6 |
| children | b65bcfaedbe5 |
| rev | line source |
|---|---|
| 6462 | 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| 4867 | 2 <html> |
| 3 <head> | |
| 7509 | 4 <title>Creare Skin - MPlayer - Movie Player per Linux</title> |
| 6462 | 5 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| 4867 | 6 <title>MPlayer skin format</title> |
| 7 <style type="text/css"> | |
| 6462 | 8 body {font-family : Verdana, Arial, Helvetica, sans-serif; |
| 9 font-size : 14px; | |
| 10 background : white;} | |
| 11 em.note {color: green; | |
| 12 font-style: normal;} | |
| 13 em.warn {color: red; | |
| 14 font-style: normal;} | |
| 4867 | 15 </style> |
| 16 </head> | |
| 17 | |
| 6462 | 18 <body> |
| 4867 | 19 |
| 20 <h1 align="center">Formato skin di MPlayer</h1> | |
| 21 | |
| 22 <hr> | |
| 23 | |
| 24 <h2>Contenuti</h2> | |
| 25 | |
| 26 <ul type=disc> | |
| 27 <li><a href="#intro">1 Introduzione</a></li> | |
| 6462 | 28 <li><a href="#overview">2 Generale</a> |
| 4867 | 29 <ul type=circle> |
| 30 <li><a href="#dirs">2.1 Directory</a></li> | |
| 31 <li><a href="#images">2.2 Immagini</a></li> | |
| 32 <li><a href="#parts">2.3 Parti di una skin</a></li> | |
| 33 <li><a href="#files">2.4 File</a></li> | |
| 34 </ul> | |
| 6462 | 35 </li> |
| 36 <li><a href="#skin">3 Il file <code>skin</code></a> | |
| 4867 | 37 <ul type=circle> |
| 38 <li><a href="#mainwin">3.1 Finestra principale</a></li> | |
| 39 <li><a href="#subwindow">3.2 Sotto finestra</a></li> | |
| 40 <li><a href="#skinmenu">3.3 Menu della skin</a></li> | |
| 41 </ul> | |
| 6462 | 42 </li> |
| 43 <li><a href="#fonts">4 Font</a> | |
| 4867 | 44 <ul type=circle> |
| 45 <li><a href="#symbols">4.1 Simboli</a></li> | |
| 46 </ul> | |
| 6462 | 47 </li> |
| 48 <li><a href="#guimsg">Appendice A: messaggi della GUI</a> | |
| 4867 | 49 </ul> |
| 50 | |
| 51 <hr> | |
| 52 | |
| 53 <div align=center> | |
| 6462 | 54 Ultima modifica: 2002/05/24 |
| 4867 | 55 </div> |
| 56 | |
| 57 <hr> | |
| 58 | |
| 59 <h2><a name="intro">1 Introduzione</a></h2> | |
| 60 | |
| 8707 | 61 Il proposito di questo documento è di descrivere il formato delle skin di MPlayer. |
| 4961 | 62 Le informazioni qui contenute possono essere errate, in quanto <em>a)</em> non sono stato io |
| 4867 | 63 a scrivere la GUI, <em>b)</em> la GUI non è finita, <em>c)</em> posso |
| 64 sbagliarmi. Quindi non sorprenderti se qualcosa non funziona come descritto qui. | |
| 65 | |
| 66 <p> | |
| 67 Grazie a <em>Zoltán Ponekker</em> per il suo aiuto. | |
| 6462 | 68 </p> |
| 4867 | 69 <p> |
| 70 <em>András Mohari <mayday@freemail.hu></em> | |
| 6462 | 71 </p> |
| 4867 | 72 |
| 73 <h2><a name="overview">2 Generale</a></h2> | |
| 74 | |
| 75 Non ha niente a che fare col formato delle skin, ma dovresti sapere | |
| 8707 | 76 che MPlayer <b>non</b> include una skin, quindi <b>devi installare almeno |
| 6462 | 77 una skin per poter usare la GUI.</b> |
| 4867 | 78 |
| 79 | |
| 80 <h3><a name="dirs">2.1 Directory</a></h3> | |
| 81 | |
| 82 Le directory in cui si cerca per le skin sono (in ordine): | |
| 83 <pre> | |
| 6462 | 84 $(DATADIR)/Skin/ |
| 85 $(PREFIX)/share/mplayer/Skin/ | |
| 4867 | 86 ~/.mplayer/Skin/ |
| 87 </pre> | |
| 88 | |
| 89 <p> | |
| 8707 | 90 Nota che il primo path può variare a seconda di come è stato configurato MPlayer |
| 6462 | 91 (vedi gli argomenti <code>--datadir</code> e <code>--prefix</code> dello script <code>configure</code>). |
| 92 </p> | |
| 4867 | 93 |
| 94 Ogni skin è installata in una sua propria directory sotto una delle directory | |
| 95 elencate sopra, per esempio: | |
| 96 <pre> | |
| 6462 | 97 $(PREFIX)/share/mplayer/Skin/default/ |
| 4867 | 98 </pre> |
| 99 | |
| 100 | |
| 101 <h3><a name="images">2.2 Formati delle immagini</a></h3> | |
| 102 | |
| 8707 | 103 Le immagini devono essere PNG in truecolor (24 o 32 bpp). |
| 4867 | 104 |
| 105 <p> | |
| 106 Nella finestra principale (vedi sotto) puoi usare immagini con `trasparenze': | |
| 107 regioni riempite col colore #FF00FF (<font color="#FF00FF">magenta</font>) | |
| 8707 | 108 sono del tutto trasparenti quando viste con MPlayer. Questo significa che puoi anche ottenere |
| 4867 | 109 finestre con una certa forma se il tuo server X ha l'estensione XShape. |
| 6462 | 110 </p> |
| 4867 | 111 |
| 112 <h3><a name="parts">2.3 Parti di una skin</a></h3> | |
| 113 | |
| 114 Le skin sono del tutto in formato libero (non come le skin a formato fisso di | |
| 115 Winamp/XMMS, per esempio), quindi sta a te creare qualcosa di grandioso. | |
| 116 | |
| 117 <p> | |
| 118 Attualmente ci sono tre finestre da essere decorate: la | |
| 119 <a href="#mainwin">finestra principale</a>, la <a href="#subwindow">sotto finestra</a> e | |
| 120 il <a href="#skinmenu">menu della skin</a> (che può essere attivata con il tasto | |
| 121 destro). | |
| 6462 | 122 </p> |
| 4867 | 123 |
| 124 <ul> | |
| 125 <li> | |
| 8707 | 126 La <b>finestra principale</b> è dove puoi controllare MPlayer. Lo sfondo della |
| 4867 | 127 finestra è un'immagine. Vari oggetti possono (e devono) essere |
| 4961 | 128 piazzati nella finestra: <em>bottoni</em>, <em>slider</em> e <em>etichette</em>. |
| 4867 | 129 Per ogni oggetto, devi |
| 130 specificare la sua posizione e dimensione. | |
| 131 | |
| 132 <p> | |
| 133 Un <b>bottone</b> ha tre stati (premuto, rilasciato, | |
| 134 disabilitato), quindi la sua immagine deve essere divisa in tre parti verticalmente. | |
| 135 Vedi l'oggetto <a href="#main.button">bottone</a> per dettagli. | |
| 136 <p> | |
| 137 Uno <b>slider</b> (usati principalmente per la barra di ricerca e il controllo di volume/bilanciamento) | |
| 138 può avere qualsiasi numero di fasi dividendo la sua immagine in differenti parti | |
| 139 una sotto l'altra. | |
| 140 Vedi <a href="#main.hpotmeter">hslider</a> e | |
| 141 <a href="#main.potmeter">slider</a> per dettagli. | |
| 6462 | 142 </p> |
| 4867 | 143 |
| 144 <p> | |
| 145 Le <b>etichette</b> sono un po' speciali: i caratteri necessari a disegnarli sono presi | |
| 146 da un file immagine, e i caratteri nell'immagine sono descritti | |
| 147 da un <a href="#fonts">file per la descrizione del font</a>. | |
| 148 Questo è un normale file di testo che specifica | |
| 149 la posizione x,y e la dimensione di ogni carattere nell'immagine. (Quindi | |
| 150 il file d'immagine e il suo file di descrizione del font formano un font <em>insieme</em>.) | |
| 151 Vedi <a href="#main.dlabel">dlabel</a> e <a href="#main.slabel">slabel</a> | |
| 152 per dettagli. | |
| 6462 | 153 </p> |
| 4867 | 154 |
| 155 <p> | |
| 156 <em class=note> | |
| 157 <b>Nota:</b> tutte le immagini possono avere la piena trasparenza come descritto nella | |
| 158 sezione sui <a href="#images">formati immagine</a>. | |
| 159 </em> | |
| 6462 | 160 </p> |
| 4867 | 161 </li> |
| 162 | |
| 163 <li> | |
| 164 La <b>sotto finestra</b> è dove appare il filmato. Può mostrare una specifica immagine | |
| 165 se non c'è nessun video caricato (è noioso avere una finestra vuota | |
| 166 :-)) | |
| 167 <em class=note><b>Nota:</b> la trasparenza | |
| 168 <b>non è permessa</b> qui.</em> | |
| 169 </li> | |
| 170 | |
| 171 <li> | |
| 8707 | 172 Il <b>menu della skin</b> è solo un modo per controllare MPlayer per mezzo delle voci |
| 4867 | 173 del menu. Sono necessarie due immagini per il menu: una è l'immagine di base |
| 174 che mostra il menu nel suo stato normale, l'altra è usata per mostrare | |
| 175 le voci selezionate. Quando attivi il menu, viene mostrata la prima immagine. | |
| 176 Se muovi il mouse sulle voci del menu, la voce attualmente selezionata | |
| 6462 | 177 è copiata dalla seconda immagine sotto il puntatore del mouse |
| 178 (la seconda immagine non è mai mostrata interamente). | |
| 4867 | 179 <p> |
| 180 Una voce del menu è definita dalla sua posizione e dimensione nell'immagine (vedi la | |
| 181 sezione sul <a href="#skinmenu">menu della skin</a> per dettagli). | |
| 6462 | 182 </p> |
| 4867 | 183 </li> |
| 184 </ul> | |
| 185 | |
| 186 <p> | |
| 187 C'è una cosa importante non ancora menzionata: per far funzionare bottoni, slider e | |
| 8707 | 188 voci del menu, MPlayer deve sapere cosa fare se sono cliccati. |
| 4867 | 189 Questo è fatto tramite <a href="#guimsg">messaggi</a> (eventi). Per questi oggetti |
| 190 devi definire i messaggi che devono essere generati quando vengono attivati. | |
| 6462 | 191 </p> |
| 4867 | 192 <h3><a name="files">2.4 File</a></h3> |
| 193 | |
| 6462 | 194 Devi avere i seguenti file per fare una skin: |
| 4867 | 195 <ul> |
| 196 <li> | |
| 8707 | 197 Il file di configurazione chiamato <a href="#skin">skin</a> dice a MPlayer come |
| 4867 | 198 mettere insieme le diverse parti della skin e cosa fare se si clicca |
| 199 da qualche parte nella finestra. | |
| 200 </li> | |
| 201 <li>L'immagine di sfondo della finestra principale.</li> | |
| 202 <li>Immagini per gli oggetti della finestra principale (inclusi uno o più file di descrizione dei font | |
| 203 necessari per disegnare le etichette).</li> | |
| 204 <li>l'immagine da mostrare nella sotto finestra (opzionale).</li> | |
| 205 <li>Due immagini per il menu della skin (ne hai bisogno solo se vuoi creare un | |
| 6462 | 206 menu).</li> |
| 4867 | 207 </ul> |
| 208 | |
| 209 Con l'eccezione del file di configurazione della skin, puoi nominare gli altri file | |
| 210 come vuoi (ma nota che i file di descrizione dei font devono avere l'estensione | |
| 211 .fnt). | |
| 212 | |
| 213 | |
| 6462 | 214 <h2><a name="skin">3 Il file <code>skin</code></a></h2> |
| 4867 | 215 |
| 216 <p> | |
| 217 Come menzionato sopra, questo è il file di configurazione della skin. | |
| 218 E' orientato alla linea; le linee di commento iniziano col carattere '<code>;</code>' | |
| 219 all'inizio della linea (solo spazi e tab sono permessi prima del | |
| 220 '<code>;</code>'). | |
| 6462 | 221 </p> |
| 4867 | 222 |
| 223 <p> | |
| 224 Il file è fatto di sezioni. Ogni sezione descrive la skin per un'applicazione e | |
| 225 ha la seguente forma: | |
| 6462 | 226 </p> |
| 227 | |
| 4867 | 228 <table border=1 width="100%"><tr bgcolor=silver><td><pre> |
| 229 section = <i>nome sezione</i> | |
| 230 . | |
| 231 . | |
| 232 . | |
| 233 end | |
| 234 </pre></td></tr></table> | |
| 235 | |
| 236 <p> | |
| 237 Attualmente c'è solo una applicazione, quindi hai bisogno solo di una sezione: | |
| 238 il suo nome è <b>movieplayer</b>. | |
| 6462 | 239 </p> |
| 4867 | 240 |
| 241 <p> | |
| 242 Dentro questa sezione ogni finestra è descritta da un blocco nella seguente forma: | |
| 6462 | 243 </p> |
| 244 | |
| 4867 | 245 <table border=1 width="100%"><tr bgcolor=silver><td><pre> |
| 246 window = <i>nome finestra</i> | |
| 247 . | |
| 248 . | |
| 249 . | |
| 250 end | |
| 251 </pre></tr></td></table> | |
| 252 dove <i>nome finestra</i> può essere una di queste stringhe: | |
| 253 <ul> | |
| 254 <li><b>main</b> - per la finestra principale</li> | |
| 255 <li><b>sub</b> - per la sotto finestra</li> | |
| 256 <li><b>menu</b> - per il menu della skin</li> | |
| 257 </ul> | |
| 258 | |
| 259 <p> | |
| 260 (I blocchi sub e menu sono opzionali---non devi per forza creare un menu o decorare | |
| 261 la sotto finestra.) | |
| 6462 | 262 </p> |
| 4867 | 263 |
| 264 <p> | |
| 265 Dentro un blocco finestra, puoi definire ogni oggetto della finestra | |
| 266 con una linea in questa forma: | |
| 267 | |
| 6462 | 268 <dl> |
| 269 <dt> | |
| 270 <b><code>oggetto = parametro</code></b> | |
| 271 </dt> | |
| 272 <dd> | |
| 4867 | 273 |
| 4961 | 274 dove <i>oggetto</i> è una stringa che identifica il tipo di oggetto della GUI, |
| 4867 | 275 <i>parametro</i> è un valore numerico o testuale (o una lista di valori |
| 276 separati da virgole). | |
| 6462 | 277 </dd> |
| 278 </dl> | |
| 4867 | 279 |
| 280 <p> | |
| 281 mettendo insieme quanto sopra, l'intero file appare così: | |
| 6462 | 282 </p> |
| 4867 | 283 |
| 284 <table border=1 width="100%"><tr bgcolor=silver><td><pre> | |
| 285 section = movieplayer | |
| 286 window = main | |
| 287 ; ... oggetti della finestra principale ... | |
| 288 end | |
| 289 | |
| 290 window = sub | |
| 291 ; ... oggetti della sotto finestra ... | |
| 292 end | |
| 293 | |
| 294 window = menu | |
| 8707 | 295 ; ... oggetti del menu ... |
| 4867 | 296 end |
| 297 end | |
| 6462 | 298 </pre></td></tr></table> |
| 4867 | 299 |
| 300 <p> | |
| 301 Il nome di un file immagine deve essere dato senza il percorso--- | |
| 302 le immagini vengono cercate nella directory della skin. Puoi (ma non è necessario) | |
| 8707 | 303 specificare l'estensione del file. Se il file non esiste, MPlayer cerca di |
| 304 caricare il file <i><nomefile>.<est></i>, dove | |
| 305 <i>png</i> e <i>PNG</i> sono provati | |
| 4867 | 306 al posto di <i><est></i> (in questo ordine). Il primo file corrispondente sarà usato. |
| 307 | |
| 308 <p> | |
| 6462 | 309 Infine qualche parola sul posizionamento. La finestra principale e la sottofinestra possono |
| 310 essere posizionate in diversi angoli dello schermo impostando le coordinate <code>X</code> e | |
| 311 <code>Y</code>. <code>0</code> è in alto o sinistra, <code>-1</code> è | |
| 312 centro e <code>-2</code> è destra o in basso, come mostrato qui: | |
| 313 </p> | |
| 314 | |
| 315 <pre> | |
| 316 | |
| 317 (0, 0)----(-1, 0)----(-2, 0) | |
| 318 | | | | |
| 319 | | | | |
| 320 (0,-1)----(-1,-1)----(-2,-1) | |
| 321 | | | | |
| 322 | | | | |
| 323 (0,-2)----(-1,-2)----(-2,-2) | |
| 324 | |
| 325 </pre> | |
| 4867 | 326 |
| 327 <table border=1 cellpadding=5 width="100%"><tr bgcolor="#ffffcc"><td> | |
| 328 Ecco un esempio per rendere le cose chiare. Supponi di avere un'immagine chiamata | |
| 329 <i>main.png</i> che usi per la finestra principale: | |
| 330 <blockquote> | |
| 331 <pre> | |
| 332 base = main, -1, -1 | |
| 333 </pre> | |
| 334 </blockquote> | |
| 335 | |
| 8707 | 336 MPlayer cerca di caricare <i>main</i>, <i>main.png</i>, <i>main.PNG</i>, |
| 337 quindi verrà trovata <i>main.png</i>. | |
| 4867 | 338 <br> |
| 339 </td></tr></table> | |
| 340 | |
| 341 | |
| 342 <h3><a name="mainwin">3.1 Finestra principale</a></h3> | |
| 343 | |
| 344 Sotto puoi vedere la lista degli oggetti che possono essere usati nel blocco | |
| 345 '<code>window = main</code>' . . . '<code>end</code>' | |
| 346 | |
| 347 <dl> | |
| 348 <dt><a name="main.base"> | |
| 349 <b>base = <i>immagine, x, y</i></b> | |
| 350 </a></dt> | |
| 351 <dd> | |
| 352 Permette di specificare l'immagine di sfondo da usare per la finestra principale. | |
| 353 La finestra apparirà sullo schermo alla posizione <i>x</i>,<i>y</i> data | |
| 354 (0,0 è l'angolo in alto a sinistra). Puoi specificare -1 per il centro | |
| 355 e -2 per destra (x) e in basso (y). La finestra sarà larga quanto l'immagine. | |
| 356 <p> | |
| 357 <em class=warn> | |
| 358 <b>Avvertimento:</b> le zone trasparenti dell' immagine (colore #FF00FF) appaiono | |
| 8707 | 359 nere se il server X non supporta l'estensione XShape. La larghezza dell'immagine deve essere |
| 360 divisibile per 8. | |
| 4867 | 361 </em> |
| 6462 | 362 </div> |
| 4867 | 363 </dd> |
| 364 | |
| 365 <dt><a name="main.button"> | |
| 366 <b>button = <i>immagine, x, y, larghezza, altezza, messaggio</i></b></a></dt> | |
| 367 <dd> | |
| 368 Posiziona un bottone di dimensioni <i>larghezza</i> * <i>altezza</i> alla posizione | |
| 369 <i>x</i>,<i>y</i>. Il messaggio specificato è generato quando viene | |
| 370 cliccato il bottone. | |
| 371 L'immagine data da <i>immagine</i> deve avere tre parti una sotto l'altra | |
| 372 (secondo i possibili stati del bottone), in questo modo: | |
| 6462 | 373 <pre> |
| 4867 | 374 +------------+ |
| 375 | premuto | | |
| 376 +------------+ | |
| 377 | rilasciato | | |
| 378 +------------+ | |
| 379 |disabilitato| | |
| 380 +------------+ | |
| 6462 | 381 </pre> |
| 4867 | 382 </dd> |
| 383 | |
| 384 <dt><a name="main.decoration"> | |
| 385 <b>decoration = enable|disable</b> | |
| 386 </a></dt> | |
| 387 <dd> | |
| 388 Abilita o disabilita la decorazione della finestra principale. Il default | |
| 389 è <b>disable</b>. | |
| 390 </dd> | |
| 391 | |
| 392 <dt> | |
| 393 <a name="main.hpotmeter"> | |
| 394 <b> | |
| 6462 | 395 hpotmeter = <i>bott, lungb,altb, fasi, numfasi, default, x, y, lung, alt, msg</i> |
| 4867 | 396 </b> |
| 397 </a> | |
| 398 </dt> | |
| 399 <dd> | |
| 6462 | 400 Inserisce uno slider orizzontale di dimensioni <i>lung</i> * <i>alt</i> alla posizione |
| 4867 | 401 <i>x</i>,<i>y</i>. L'immagine può essere divisa in diverse parti |
| 402 per le diverse fasi dello slider (per esempio, | |
| 403 puoi avere uno slider per il controllo volume che cambia da verde a rosso | |
| 404 al cambiare del suo valore dal minimo al massimo.) | |
| 405 hpotmeter può avere un bottone che si può trascinare orizzontalmente. | |
| 406 I parametri sono: | |
| 407 <ul> | |
| 408 <li><i>bott</i> - l'immagine da usare per il bottone | |
| 409 (deve avere tre parti una sotto l'altra, come nel caso del | |
| 410 <a href="#main.button">bottone</a>)</li> | |
| 411 <li><i>lb</i>, <i>ab</i> - dimensione del bottone</li> | |
| 412 <li><i>fasi</i> - L'immagine da usare per le differenti fasi dello | |
| 413 slider. L'immagine deve essere divisa in <i>numfasi</i> parti verticalmente | |
| 414 (vedi sotto). Può essere usato un valore speciale <kbd>NULL</kbd> se non vuoi | |
| 415 l'immagine. | |
| 416 </li> | |
| 417 <li><i>numfasi</i> - numero di fasi inserite nell'immagine <i>fasi</i> | |
| 418 </li> | |
| 419 <li><i>default</i> - valore di default dello slider (da 0 a | |
| 420 100)</li> | |
| 421 <li><i>x</i>, <i>y</i> - posizione dello slider</li> | |
| 422 <li><i>l</i>, <i>a</i> - larghezza e altezza dello slider</li> | |
| 423 <li><i>msg</i> - il messaggio da generare quando viene cambiato il valore dello | |
| 424 slider</li> | |
| 425 </ul> | |
| 426 L'immagine usata per le differenti fasi deve essere più o meno così: | |
| 427 <div align=center><table border=0><tr><td><pre><small> | |
| 428 +------------+ | |
| 429 | fase #1 | | |
| 430 +------------+ | |
| 431 | fase #2 | | |
| 432 +------------+ | |
| 433 ... | |
| 434 +------------+ | |
| 435 | fase #n | | |
| 436 +------------+ | |
| 437 </small></pre></td></tr></table></div> | |
| 438 <em class=note> | |
| 439 <b>Nota:</b> ci sarà anche un oggetto vpotmeter, ma non è ancora stato | |
| 440 implementato. | |
| 441 </em> | |
| 6462 | 442 </dd> |
| 4867 | 443 |
| 444 <dt><a name="main.potmeter"> | |
| 445 <b>potmeter = <i>fasi, numfasi, default, x, y, l, a, msg</i></b> | |
| 446 </a></dt> | |
| 447 <dd> | |
| 448 Uno slider senza bottone. (Penso sia inteso per essere girato, | |
| 449 ma reagisce solo al trascinamento orizzontale.) | |
| 450 Per la descrizione dei parametri vedi | |
| 451 <a href="#main.hpotmeter">hpotmeter</a>. <i>fasi</i> può essere | |
| 452 <code>NULL</code>, ma è proprio inutile, infatti non puoi vedere dove | |
| 453 è situato lo slider. | |
| 454 </dd> | |
| 455 | |
| 456 <dt><a name="main.font"> | |
| 457 <b>font = <i>filefont, fontid</i></b> | |
| 458 </a></dt> | |
| 459 <dd> | |
| 460 Definisce un font. <i>filefont</i> è il nome di un file che descrive un font | |
| 461 con estensione <code>.fnt</code> (<b>non c'è bisogno</b> di specificare l'estensione | |
| 462 qui). | |
| 463 <i>fontid</i> è usato per riferirsi al font | |
| 464 (vedi <a href="#main.dlabel">dlabel</a> e <a href="#main.slabel">slabel</a>). | |
| 465 Possono essere definiti fino a 25 font. | |
| 466 </dd> | |
| 467 | |
| 468 <dt><a name="main.dlabel"> | |
| 469 <b>dlabel = <i>x, y, lunghezza, allineamento, fontid, "testo"</i></b> | |
| 470 </a></dt> | |
| 471 <dd> | |
| 472 Posiziona una etichetta dinamica in <i>x</i>,<i>y</i>. L'etichetta è detta | |
| 473 dinamica perchè il suo testo è aggiornato periodicamente. | |
| 474 La lunghezza massima dell'etichetta è data da <i>lunghezza</i> (la sua altezza è quella di un | |
| 475 carattere). | |
| 476 Se il testo da visualizzare è più largo, allora sarà fatto | |
| 477 ruotare, altrimenti è allineato nello spazio specificato tramite il valore | |
| 478 del parametro <i>allineamento</i>: 0 per destra, 1 per centro, | |
| 479 2 per sinistra. | |
| 480 <br> | |
| 481 Il testo da mostrare è dato da <i>testo</i>: deve essere scritto tra | |
| 482 virgolette (<code>"</code>) (ma le <code>"</code> non possono essere parte del | |
| 483 testo). L'etichetta è visualizzata usando il font identificato da <i>fontid</i>. | |
| 484 Puoi usare le seguenti variabili nel testo. | |
| 485 | |
| 486 <div align=center> | |
| 487 <table valign=top border=1> | |
| 488 <tr align=center><th>Variabile</th><th align=left>Significato</th></tr> | |
| 489 <tr><td align=center><kbd>$1</kbd></td> | |
| 490 <td>tempo in formato <em>hh:mm:ss</em></td></tr> | |
| 491 <tr><td align=center><kbd>$2</kbd></td> | |
| 492 <td>tempo in formato <em>mmmm:ss</em></td></tr> | |
| 493 <tr><td align=center><kbd>$3</kbd></td> | |
| 494 <td>tempo in formato <em>hh</em> (ore)</td></tr> | |
| 495 <tr><td align=center><kbd>$4</kbd></td> | |
| 496 <td>tempo in formato <em>mm</em> (minuti)</td></tr> | |
| 497 <tr><td align=center><kbd>$5</kbd></td> | |
| 498 <td>tempo in formato <em>ss</em> (secondi)</td></tr> | |
| 499 <tr><td align=center><kbd>$6</kbd></td> | |
| 500 <td>lunghezza filmato nel formato <em>hh:mm:ss</em></td></tr> | |
| 501 <tr><td align=center><kbd>$7</kbd></td> | |
| 502 <td>lunghezza filmato nel formato <em>mmmm:ss</em></td></tr> | |
| 503 <tr><td align=center><kbd>$8</kbd></td> | |
| 504 <td>tempo in formato <em>h:mm:ss</em></td></tr> | |
| 505 <tr><td align=center><kbd>$v</kbd></td> | |
| 506 <td>volume in formato <em>xxx.xx%</em></td></tr> | |
| 507 <tr><td align=center><kbd>$V</kbd></td> | |
| 508 <td>volume in formato <em>xxx.x</em></td></tr> | |
| 509 <tr><td align=center><kbd>$b</kbd></td> | |
| 510 <td>bilanciamento in formato <em>xxx.xx%</em></td></tr> | |
| 511 <tr><td align=center><kbd>$B</kbd></td> | |
| 512 <td>bilanciamento in formato <em>xxx.x</em></td></tr> | |
| 513 <tr><td align=center><kbd>$$</kbd></td> | |
| 514 <td>il carattere <kbd>$</kbd></td></tr> | |
| 515 <tr><td align=center><kbd>$a</kbd></td> | |
| 516 <td>un carattere a seconda del tipo di audio (nessuno: <code>n</code>, | |
| 517 mono: <code>m</code>, stereo: <code>t</code>)</td></tr> | |
| 518 <tr><td align=center><kbd>$t</kbd></td> | |
| 519 <td>numero traccia (nella playlist)</td></tr> | |
| 520 <tr><td align=center><kbd>$o</kbd></td> | |
| 521 <td>nomefile</td></tr> | |
| 522 <tr><td align=center><kbd>$f</kbd></td> | |
| 523 <td>nomefile in minuscolo</td></tr> | |
| 524 <tr><td align=center><kbd>$F</kbd></td> | |
| 525 <td>nomefile in maiuscolo</td></tr> | |
| 526 <tr><td align=center><kbd>$T</kbd></td> | |
| 527 <td>un carattere a seconda del tipo di stream (file: <code>f</code>, | |
| 528 video CD: <code>v</code>, DVD: <code>d</code>, URL: <code>u</code>) | |
| 529 </td></tr> | |
| 530 <tr><td align=center><kbd>$p</kbd></td> | |
| 531 <td>il carattere "p" (se si sta leggendo un filmato e il font ha il carattere | |
| 532 "p") | |
| 533 </td></tr> | |
| 534 <tr><td align=center><kbd>$s</kbd></td> | |
| 535 <td>il carattere "s" (se non si sta leggendo un filmato e il font ha il carattere | |
| 536 "s") | |
| 537 </td></tr> | |
| 538 <tr><td align=center><kbd>$e</kbd></td> | |
| 539 <td>il carattere "e" (se il filmato è in pausa e il font ha il carattere | |
| 540 "e") | |
| 541 </td></tr> | |
| 8707 | 542 <tr><td align=center><kbd>$x</kbd></td> |
| 543 <td>larghezza del filmato | |
| 544 </td></tr> | |
| 545 <tr><td align=center><kbd>$y</kbd></td> | |
| 546 <td>altezza del filmato | |
| 547 </td></tr> | |
| 548 <tr><td align=center><kbd>$C</kbd></td> | |
| 549 <td>nome del codec utilizzato | |
| 550 </td></tr> | |
| 4867 | 551 </table></div> |
| 552 <p> | |
| 553 <b>Nota:</b> Le variabili <kbd>$a</kbd>, <kbd>$T</kbd>, <kbd>$p</kbd>, <kbd>$s</kbd> | |
| 554 e <kbd>$e</kbd> ritornano tutte caratteri che dovrebbero essere visualizzati | |
| 555 come simboli speciali (per esempio, "e" è per il simbolo della pausa che di solito | |
| 556 appare come <code>||</code>). Dovresti avere un font per i caratteri normali | |
| 557 e un altro per i simboli. | |
| 558 Vedi la sezione sui <a href="#symbols">simboli</a> per altre informazioni. | |
| 559 </dd> | |
| 560 </dl> | |
| 561 | |
| 562 <dl> | |
| 563 <dt><a name="main.slabel"> | |
| 564 <b>slabel = <i>x, y, fontid, testo</i></b> | |
| 565 </a></dt> | |
| 566 <dd> | |
| 567 Posiziona una etichetta statica in <i>x</i>,<i>y</i>. | |
| 568 Il <i>testo</i> è visualizzato usando il font identificato da <i>fontid</i>. | |
| 569 Il testo è una pura stringa (le variabili $x non funzionano) che deve essere racchiuso | |
| 570 tra virgolette (le <code>"</code> non possono essere parte del testo). | |
| 571 | |
| 572 </dd> | |
| 573 </dl> | |
| 574 | |
| 575 | |
| 576 <h3><a name="subwindow">3.2 Sotto finestra</a></h3> | |
| 577 | |
| 578 I seguenti oggetti possono essere usati nel blocco | |
| 579 '<code>window = sub</code>' . . . '<code>end</code>'. | |
| 580 | |
| 581 <dl> | |
| 582 <dt><a name="sub.base"> | |
| 583 <b>base = <i>immagine, x, y, larghezza, altezza</i></b> | |
| 584 </a></dt> | |
| 585 <dd> | |
| 586 L'immagine da visualizzare nella finestra. | |
| 587 La finestra apparirà alla posizione <i>x</i>,<i>y</i> data | |
| 588 sullo schermo (0,0 è l'angolo in alto a sinistra). Puoi specificare -1 per centro | |
| 4961 | 589 e -2 per destra (x) e sotto (y). La finestra sarà grande quanto l'immagine. |
| 4867 | 590 <i>larghezza</i> e <i>altezza</i> danno la dimensione della finestra; sono opzionali |
| 591 (se mancano, la finestra è grande quanto l'immagine). | |
| 592 </dd> | |
| 593 </dl> | |
| 594 | |
| 595 <dl> | |
| 596 <dt><a name="sub.background"> | |
| 597 <b>background = <i>r, g, b</i></b> | |
| 598 </a></dt> | |
| 599 <dd> | |
| 600 Permette di definire il colore di sfondo. Utile se l'immagine è più piccola della | |
| 601 finestra. | |
| 602 <i>r</i>, <i>g</i> e <i>b</i> specificano le componenti rossa, verde e blu | |
| 603 del colore (ognuno è un numero decimale compreso tra 0 e 255). | |
| 604 </dd> | |
| 605 </dl> | |
| 606 | |
| 607 | |
| 608 <h3><a name="skinmenu">3.3 Menu della skin</a></h3> | |
| 609 | |
| 4961 | 610 Come menzionato prima, il menu è visualizzato usando due immagini. |
| 4867 | 611 Le normali voci del menu sono prese dall'immagine specificata dall'oggetto <i>base</i>, |
| 612 mentre la voce attualmente selezionata è presa dall'immagine specificata dall'oggetto | |
| 613 <i>selected</i>. | |
| 614 Devi definire la posizione e la dimensione di ogni voce del menu tramite l'oggetto <i>menu</i>. | |
| 615 | |
| 616 | |
| 617 <p> | |
| 618 Questi sono gli oggetti che possono essere usati nel blocco '<code>window = menu</code>' | |
| 619 . . . '<code>end</code>'. | |
| 620 | |
| 621 <dl> | |
| 622 <dt><a name="menu.base"> | |
| 623 <b>base = <i>immagine</i></b> | |
| 624 </a></dt> | |
| 625 <dd> | |
| 626 L'immagine delle normali voci del menu. | |
| 627 </dl> | |
| 628 </dd> | |
| 629 | |
| 630 <dl> | |
| 631 <dt><a name="menu.selected"> | |
| 632 <b>selected = <i>immagine</i></b> | |
| 633 </a></dt> | |
| 634 <dd> | |
| 635 L'immagine che mostra il menu con tutte le voci selezionate. | |
| 636 </dd> | |
| 637 </dl> | |
| 638 | |
| 639 <dl> | |
| 640 <dt><a name="menu.menu"> | |
| 641 <b>menu = <i>x, y, larghezza, altezza, messaggio</i></b> | |
| 642 </a></dt> | |
| 643 <dd> | |
| 644 Definisce la posizione <i>x</i>,<i>y</i> e la grandezza di una voce del menu nelle | |
| 645 immagini. <i>messaggio</i> è il messaggio da generare quando | |
| 646 il bottone del mouse è rilasciato sopra la voce. | |
| 647 </dd> | |
| 648 </dl> | |
| 649 | |
| 650 | |
| 651 <h2><a name="fonts">4 Font</a></h2> | |
| 652 | |
| 653 Come detto nella sezione sulle varie parti di una skin, un font è definito da | |
| 654 un'immagine e un file di descrizione. | |
| 655 Puoi mettere i caratteri ovunque nell'immagine, ma assicurati | |
| 656 che la loro posizione e dimensione sia data esattamente nel file di descrizione. | |
| 657 | |
| 658 <p> | |
| 659 Il file di descrizione del font (con estensione .fnt) può avere linee di commento | |
| 660 che iniziano con '<code>;</code>'. | |
| 661 Il file deve avere una linea nella forma | |
| 662 <blockquote> | |
| 663 <pre> | |
| 664 image = <i>immagine</i> | |
| 665 </pre> | |
| 666 </blockquote> | |
| 667 | |
| 668 <p> | |
| 669 dove <i>immagine</i> è il nome del file immagine da usare per | |
| 670 il font (non devi specificare l'estensione). | |
| 671 La linea sopra è seguita dalle linee di definizione del carattere nella forma: | |
| 672 | |
| 673 <blockquote> | |
| 674 <pre> | |
| 675 "<i>car</i>" = <i>x, y, l, a</i> | |
| 676 </pre> | |
| 677 </blockquote> | |
| 678 | |
| 679 <p> | |
| 680 Qui <i>x</i> e <i>y</i> specificano la posizione del carattere | |
| 681 <i>car</i> nell'immagine (0,0 è l'angolo in alto a sinistra). | |
| 682 <i>l</i> e <i>a</i> sono la larghezza e l'altezza del carattere | |
| 683 (in pixel, naturalmente). | |
| 684 | |
| 685 <p> | |
| 686 Ecco un esempio che definisce i caratteri A, B, C usando font.png. | |
| 687 <table width="100%" border=1><tr bgcolor=silver><td><pre> | |
| 688 ; può essere "font" invece di "font.png" | |
| 689 image = font.png | |
| 690 | |
| 691 ; Tre caratteri sono abbastanza solo per una dimostrazione. :-) | |
| 692 "A" = 0,0, 7,13 | |
| 693 "B" = 7,0, 7,13 | |
| 694 "C" = 14,0, 7,13 | |
| 695 </pre></td></tr></table> | |
| 696 | |
| 697 | |
| 698 <h3><a name="symbols">4.1 Simboli</a></h3> | |
| 699 | |
| 700 Alcuni caratteri hanno significati speciali quando ritornati da alcune variabili | |
| 701 usate in | |
| 702 <a href="#main.dlabel">dlabel</a>; questi caratteri vengono visualizzati | |
| 703 come simboli. (Per esempio, in caso di un flusso DVD, si può visualizzare | |
| 704 un bel logo DVD invece del carattere 'd'.) | |
| 705 | |
| 706 <p> | |
| 707 La tabella seguente elenca tutti i caratteri che possono essere usati per visualizzare | |
| 708 simboli (e quindi richiedono un font differente). | |
| 709 | |
| 710 <div align=center> | |
| 711 <table> | |
| 712 <tr><th align=center>Carattere</th><th align=left>Simbolo</th></tr> | |
| 713 <tr><td align=center><kbd>p</kbd></td> | |
| 714 <td align=left>play</td></tr> | |
| 715 <tr><td align=center><kbd>s</kbd></td> | |
| 716 <td align=left>stop</td></tr> | |
| 717 <tr><td align=center><kbd>e</kbd></td> | |
| 718 <td align=left>pausa</td></tr> | |
| 719 <tr><td align=center><kbd>n</kbd></td> | |
| 720 <td align=left>muto</td></tr> | |
| 721 <tr><td align=center><kbd>m</kbd></td> | |
| 722 <td align=left>suono mono</td></tr> | |
| 723 <tr><td align=center><kbd>t</kbd></td> | |
| 724 <td align=left>suono stereo</td></tr> | |
| 725 <tr><td align=center><kbd>f</kbd></td> | |
| 726 <td align=left>lo stream è un file</td></tr> | |
| 727 <tr><td align=center><kbd>v</kbd></td> | |
| 728 <td align=left>lo stream è un video CD</td></tr> | |
| 729 <tr><td align=center><kbd>d</kbd></td> | |
| 730 <td align=left>lo stream è un DVD</td></tr> | |
| 731 <tr><td align=center><kbd>u</kbd></td> | |
| 732 <td align=left>lo stream è una URL</td></tr> | |
| 733 </table> | |
| 734 </div> | |
| 735 | |
| 736 | |
| 737 <h2><a name="guimsg">Appendice A: messaggi della GUI</a></h2> | |
| 738 | |
| 739 Questi sono i messaggi che possono essere generati da bottoni, slider e | |
| 740 voci del menu. | |
| 741 | |
| 742 <p> | |
| 743 <em class=note> | |
| 744 <b>Nota:</b> alcuni messaggi possono non funzionare come ci si aspetta (o non | |
| 745 funzionare del tutto). Come sai, la GUI è in sviluppo.</em> | |
| 746 | |
| 747 <p> | |
| 748 <i>Controllo riproduzione:</i> | |
| 749 <blockquote> | |
| 750 <dl> | |
| 751 <dt><b>evNext</b> | |
| 752 <dd>Salta alla prossima traccia della playlist. | |
| 753 | |
| 754 <dt><b>evPause</b> | |
| 755 <dd>Pausa la riproduzione. | |
| 756 | |
| 757 <dt><b>evPauseSwitchToPlay</b> | |
| 758 <dd>Forma un interruttore logico insieme a <i>evPlaySwitchToPause</i>. Possono essere usati | |
| 759 per avere un bottone comune di play/pausa. Entrambi i messaggi dovrebbero venire assegnati | |
| 760 a bottoni visualizzati nella stessa posizione della finestra. Questo | |
| 761 messaggio mette in pausa la riproduzione e viene mostrata l'immagine per il bottone <i>evPlaySwitchToPause</i> | |
| 762 (ad indicare che il bottone può essere premuto per continuare la riproduzione). | |
| 763 | |
| 764 <dt><b>evPlay</b> | |
| 765 <dd>Inizia la riproduzione. | |
| 766 | |
| 767 <dt><b>evPlaySwitchToPause</b> | |
| 768 <dd>L'opposto di <i>evPauseSwitchToPlay</i>. Questo messaggio inizia la riproduzione | |
| 769 ed è mostrata l'immagine per il bottone <i>evPauseSwitchToPlay</i> (ad | |
| 770 indicare che il bottone può essere premuto per mettere in pausa). | |
| 771 | |
| 772 <dt><b>evPrev</b> | |
| 773 <dd>Salta alla traccia precedente nella playlist. | |
| 774 | |
| 775 <dt><b>evStop</b> | |
| 776 <dd>Ferma la riproduzione. | |
| 777 </dl> | |
| 778 </blockquote> | |
| 779 | |
| 780 <p> | |
| 781 <i>Ricerca nello stream:</i> | |
| 782 <blockquote> | |
| 783 <dl> | |
| 784 <dt><b>evBackward10sec</b> | |
| 785 <dt><b>evBackward1min</b> | |
| 786 <dt><b>evBackward10min</b> | |
| 787 <dd>Per andare indietro di 10 secondi / 1 minuto / 10 minuti. | |
| 788 | |
| 789 <dt><b>evForward10sec</b> | |
| 790 <dt><b>evForward1min</b> | |
| 791 <dt><b>evForward10min</b> | |
| 792 <dd>Per andare avanti di 10 secondi / 1 minuto / 10 minuti. | |
| 793 | |
| 794 <dt><b>evSetMoviePosition</b> | |
| 795 <dd>Per andare alla posizione (può essere usato da uno slider; è usato il valore | |
| 796 relativo (0-100%) dello slider). | |
| 797 </dl> | |
| 798 </blockquote> | |
| 799 | |
| 800 <p> | |
| 801 <i>Controllo video:</i> | |
| 802 <blockquote> | |
| 803 <dl> | |
| 804 <dt><b>evDoubleSize</b> | |
| 805 <dd>Raddoppia le dimensioni della finestra del filmato. | |
| 806 | |
| 807 <dt><b>evFullScreen</b> | |
| 808 <dd>Manda a pieno schermo e vice versa. | |
| 809 | |
| 810 <dt><b>evNormalSize</b> | |
| 811 <dd>Regola la finestra del filmato alle sue dimensioni normali. | |
| 812 </dl> | |
| 813 </blockquote> | |
| 814 | |
| 815 <p> | |
| 816 <i>Controllo audio:</i> | |
| 817 <blockquote> | |
| 818 <dl> | |
| 819 <dt><b>evDecAudioBufDelay</b> | |
| 820 <dd>Diminuisce il ritardo del buffer audio. | |
| 821 | |
| 822 <dt><b>evDecBalance</b> | |
| 823 <dd>Diminuisce il bilanciamento. | |
| 824 | |
| 825 <dt><b>evDecVolume</b> | |
| 826 <dd>Diminuisce il volume. | |
| 827 | |
| 828 <dt><b>evIncAudioBufDelay</b> | |
| 829 <dd>Aumenta il ritardo del buffer audio. | |
| 830 | |
| 831 <dt><b>evIncBalance</b> | |
| 832 <dd>Aumenta il bilanciamento. | |
| 833 | |
| 834 <dt><b>evIncVolume</b> | |
| 835 <dd>Aumenta il volume. | |
| 836 | |
| 837 <dt><b>evMute</b> | |
| 838 <dd>Regola il suono su muto e vice versa. | |
| 839 | |
| 840 <dt><b>evSetBalance</b> | |
| 841 <dd>Regola il bilanciamento (può essere usato da uno slider; è usato il valore | |
| 842 relativo (0-100%) dello slider). | |
| 843 | |
| 844 <dt><b>evSetVolume</b> | |
| 845 <dd>Regola il volume (può essere usato da uno slider; è usato il valore | |
| 846 relativo (0-100%) dello slider). | |
| 847 </dl> | |
| 848 </blockquote> | |
| 849 | |
| 850 <p> | |
| 851 <i>Vari:</i> | |
| 852 <blockquote> | |
| 853 <dl> | |
| 854 <dt><b>evAbout</b> | |
| 855 <dd>Apre la finestra "about". | |
| 856 | |
| 8707 | 857 <dt><b>evDropSubtitle</b> |
| 858 <dd>Disabilita il sottotitolo attualmente in uso. | |
| 859 | |
|
6548
e56e991d2ee7
EvEqualeaser --> EvEqualizer, since Atmos just committed my typo fix.
diego
parents:
6462
diff
changeset
|
860 <dt><b>evEqualizer</b> |
| 4867 | 861 <dd>Accende/spegne l'equalizzatore. |
| 862 | |
| 863 <dt><b>evExit</b> | |
| 864 <dd>Esce dal programma. | |
| 865 | |
| 866 <dt><b>evIconify</b> | |
| 867 <dd>Riduce ad icona la finestra. | |
| 868 | |
| 869 <dt><b>evLoad</b> | |
| 870 <dd>Carica un file (aprendo una finestra del file browser, dove puoi scegliere | |
| 871 un file). | |
| 872 | |
| 873 <dt><b>evLoadPlay</b> | |
| 874 <dd>Fa la stessa cosa di <i>evLoad</i>, ma inizia automaticamente la riproduzione | |
| 875 dopo il caricamento del file. | |
| 876 | |
| 8707 | 877 <dt><b>evLoadSubtitle</b> |
| 878 <dd>Carica un file di sottotitolo (con il fileselector) | |
| 879 | |
| 880 <dt><b>evLoadAudioFile</b> | |
| 881 <dd>Carica un file audio (con il fileselector) | |
| 882 | |
| 4867 | 883 <dt><b>evNone</b> |
| 884 <dd>Messaggio vuoto, non ha nessun effetto. (Eccetto forse nella versione CVS. :-)) | |
| 885 | |
| 886 <dt><b>evPlayList</b> | |
| 887 <dd>Apre/chiude la finestra della playlist. | |
| 888 | |
| 8707 | 889 <dt><b>evPlayDVD</b> |
| 890 <dd>Prova a leggere il disco nel drive DVD-ROM dato. | |
| 891 | |
| 892 <dt><b>evPlayVCD</b> | |
| 893 <dd>Prova a leggere il disco nel drive CD-ROM dato. | |
| 894 | |
| 4867 | 895 <dt><b>evPreferences</b> |
| 896 <dd>Apre la finestra delle preferenze. | |
| 897 | |
| 8707 | 898 <dt><b>evSetAspect</b> |
| 899 <dd>Imposta le proporzioni dell'immagine mostrata. | |
| 900 | |
| 901 <dt><b>evSetURL</b> | |
| 902 <dd>Mostra la finestra di dialogo dell' URL. | |
| 903 | |
| 4867 | 904 <dt><b>evSkinBrowser</b> |
| 905 <dd>Apre la finestra dello skin browser. | |
| 906 </dl> | |
| 907 </blockquote> | |
| 908 | |
| 909 </body> | |
| 910 </html> |