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

<?xml version="1.0" encoding="utf-8"?>
<!-- synced with r19081 -->
<!-- Opiekun: Flex -->
<appendix id="skin">
<title>Format skórki <application>MPlayera</application></title>

<sect1 id="skin-overview">
<title>Wstęp</title>
<para>
W zasadzie nie ma to żadnego związku z formatem skórki, ale powinieneś
wiedzieć, że <application>MPlayer</application> <emphasis role="bold">nie</emphasis>
ma wbudowanej skórki, w związku z tym <emphasis role="bold"> co najmniej
jedna skórka musi być zainstalowana, abyś miał możliwość korzystania z GUI.</emphasis>
</para>

<sect2 id="skin-overview-directories">
<title>Katalogi</title>
<para>
Skórki są szukane w następujących katalogach (w kolejności):
<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>
Zauważ, że pierwsza ścieżka może się różnić, w zależności od sposobu w jaki
<application>MPlayer</application> został skonfigurowany
(zobacz argumenty <option>--prefix</option> oraz <option>--datadir</option>
w skrypcie <command>configure</command>).
</para>

<para>
Każda skórka jest instalowana w swoim własnym katalogu, w jednej z wyżej
wymienionych lokacji, na przykład:
<screen>$(PREFIX)/share/mplayer/skins/default/</screen>
</para>
</sect2>

<sect2 id="skin-overview-formats">
<title>Formaty obrazków</title>
<para>Obrazki muszą być zapisane w formacie PNG (paleta truecolor - 24 lub 32 bpp).</para>
<para>
W głównym oknie oraz na panelu odtwarzania (zobacz niżej) możesz użyć
obrazków z 'przezroczystością': obszary wypełnione kolorem #FF00FF (magenta) są
w pełni przezroczyste dla <application>MPlayera</application>. Oznacza to, że
możesz mieć okna o różnych kształtach jeśli Twój X Server ma rozszerzenie
XShape.
</para>
</sect2>

<sect2 id="skin-overview-components">
<title>Składniki skórki</title>
<para>
Skórki są całkowicie konfigurowalne (w odróżnieniu od skórek np. 
<application>Winampa</application>/<application>XMMS</application>),
a więc zależy to wyłącznie od Ciebie, czy stworzysz coś wspaniałego.
</para>

<para>
W chwili obecnej mamy cztery okna, które można ozdobić:
<link linkend="skin-file-main">okno główne (main window)</link>,
<link linkend="skin-file-subwindow">okno ekranu (subwindow)</link>,
<link linkend="skin-file-main">panel odtwarzania (playbar)</link>,
<link linkend="skin-file-menu">menu skórki (skin menu)</link> (które może być
aktywowane prawym przyciskiem myszy).

<itemizedlist>
<listitem><para>
  <emphasis role="bold">Okno główne</emphasis> i/lub
  <emphasis role="bold">panel odtwarzania</emphasis> to miejsca, gdzie możesz
  sterować <application>MPlayerem</application>.
  Tłem tego okna jest obrazek. Różne elementy mogą (i muszą) być umieszczone
  w tym oknie: <emphasis>przyciski</emphasis>, <emphasis>potencjometry</emphasis>
  (suwaki) i <emphasis>etykiety</emphasis>. Dla każdego elementu musisz określić
  ich pozycję oraz rozmiar.
</para><para>
   <emphasis role="bold">Przycisk</emphasis> ma trzy stany (wciśnięty,
   zwolniony, nieaktywny), zatem jego obrazki muszą być podzielone na trzy
   części w pionie. Zobacz sekcję <link linkend="skin-button">button</link>, by
   dowiedzieć się więcej.
</para><para>
  <emphasis role="bold">Potencjometr (suwak)</emphasis> (wykorzystywany głównie
  jako pasek przewijania i kontrolka głośności/balansu) może składać się z
  każdej liczby stanów poprzez podzielenie jego obrazka na wiele części, z
  których jedna jest pod drugą. Zobacz
  <link linkend="skin-hpotmeter">hpotmeter</link> oraz
  <link linkend="skin-potmeter">potmeter</link>, by dowiedzieć się więcej.
</para><para>
  <emphasis role="bold">Etykiety</emphasis> są nieco specyficzne: Znaki
  potrzebne do ich narysowania są pobierane z pliku graficznego, a znaki
  umieszczone w pliku graficznym są opisane przez
  <link linkend="skin-fonts">plik opisu czcionek</link>. Jest to plik, który za
  pomocą czystego tekstu określa współrzędne x, y oraz wielkość każdego znaku
  umieszczonego na obrazku (plik graficzny i jego plik opisu tworzą
  <emphasis>razem</emphasis> czcionkę).
  Zobacz <link linkend="skin-dlabel">dlabel</link>
  oraz <link linkend="skin-slabel">slabel</link>, by dowiedzieć się więcej.
