Mercurial > mplayer.hg
view DOCS/xml/cs/skin.xml @ 26363:3d420ef8f9be
typo in filename
author | diego |
---|---|
date | Fri, 11 Apr 2008 10:35:32 +0000 (2008-04-11) |
parents | 40e794ce297d |
children | 0f1b5b68af32 |
line wrap: on
line source
<?xml version="1.0" encoding="utf-8"?> <!-- synced with r21612 --> <appendix id="skin"> <title>Form叩t skin哲 <application>MPlayer</application>u</title> <sect1 id="skin-overview"> <title>P�ehled</title> <para> Nem叩 to sice nic spole�n辿ho s form叩tem skinu, ale m�li byste v�d�t, 転e <application>MPlayer</application> <emphasis role="bold">nem叩</emphasis> vestav�n箪 skin, tak転e <emphasis role="bold">si mus鱈te alespo� jeden skin nainstalovat, chcete-li pou転鱈vat GUI.</emphasis> </para> <!-- ********** --> <sect2 id="skin-overview-directories"> <title>Adres叩�e</title> <para> Adres叩�e prohled叩van辿 na skiny jsou (v tomto po�ad鱈): <orderedlist> <listitem><para> <filename class="directory">$(DATADIR)/skins/</filename> </para></listitem> <listitem><para> <filename class="directory">$(PREFIX)/share/mplayer/skins/</filename> </para></listitem> <listitem><para> <filename class="directory">~/.mplayer/skins/</filename> </para></listitem> </orderedlist> </para> <para> Poznamenejme, 転e prvn鱈 z cest se m哲転e li邸it podle toho, jak je <application>MPlayer</application> zkonfigurov叩n (viz volby configure skriptu <option>--prefix</option> a <option>--datadir</option>). </para> <para> Ka転d箪 skin je instalov叩n do vlastn鱈ho adres叩�e v n�kter辿m z v箪邸e uveden箪ch. Nap�鱈klad: <screen>$(PREFIX)/share/mplayer/skins/default/</screen> </para> </sect2> <!-- ********** --> <sect2 id="skin-overview-formats"> <title>Form叩ty obr叩zk哲</title> <para>Obr叩zky mus鱈 b箪t truecolor (24 nebo 32 bpp) PNG.</para> <para> V hlavn鱈m okn� a v p�ehr叩va�i (viz n鱈転) m哲転ete pou転鱈t obr叩zky s 'pr哲hlednost鱈': Oblasti vypln�n辿 barvou #FF00FF (magenta) jsou pln� pr哲hledn辿, pokud jsou zobrazov叩ny <application>MPlayer</application>em. To znamen叩, 転e m哲転ete m鱈t tvarovan叩 okna, pokud m叩 v叩邸 X server XShape roz邸鱈�en鱈. </para> </sect2> <sect2 id="skin-overview-components"> <title>Sou�叩sti skinu</title> <para> Skiny maj鱈 pom�rn� voln箪 form叩t (narozd鱈l nap�鱈klad od pevn辿ho form叩tu skin哲 <application>Winamp</application>u/<application>XMMS</application>), tak転e je jen na v叩s, zda vytvo�鱈te n�co skv�l辿ho. </para> <para> V sou�asnosti jsou zde �ty�i okna, kter叩 m哲転ete dekorovat: <link linkend="skin-file-main">hlavn鱈 okno</link>, <link linkend="skin-file-subwindow">podokno</link>, <link linkend="skin-file-main">ovl叩dac鱈 panel</link> a <link linkend="skin-file-menu">nabidka</link> (tu lze aktivovat prav箪m my邸鱈tkem). <itemizedlist> <listitem> <para> <application>MPlayer</application> je ovl叩d叩n v <emphasis role="bold">hlavn鱈m okn�</emphasis> a/nebo v <emphasis role="bold">ovl叩dac鱈m panelu</emphasis>. Pozad鱈m okna je obr叩zek. N叩sleduj鱈c鱈 sou�叩sti mohou (a mus鱈) b箪t um鱈st�ny v okn�: <emphasis>tla�鱈tka</emphasis>, <emphasis>potenciometry</emphasis> (邸oup叩tka) a <emphasis>popisky</emphasis>. Ka転d辿 sou�叩sti mus鱈te nastavit pozici a velikost. </para> <para> A <emphasis role="bold">tla�鱈tko</emphasis> m叩 t�i stavy (stisknuto, pu邸t�no a zak叩z叩no), proto mus鱈 b箪t jeho obraz svisle rozd�len do t�鱈 �叩st鱈. Detaily viz sou�叩st <link linkend="skin-button">tla�鱈tko</link>. </para> <para> A <emphasis role="bold">potenciometr</emphasis> (hlavn� pou転鱈van箪 pro li邸tu p�ev鱈jen鱈 a ovl叩d叩n鱈 hlasitosti/stereov叩hy) m哲転e m鱈t libovoln箪 po�et f叩z鱈 d�l鱈c鱈ch jeho obraz na jednotliv辿 �叩sti pod sebou. Detaily viz <link linkend="skin-hpotmeter">hpotenciometr</link> a <link linkend="skin-potmeter">potenciometr</link>. </para> <para> <emphasis role="bold">Popisky</emphasis> jsou pon�kud zvl叩邸tn鱈: Znaky pot�ebn辿 pro jejich vykreslen鱈 jsou br叩ny z obrazov辿ho souboru a znaky v obr叩zku jsou pops叩ny <link linkend="skin-fonts">souborem popisu fontu</link>. Tento (druh箪) soubor je prost箪 textov箪 soubor, kter箪 popisuje pozici x,y a velikost ka転d辿ho znaku v obr叩zku (obr叩zkov箪 soubor a soubor popisu fontu <emphasis>spolu</emphasis> tvo�鱈 font). Detaily viz <link linkend="skin-dlabel">dlabel</link>. </para> <note><para> V邸echny obr叩zky mohou m鱈t plnou pr哲hlednost, jak je pops叩na v sekci o <link linkend="skin-overview-formats">form叩tech obr叩zk哲</link>. Pokud X server nepodporuje roz邸鱈�en鱈 XShape, budou pr哲hledn辿 �叩sti �ern辿. Pokud byste cht�li vyu転鱈t tuto vlastnost, mus鱈 b箪t 邸鱈�ka pozad鱈 hlavn鱈ho okna celo�鱈seln� d�liteln叩 8. </para></note> </listitem> <listitem><para> <emphasis role="bold">Podokno</emphasis> je to okno, kde se zobrazuje film. M哲転e v n�m b箪t zobrazen ur�en箪 obr叩zek, pokud nen鱈 na�ten 転叩dn箪 film (je docela 炭navn辿, pokud zde nen鱈 nic :-)). <emphasis role="bold">Pozn叩mka:</emphasis> pr哲hlednost zde <emphasis role="bold">nen鱈 povolena</emphasis>. </para></listitem> <listitem> <para> <emphasis role="bold">Nab鱈dka</emphasis> je jen zp哲sob, jak ovl叩dat <application>MPlayer</application> polo転kami menu. Vy転adov叩ny jsou dva obr叩zky: jeden z nich jako menu v norm叩ln鱈m stavu a druh箪 se zv箪razn�n箪mi polo転kami. Kdy転 pak vyvol叩te menu, je zobrazen prvn鱈 obr叩zek. P�i pohybu my邸鱈 p�es polo転ky, je zkop鱈rov叩na aktu叩ln� vybran叩 polo転ka z druh辿ho obr叩zku p�es ten prvn鱈 pod kursorem (druh箪 obr叩zek nen鱈 nikdy zobrazen cel箪). </para> <para> Polo転ka menu je definov叩na svou pozic鱈 a velikost鱈 v obr叩zku (detaily viz sekce <link linkend="skin-file-menu">nab鱈dka</link>). </para> </listitem> </itemizedlist> </para> <para> Jednu d哲le転itou v�c jsme je邸t� nezm鱈nili: Maj鱈-li tla�鱈tka, potenciometry a polo転ky menu pracovat, mus鱈 <application>MPlayer</application> v�d�t, co m叩 ud�lat, pokud je na n� kliknuto. To je zaji邸t�no pomoc鱈 <link linkend="skin-gui">zpr叩v</link> (ud叩lost鱈). Pro tyto �leny tedy mus鱈te definovat zpr叩vy, kter辿 budou p�i kliku generov叩ny. </para> </sect2> <!-- ********** --> <sect2 id="skin-files"> <title>Soubory</title> <para> Pro v箪robu skinu budete pot�ebovat n叩sleduj鱈c鱈: <itemizedlist> <listitem><para> Konfigura�n鱈 soubor jm辿nem <link linkend="skin-file">skin</link> �ekne <application>MPlayer</application>u, jak m叩 d叩t jednotliv辿 �叩sti skinu dohromady a co ud�lat, kliknete-li n�kde v okn�. </para></listitem> <listitem><para> Obr叩zek pozad鱈 hlavn鱈ho okna. </para></listitem> <listitem><para> Obr叩zky polo転ek hlavn鱈ho okna (v�etn� jednoho nebo v鱈ce soubor哲 s popisem fontu pro vykreslov叩n鱈 popisek). </para></listitem> <listitem><para> Obr叩zek pro zobrazen鱈 v podokn� (voliteln箪). </para></listitem> <listitem><para> Dva obr叩zky pro nab鱈dku (ty jsou pot�eba pouze pokud chcete vytvo�it menu). </para></listitem> </itemizedlist> S v箪jimkou konfigura�n鱈ho souboru skinu si m哲転ete pojmenovat ostatn鱈 soubory jak chcete (s t鱈m, 転e va邸e soubory s popisem fontu budou m鱈t p�鱈ponu <filename>.fnt</filename>). </para> </sect2> </sect1> <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> <sect1 id="skin-file"> <title>Soubor skin</title> <para> Jak jsme ji転 �ekli, je to konfigura�n鱈 soubor skinu. Soubor je �叩dkov� orientov叩n; �叩dky s koment叩�em za�鱈naj鱈 znakem '<literal>;</literal>' (p�ed n鱈m jsou povoleny jen mezery a tabul叩tory). </para> <para> Soubor je slo転en ze sekc鱈. Ka転d叩 sekce popisuje skin pro aplikaci a m叩 n叩sleduj鱈c鱈 formu: <programlisting> section = <replaceable>n叩zev cekce</replaceable> . . . end </programlisting> </para> <para> Zat鱈m m叩me jen jednu aplikaci, tak転e pot�ebujete jen jednu sekci: jej鱈 n叩zev je <emphasis role="bold">movieplayer</emphasis>. </para> <para> Uvnit� sekce je ka転d辿 okno pos叩no blokem, kter箪 m叩 n叩sleduj鱈c鱈 formu: <programlisting> window = <replaceable>n叩zev okna</replaceable> . . . end </programlisting> </para> <para> kde <replaceable>n叩zev okna</replaceable> m哲転e b箪t jeden z t�chto �et�zc哲: <itemizedlist> <listitem><para> <emphasis role="bold">main</emphasis> - pro hlavn鱈 okno </para></listitem> <listitem><para> <emphasis role="bold">sub</emphasis> - pro podokno </para></listitem> <listitem><para> <emphasis role="bold">menu</emphasis> - pro nab鱈dku </para></listitem> <listitem><para> <emphasis role="bold">playbar</emphasis> - ovl叩dac鱈 panel </para></listitem> </itemizedlist> </para> <para> (Bloky sub a menu jsou voliteln辿 - nemus鱈te vytv叩�et nab鱈dku nebo vyzdobit podokno.) </para> <para> Uvnit� window bloku m哲転ete definovat ka転dou polo転ku okna �叩dkem v tomto tvaru: <programlisting>polo転ka = parametr</programlisting> Kde <literal>polo転ka</literal> je �et�zec ozna�uj鱈c鱈 typ polo転ky GUI a <literal>parametr</literal> je �鱈seln叩 nebo textov叩 hodnota (nebo seznam hodnot odd�len箪ch �叩rkami). </para> <para> D叩te-li to v邸echno dohromady, cel箪 soubor vypad叩 asi takto: <programlisting> section = movieplayer window = main ; ... polo転ky hlavn鱈ho okna ... end window = sub ; ... polo転ky podokna ... end window = menu ; ... polo転ky menu ... end window = playbar ; ... polo転ky ovl叩dac鱈ho panelu ... end end </programlisting> </para> <para> Jm辿no souboru s obr叩zkem mus鱈 b箪t zad叩no bez 炭vodn鱈ch adres叩�哲 - obr叩zky jsou vyhled叩v叩ny v adres叩�i <filename class="directory">skins</filename>. M�li byste (ale nemus鱈te) zadat p�鱈ponu souboru. Pokud soubor neexistuje, zkou邸鱈 <application>MPlayer</application> na�鱈st soubor <filename><jm辿no>.<p�鱈p></filename>, kdy jsou za <filename><p�鱈p></filename> zkou邸eny p�鱈pony <literal>png</literal> a <literal>PNG</literal> (v tomto po�ad鱈). Pou転it箪 bude prvn鱈 vyhovuj鱈c鱈 soubor. </para> <para> Aby bylo v邸e jasn辿, uvedeme p�鱈klad. �ekn�me, 転e m叩te obr叩zek jm辿nem <filename>main.png</filename>, kter箪 pou転ijeme pro hlavn鱈 okno: <programlisting>base = main, -1, -1</programlisting> <application>MPlayer</application> se pokus鱈 nahr叩t soubory <filename>main</filename>, <filename>main.png</filename>, <filename>main.PNG</filename>. </para> <para> Nakonec n�kolik slov o pozicov叩n鱈. Hlavn鱈 okno a podokno lze um鱈stit do odli邸n箪ch roh哲 obrazovky zad叩n鱈m sou�adnic <literal>X</literal> a <literal>Y</literal>. <literal>0</literal> horn鱈 nebo lev箪, <literal>-1</literal> je st�ed a <literal>-2</literal> je vpravo nebo dole, jak je vid�t na obr叩zku: <informalfigure> <screen> (0, 0)----(-1, 0)----(-2, 0) | | | | | | (0,-1)----(-1,-1)----(-2,-1) | | | | | | (0,-2)----(-1,-2)----(-2,-2) </screen> </informalfigure> </para> <!-- ********** --> <sect2 id="skin-file-main"> <title>Hlavn鱈 okno a ovl叩dac鱈 panel</title> <para> N鱈転e uv叩d鱈me seznam polo転ek, kter辿 mohou b箪t pou転ity v bloc鱈ch '<literal>window = main</literal>' ... '<literal>end</literal>', a '<literal>window = playbar</literal>' ... '<literal>end</literal>'. </para> <variablelist> <varlistentry> <term><literal> <anchor id="skin-main-base"/>base = obr叩zek, X, Y </literal></term> <listitem><para> Umo転�uje nastavit obr叩zek pozad鱈 hlavn鱈ho okna. Okno bude vykresleno na zadan箪ch sou�adnic鱈ch <literal>X,Y</literal> na obrazovce a bude m鱈t velikost obr叩zku. </para> <note><para> Tyto koordin叩ty zat鱈m nefunguj鱈 pro okno display. </para></note> <warning><para>Pr哲hledn辿 oblasti v obr叩zku (obarven辿 #FF00FF) budou �ern辿 na X serverech bez XShape roz邸鱈�en鱈. �鱈�ka obr叩zku mus鱈 b箪t celo�鱈seln� d�liteln叩 8.</para></warning> </listitem> </varlistentry> <varlistentry> <term><literal> <anchor id="skin-button"/>button = obr叩zek, X, Y, 邸鱈�ka, v箪邸ka, zpr叩va </literal></term> <listitem><para> Um鱈st鱈 tla�鱈tko rozm�ru <literal>邸鱈�ka</literal> * <literal>v箪邸ka</literal> na pozici <literal>X,Y</literal>. Zadan叩 <literal>zpr叩va</literal> je generov叩na p�i kliku na tla�鱈tko. Zadan箪 <literal>obr叩zek</literal> mus鱈 m鱈t t�i �叩sti pod sebou (odpov鱈daj鱈c鱈 mo転n箪m stav哲m tla�鱈tka) takto: </para> <informalfigure> <screen> +------------+ | stisknuto | +------------+ | uvoln�no | +------------+ | zak叩z叩no | +------------+<!-- --></screen> </informalfigure> </listitem> </varlistentry> <varlistentry> <term><literal> <anchor id="skin-decoration"/>decoration = enable|disable </literal></term> <listitem><para> Zapne (enable) nebo vypne (disable) dekoraci hlavn鱈ho okna, produkovanou okenn鱈m mana転erem. V箪choz鱈 je <emphasis role="bold">disable</emphasis>. </para> <note><para> V okn� display to nefunguje, nen鱈 to pot�eba. </para></note> </listitem> </varlistentry> <varlistentry> <term><literal> <anchor id="skin-hpotmeter"/>hpotmeter = tla�鱈tko, t邸鱈�ka, tv箪邸ka, f叩ze, po�et_f叩z鱈, v箪choz鱈, X, Y, 邸鱈�ka, v箪邸ka, zpr叩va </literal></term> <listitem><para> </para></listitem> </varlistentry> <varlistentry> <term><literal> <anchor id="skin-vpotmeter"/>vpotmeter = tla�鱈tko, t邸鱈�ka, tv箪邸ka, f叩ze, po�et_f叩z鱈, v箪choz鱈, X, Y, 邸鱈�ka, v箪邸ka, zpr叩va </literal></term> <listitem><para> Um鱈st鱈 vodorovn箪 (hpotmeter) nebo svisl箪 (vpotmeter) potenciometr velikosti <literal>邸鱈�ka</literal> * <literal>v箪邸ka</literal> na pozici <literal>X,Y</literal>. Obr叩zek m哲転e b箪t rozd�len do r哲zn箪ch �叩st鱈 pro r哲zn辿 f叩ze potenciometru (Nap�鱈klad m哲転ete m鱈t potenciometr pro nastaven鱈 hlasitosti, jeho転 dr叩ha se barv鱈 ze zelen辿 na �ervenou, jak se jeho hodnota m�n鱈 od nejmen邸鱈 do nejv�t邸鱈.). <literal>hpotmeter</literal> m哲転e m鱈t t叩hlo, kter辿 m哲転e b箪t vodorovn� ta転eno. V箪znam parametr哲: <itemizedlist> <listitem><para> <literal>tla�鱈tko</literal> - obr叩zek, kter箪 se pou転ije pro tla�鱈tko (mus鱈 m鱈t t�i �叩sti pod sebou, stejn� jako v p�鱈pad� tohoto <link linkend="skin-button">tla�鱈tka</link>) </para></listitem> <listitem><para> <literal>t邸鱈�ka</literal>, <literal>tv箪邸ka</literal> - velikost tla�鱈tka </para></listitem> <listitem><para> <literal>f叩ze</literal> - obr叩zek pou転it箪 pro r哲zn辿 f叩ze hpotmetru. Pokud 転叩dn箪 obr叩zek nechcete, m哲転ete pou転鱈t speci叩ln鱈 hodnotu <literal>NULL</literal>. Obr叩zek mus鱈 b箪t rozd�len svisle na <literal>po�et_f叩z鱈</literal> �叩st鱈 takto: <informalfigure><screen> +------------+ | f叩ze #1 | +------------+ | f叩ze #2 | +------------+ ... +------------+ | f叩ze #n | +------------+<!-- --></screen></informalfigure> </para></listitem> <listitem><para> <literal>numphases</literal> - number of phases stored in the <literal>po�et_f叩z鱈</literal> - po�et f叩z鱈 ulo転en箪ch v obr叩zku <literal>f叩ze</literal> </para></listitem> <listitem><para> <literal>v箪choz鱈</literal> - v箪choz鱈 hodnota pro hpotmeter (v rozsahu <literal>0</literal> a転 <literal>100</literal>) </para></listitem> <listitem><para> <literal>X</literal>, <literal>Y</literal> - pozice pro hpotmeter </para></listitem> <listitem><para> <literal>邸鱈�ka</literal>, <literal>v箪邸ka</literal> - 邸鱈�ka a v箪邸ka <literal>hpotmeter</literal>u </para></listitem> <listitem><para> <literal>zpr叩va</literal> - zpr叩va generovan叩 p�i zm�n� hodnoty <literal>hpotmeter</literal>u </para></listitem> </itemizedlist> </para></listitem> </varlistentry> <varlistentry> <term><literal> <anchor id="skin-potmeter"/>potmeter = f叩ze, po�et_f叩z鱈, v箪choz鱈, X, Y, 邸鱈�ka, v箪邸ka, zpr叩va </literal></term> <listitem><para> <literal>hpotmeter</literal> bez tla�鱈tka. (soudil bych, 転e byl m鱈n�n jako oto�n箪, ale reaguje pouze na horizont叩ln鱈 ta転en鱈.) Popis parametr哲 je stejn箪 jako v <link linkend="skin-hpotmeter">hpotmeter</link>. <literal>f叩ze</literal> mohou b箪t <literal>NULL</literal>, ale je to vcelku k ni�emu, jeliko転 nem哲転ete vid�t, jak je nastaven <literal>potmeter</literal>. </para></listitem> </varlistentry> <varlistentry> <term><literal> <anchor id="skin-font"/>font = soubor_fontu, id_fontu </literal></term> <listitem><para> Definuje font. <literal>soubor_fontu</literal> je jm辿no souboru popisu fontu s p�鱈ponou <filename>.fnt</filename> (zde p�鱈ponu nezad叩vejte). <literal>id_fontu</literal> je pou転it jako ukazatel na font (viz <link linkend="skin-dlabel">dlabel</link> a <link linkend="skin-slabel">slabel</link>). Definov叩no m哲転e b箪t v鱈ce ne転 25 font哲. </para></listitem> </varlistentry> <varlistentry> <term><literal> <anchor id="skin-slabel"/>slabel = X, Y, id_fontu, "text"; </literal></term> <listitem><para> Um鱈st鱈 statick箪 popisek na pozici <literal>X,Y</literal>. <literal>text</literal> je zobrazen fontem identifikovan箪m pomoc鱈 <literal>id_fontu</literal>. Text je surov箪 �et�zec (<literal>$x</literal> prom�nn辿 nefunguj鱈), kter箪 mus鱈 b箪t uzav�en ve dvojit箪ch uvozovk叩ch (ale znak " nesm鱈 b箪t sou�叩st鱈 textu). Popisek je zobrazen fontem identifikovan箪m pomoc鱈 <literal>id_fontu</literal>. </para></listitem> </varlistentry> <varlistentry> <term><literal> <anchor id="skin-dlabel"/>dlabel = X, Y, d辿lka, zarovn叩n鱈, id_fontu, "text" </literal></term> <listitem> <para> Um鱈st鱈 dynamick箪 popisek na pozici <literal>X,Y</literal>. Popisek je dynamick箪 proto, 転e je jeho text periodicky obnovov叩n. Maxim叩ln鱈 d辿lka popisku je nastavena na <literal>d辿lka</literal> (jeho v箪邸kou je v箪邸ka znaku). Pokud je zobrazovan箪 text 邸ir邸鱈, pak bude rolov叩n, jinak bude zarovn叩n do ur�en辿ho prostoru podle hodnoty parametru <literal>zarovn叩n鱈</literal>: <literal>0</literal> je zarovn叩n鱈 vpravo, <literal>1</literal> na st�ed, <literal>2</literal> vlevo. </para> <para> Text k zobrazen鱈 je zad叩n parametrem <literal>text</literal>: Mus鱈 b箪t uzav�en do dvojit箪ch uvozovek (ale znak " nesm鱈 b箪t sou�叩st鱈 textu). Popisek je zobrazen fontem identifikovan箪m pomoc鱈 <literal>id_fontu</literal>. V textu m哲転ete pou転鱈t tyto prom�nn辿: </para> <informaltable> <tgroup cols="2"> <thead> <row><entry>Prom�nn叩</entry><entry>V箪znam</entry></row> </thead> <tbody> <row> <entry>$1</entry> <entry>�as p�ehr叩v叩n鱈 ve form叩tu <emphasis>hh:mm:ss</emphasis></entry> </row> <row> <entry>$2</entry> <entry>�as p�ehr叩v叩n鱈 ve form叩tu <emphasis>mmmm:ss</emphasis></entry> </row> <row> <entry>$3</entry> <entry>�as p�ehr叩v叩n鱈 ve form叩tu <emphasis>hh</emphasis> (hodiny)</entry> </row> <row> <entry>$4</entry> <entry>�as p�ehr叩v叩n鱈 ve form叩tu <emphasis>mm</emphasis> (minuty)</entry> </row> <row> <entry>$5</entry> <entry>�as p�ehr叩v叩n鱈 ve form叩tu <emphasis>ss</emphasis> (sekundy)</entry> </row> <row> <entry>$6</entry> <entry>d辿lka filmu ve form叩tu <emphasis>hh:mm:ss</emphasis></entry> </row> <row> <entry>$7</entry> <entry>d辿lka filmu ve form叩tu <emphasis>mmmm:ss</emphasis></entry> </row> <row> <entry>$8</entry> <entry>�as p�ehr叩v叩n鱈 ve form叩tu <emphasis>h:mm:ss</emphasis></entry> </row> <row> <entry>$v</entry> <entry>hlasitost ve form叩tu <emphasis>xxx.xx</emphasis>%</entry> </row> <row> <entry>$V</entry> <entry>hlasitost ve form叩tu <emphasis>xxx.xx</emphasis></entry> </row> <row> <entry>$b</entry> <entry>stereov叩ha ve form叩tu <emphasis>xxx.xx</emphasis>%</entry> </row> <row> <entry>$B</entry> <entry>stereov叩ha ve form叩tu <emphasis>xxx.xx</emphasis></entry> </row> <row> <entry>$$</entry> <entry>znak $</entry> </row> <row> <entry>$a</entry> <entry>znak podle typu audia (転叩dn辿: <literal>n</literal>, mono: <literal>m</literal>, stereo: <literal>t</literal>)</entry> </row> <row> <entry>$t</entry> <entry>�鱈slo stopy (v playlistu)</entry> </row> <row> <entry>$o</entry> <entry>n叩zev souboru</entry> </row> <row> <entry>$f</entry> <entry>n叩zev souboru mal箪mi p鱈smeny</entry> </row> <row> <entry>$F</entry> <entry>n叩zev souboru velk箪mi p鱈smeny</entry> </row> <row> <entry>$T</entry> <entry>znak podle typu datov辿ho proudu (soubor: <literal>f</literal>, Video CD: <literal>v</literal>, DVD: <literal>d</literal>, URL: <literal>u</literal>) </entry> </row> <row> <entry>$p</entry> <entry>znak <keycap>p</keycap> (pokud p�ehr叩v叩te soubor a font obsahuje znak <keycap>p</keycap>)</entry> </row> <row> <entry>$s</entry> <entry>znak <keycap>s</keycap> character (pokud p�ehr叩v叩te soubor a font obsahuje znak <keycap>s</keycap>)</entry> </row> <row> <entry>$e</entry> <entry>znak <keycap>e</keycap> (pokud je p�ehr叩v叩n鱈 pozastaveno a font obsahuje znak <keycap>e</keycap>)</entry> </row> <row> <entry>$x</entry> <entry>邸鱈�ka filmu</entry> </row> <row> <entry>$y</entry> <entry>v箪邸ka filmu</entry> </row> <row> <entry>$C</entry> <entry>n叩zev pou転it辿ho kodeku</entry> </row> </tbody> </tgroup> </informaltable> <note><para> Prom�nn辿 <literal>$a, $T, $p, $s</literal> a <literal>$e</literal> vracej鱈 znaky, kter辿 by m�ly b箪t zobrazov叩ny jako speci叩ln鱈 symboly (nap�鱈klad, <keycap>e</keycap> vrac鱈 symbol pauza, kter箪 obvykle vypad叩 jako ||). M�li byste m鱈t font pro norm叩ln鱈 znaky a jin箪 font pro symboly. V鱈ce informac鱈 viz sekce o <link linkend="skin-fonts-symbols">symbolech</link>. </para></note> </listitem> </varlistentry> </variablelist> </sect2> <!-- ********** --> <sect2 id="skin-file-subwindow"> <title>Ovl叩dac鱈 panel</title> <para> N叩sleduj鱈c鱈 vstupy mohou b箪t pou転ity v bloku '<literal>window = sub</literal>' . . . '<literal>end</literal>'. </para> <variablelist> <varlistentry> <term><literal> <anchor id="skin-sub-base"/>base = obr叩zek, X, Y, 邸鱈�ka, v箪邸ka </literal></term> <listitem><para> Obr叩zek, kter箪 bude zobrazen v okn�. Okno se zobraz鱈 na pozici zadan辿 sou�adnicemi <literal>X,Y</literal> na obrazovce (<literal>0,0</literal> je lev箪 horn鱈 roh). M哲転ete nastavit <literal>-1</literal> pro st�ed a <literal>-2</literal> pro vpravo (<literal>X</literal>) a dole (<literal>Y</literal>). Okno bude stejn� velk辿 jako obr叩zek. <literal>邸鱈�ka</literal> a <literal>v箪邸ka</literal> ud叩vaj鱈 velikost okna; jsou voliteln辿 (pokud chyb鱈, m叩 okno rozm�ry shodn辿 s obr叩zkem). </para></listitem> </varlistentry> <varlistentry> <term><literal> <anchor id="skin-background"/>background = R, G, B </literal></term> <listitem><para> Umo転�uje nastavit barvu pozad鱈. To je u転ite�n辿, pokud je obr叩zek men邸鱈 ne転 okno. <literal>R</literal>, <literal>G</literal> a <literal>B</literal> ozna�uj鱈 �ervenou, zelenou a modrou slo転ku barvy (ka転d叩 z nich je dekadick叩 hodnota 0 a転 255). </para></listitem> </varlistentry> </variablelist> </sect2> <!-- ********** --> <sect2 id="skin-file-menu"> <title>Nab鱈dka</title> <para> Jak ji転 bylo d�鱈ve �e�eno, nab鱈dka je zobrazena pomoc鱈 dvou obr叩zk哲. Norm叩ln鱈 polo転ky nab鱈dky jsou br叩ny z obr叩zku ur�en辿ho polo転kou <literal>base</literal>, zat鱈mco aktu叩ln� zvolen箪 vstup je br叩n z obr叩zku ur�en辿ho polo転kou <literal>selected</literal>. Mus鱈te definovat pozici a rozm�r ka転d辿 polo転ky nab鱈dky. </para> <para> N叩sleduj鱈c鱈 vstupy mohou b箪t pou転ity v bloku '<literal>window = menu</literal>'. . .'<literal>end</literal>'. </para> <variablelist> <varlistentry> <term><literal> <anchor id="skin-menu-base"/>base = obr叩zek </literal></term> <listitem><para> Obr叩zek norm叩ln鱈ch polo転ek nab鱈dky. </para></listitem> </varlistentry> <varlistentry> <term><literal> <anchor id="skin-selected"/>selected = obr叩zek </literal></term> <listitem><para> Obr叩zek nab鱈dky kde jsou v邸echny polo転ky vybr叩ny. </para></listitem> </varlistentry> <varlistentry> <term><literal> <anchor id="skin-menu"/>menu = X, Y, 邸鱈�ka, v箪邸ka, zpr叩va </literal></term> <listitem><para> Definuje pozici <literal>X,Y</literal> a rozm�r polo転ky nab鱈dky v obr叩zku. <literal>zpr叩va</literal> je zpr叩va, generovan叩 jakmile je uvoln�no tla�鱈tko my邸i nad polo転kou. </para></listitem> </varlistentry> </variablelist> </sect2> </sect1> <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> <sect1 id="skin-fonts"> <title>Fonty</title> <para> Jak jsme ji転 zm鱈nili v sekci o �叩stech skinu, font je definov叩n obr叩zkem a souborem popisu. M哲転ete rozm鱈stit znaky v obr叩zku libovoln�, ale ujist�te se, 転e je jejich velikost a pozice je uvedena v souboru popisu p�esn�. </para> <para> Soubor popisu fontu (s p�鱈ponou <filename>.fnt</filename>) m哲転e obsahovat �叩dky s koment叩�em za�鱈naj鱈c鱈 '<literal>;</literal>'. Soubor mus鱈 obsahovat �叩dek ve form� <anchor id="skin-font-image"/> <programlisting>image = <replaceable>obr叩zek</replaceable></programlisting> Kde <literal><replaceable>obr叩zek</replaceable></literal> je n叩zev obr叩zku pou転it辿ho pro font (nemus鱈te zad叩vat p�鱈ponu). <anchor id="skin-font-char"/> <programlisting>"char" = X, Y, 邸鱈�ka, v箪邸ka</programlisting> Zde <literal>X</literal> a <literal>Y</literal> ud叩vaj鱈 pozici <literal>char</literal> znaku v obr叩zku (<literal>0,0</literal> je lev箪 horn鱈 roh). <literal>邸鱈�ka</literal> a <literal>v箪邸ka</literal> jsou rozm�ry znaku v pixelech. </para> <para> Tento p�鱈klad definuje znaky A, B, C s pou転鱈t鱈m <filename>font.png</filename>. <programlisting> ; Zde m哲転e b箪t jen "font" m鱈sto "font.png". image = font.png ; T�i znaky pro ilustraci sta�鱈 :-) "A" = 0,0, 7,13 "B" = 7,0, 7,13 "C" = 14,0, 7,13 </programlisting> </para> <!-- ********** --> <sect2 id="skin-fonts-symbols"> <title>Symboly</title> <para> N�kter辿 znaky maj鱈 speci叩ln鱈 v箪znam, jsou-li vr叩ceny n�kterou z prom�nn箪ch pou転it箪ch v <link linkend="skin-dlabel">dlabel</link>. Tyto znaky maj鱈 b箪t zobrazov叩ny jako symboly, tak転e mohou b箪t zobrazeny v�ci jako p�kn辿 DVD logo m鱈sto znaku '<literal>d</literal>' pro DVD datov箪 proud. </para> <para> N叩sleduj鱈c鱈 tabulka obsahuje znaky, kter辿 mohou b箪t pou転ity k zobrazen鱈 symbol哲 (a tud鱈転 vy転aduj鱈 odli邸n箪 font). </para> <informaltable> <tgroup cols="2"> <thead> <row><entry>Znak</entry><entry>Symbol</entry></row> </thead> <tbody> <row><entry><keycap>p</keycap></entry><entry>play</entry></row> <row><entry><keycap>s</keycap></entry><entry>stop</entry></row> <row><entry><keycap>e</keycap></entry><entry>pauza</entry></row> <row><entry><keycap>n</keycap></entry><entry>bez zvuku</entry></row> <row><entry><keycap>m</keycap></entry><entry>mono zvuk</entry></row> <row><entry><keycap>t</keycap></entry><entry>stereo zvuk</entry></row> <row><entry><keycap>f</keycap></entry><entry>datov箪 proud je soubor</entry></row> <row><entry><keycap>v</keycap></entry><entry>datov箪 proud je Video CD</entry></row> <row><entry><keycap>d</keycap></entry><entry>datov箪 proud je DVD</entry></row> <row><entry><keycap>u</keycap></entry><entry>datov箪 proud je URL</entry></row> </tbody> </tgroup> </informaltable> </sect2> </sect1> <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> <sect1 id="skin-gui"> <title>GUI zpr叩vy</title> <para> Tyto zpr叩vy mohou b箪t generov叩ny tla�鱈tky, potenciometry a polo転kami nab鱈dky. </para> <variablelist> <title>Ovl叩d叩n鱈 p�ehr叩v叩n鱈:</title> <varlistentry> <term><emphasis role="bold">evNext</emphasis></term> <listitem><para> Sko�鱈 na n叩sleduj鱈c鱈 stopu v playlistu. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evPause</emphasis></term> <listitem><para> Tvo�鱈 p�ep鱈na� spole�n� s <literal>evPlaySwitchToPause</literal>. Ty mohou b箪t pou転ity k vytvo�en鱈 tradi�n鱈ho play/pauza tla�鱈tka. Ob� zpr叩vy by m�ly b箪t p�i�azeny tla�鱈tk哲m um鱈st�n箪m na stejn辿 pozici v okn�. Tato zpr叩va pozastav鱈 p�ehr叩v叩n鱈 a zobrazen bude obr叩zek pro <literal>evPlaySwitchToPause</literal> tal�鱈tko (pro indikaci, 転e tla�鱈tko m哲転e b箪t stisknuto pro obnoven鱈 p�ehr叩v叩n鱈). </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evPlay</emphasis></term> <listitem><para> Zah叩j鱈 p�ehr叩v叩n鱈. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evPlaySwitchToPause</emphasis></term> <listitem><para> Protiklad <literal>evPauseSwitchToPlay</literal>. Tato zpr叩va zah叩j鱈 p�ehr叩v叩n鱈 a zobraz鱈 obr叩zek pro tla�鱈tko <literal>evPauseSwitchToPlay</literal> (pro indikaci, 転e tla�鱈tko m哲転e b箪t stisknuto pro pozastaven鱈 p�ehr叩v叩n鱈). </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evPrev</emphasis></term> <listitem><para> Sko�鱈 na p�edchoz鱈 stopu v playlistu. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evStop</emphasis></term> <listitem><para> Zastav鱈 p�ehr叩v叩n鱈. </para></listitem> </varlistentry> </variablelist> <variablelist> <title>P�ev鱈jen鱈:</title> <varlistentry> <term><emphasis role="bold">evBackward10sec</emphasis></term> <listitem><para> P�evine zp�t o 10 sekund. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evBackward1min</emphasis></term> <listitem><para> P�evine zp�t o 1 minutu. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evBackward10min</emphasis></term> <listitem><para> P�evine zp�t o 10 minut. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evForward10sec</emphasis></term> <listitem><para> P�evine vp�ed o 10 sekund. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evForward1min</emphasis></term> <listitem><para> P�evine vp�ed o 1 minutu. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evForward10min</emphasis></term> <listitem><para> P�evine vp�ed o 10 minut. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evSetMoviePosition</emphasis></term> <listitem><para> P�evine na danou pozici (m哲転e b箪t p�i�azeno potenciometru; pou転ije se relativn鱈 hodnota (0-100%) potenciometru). </para></listitem> </varlistentry> </variablelist> <variablelist> <title>Ovl叩d叩n鱈 videa:</title> <varlistentry> <term><emphasis role="bold">evHalfSize</emphasis></term> <listitem><para> Nastav鱈 velikost okna filmu na polovi�n鱈 velikost. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evDoubleSize</emphasis></term> <listitem><para> Nastav鱈 velikost okna filmu na dvojn叩sobnou velikost. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evFullScreen</emphasis></term> <listitem><para> P�ep鱈n叩 do celoobrazovkov辿ho re転imu a zp�t. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evNormalSize</emphasis></term> <listitem><para> Nastav鱈 velikost okna na norm叩ln鱈 velikost. </para></listitem> </varlistentry> </variablelist> <variablelist> <title>Ovl叩d叩n鱈 zvuku:</title> <varlistentry> <term><emphasis role="bold">evDecAudioBufDelay</emphasis></term> <listitem><para> Sn鱈転鱈 zpo転d�n鱈 vyrovn叩vac鱈 pam�ti zvuku. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evDecBalance</emphasis></term> <listitem><para> Sn鱈転鱈 hodnotu stereov叩hy. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evDecVolume</emphasis></term> <listitem><para> Sn鱈転鱈 hlasitost. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evIncAudioBufDelay</emphasis></term> <listitem><para> Zv箪邸鱈 zpo転d�n鱈 vyrovn叩vac鱈 pam�ti zvuku. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evIncBalance</emphasis></term> <listitem><para> Zv箪邸鱈 hodnotu stereov叩hy. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evIncVolume</emphasis></term> <listitem><para> Zv箪邸鱈 hlasitost. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evMute</emphasis></term> <listitem><para> Vypne/zapne zvuk. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evSetBalance</emphasis></term> <listitem><para> Nastav鱈 stereov叩hu (m哲転e b箪t sdru転eno s potenciometrem; pou転ije se relativn鱈 hodnota potenciometru (0-100%)). </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evSetVolume</emphasis></term> <listitem><para> Nastav鱈 hlasitost (m哲転e b箪t sdru転eno s potenciometrem; pou転ije se relativn鱈 hodnota potenciometru (0-100%)). </para></listitem> </varlistentry> </variablelist> <variablelist> <title>R哲zn辿:</title> <varlistentry> <term><emphasis role="bold">evAbout</emphasis></term> <listitem><para> Otev�e okno o aplikaci. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evDropSubtitle</emphasis></term> <listitem><para> Vypne aktu叩ln� pou転it辿 titulky. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evEqualizer</emphasis></term> <listitem><para> Zapne/vypne ekvaliz辿r. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evExit</emphasis></term> <listitem><para> Ukon�鱈 program. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evIconify</emphasis></term> <listitem><para> Minimalizuje okno. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evLoad</emphasis></term> <listitem><para> Otev�e soubor (otev�en鱈m okna prohl鱈転e�e soubor哲, kde si soubor vyberete). </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evLoadPlay</emphasis></term> <listitem><para> Stejn辿 jako <literal>evLoad</literal>, ale nav鱈c se okam転it� spust鱈 p�ehr叩v叩n鱈 otev�en辿ho souboru. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evLoadSubtitle</emphasis></term> <listitem><para> Otev�e soubor s titulky (pomoc鱈 prohl鱈転e�e soubor哲) </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evLoadAudioFile</emphasis></term> <listitem><para> Otev�e soubor se zvukem (pomoc鱈 prohl鱈転e�e soubor哲) </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evNone</emphasis></term> <listitem><para> Pr叩zdn叩 zpr叩va, nem叩 転叩dn箪 efekt (mo転n叩 s v箪jimkou Subversion verz鱈 :-)). </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evPlaylist</emphasis></term> <listitem><para> Otev�e/zav�e okno playlistu. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evPlayDVD</emphasis></term> <listitem><para> Zkus鱈 otev�鱈t disk v zadan辿 DVD-ROM mechanice. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evPlayVCD</emphasis></term> <listitem><para> Zkus鱈 otev�鱈t disk v zadan辿 CD-ROM mechanice. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evPreferences</emphasis></term> <listitem><para> Otev�e okno p�edvoleb. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evSetAspect</emphasis></term> <listitem><para> Nastav鱈 pom�r stran zobrazovan辿ho obr叩zku. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evSetURL</emphasis></term> <listitem><para> Zobraz鱈 dialogov辿 okno pro volbu URL. </para></listitem> </varlistentry> <varlistentry> <term><emphasis role="bold">evSkinBrowser</emphasis></term> <listitem><para> Otev�e okno voli�e skin哲. </para></listitem> </varlistentry> </variablelist> </sect1> <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> <sect1 id="skin-quality"> <title>Tvorba kvalitn鱈ch skin哲</title> <para> Co kdy転 jste si p�e�etli o skinech pro GUI <application>MPlayer</application>u, odvedli to nejlep邸鱈 s <application>Gimp</application>em a chcete n叩m poslat sv哲j skin? P�e�t�te si p叩r n叩vod哲, abyste se vyhnuli b�転n箪m omyl哲m a vytvo�ili vysoce kvalitn鱈 skin. </para> <para> Chceme, aby skiny, kter辿 p�id叩me do na邸eho repozit叩�e odpov鱈daly ur�it箪m standard哲m kvality. Je zde tak辿 mnoho v�c鱈, kter辿 m哲転ete ud�lat, abyste n叩m uleh�ili pr叩ci. </para> <para> Za p�鱈klad si vemte skin <systemitem>Blue</systemitem>. Ten spl�uje v邸echna krit辿ria od verze 1.5. </para> <itemizedlist> <listitem><para> Ke ka転d辿mu skinu by m�l b箪t soubor <filename>README</filename>, obsahuj鱈c鱈 informace o v叩s jako autorovi, o copyrightu a licenci a v邸e ostatn鱈, co chcete dodat. Chcete-li m鱈t changelog, tento soubor je dobr箪m m鱈stem. </para></listitem> <listitem><para> M�l by tu b箪t soubor <filename>VERSION</filename> neobsahuj鱈c鱈 nic jin辿ho, ne転 �鱈slo verze na jedin辿m �叩dku (nap�. 1.0). </para></listitem> <listitem><para> Horizont叩ln鱈 a vertik叩ln鱈 ovl叩d叩n鱈 (posuvn鱈ky jako hlasitost nebo pozice) by m�ly m鱈t st�ed knofl鱈ku spr叩vn� zarovn叩n na stred posuvn鱈ku. M�lo by b箪t mo転n辿 posouvat knofl鱈k na oba konce posuvn鱈ku, ale ne za n�. </para></listitem> <listitem><para> Jednotliv辿 sou�叩sti skinu by m�ly m鱈t spr叩vn辿 rozm�ry deklarovan辿 v souboru skin. Pokud to tak nen鱈, m哲転ete kliknout mimo nap�. tla�鱈tko a to se stejn� stiskne, nebo kliknout na jeho plochu a nestisknout jej. </para></listitem> <listitem><para> Soubor <filename>skin</filename> by m�l b箪t srovn叩n na znaky a neobsahovat tabul叩tory. Srovn叩n na znaky znamen叩, 転e se �鱈sla budou rovnat do 炭hledn箪ch sloupc哲. </para></listitem> </itemizedlist> </sect1> </appendix>