6556
|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
1981
|
2 <html>
|
|
3 <head>
|
6556
|
4 <LINK REL="stylesheet" TYPE="text/css" HREF="../default.css">
|
1981
|
5 <meta http-equiv=Content-Type content="text/html; charset=iso-8859-2">
|
|
6 <title>MPlayer skin formátum</title>
|
|
7 <style type="text/css">
|
|
8 em.note {color: green}
|
|
9 em.warn {color: red}
|
|
10 </style>
|
|
11 </head>
|
|
12
|
6556
|
13 <body>
|
1981
|
14
|
|
15 <h1 align="center">MPlayer skin formátum</h1>
|
|
16
|
|
17 <hr>
|
|
18
|
|
19 <h2>Tartalom</h2>
|
|
20
|
|
21 <ul type=disc>
|
|
22 <li><a href="#intro">1. Bevezető</a></li>
|
|
23 <li><a href="#overview">2. Áttekintés</a></li>
|
|
24 <ul type=circle>
|
|
25 <li><a href="#dirs">2.1. Könyvtárak</a></li>
|
|
26 <li><a href="#images">2.2. Képformátumok</a></li>
|
|
27 <li><a href="#parts">2.3. A skin részei</a></li>
|
|
28 <li><a href="#files">2.4. Fájlok</a></li>
|
|
29 </ul>
|
|
30 <li><a href="#skin">3. A <code>skin</code> fájl</a></li>
|
|
31 <ul type=circle>
|
|
32 <li><a href="#mainwin">3.1. Főablak</a></li>
|
|
33 <li><a href="#subwindow">3.2. Lejátszóablak</a></li>
|
|
34 <li><a href="#skinmenu">3.3. Skin menü</a></li>
|
|
35 </ul>
|
|
36 <li><a href="#fonts">4. Fontok</a></li>
|
|
37 <ul type=circle>
|
|
38 <li><a href="#symbols">4.1. Szimbólumok</a></li>
|
|
39 </ul>
|
|
40 <li><a href="#guimsg">A. függelék: GUI üzenetek</a></li>
|
|
41 </ul>
|
|
42
|
|
43 <hr>
|
|
44
|
|
45 <div align=center>
|
|
46 Utolsó módosítás: 2001. szeptember 9.
|
|
47 </div>
|
|
48
|
|
49 <hr>
|
|
50
|
|
51 <h2><a name="intro">1. Bevezető</a></h2>
|
|
52
|
|
53 Ez a kis leírás arról szól, hogy milyen is egy MPlayer skin formátuma.
|
|
54 Nincs rá garancia, hogy minden úgy van, ahogy itt leírtam, egyrészt mert
|
|
55 nem én írtam a GUI-t, másrészt mert a GUI még nincs kész, harmadrészt pedig
|
|
56 azért, mert én is tévedhetek. Szóval ne lepődj meg, ha valami nem úgy van,
|
|
57 ahogy itt szerepel.
|
|
58
|
|
59 <p>
|
|
60 Köszönet <em>Ponekker Zoltánnak</em> a segítségéért.
|
|
61
|
|
62 <p>
|
|
63 <em>Mohari András <mayday@freemail.hu></em>
|
|
64
|
|
65
|
|
66 <h2><a name="overview">2. Áttekintés</a></h2>
|
|
67
|
|
68 Nem tartozik szorosan a témához, de nem árt tudni, hogy
|
|
69 <em>az MPlayernek <b>nincs</b> beépített skinje, ezért <b>legalább
|
|
70 egy skint telepíteni kell</b> a GUI használatához.
|
|
71 </em>
|
|
72
|
|
73 <h3><a name="dirs">2.1. Könyvtárak</a></h3>
|
|
74
|
|
75 <p>
|
|
76 A skineket a következő könyvtárakban (és a megadott sorrendben)
|
|
77 keresi a program:
|
|
78 <pre>
|
8319
|
79 $(DATADIR)/Skin/
|
|
80 $(PREFIX)/share/mplayer/Skin/
|
8307
|
81 ~/.mplayer/Skin/
|
1981
|
82 </pre>
|
|
83
|
|
84 <p>
|
8307
|
85 A második könyvtár más is lehet, attól függően, hogy hogyan volt konfigurálva
|
1981
|
86 az MPlayer (lásd a <code>configure</code> script <code>--datadir</code>
|
|
87 kapcsolóját).
|
|
88
|
|
89 <p>
|
|
90 Az előbbi könyvtárak alatt minden skin a saját könyvtárába kerül, például:
|
|
91 <pre>
|
|
92 /usr/local/share/mplayer/Skin/default/
|
|
93 </pre>
|
|
94
|
|
95
|
|
96 <h3><a name="images">2.2. Képformátumok</a></h3>
|
|
97
|
8307
|
98 A skinhez használt képek trucolor (24 vagy 32 bit/pixel) PNG
|
|
99 formátumban lehetnek.
|
1981
|
100
|
|
101 <p>
|
|
102 A főablakban (lásd alább) teljesen "átlátszó" részeket tartalmazó képeket
|
|
103 is lehet használni: az átlátszónak szánt területeket az #FF00FF
|
|
104 (<font color="#FF00FF">lila</font>) színnel kell megjelölni. Ez azt jelenti,
|
|
105 hogy a főablak akár "formára vágott" is lehet, ha az X szervereden van
|
|
106 XShape támogatás.
|
|
107
|
|
108
|
|
109 <h3><a name="parts">2.3. A skin részei</a></h3>
|
|
110
|
|
111 A skin felépítése meglehetősen szabad (ellentétben például a Winamp/XMMS
|
|
112 fix felépítésű skinjével), így csak rajtad múlik, hogy mit hozol ki belőle.
|
|
113
|
|
114 <p>
|
|
115 Jelenleg három "bőrözhető" ablak van: a <a href="#mainwin">főablak</a>,
|
|
116 a <a href="#subwindow">lejátszóablak</a> és a <a href="#skinmenu">skin menü</a>
|
|
117 (utóbbi a jobb gomb lenyomásával jeleníthető meg).
|
|
118
|
|
119 <ul>
|
|
120 <li>
|
|
121 Az MPlayert a <b>főablakból</b> lehet irányítani. Az ablak alapját egy
|
|
122 kép adja, erre lesznek rárajzolva a különféle elemek:
|
|
123 <em>gombok</em>, <em>potméterek</em> és <em>címkék</em>.
|
|
124 Természetesen minden elemhez tartozik egy kép, aminek kirajzolásához meg
|
|
125 kell adni a méretét és az ablakon belüli helyét.
|
|
126
|
|
127 <p>
|
|
128 Egy <b>gombnak</b> három állapota van (lenyomott, felengedett, letiltott),
|
|
129 így a gomb képe ennek megfelelően három egymás alatti részből áll.
|
|
130 Részletekért lásd a <a href="#main.button">button</a> elem leírását.
|
|
131 <p>
|
|
132 Egy <b>potméter</b> (ez főleg pozícionáláshoz és hangerő/balansz állításhoz
|
|
133 használatos) képe több különböző fázisból állhat, így a potméterhez
|
|
134 készített kép szintén egymás alatti részekből áll.
|
|
135 Részletekért lásd a <a href="#main.hpotmeter">hpotmeter</a> és a
|
|
136 <a href="#main.potmeter">potmeter</a> elemet.
|
|
137
|
|
138 <p>
|
|
139 A <b>címkék</b> némileg különlegesek, ugyanis a kirajzolásukhoz szükséges
|
|
140 karakterek egy képről származnak, amin belül az egyes karakterek helyét
|
|
141 és méretét egy szöveges <a href="#fonts">fontleíró fájl</a> segítségével kell
|
|
142 megadni. A címkékről részletesen a <a href="#main.dlabel">dlabel</a> és
|
|
143 <a href="#main.slabel">slabel</a> elemnél olvashatsz.
|
|
144
|
|
145 <p>
|
|
146 <em class=note>
|
|
147 <b>Megjegyzés:</b> a főablak rajzolásához használt képek tartalmazhatnak
|
|
148 teljesen átlátszó részeket, ahogy arról a
|
8307
|
149 <a href="#images">képformátumoknál</a> már szó volt. Ha az X Server nem tartalmazza az XShape bővitményt, akkor
|
|
150 az átlátszónak megjelölt részek fekete színüek lesznek. Ha ezt ki szeretnéd használni, akkor a main ablak hátter
|
|
151 képének szélességének oszthatónak kell lennie nyolccal.
|
1981
|
152 </em>
|
|
153 </li>
|
|
154
|
|
155 <li>
|
|
156 A <b>lejátszóablakban</b> lesz lejátszva a film. Ha nincs
|
|
157 betöltve film, akkor meg lehet jeleníteni benne egy előre megadott képet
|
|
158 (hogy ne legyen olyan üres :-)).
|
|
159 <em class=note>
|
|
160 <b>Megjegyzés:</b> ezen a képen az átlátszóság nincs megengedve.
|
|
161 </em>
|
|
162 </li>
|
|
163
|
|
164 <li>
|
|
165 A <b>skin menü</b> egy újabb módja az MPlayer irányításának, csak éppen
|
|
166 menüpontok segítségével. Kirajzolásához két képre van szükség:
|
|
167 az egyik a normál, a másik pedig a kijelölt menüpontokból felépített menüt
|
|
168 adja. Amikor a menü
|
|
169 megjelenik, akkor az első kép lesz kirajzolva. Ha az egeret egy menüpont fölé
|
|
170 viszed, akkor annak az egy menüpontnak a kijelölt képe a második képről rá
|
|
171 lesz másolva az ablakban levő képre.
|
|
172 (A lényeg tehát az, hogy a második kép sohasem
|
|
173 jelenik meg teljes egészében, hanem mindig csak egy menüpontja lesz
|
|
174 kirajzolva.)
|
|
175 <p>
|
|
176 A menüpontokat a képeken belüli helyükkel és méretükkel kell definiálni
|
|
177 (lásd a <a href="#skinmenu">skin menüről</a> szóló részt).
|
|
178 </li>
|
|
179 </ul>
|
|
180
|
|
181 <p>
|
|
182 Egy fontos dologról még nem esett szó: a gombok, potméterek és menüpontok
|
|
183 működéséhez az MPlayernek tudnia kell, hogy mit is csináljon, ha rájuk
|
|
184 kattintasz. Ez <a href="#guimsg">üzenetek</a> (események) segítségével
|
|
185 valósul meg. Az előbb említett elemekhez mindig meg kell adni azt az üzenetet,
|
|
186 amit majd a kattintásra generálnak.
|
|
187
|
|
188
|
|
189 <h3><a name="files">2.4. Fájlok</a></h3>
|
|
190
|
|
191 A fentiek ismeretében egy skinhez az alábbi fájlok szükségesek.
|
|
192 <ul>
|
|
193 <li>
|
|
194 A skin összerakása a <a href="#skin">skin</a> nevű konfigurációs fájl
|
|
195 segítségével történik. Ez adja meg az MPlayernek, hogy miként állítsa elő az
|
|
196 egyes részekből a képernyőn az ablak képét, illetve hogy mit csináljon,
|
|
197 ha kattintasz valahová az ablakban.
|
|
198 </li>
|
|
199 <li>A főablak hátterének képe.</li>
|
|
200 <li>
|
|
201 A főablak egyes elemeinek képei, beleértve a címkék rajzolásához szükséges
|
|
202 fontleíró fájlokat is.
|
|
203 </li>
|
|
204 <li>A lejátszóablakban megjelenített kép (nem kötelező).</li>
|
|
205 <li>A menühöz tartozó két kép (nem kötelezőek, ha nem készítesz menüt).</li>
|
|
206 </ul>
|
|
207
|
|
208 A <code>skin</code> fájl kivételével az összes fájlt úgy nevezed el,
|
|
209 ahogy csak akarod (de a fontleíró fájloknak .fnt kiterjesztésűeknek kell
|
|
210 lenniük).
|
|
211
|
|
212 <h2><a name="skin">3. A <code><b>skin</b></code> fájl</a></h2>
|
|
213
|
|
214 Amint fentebb írtam, ez a skin konfigurációs fájl.
|
|
215 A fájl sor-orientált; megjegyzéseket a "<code>;</code>" karakterrel lehet
|
|
216 kezdeni a sor elején (legfeljebb szóközök és tab karakterek lehetnek
|
|
217 a "<code>;</code>" előtt).
|
|
218
|
|
219 <p>
|
|
220 A fájl egy vagy több szekcióból áll, ahol minden szekció egy alkalmazás
|
|
221 leírására szolgál, és a következőképpen néz ki:
|
|
222 <table border=1 width="100%"><tr bgcolor=silver><td><pre>
|
|
223 section = <i>szekciónév</i>
|
|
224 .
|
|
225 .
|
|
226 .
|
|
227 end
|
|
228 </pre></td></tr></table>
|
|
229
|
|
230 <p>
|
|
231 Jelenleg csak egyetlen alkalmazás van, így csak egy szekciót kell megadni:
|
|
232 ennek neve <b>movieplayer</b>.
|
|
233
|
|
234 <p>
|
|
235 Ezen a szekción belül az MPlayer minden egyes ablakához az alábbi formájú
|
|
236 leíró blokkok tartoznak:
|
|
237 <table border=1 width="100%"><tr bgcolor=silver><td><pre>
|
|
238 window = <i>ablaknév</i>
|
|
239 .
|
|
240 .
|
|
241 .
|
|
242 end
|
8144
|
243 </pre></td></tr></table>
|
1981
|
244 Az <i>ablaknév</i> a következők valamelyike lehet:
|
|
245 <ul>
|
|
246 <li><b>main</b> - a főablak</li>
|
|
247 <li><b>sub</b> - a lejátszóablak</li>
|
|
248 <li><b>menu</b> - a skin menü</li>
|
|
249 </ul>
|
|
250
|
|
251 <p>
|
|
252 (A lejátszóablak és a menü blokkja el is hagyható, ha nincs szükséged
|
|
253 rájuk.)
|
|
254
|
|
255 <p>
|
|
256 A blokkon belül az ablak minden egyes elemét ilyen sorok adják meg:
|
|
257
|
|
258 <blockquote>
|
|
259 <pre>
|
|
260 elem = paraméter
|
|
261 </pre>
|
|
262 </blockquote>
|
|
263
|
|
264 <p>
|
|
265 Az <i>elem</i> egy rögzített név,
|
|
266 a <i>paraméter</i> pedig egy numerikus vagy szöveges érték (vagy vesszőkkel
|
|
267 elválasztott értéklista).
|
|
268
|
|
269 <p>
|
|
270 A fentiek együtt valahogy így néznek ki:
|
|
271
|
|
272 <p>
|
|
273 <table border=1 width="100%"><tr bgcolor=silver><td><pre>
|
|
274 section = movieplayer
|
|
275 window = main
|
|
276 ; ... a főablak elemei ...
|
|
277 end
|
|
278
|
|
279 window = sub
|
|
280 ; ... a lejátszóablak elemei ...
|
|
281 end
|
|
282
|
|
283 window = menu
|
8307
|
284 ; ... a menü elemei ...
|
1981
|
285 end
|
|
286 end
|
8144
|
287 </pre></td></tr></table>
|
1981
|
288
|
|
289 <p>
|
|
290 Végezetül néhány szó az elemekhez rendelt képek megadásáról.
|
|
291 <br>
|
8307
|
292 A fájlok nevét könyvtárak nélkül kell megadni, ugyanis a képeket a skin file
|
1981
|
293 könyvtárában keresi az MPlayer. A fájlok kiterjesztése elhagyható.
|
|
294 Ha a megadott
|
|
295 fájl nem létezik, akkor az MPlayer megpróbálja betölteni a
|
|
296 <i><fájlnév>.<kit></i> nevű fájlt, ahol a <i><kit></i>
|
8307
|
297 helyére a <i>png</i>
|
|
298 vagy <i>PNG</i> végződést helyezi (a megadott sorrendben). Az első létező fájlt
|
1981
|
299 fogja betölteni.
|
|
300
|
|
301 <p>
|
|
302
|
|
303 <table border=1 cellpadding=5 width="100%"><tr bgcolor="#ffffcc"><td>
|
|
304 Itt egy példa, hogy mindez világosabb legyen. Tegyük fel, hogy a
|
|
305 <i>main.png</i> lesz a főablak háttere, amit így adsz meg:
|
|
306 <blockquote>
|
|
307 <pre>
|
|
308 base = main, -2, -2
|
|
309 </pre>
|
|
310 </blockquote>
|
|
311
|
8307
|
312 Ennek hatására az MPlayer megpróbálja betölteni a <i>main</i>, <i>main.png</i>,
|
|
313 majd a <i>main.PNG<i> fájlt, így végül megtalálja a
|
1981
|
314 <i>main.png</i>-t.
|
|
315 </td></tr></table>
|
|
316
|
|
317
|
|
318 <h3><a name="mainwin">3.1. A főablak</a></h3>
|
|
319
|
|
320 Az alábbiakban a "<code>window = main</code>" . . .
|
|
321 "<code>end</code>" blokkban használható elemek leírása következik.
|
|
322
|
|
323 <dl>
|
|
324 <dt><a name="main.base">
|
|
325 <b>base = <i>kép, x, y</i></b>
|
|
326 </a></dt>
|
|
327 <dd>
|
|
328 Ezzel kell megadni a főablak hátteréül szolgáló képet. Az
|
|
329 <i>x</i>,<i>y</i> az ablak helyét adja meg a képernyőn
|
|
330 (0,0 a képernyő bal felső
|
|
331 sarka). Értékük igazításra is használható: a -1 középre, a
|
|
332 -2 pedig jobbra (x) illetve alulra (y) igazítást jelent.
|
|
333 <p>
|
|
334 <em class=warn>
|
|
335 <b>Figyelem:</b> a képen az átlátszónak megjelölt területek (#FF00FF színűek)
|
8307
|
336 feketék lesznek az XShape támogatás nélküli X szervereken. A kép szélességének oszthatónak kell lennie nyolccal.
|
1981
|
337 </em>
|
|
338 </dd>
|
|
339 </dl>
|
|
340
|
|
341 <dl>
|
|
342 <dt><a name="main.button">
|
|
343 <b>button = <i>kép, x, y, szél, mag, üzenet</i></b></a></dt>
|
|
344 <dd>
|
|
345 Egy <i>szél</i> * <i>mag</i> pixel méretű nyomógombot helyez az ablak
|
|
346 <i>x</i>,<i>y</i> pozíciójába. A gomb lenyomáskor a megadott
|
|
347 <i>üzenet</i>et generálja.
|
|
348 A <i>kép</i> paraméterrel megadott képnek három egymás alatti részből kell
|
|
349 állnia a gomb három lehetséges állapotának megfelelően, valahogy így:
|
|
350 <div align=center><table><tr><td><pre><small>
|
|
351 +---------------+
|
|
352 | lenyomott |
|
|
353 +---------------+
|
|
354 | felengedett |
|
|
355 +---------------+
|
|
356 | letiltott |
|
|
357 +---------------+
|
|
358 </small></pre></td></tr></table></div>
|
|
359 </dd>
|
|
360 </dl>
|
|
361
|
|
362 <dl>
|
|
363 <dt><a name="main.decoration">
|
|
364 <b>decoration = enable|disable</b>
|
|
365 </a></dt>
|
|
366 <dd>
|
|
367 Engedélyezi (<b>enable</b>) vagy tiltja (<b>disable</b>) az ablakkezelőnek
|
|
368 a főablak dekorációját. Alapértelmezés szerint a dekoráció le van tiltva.
|
|
369 </dd>
|
|
370 </dl>
|
|
371
|
|
372 <dl>
|
|
373 <dt>
|
|
374 <a name="main.hpotmeter">
|
|
375 <b>
|
|
376 hpotmeter = <i>gomb, gsz, gm, fáziskép, fázisok, alap, x, y, sz, m, üzenet</i>
|
|
377 </b>
|
|
378 </a>
|
|
379 </dt>
|
|
380 <dd>
|
|
381 Egy <i>sz</i> * <i>m</i> pixel méretű vízszintes potmétert
|
|
382 ("csúszkát") helyez az ablak <i>x</i>,<i>y</i> pozíciójába.
|
|
383 A potméter képe több fázisból állhat (például a hangerő potmétere lehet egy
|
|
384 zöldből vörösbe tartó színátmenet, ahogy a potmétert minimumról maximumra
|
|
385 húzzák). A potméternek van egy gombja is, amit végig lehet húzni a potméter
|
|
386 hossza mentén.
|
|
387 A paraméterek jelentése:
|
|
388 <ul>
|
|
389 <li><i>gomb</i> - a hpotmeter gombjának képe
|
|
390 (ugyanúgy három egymás alatti részből kell állnia, mint a
|
|
391 <a href="#main.button">button</a> elem képének)</li>
|
|
392 <li><i>gsz</i>, <i>gm</i> - a gomb szélessége és magassága</li>
|
|
393 <li><i>fáziskép</i> - A hpotmeter egyes fázisait tartalmazó kép, ami
|
|
394 a <i>fázisok</i> paraméter által adott számú egymás alatti részből áll
|
|
395 (lásd lent).
|
|
396 Ha nincs szükséged fázisképre, akkor azt a <kbd>NULL</kbd> érték megadásával
|
|
397 jelezheted.
|
|
398 </li>
|
|
399 <li><i>fázisok</i> - a fázisok száma a <i>fáziskép</i> által adott
|
|
400 képen</li>
|
|
401 <li><i>alap</i> - a hpotmeter kezdőértéke (0-tól 100-ig)</li>
|
|
402 <li><i>x</i>, <i>y</i> - a hpotmeter pozíciója az ablakban</li>
|
|
403 <li><i>sz</i>, <i>m</i> - a hpotmeter szélessége és magassága</li>
|
|
404 <li><i>üzenet</i> - a hpotmeter értékének megváltozásakor generált
|
|
405 üzenet</li>
|
|
406 </ul>
|
|
407 Az egyes fázisokat tartalmazó képnek valahogy így kell kinéznie:
|
|
408 <div align=center><table border=0><tr><td><pre><small>
|
|
409 +-----------------+
|
|
410 | 1. fázis képe |
|
|
411 +-----------------+
|
|
412 | 2. fázis képe |
|
|
413 +-----------------+
|
|
414 . .
|
|
415 +-----------------+
|
|
416 | n. fázis képe |
|
|
417 +-----------------+
|
|
418 </small></pre></td></tr></table></div>
|
|
419 <em class=note>
|
|
420 <b>Megjegyzés:</b> a hpotmeter-nek lesz párja is (vpotmeter), de az jelenleg
|
|
421 még nincs kész.
|
|
422 </em>
|
|
423 </dd>
|
|
424 </dl>
|
|
425
|
|
426 <dl>
|
|
427 <dt><a name="main.potmeter">
|
|
428 <b>potmeter = <i>fáziskép, fázisok, alap, x, y, sz, m, üzenet</i></b>
|
|
429 </a></dt>
|
|
430 <dd>
|
|
431 Ez egy gomb nélküli potméter. (Azt hiszem, forgatható akar
|
|
432 lenni, de jelenleg csak a vízszintes irányú húzásra reagál.)
|
|
433 A paraméterek jelentését lásd a
|
|
434 <a href="#main.hpotmeter">hpotmeter-nél</a>.
|
|
435 A <i>fáziskép</i> itt is lehet <code>NULL</code>, de elég furcsán
|
|
436 mutat, ha nem látod a potméter állását (hiszen gombja nincs)...
|
|
437
|
|
438 </dd>
|
|
439 </dl>
|
|
440
|
|
441 <dl>
|
|
442 <dt><a name="main.font">
|
|
443 <b>font = <i>fontfájl, fontazon</i></b>
|
|
444 </a></dt>
|
|
445 <dd>
|
|
446 Egy fontot definiál. A <i>fontfájl</i> egy <code>.fnt</code> kiterjesztésű
|
|
447 szöveges fontleíró fájl neve (a kiterjesztést itt <b>nem kell</b> megadni).
|
|
448 A <i>fontazon</i> a későbbiekben a font azonosítására szolgál
|
|
449 (lásd a <a href="#main.dlabel">dlabel</a> és
|
|
450 <a href="#main.slabel">slabel</a> elemet).
|
|
451 Maximum 25 font definiálható.
|
|
452 </dd>
|
|
453 </dl>
|
|
454
|
|
455 <dl>
|
|
456 <dt><a name="main.dlabel">
|
|
457 <b>dlabel = <i>x, y, hossz, igazítás, fontazon, "szöveg"</i></b>
|
|
458 </a></dt>
|
|
459 <dd>
|
|
460 Egy dinamikus címkét helyez az <i>x</i>,<i>y</i> pozícióba.
|
|
461 A címke attól dinamikus, hogy a tartalma periodikusan frissítve van.
|
|
462 A <i>hossz</i> a címke maximális hosszát adja pixelben (magassága
|
|
463 egy karakternyi). Ha a címke szövege hosszabb ennél,
|
|
464 akkor az adott területen belül folyamatosan görgetve lesz. Ha rövidebb, akkor
|
|
465 az <i>igazítás</i> paraméter értéke szerint lesz igazítva a területen
|
|
466 belül: 0 esetén jobbra, 1 esetén középre, 2 esetén balra.
|
|
467 <br>
|
|
468 A <i>szöveg</i> paraméter adja a címke szövegét, amit kötelező dupla
|
|
469 idézőjelek (<code>"</code>) közé írni (ám jelenleg a <code>"</code> nem
|
|
470 lehet része a szövegnek). A megjelenítés a <i>fontazon</i> által
|
|
471 azonosított fonttal történik. A címke szövegében az alább
|
|
472 felsorolt változók is használhatók.
|
|
473 <div align=center>
|
8144
|
474 <table border=1>
|
1981
|
475 <tr align=center><th>Változó</th><th align=left>Jelentése</th></tr>
|
|
476 <tr><td align=center><kbd>$1</kbd></td>
|
|
477 <td>lejátszás ideje <em>hh:mm:ss</em> formában</td></tr>
|
|
478 <tr><td align=center><kbd>$2</kbd></td>
|
|
479 <td>lejátszás ideje <em>mmmm:ss</em> formában</td></tr>
|
|
480 <tr><td align=center><kbd>$3</kbd></td>
|
|
481 <td>lejátszás ideje <em>hh</em> formában (órák)</td></tr>
|
|
482 <tr><td align=center><kbd>$4</kbd></td>
|
|
483 <td>lejátszás ideje <em>mm</em> formában (percek)</td></tr>
|
|
484 <tr><td align=center><kbd>$5</kbd></td>
|
|
485 <td>lejátszás ideje <em>ss</em> formában (másodpercek)</td></tr>
|
|
486 <tr><td align=center><kbd>$6</kbd></td>
|
|
487 <td>film hossza <em>hh:mm:ss</em> formában</td></tr>
|
|
488 <tr><td align=center><kbd>$7</kbd></td>
|
|
489 <td>film hossza <em>mmmm:ss</em> formában</td></tr>
|
|
490 <tr><td align=center><kbd>$8</kbd></td>
|
|
491 <td>lejátszás ideje <em>h:mm:ss</em> formában</td></tr>
|
|
492 <tr><td align=center><kbd>$v</kbd></td>
|
|
493 <td>hangerő <em>xxx.xx%</em> formában</td></tr>
|
|
494 <tr><td align=center><kbd>$V</kbd></td>
|
|
495 <td>hangerő <em>xxx.x</em> formában</td></tr>
|
|
496 <tr><td align=center><kbd>$b</kbd></td>
|
|
497 <td>balansz <em>xxx.xx%</em> formában</td></tr>
|
|
498 <tr><td align=center><kbd>$B</kbd></td>
|
|
499 <td>balansz <em>xxx.x</em> formában</td></tr>
|
|
500 <tr><td align=center><kbd>$$</kbd></td>
|
|
501 <td>a <kbd>$</kbd> karakter</td></tr>
|
|
502 <tr><td align=center><kbd>$a</kbd></td>
|
|
503 <td>egy karakter a hang fajtájának megfelelően (nincs: <code>n</code>,
|
|
504 mono: <code>m</code>, sztereó: <code>t</code>)</td></tr>
|
|
505 <tr><td align=center><kbd>$t</kbd></td>
|
|
506 <td>track száma (a lejátszólistában)</td></tr>
|
|
507 <tr><td align=center><kbd>$o</kbd></td>
|
|
508 <td>fájlnév</td></tr>
|
|
509 <tr><td align=center><kbd>$f</kbd></td>
|
|
510 <td>fájlnév csupa kisbetűvel</td></tr>
|
|
511 <tr><td align=center><kbd>$F</kbd></td>
|
|
512 <td>fájlnév csupa nagybetűvel</td></tr>
|
|
513 <tr><td align=center><kbd>$T</kbd></td>
|
|
514 <td>egy karakter a stream típusának megfelelően (fájl: <code>f</code>,
|
|
515 video CD: <code>v</code>, DVD: <code>d</code>, URL: <code>u</code>)
|
|
516 </td></tr>
|
|
517 <tr><td align=center><kbd>$p</kbd></td>
|
|
518 <td>a "p" karakter, ha a lejátszás folyamatban van, és a
|
|
519 font tartalmazza a "p" karaktert</td></tr>
|
|
520 <tr><td align=center><kbd>$s</kbd></td>
|
|
521 <td>az "s" karakter, ha a lejátszás le van állítva, és a
|
|
522 font tartalmazza az "s" karaktert</td></tr>
|
|
523 <tr><td align=center><kbd>$e</kbd></td>
|
|
524 <td>az "e" karakter, ha a lejátszás szünetel, és a font
|
|
525 tartalmazza az "e" karaktert</td></tr>
|
8307
|
526 <tr><td align=center><kbd>$x</kbd></td>
|
|
527 <td>a film szélessége</td></tr>
|
|
528 <tr><td align=center><kbd>$y</kbd></td>
|
|
529 <td>a film magassága</td></tr>
|
|
530 <tr><td align=center><kbd>$C</kbd></td>
|
|
531 <td>a használt codec neve</td></tr>
|
1981
|
532 </table></div>
|
|
533 <p>
|
|
534 <b>Megjegyzés:</b> a <kbd>$a</kbd>, <kbd>$T</kbd>, <kbd>$p</kbd>, <kbd>$s</kbd>
|
|
535 és <kbd>$e</kbd> változók lehetővé teszik, hogy az általuk visszaadott
|
|
536 karakterekkel különleges szimbólumokat jeleníts meg (például az "e"
|
|
537 karakterrel a szünet jelét, ami többnyire valami ilyesmi: <code>||</code>).
|
|
538 Ezeknek a szimbólumoknak célszerű külön fontot készíteni. Lásd a
|
|
539 <a href="#symbols">szimbólumokról</a> szóló részt.
|
|
540 </dd>
|
|
541 </dl>
|
|
542
|
|
543 <dl>
|
|
544 <dt><a name="main.slabel">
|
|
545 <b>slabel = <i>x, y, fontazon, "szöveg"</i></b>
|
|
546 </a></dt>
|
|
547 <dd>
|
|
548 Egy állandó szövegű címkét jelenít meg az <i>x</i>,<i>y</i>
|
|
549 pozícióban. A <i>szöveg</i> egy "sima" szöveg
|
|
550 ($x formájú változók itt nem működnek), amit dupla idézőjelek közé kell írni
|
|
551 (jelenleg a <code>"</code> nem lehet a szöveg része).
|
|
552 A címke a <i>fontazon</i> által azonosított fonttal lesz megjelenítve.
|
|
553 </dd>
|
|
554 </dl>
|
|
555
|
|
556
|
|
557 <h3><a name="subwindow">3.2. Lejátszóablak</a></h3>
|
|
558
|
|
559 A "<code>window = sub</code>" . . . "<code>end</code>" blokkban
|
|
560 az alább felsorolt elemek használhatók.
|
|
561
|
|
562 <dl>
|
|
563 <dt><a name="sub.base">
|
|
564 <b>base = <i>kép, x, y, szélesség, magasság</i></b>
|
|
565 </a></dt>
|
|
566 <dd>
|
|
567 Ezzel tudod megadni az ablakban megjelenítendő képet. Az
|
|
568 <i>x</i> és <i>y</i> paraméter az ablak pozícióját adja a képernyőn
|
|
569 (0,0 a bal felső sarok). Értéke igazításra is használható: a -1 középre
|
|
570 igazít, a -2 pedig jobbra (x) illetve alulra (y).
|
|
571 A <i>szélesség</i> és <i>magasság</i> az ablak méretét adja; akár el
|
|
572 is hagyhatók (ilyenkor az ablak mérete megegyezik a kép méretével).
|
|
573 </dd>
|
|
574 </dl>
|
|
575
|
|
576 <dl>
|
|
577 <dt><a name="sub.background">
|
|
578 <b>background = <i>r, g, b</i></b>
|
|
579 </a></dt>
|
|
580 <dd>
|
|
581 Ezzel tudod beállítani az ablak háttérszínét. Akkor hasznos, ha az ablak
|
|
582 nagyobb a megjelenített képnél.
|
|
583 Az <i>r</i>, <i>g</i>, <i>b</i> a szín vörös, zöld, kék
|
|
584 összetevőjét adja meg (mindegyik egy decimális szám 0-tól 255-ig).
|
|
585 </dd>
|
|
586 </dl>
|
|
587
|
|
588
|
|
589 <h3><a name="skinmenu">3.3. Skin menü</a></h3>
|
|
590
|
|
591 Amint arról már szó volt, a menü két kép segítségével van kirajzolva.
|
|
592 A menü alapját a <i>base</i> elem képe adja, míg a kijelölt menüpont a
|
|
593 <i>selected</i> elem képéről lesz a háttérre rajzolva. Egy menüpont
|
|
594 képen belüli pozícióját és méretét a <i>menu</i> elem adja meg.
|
|
595
|
|
596 <p>
|
|
597 A "<code>window = menu</code>" . . . "<code>end</code>" blokkban
|
|
598 az alább felsorolt elemek használhatók.
|
|
599
|
|
600 <dl>
|
|
601 <dt><a name="menu.base">
|
|
602 <b>base = <i>kép</i></b>
|
|
603 </a></dt>
|
|
604 <dd>
|
|
605 A normál menü képe.
|
8144
|
606 </dd>
|
1981
|
607 </dl>
|
|
608
|
|
609 <dl>
|
|
610 <dt><a name="menu.selected">
|
|
611 <b>selected = <i>kép</i></b>
|
|
612 </a></dt>
|
|
613 <dd>
|
|
614 A kép, amin az összes menüpont kijelölt állapotban van.
|
|
615 </dd>
|
|
616 </dl>
|
|
617
|
|
618 <dl>
|
|
619 <dt><a name="menu.menu">
|
|
620 <b>menu = <i>x, y, szélesség, magasság, üzenet</i></b>
|
|
621 </a></dt>
|
|
622 <dd>
|
|
623 Megadja egy menüpont képen belüli <i>x</i>,<i>y</i> pozícióját
|
|
624 és méretét. Ha az egérgombot felengeded a menüpont felett, akkor az
|
|
625 <i>üzenet</i> paraméterben megadott üzenetet generálja.
|
|
626 </dd>
|
|
627 </dl>
|
|
628
|
|
629
|
|
630 <h2><a name="fonts">4. Fontok</a></h2>
|
|
631
|
|
632 A skin részeiről szóló pontban már említettem, hogy egy font az egyes
|
|
633 karakterek
|
|
634 előre megrajzolt képéből és egy szöveges leíró fájlból áll. A képen belül
|
|
635 a karakterek bárhol lehetnek, a lényeg az, hogy a leíró fájlban pontosan add
|
|
636 meg minden karakter helyét és méretét.
|
|
637
|
|
638 <p>
|
|
639 A fájl .fnt kirejesztésű; lehetnek benne megjegyzések, ezeket a sor elejére
|
|
640 írt "<code>;</code>" karakterrel kell kezdeni.
|
|
641 Az alábbi sornak feltétlenül szerepelnie kell valahol (célszerűen a fájl
|
|
642 elején):
|
|
643 <blockquote>
|
|
644 <pre>
|
|
645 image = <i>kép</i>
|
|
646 </pre>
|
|
647 </blockquote>
|
|
648
|
|
649 <p>
|
|
650 A <i>kép</i> a karakterek képét tartalmazó fájl neve
|
|
651 (a kiterjesztés itt is elhagyható).
|
|
652 Ezt a sort az egyes karaktereket definiáló sorok követik, amiknek
|
|
653 így kell kinézniük:
|
|
654
|
|
655 <blockquote>
|
|
656 <pre>
|
|
657 "<i>kar</i>" = <i>x, y, sz, m</i>
|
|
658 </pre>
|
|
659 </blockquote>
|
|
660
|
|
661 <p>
|
|
662 Itt <i>x</i> és <i>y</i> a <i>kar</i> karakter képen
|
|
663 belüli pozíciója (0,0 a kép bal felső sarka), az
|
|
664 <i>sz</i> és <i>m</i> pedig a karakter szélessége és magassága
|
|
665 pixelben.
|
|
666
|
|
667 <p>
|
|
668 Az alábbi példa a font.png képen egymás után rajzolt A, B és C karaktert
|
|
669 definiálja.
|
|
670 <table width="100%" border=1><tr bgcolor=silver><td><pre>
|
|
671 ; "font.png" helyett akár "font" is lehet
|
|
672 image = font.png
|
|
673
|
|
674 ; Három karakter legfeljebb csak példának elég. :-)
|
|
675 "A" = 0,0, 7,13
|
|
676 "B" = 7,0, 7,13
|
|
677 "C" = 14,0, 7,13
|
|
678 </pre></td></tr></table>
|
|
679
|
|
680
|
|
681 <h3><a name="symbols">4.1. Szimbólumok</a></h3>
|
|
682
|
|
683 A <a href="#main.dlabel">dlabel</a> elem bizonyos változói olyan karaktereket
|
|
684 adnak vissza, amikhez célszerű külön fontot készíteni, hogy így különféle
|
|
685 szimbólumokat, jeleket lehessen megjeleníteni az adott karakterek helyett.
|
|
686 (Például a DVD streamet jelentő "d" karakterhez rajzolhatsz egy szép
|
|
687 kis "DVD" feliratot.)
|
|
688
|
|
689 <p>
|
|
690 Az alábbi táblázatban láthatók azok a karakterek, amik szimbólumok
|
|
691 megjelenítésére használhatók, és amikhez érdemes külön fontot készíteni.
|
|
692
|
|
693 <div align=center>
|
|
694 <table>
|
|
695 <tr><th align=center>Karakter</th><th align=left>Szimbólum</th></tr>
|
|
696 <tr><td align=center><kbd>p</kbd></td>
|
|
697 <td align=left>lejátszás (play)</td></tr>
|
|
698 <tr><td align=center><kbd>s</kbd></td>
|
|
699 <td align=left>leállítás (stop)</td></tr>
|
|
700 <tr><td align=center><kbd>e</kbd></td>
|
|
701 <td align=left>szünet (pause)</td></tr>
|
|
702 <tr><td align=center><kbd>n</kbd></td>
|
|
703 <td align=left>nincs hang</td></tr>
|
|
704 <tr><td align=center><kbd>m</kbd></td>
|
|
705 <td align=left>mono hang</td></tr>
|
|
706 <tr><td align=center><kbd>t</kbd></td>
|
|
707 <td align=left>sztereó hang</td></tr>
|
|
708 <tr><td align=center><kbd>f</kbd></td>
|
|
709 <td align=left>a stream egy fájl</td></tr>
|
|
710 <tr><td align=center><kbd>v</kbd></td>
|
|
711 <td align=left>a stream egy video CD</td></tr>
|
|
712 <tr><td align=center><kbd>d</kbd></td>
|
|
713 <td align=left>a stream egy DVD</td></tr>
|
|
714 <tr><td align=center><kbd>u</kbd></td>
|
|
715 <td align=left>a stream egy URL</td></tr>
|
|
716 </table>
|
|
717 </div>
|
|
718
|
|
719 <h2><a name="guimsg">A. függelék: GUI üzenetek</a></h2>
|
|
720
|
|
721 A gombok, potméterek és menüpontok az alább felsorolt üzeneteket generálhatják.
|
|
722
|
|
723 <p>
|
|
724 <em class=note><b>Megjegyzés:</b> jelenleg még nem mindegyik üzenet működik
|
|
725 (vagy legalábbis nem megfelelően). Amint tudod, a GUI még fejlesztés alatt áll.
|
|
726 </em>
|
|
727
|
|
728 <p>
|
|
729 <i>Lejátszás:</i>
|
|
730 <blockquote>
|
|
731 <dl>
|
|
732 <dt><b>evNext</b>
|
|
733 <dd>A következő számra ugrik a lejátszólistában.
|
|
734
|
|
735 <dt><b>evPause</b>
|
|
736 <dd>Szünetelteti a lejátszást.
|
|
737
|
|
738 <dt><b>evPauseSwitchToPlay</b>
|
|
739 <dd>Az <i>evPlaySwitchToPause</i> üzenettel együtt egy kapcsolót alkot, ami
|
|
740 egy (látszólag) közös lejátszás/szünet gomb használatát teszi lehetővé.
|
|
741 Mindkét üzenetet egy-egy gombhoz célszerű hozzárendelni, és a gombokat azonos
|
|
742 pozícióba kell rakni. Ennek az üzenetnek a hatására a lejátszás szünetel, és
|
|
743 az <i>evPlaySwitchToPause</i> gomb képe lesz kirajzolva
|
|
744 (jelezve hogy lenyomhatod a
|
|
745 gombot a lejátszás folytatásához).
|
|
746
|
|
747 <dt><b>evPlay</b>
|
|
748 <dd>Megkezdi a lejátszást.
|
|
749
|
|
750 <dt><b>evPlaySwitchToPause</b>
|
|
751 <dd>Az <i>evPauseSwitchToPlay</i> párja. Az üzenet hatására a megkezdődik a
|
|
752 lejátszás,
|
|
753 és az <i>evPauseSwitchToPlay</i> gomb képe lesz kirajzolva (jelezve hogy
|
|
754 lenyomhatod a gombot a lejátszás szüneteltetéséhez).
|
|
755
|
|
756 <dt><b>evPrev</b>
|
|
757 <dd>Az előző számra ugrik a lejátszólistában.
|
|
758
|
|
759 <dt><b>evStop</b>
|
|
760 <dd>Megállítja a lejátszást.
|
|
761 </dl>
|
|
762 </blockquote>
|
|
763
|
|
764 <p>
|
|
765 <i>Pozícionálás:</i>
|
|
766 <blockquote>
|
|
767 <dl>
|
|
768 <dt><b>evBackward10sec</b>
|
|
769 <dt><b>evBackward1min</b>
|
|
770 <dt><b>evBackward10min</b>
|
|
771 <dd>10 másodpercet / 1 percet / 10 percet ugrik vissza a lejátszásban.
|
|
772
|
|
773 <dt><b>evForward10sec</b>
|
|
774 <dt><b>evForward1min</b>
|
|
775 <dt><b>evForward10min</b>
|
|
776 <dd>10 másodpercet / 1 percet / 10 percet ugrik előre a lejátszásban.
|
|
777
|
|
778 <dt><b>evSetMoviePosition</b>
|
|
779 <dd>A megadott pozícióra ugrik (potméternél használatos, a potméter
|
|
780 relatív értékét (0-100%) használja).
|
|
781 </dl>
|
|
782 </blockquote>
|
|
783
|
|
784 <p>
|
|
785 <i>Videoval kapcsolatos üzenetek:</i>
|
|
786 <blockquote>
|
|
787 <dl>
|
|
788 <dt><b>evDoubleSize</b>
|
|
789 <dd>Dupla méretűre állítja a lejátszóablakot.
|
|
790
|
|
791 <dt><b>evFullScreen</b>
|
|
792 <dd>Váltás ablakos és teljes képernyős mód között (oda-vissza működik).
|
|
793
|
|
794 <dt><b>evNormalSize</b>
|
|
795 <dd>Normál méretűre állítja a lejátszóablakot.
|
|
796 </dl>
|
|
797 </blockquote>
|
|
798
|
|
799 <p>
|
|
800 <i>Hanggal kapcsolatos üzenetek:</i>
|
|
801 <blockquote>
|
|
802 <dl>
|
|
803 <dt><b>evDecAudioBufDelay</b>
|
|
804 <dd>Csökkenti a hang késleltetését.
|
|
805
|
|
806 <dt><b>evDecBalance</b>
|
|
807 <dd>Csökkenti a balanszot.
|
|
808
|
|
809 <dt><b>evDecVolume</b>
|
|
810 <dd>Csökkenti a hangerőt.
|
|
811
|
|
812 <dt><b>evIncAudioBufDelay</b>
|
|
813 <dd>Növeli a hang késleltetését.
|
|
814
|
|
815 <dt><b>evIncBalance</b>
|
|
816 <dd>Növeli a balanszot.
|
|
817
|
|
818 <dt><b>evIncVolume</b>
|
|
819 <dd>Növeli a hangerőt.
|
|
820
|
|
821 <dt><b>evMute</b>
|
|
822 <dd>Kikapcsolja/bekapcsolja a hangot.
|
|
823
|
|
824 <dt><b>evSetBalance</b>
|
|
825 <dd>Adott értékre állítja a balanszot (potméterrel használatos, a potméter
|
|
826 relatív értékét (0-100%) használja).
|
|
827
|
|
828 <dt><b>evSetVolume</b>
|
|
829 <dd>Adott értékre állítja a hangerőt (potméterrel használatos, a potméter
|
|
830 relatív értékét (0-100%) használja).
|
|
831 </dl>
|
|
832 </blockquote>
|
|
833
|
|
834 <p>
|
|
835 <i>Egyéb üzenetek:</i>
|
|
836 <blockquote>
|
|
837 <dl>
|
|
838 <dt><b>evAbout</b>
|
|
839 <dd>Megjeleníti a program információs ablakát.
|
|
840
|
8307
|
841 <dt><b>evDropSubtitle</b>
|
|
842 <dd>Törli az aktuálisan használt felirat fájlt.
|
|
843
|
6726
|
844 <dt><b>evEqualizer</b>
|
1981
|
845 <dd>Bekapcsolja/kikapcsolja az equalizert.
|
|
846
|
|
847 <dt><b>evExit</b>
|
|
848 <dd>Kilép a programból.
|
|
849
|
|
850 <dt><b>evIconify</b>
|
|
851 <dd>Ikonizálja az ablakot.
|
|
852
|
|
853 <dt><b>evLoad</b>
|
|
854 <dd>Betölt egy fájlt (amit egy fájlválasztó ablakban jelölhetsz ki).
|
|
855
|
|
856 <dt><b>evLoadPlay</b>
|
|
857 <dd>Ugyanaz mint az <i>evLoad</i>, de betöltés után automatikusan megkezdi
|
|
858 a lejátszást.
|
|
859
|
8307
|
860 <dt><b>evLoadSubtitle</b>
|
|
861 <dd>Betölt egy felirat fájlt (amit egy fájlválasztó ablakban jelölhetsz ki).
|
|
862
|
|
863 <dt><b>evLoadAudioFile</b>
|
|
864 <dd>Betölt egy hang fájlt (amit egy fájlválasztó ablakban jelölhetsz ki).
|
|
865
|
1981
|
866 <dt><b>evNone</b>
|
|
867 <dd>Üres üzenet, nincs hatása. (Legfeljebb csak a CVS verzióban. :-))
|
|
868
|
|
869 <dt><b>evPlayList</b>
|
|
870 <dd>Megnyitja/bezárja a lejátszólista ablakot.
|
|
871
|
8307
|
872 <dt><b>evPlayDVD</b>
|
|
873 <dd>Megpróbálja megnyitni a megadott DVDROM - ban lévő lemezt.
|
|
874
|
|
875 <dt><b>evPlayVCD</b>
|
|
876 <dd>Megpróbálja megnyitni a megadott CDROM - ban lévő lemezt.
|
|
877
|
1981
|
878 <dt><b>evPreferences</b>
|
|
879 <dd>Megnyitja a beállítások ablakot.
|
|
880
|
8307
|
881 <dt><b>evSetAspect</b>
|
|
882 <dd>Beállítja a képarányt a megadottra.
|
|
883
|
|
884 <dt><b>evSetURL</b>
|
|
885 <dd>Elővarázsolja az URL dialogus ablakot.
|
|
886
|
1981
|
887 <dt><b>evSkinBrowser</b>
|
|
888 <dd>Megnyitja a skinböngésző ablakot.
|
|
889 </dl>
|
|
890 </blockquote>
|
|
891
|
|
892 </body>
|
|
893 </html>
|