</para>
<note><para>Wszystkie obrazki mogą być całkowicie przezroczyste - tak, jak to
opisano w sekcji <link linkend="skin-overview-formats">formaty plików
graficznych</link>. Jeżeli X Server nie obsługuje rozszerzenia XShape, to
elementy oznaczone jako przezroczyste będą czarne. Jeśli chciałbyś wykorzystać
taką możliwość, szerokość obrazka tła głównego okna musi być podzielna przez 8.
</para></note>
</listitem>

<listitem><para>
  <emphasis role="bold">Okno ekranu</emphasis> to miejsce, gdzie odtwarzany jest
  film. Może ono wyświetlać określony obrazek, jeśli żaden film nie jest uruchomiony
  (to dość nudne mieć puste okno :-)) <emphasis role="bold">Uwaga:</emphasis>
  przezroczystość <emphasis role="bold">nie jest</emphasis> tutaj dostępna.
</para></listitem>

<listitem><para>
  <emphasis role="bold">Menu skórki</emphasis> to po prostu jeden ze sposobów na
  kontrolowanie <application>MPlayera</application> poprzez wpisy w menu. Dwa
  obrazki są do tego potrzebne: pierwszy z nich jest obrazkiem podstawowym,
  który pokazuje zwykły stan menu, drugi zaś służy do wyświetlenia zaznaczonych
  obszarów. Gdy uaktywnisz menu, zostanie pokazany pierwszy obrazek. Jeśli
  przesuniesz mysz nad któryś z jego wpisów, wówczas zaznaczony element jest
  kopiowany z drugiego obrazka w miejsce, na które wskazuje kursor myszy (drugi
  obrazek nigdy nie jest wyświetlany w całości).
</para><para>
 Wpis w menu jest określony przez jego pozycję oraz rozmiar na obrazku (zobacz
 sekcję <link linkend="skin-file-menu">menu skórki</link> by dowiedzieć się
 więcej).
</para></listitem>
</itemizedlist>
</para>

<para>
  Jedna ważna sprawa, która nie została jeszcze powiedziana:
  <application>MPlayer</application> musi wiedzieć co zrobić w momencie
  kliknięcia na przyciski, potencjometry i wpisy w menu, aby zadziałały. Zostało
  to zrobione za pomocą <link linkend="skin-gui">sygnałów</link> (zdarzeń). Dla
  tych elementów musisz zdefiniować sygnały, które mają być wysłane podczas
  kliknięcia na nie.
</para>
</sect2>

<sect2 id="skin-files">
<title>Pliki</title>
<para>
Potrzebujesz następujących plików do stworzenia skórki:
<itemizedlist>
<listitem><para>
  Plik konfiguracyjny o nazwie <link linkend="skin-file">skin</link> mówi
  <application>MPlayerowi</application> jak połączyć różne części skórki
  w jedną całość i co zrobić, gdy kliknie się gdzieś na obszarze okna.
</para></listitem>
<listitem><para>
  Plik graficzny tła w oknie głównym.
</para></listitem>
<listitem><para>
  Obrazki dla elementów w głównym oknie (zawierające jeden lub
  więcej plików opisu czcionek potrzebnych do rysowania etykiet).
</para></listitem>
<listitem><para>
  Obrazek wyświetlany w oknie ekranu (opcjonalnie)
</para></listitem>
<listitem><para>
  Dwa obrazki dla menu skórki (potrzebne są tylko wtedy, gdy chcesz stworzyć
  takie menu).
</para></listitem>
</itemizedlist>
  Za wyjątkiem pliku konfiguracyjnego skórki, możesz nazwać wszystkie pliki
  tak, jak tego chcesz (ale weź pod uwagę, że pliki opisu czcionek muszą mieć
  rozszerzenie <filename>.fnt</filename> ).
</para>
</sect2>
</sect1>

<sect1 id="skin-file">
<title>Plik skin</title>
<para>
Jak zostało powiedziane wcześniej, plik ten jest plikiem konfigurującym skórkę.
Obsługuje różne rodzaje wierszy; komentarze zaczynają wiersz znakiem
'<literal>;</literal>' (tylko spacje i znaki tabulacji są dopuszczone przed
'<literal>;</literal>').
</para>

<para>
Plik podzielony jest na sekcje. Każda sekcja opisuje skórkę dla każdej
aplikacji i ma następującą formę:

<programlisting>
section = <replaceable>nazwa sekcji</replaceable>
.
.
.
end
</programlisting>
</para>

<para>
Obecnie jest tylko jedna aplikacja, a więc potrzebujesz tylko jedną sekcję
'section' - jej nazwa to <emphasis role="bold">movieplayer</emphasis>.
</para>

