path: root/DOCS/xml/cs/skin.xml

<?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)/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
  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">skins</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>
&l