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 &lt;mayday@freemail.hu&gt;</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>&lt;jm�no&gt;.&lt;p�p&gt;</filename>, kdy jsou za
<filename>&lt;p�p&gt;</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, &quot;text&quot;
  </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 &quot; 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, &quot;text&quot;
  </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 &quot; 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>&quot;char&quot; = 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 &quot;font&quot; m�sto &quot;font.png&quot;.
image = font.png

; T�i znaky pro ilustraci sta蓁 :-)
&quot;A&quot; =  0,0, 7,13
&quot;B&quot; =  7,0, 7,13
&quot;C&quot; = 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>