<para>
Wewnątrz tej sekcji każde z okien jest opisane przez blok następującej postaci:
<programlisting>
window = <replaceable>nazwa okna</replaceable>
.
.
.
end
</programlisting>
</para>

<para>
gdzie <replaceable>nazwa okna</replaceable> może być jednym z poniższych łańcuchów:
<itemizedlist>
<listitem><para><emphasis role="bold">main</emphasis> - dla okna głównego</para></listitem>
<listitem><para><emphasis role="bold">sub</emphasis> - dla okna ekranu</para></listitem>
<listitem><para><emphasis role="bold">menu</emphasis> - dla menu skórki</para></listitem>
<listitem><para><emphasis role="bold">playbar</emphasis> - dla panelu odtwarzania</para></listitem>
</itemizedlist>
</para>

<para>
(Bloki sub i menu są opcjonalne - nie musisz tworzyć menu czy elementów skórki
dla okna ekranu)
</para>

<para>
Wewnątrz bloku 'window' możesz definiować każdy element okna, wpisując linijkę
tej postaci: <programlisting>item = parametr</programlisting>
Gdzie <literal>item</literal> jest łańcuchem, kóry identyfikuje typ elementu
GUI, <literal>parametr</literal> jest wartością numeryczną lub tekstową (lub
listą takich wartości oddzielonych od siebie znakiem przecinka).
</para>

<para>
Złożenie powyższych elementów razem tworzy plik, który wygląda mniej więcej tak:
<programlisting>
section = movieplayer
  window = main
  ; ... elementy okna głównego ...
  end

  window = sub
  ; ... elementy okna ekranu ...
  end

  window = menu
  ; ... elementy menu skórki ...
  end

  window = playbar
  ; ... elementy panelu odtwarzania ...
  end
end
</programlisting>
</para>

<para>
Nazwa pliku graficznego musi zostać podana bez żadnych nazw katalogów - obrazki
są szukane w katalogu <filename class="directory">skins</filename>.
Możesz (ale nie musisz) określić rozszerzenia tego pliku. Jeśli plik taki nie
istnieje, <application>MPlayer</application>
spróbuje wczytać plik <filename>&lt;nazwa pliku&gt;.&lt;rozszerzenie&gt;</filename>,
gdzie <literal>png</literal> oraz <literal>PNG</literal> są brane jako
<filename>&lt;rozszerzenie&gt;</filename> (w tej właśnie kolejności). Pierwszy
pasujący plik będzie użyty.
</para>

<para>
Na koniec kilka słów na temat pozycjonowania. Okno główne oraz okno ekranu możesz
umieścić w różnych narożnikach ekranu poprzez ustawienie współrzędnych
<literal>X</literal> i <literal>Y</literal>. <literal>0</literal> to góra lub
lewa strona, <literal>-1</literal> to środek, <literal>-2</literal> to strona
prawa, lub dół, tak jak przedstawiono na poniższej ilustracji:
</para>
<informalfigure>
<screen>
(0, 0)----(-1, 0)----(-2, 0)
  |          |          |
  |          |          |
(0,-1)----(-1,-1)----(-2,-1)
  |          |          |
  |          |          |
(0,-2)----(-1,-2)----(-2,-2)
</screen>
</informalfigure>

<para>
Oto przykład wyjaśniający to lepiej. Przypuśćmy, że masz obrazek nazwany
<filename>main.png</filename>, który został użyty dla okna głównego:
<programlisting>base = main, -1, -1</programlisting>
<application>MPlayer</application> spróbuje wczytać pliki
<filename>main</filename>, <filename>main.png</filename>,
<filename>main.PNG</filename>.
</para>


<sect2 id="skin-file-main">
<title>Okno główne i panel odtwarzania</title>
<para>
Poniżej znajduje się lista wpisów, które mogą być użyte w blokach
'<literal>window = main</literal>'...'<literal>end</literal>'
oraz '<literal>window = playbar</literal>' ... '<literal>end</literal>'.
</para>

