Mercurial > mplayer.hg
view DOCS/xml/cs/skin.xml @ 17530:04d6525d59d6
change sws sharpen filter a little
author | michael |
---|---|
date | Sat, 04 Feb 2006 00:08:54 +0000 (2006-02-04) |
parents | 9f2b1c5bbf27 |
children | 9a5a62f480e6 |
line wrap: on
line source
<?xml version="1.0" encoding="iso-8859-2"?> <!-- Synced with: 1.12 --> <appendix id="skin"> <title>Form�t skin� <application>MPlayer</application>u</title> <para> 晄el tohoto dokumentu je popis form�tu skinu <application>MPlayer</application>u. Zde uveden� informace mohou b�t chybn�, proto�e: <orderedlist> <listitem><para>Nejsem to j�, kdo p躪e GUI.</para></listitem> <listitem><para>GUI nen� dokon�eno.</para></listitem> <listitem><para>Mohu se m�lit.</para></listitem> </orderedlist> Tak�e nebu�te p�ekvapeni, pokud n�co nebude pracovat p�esn� tak, jak je to zde pops�no. </para> <para>D�kuji <emphasis>Zolt�nu Ponekkerovi</emphasis> za jeho pomoc.</para> <para><emphasis>Andr�s Mohari <mayday@freemail.hu></emphasis></para> <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)/Skin/</filename> </para></listitem> <listitem><para> <filename class="directory">$(PREFIX)/share/mplayer/Skin/</filename> </para></listitem> <listitem><para> <filename class="directory">~/.mplayer/Skin/</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/Skin/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 is <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">Skin</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> Nakonec je�t� p�r slov k um�s�ov�n�. Hlavn� okno a podokno mohou b�t um�st�ny v r�zn�ch roz�ch obrazovky zad�n�m sou�adnic <literal>X</literal> a <literal>Y</literal>. <literal>0</literal> je naho�e nebo vlevo, <literal>-1</literal> je st�ed a <literal>-2</literal> je vpravo nebo dole, jak je vid�t na obr�zku: </para> <informalfigure> <screen> (0, 0)----(-1, 0)----(-2, 0) | | | | | | (0,-1)----(-1,-1)----(-2,-1) | | | | | | (0,-2)----(-1,-2)----(-2,-2) </screen> </informalfigure> <para> Aby bylo v�e jasn�, uv�d�me p�klad. �ekn�me, �e m�te obr�zek jm�nem <filename>main.png</filename>, kter� pou�ijete pro hlavn� okno: <programlisting>base = main, -1, -1</programlisting> <application>MPlayer</application> zkus� na蓁st soubory <filename>main</filename>, <filename>main.png</filename>, <filename>main.PNG</filename>. </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�: </para> <itemizedlist> <listitem><para><literal>tla蓁tko</literal> - obr�zek, ktr� 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: </para> <informalfigure> <screen> +------------+ | f�ze #1 | +------------+ | f�ze #2 | +------------+ ... +------------+ | f�ze #n | +------------+ </screen> </informalfigure> </listitem> <listitem><para><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> </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> </listitem> </varlistentry> </variablelist> <note><para> Prom�nn� <literal>$a, $T, $p, $s</literal> a <literal>$e</literal> vracej� znaky, kter� by se m�ly zobrazit jako speci�ln� symboly (nap�klad <keycap>e</keycap> je symbol pro pauzu, kter� obvykle vypad� asi takto ||). M�li byste m�t font pro norm�ln� znaky a jin� font pro symboly. Pro v�ce informac� viz sekci <link linkend="skin-fonts-symbols">symboly</link>. </para></note> </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>pause</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> <note><para> N�kter� zpr�va nemus� pracovat podle o�ek�v�n� (nebo v�bec). Jak v�te, GUI je ve v�voji. </para></note> <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. 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 CVS 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> </appendix>