<variablelist>
<varlistentry>
  <term><literal>
  <anchor id="skin-main-base"/>base = obrazek, X, Y
  </literal></term>
  <listitem><para>
  Możesz określić obrazek tła, który będzie używany w oknie głównym.
  Okno będzie widoczne na ekranie na współrzędnych <literal>X, Y</literal>. Okno
  będzie wielkości tego obrazka.
    </para>
    <note><para>Współrzędne te nie działają na razie dla okna ekranu.</para></note>
    <warning><para>Obszary przezroczystości obrazka (kolor #FF00FF) będą
    widoczne jako czarne pod X serwerami niemającymi rozszerzenia
    XShape. Szerokość obrazka musi być podzielna przez 8.</para></warning>
    </listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-button"/>button = obrazek, X, Y, szerokość, wysokość, sygnał
  </literal></term>
  <listitem><para>
Umieści przycisk o rozmiarze <literal>szerokość</literal> *
<literal>wysokość</literal> na pozycji <literal>X</literal>,
<literal>Y</literal>. Określony <literal>sygnał</literal> jest generowany
podczas kliknięcia na przycisk. Obrazek ten opisany przez
<literal>obrazek</literal> musi składać się z trzech części jedna pod drugą
(stosownie do możliwych stanów przycisku), w ten oto sposób:
</para>
<informalfigure>
<screen>
+---------------+
|  wciśnięty    |
+---------------+
|  zwolniony    |
+---------------+
| nieaktywny    |
+---------------+
</screen>
</informalfigure>
  </listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-decoration"/>decoration = enable|disable (włączona|wyłączona)
  </literal></term>
  <listitem><para>
Włącza lub wyłącza dekorację menedżera okna w oknie głównym.
Domyślnie jest <emphasis role="bold">wyłączona</emphasis>.
    </para>
    <note><para>Nie działa to w oknie ekranu, gdyż nie ma takiej potrzeby.</para></note>
  </listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-hpotmeter"/>hpotmeter = przycisk, szer_przycisku, wys_przycisku, faza, liczba_faz, domyślny, X, Y, szerokość, wysokość, sygnał
  </literal></term>
  <listitem><para>

    </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-vpotmeter"/>vpotmeter = przycisk, szer_przycisku, wys_przycisku, fazy, liczba_faz, domyślny, X, Y, szerokość, wysokość, sygnał
  </literal></term>
  <listitem><para>
Umieszcza poziomo (hpotmeter) lub pionowo (vpotmeter) suwak o rozmiarze
<literal>szerokość</literal> * <literal>wysokość</literal> i pozycji
<literal>X,Y</literal>. Obrazek może być podzielony na różne części dla różnych
faz suwaka (np. możesz mieć suwak głośności, który w zależności od położenia
zmienia kolor z zielonego (minimum) na czerwony (maksimum)).
<literal>hpotmeter</literal> może być przyciskiem umieszczonym poziomo.
Jego parametry to:
    </para>
    <itemizedlist>
    <listitem><para><literal>przycisk</literal> - obrazek użyty do przycisku
    (musi posiadać trzy części jedna pod drugą tak, jak w przypadku
    <link linkend="skin-button">przycisku</link>)
    </para></listitem>
    <listitem><para><literal>szer_przycisku</literal>,<literal>wys_przycisku</literal> - wielkość przycisku
    </para></listitem>
   <listitem><para><literal>fazy</literal> - obrazek używany do określenie faz
   dla hpotmeter. Wartość specjalna <literal>NULL</literal> może być użyta,
   jeśli nie chcesz żadnego obrazka. Obrazek musi być podzielony w pionie
   na fragmenty <literal>poszczególnych faz</literal> tak, jak poniżej:
    </para>
<informalfigure>
<screen>
+------------+
|  faza #1   |
+------------+
|  faza #2   |
+------------+
     ...
+------------+
|  faza #n   |
+------------+
</screen>

</informalfigure>
    </listitem>
    <listitem><para><literal>liczba_faz</literal> - liczba faz znajdująca się na obrazku z <literal>fazami</literal>
    </para></listitem>
    <listitem><para><literal>domyślny</literal> - domyślne ustawienie dla hpotmeter
    (zakres od <literal>0</literal> do <literal>100</literal>)
    </para></listitem>
    <listitem><para><literal>X</literal>,<literal>Y</literal> - pozycja dla hpotmeter
    </para></listitem>
    <listitem><para><literal>szerokość</literal>,<literal>wysokość</literal> - szerokość i wysokość dla
  <literal>hpotmeter</literal>
    </para></listitem>
    <listitem><para><literal>sygnał</literal> - sygnał generowany podczas zmiany wartości <literal>hpotmeter</literal>
    </para></listitem>
    </itemizedlist>

    </listitem>
</varlistentry>

<varlistentry>
  <term><literal>
  <anchor id="skin-potmeter"/>potmeter = fazy, liczba_faz, domyślny, X, Y, szerokość, wysokość, sygnał
  </literal></term>
  <listitem><para>
<literal>hpotmeter</literal> bez przycisku. (domyślam się, że chodzi o to, aby
nim kręcić, ale reaguje on tylko na poziome przesuwanie). Opis parametrów znajdziesz w części o
<link linkend="skin-hpotmeter">hpotmeter</link>.
Parametr <literal>fazy</literal> może mieć wartość <literal>NULL</literal>, ale
jest to zupełnie bezużyteczne, gdyż nie widać wtedy położenia potencjometru.
    </