comparison DOCS/xml/de/skin.xml @ 18650:587abd8f3dab

Except for missing cd-dvd.xml and codecs.xml, German xml docs should be complete, synced and corrected :) Here we go: bugreports.xml: * r18600: xml docs: CVS --> Subversion * r18552: URL fix bugs.xml, audio.xml, usage.xml, faq.xml, tvinput.xml, documentation.xml: * fix "in sync with" tag skin.xml: * review * r18600: xml docs: CVS --> Subversion * r17975: Rename the default GUI skins directory from 'Skin' to 'skins' install.xml: * r17975: Rename the default GUI skins directory from 'Skin' to 'skins' * r17707: New website structure, the /homepage subdirectory is gone. * r17462: s/LIVE.COM/LIVE555/ + URL update video.xml: * tiny wording fix mail-lists.xml: * r18606: Fix mailing list name. * r18600: xml docs: CVS --> Subversion

18649:a367e32c2173

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- in sync with r18600 -->
<appendix id="skin">
<title><application>MPlayer</application> Skinformat</title>

<sect1 id="skin-overview">
<title>Überblick</title>
<para>
  Es hat nicht wirklich etwas mit dem Skinformat zu tun, aber du solltest
  wissen, dass <application>MPlayer</application> <emphasis role="bold">keinen</emphasis>
  eingebauten Skin besitzt, also <emphasis role="bold">muß zumindest ein Skin
  installiert sein, damit das GUI verwendet werden kann.</emphasis>
</para>

<sect2 id="skin-overview-directories">
<title>Verzeichnisse</title>

  (siehe Argumente <option>--prefix</option> und <option>--datadir</option>
  des <command>configure</command>-Scripts).
</para>

<para>
  Jeder Skin wird in sein eigenes Verzeichnis unterhalb einem der oben
  aufgeführten Verzeichnisse installiert, zum Beispiel:
<screen>$(PREFIX)/share/mplayer/skins/default/</screen>
</para>
</sect2>

<para>
  Die Bilder müssen Truecolor-PNGs sein (24 oder 32 bpp).
</para>

<para>
  Im Hauptfenster und in der Abspilleiste (siehe unten) kannst du Bilder
  mit 'Transparenz' verwenden: Mit der Farbe #FF00FF (Magenta) gefüllte Bereiche
  sind beim Betrachten mit <application>MPlayer</application> voll transparent.
  Die bedeutet, dass du sogar Formfenster haben kannst, wenn dein X-Server die
  XShape-Extension besitzt.
</para>

<para>
  Zur Zeit sind vier Fenster zu dekorieren: das
  <link linkend="skin-file-main">Hauptfenster</link>, das
  <link linkend="skin-file-subwindow">Unterfenster</link>, die
  <link linkend="skin-file-main">Abspielleise</link> und das
  <link linkend="skin-file-menu">Skin-Menü</link> (das durch einen
  Rechtsklick aktiviert werden kann).

<itemizedlist>
<listitem><para>
  Das <emphasis role="bold">Hauptfenster</emphasis> und/oder die
  <emphasis role="bold">Abspielleise</emphasis> befindet sich dort, wo du
  <application>MPlayer</application> kontrollieren kannst. Der Hintergrund
  des Fensters ist ein Grafik.
  Ins Fenster können (und müssen) diverse Elemente platziert werden:
  <emphasis>Buttons</emphasis>, <emphasis>Potentiometer</emphasis> (Schieberegler)
  und <emphasis>Labels</emphasis>.
  Für jedes Element, musst du dessen Position und Größe.
</para><para>
  Ein <emphasis role="bold">Button</emphasis> besitzt drei Zustände (gedrückt,
  losgelassen, deaktiviert), deshalb muss seine Grafik vertikal in drei Teile
  getrennt werden. Siehe Eintrag <link linkend="skin-button">Button</link>
  mit mehr Details.
</para><para>
  Ein <emphasis role="bold">Potentiometer</emphasis> (hauptsächlich für
  die Suchleiste und die Lautstärke-/Balance-Regler) kann eine beliebige
  Anzahl von Phasen by dividing its Grafik
  into different parts below each other. See
  <link linkend="skin-hpotmeter">hpotmeter</link> and
  <link linkend="skin-potmeter">Potentiometer</link> for details.
</para><para>
  <emphasis role="bold">Labels</emphasis> sind ein wenig speziell: Die Zeichen,
  die manzu ihrer Darzustellung benötigt, werden von einer Grafikdatei, und
  die Zeichen in der Grafik werden durch eine
  <link linkend="skin-fonts">Schrift-Beschreibungsdatei</link> festgelegt.
  Letztere ist eine Volltextdatei, welche die x-,y-Position und Größe jedes
  Zeichens in der Grafik beschreibt (die Grafikdatei und ihre
  Schrift-Beschreibungsdatei bilden <emphasis>zusammen</emphasis> eine Schrift).
  Siehe
  <link linkend="skin-dlabel">dlabel</link>
  und
  <link linkend="skin-slabel">slabel</link> fpr Details.
</para>
<note>
<para>
  Alle Grafiken können wie im Abschnitt über die
  <link linkend="skin-overview-formats">Grafikformate</link> erklärt

</para>
</note>
</listitem>

<listitem><para>
  Das <emphasis role="bold">Unterfenster</emphasis> ist dort wo der Film
  erscheint. Es kann eine festgelegte Grafik anzeigen, wenn kein Film geladen
  iat (es ist ziemlich langweilig, ein leeres Fenster vor sich zu haben :-))
  <emphasis role="bold">Beachte:</emphasis> Transparenz ist hier
  <emphasis role="bold">nicht erlaubt</emphasis>.
</para></listitem>

<listitem><para>
  Das <emphasis role="bold">Skin-Menü</emphasis> ist ganz einfach ein
  Weg, <application>MPlayer</application> mittels der Menüeinträge zu
  kontrollieren. Zwei Grafiken sind für das Menü erforderlich:
  eine davon ist die Basisgrafik, die den Normalzustand des Menüs darstellt,
  die andere wird zur Anzeige des gewählten Einträge verwendet.
  Wenn due das Menü aufklappst, wird die erste Grafik angezeigt. Bewegst du
  die Maus über die Menüeinträge, wird der aktuell gewählte Eintrag aus der
  zweiten Grafik über den Menüeintrag unterhalb des Mauszeigers kopiert
  (die zweite Grafik wird nie als Ganzes angezeigt).
</para><para>
  Rin Menüeintrag wird definiert durch seine Position und Größe innerhalb
  der Grafik (sieh nach mehr Details im Abschnitt über das
  <link linkend="skin-file-menu">Skin-Menü</link>).
</para></listitem>
</itemizedlist>
</para>

</sect2>

<sect2 id="skin-files">
<title>Dateien</title>
<para>
  Du benötigst folgende Dateien, um einen Skin zu bauen:
<itemizedlist>
<listitem><para>
  Die Konfigurationsdatei genannt <link linkend="skin-file">skin</link> erzählt
  <application>MPlayer</application>, wie er unterschiedliche Teile des Skins
  zusammengefügt werden und was er tun soll, wenn du irgendwo innerhalb des Fenster
  hinklickst.
</para></listitem>
<listitem><para>
  Die Hintergrundgrafik fürs Hauptfenster.
</para></listitem>
<listitem><para>
  Grafiken für die Elemente im Hauptfenster (einschließlich einer oder mehrerer
  Schrift-Beschreibungsdateien zum zeichnen der Labels).
</para></listitem>
<listitem><para>
  Die Grafik, die im Unterfenster angezeigt werden soll (optional).
</para></listitem>
<listitem><para>
  Zwei Grafiken für das Skin-Menü (sie werden nur gebraucht, wenn du want
  ein Menü erzeugst).
</para></listitem>
</itemizedlist>
  Mit Ausnahme der skin-Konfigurationsdatei, kannst du die anderen Dateien
  benenne, wie es dir beliebt (beachte aber, dass Schrift-Beschreibungsdateien
  eine <filename>.fnt</filename>-Erweiterung besitzen müssen).
</para>
</sect2>
</sect1>

<sect1 id="skin-file">
<title>Die skin-Datei</title>
<para>
  Wie oben erwähnt, ist dies die skin-Konfigurationsdatei. Sie ist
  Zeilen-orientiert;
  Kommentarzeilen beginnen mit einem '<literal>;</literal>' Semikolon-Zeichen
  am Zeilenanfang (es sind nur Leer- und Tabulator-Zeichen vor dem
  '<literal>;</literal>' erlaubt).
</para>

<para>
  Die Datei ist in Abschnitte unterteilt. Jeder Abschnitt beschreibt den Skin
  für eine Anwendung und besitzt folgende Form:
<programlisting>
section = <replaceable>abschnittsname</replaceable>
.
.
.
end
</programlisting>
</para>

<para>
  Zur Zeit gibt es nur eine Anwendung, somit brauchst du nur einen Abschnitt:
  sein Name ist <emphasis role="bold">movieplayer</emphasis>.
</para>

<para>
  Innerhalb dieses Abschnitts wird jedes Fenster durch einen Block folgender
  Form beschrieben:
<programlisting>
window = <replaceable>fenstername</replaceable>
.
.
.
end
</programlisting>
</para>

<para>
  wobei <replaceable>fenstername</replaceable> einer dieser Strings sein
  kann:
<itemizedlist>
<listitem><para><emphasis role="bold">main</emphasis> - für das Hauptfenster</para></listitem>
<listitem><para><emphasis role="bold">sub</emphasis> - für das Unterfenster</para></listitem>
<listitem><para><emphasis role="bold">menu</emphasis> - für das Skin-Menü</para></listitem>
<listitem><para><emphasis role="bold">playbar</emphasis> - Abspielleise</para></listitem>
</itemizedlist>
</para>

<para>
  (Die sub- und menu-Blöcke sind optional - du musst kein Menü erzeugen oder
  das Unterfenster dekorieren.)
</para>

<para>
  Innerhalb des Fensterblocks kannst du jedes Element für das Fenster durch eine
  Zeile in dieser Form definieren:
<programlisting>item = parameter</programlisting>
  Wobei <literal>item</literal> ein String ist, der den Typ des GUI-elements
  identifiziert, <literal>parameter</literal> ist ein numerischer oder textueller
  Wert (oder eine Liste Komma-getrennter Werte).
</para>

<para>
  Fügt man nun das oben genannte zusammen, sieht die komplette Datei etwa so aus:
<programlisting>
section = movieplayer
  window = main
  ; ... Elemente fürs Hauptfenster ...
  end

  window = sub
  ; ... Elemente fürs Unterfenster ...
  end

  window = menu
  ; ... Elemente fürs Menü ...
  end

  window = playbar
  ; ... Elemente für die Abspielleise ...
  end
end
</programlisting>
</para>

<para>
  Der Name einer Grafikdatei muss ohne führende Pfadangaben angegeben werden -
  Grafiken werden im Verzeichnis <filename class="directory">skins</filename>
  gesucht.
  Du kannst (musst aber nicht) die Erweiterungder Datei spezifizieren.
  Existiert die Datei nicht, versucht <application>MPlayer</application> die
  <filename>&lt;dateiname&gt;.&lt;ext&gt;</filename> zu laden, wobwei
  <literal>png</literal> und <literal>PNG</literal> als
  <filename>&lt;ext&gt;</filename> (Erweiterung) versucht werden
  (in dieser Reihenfolge). Die erste zutreffende Datei wird verwendet.
</para>

<para>
  Zum Schluss einige Worte zur Positionierung.

(0,-2)----(-1,-2)----(-2,-2)
</screen>
</informalfigure>

<para>
  Hier ein Beispiel, um es zu verdeutlichen. Angenommen du hast eine Grafik
  mit Namen <filename>main.png</filename>, die für das Hauptfenster nutzt:
  <programlisting>base = main, -1, -1</programlisting>
  <application>MPlayer</application> versucht, die Dateien
  <filename>main</filename>,
  <filename>main.png</filename>,

  zu laden.
</para>


<sect2 id="skin-file-main">
<title>Hauptfenster und Abspielleise</title>
<para>
  Unten steht eine Liste von Einträgen, die in den Blöcken
  '<literal>window = main</literal>' ... '<literal>end</literal>',
  und the '<literal>window = playbar</literal>' ... '<literal>end</literal>'
  genutzt werden können.
</para>

<variablelist>
<varlistentry>

  <para>
  Platziere einen horizontal (hpotmeter) oder vertikal (vpotmeter) Potentiometer mit
  der Größe <literal>width</literal> * <literal>height</literal> an Position
  <literal>X,Y</literal>. Die Grafik kann in unterschiedliche Teile für die
  verschiedenen Phasen des Potentiometers aufgeteilt werden (du kannst zum Beispiel
  eines für die Lautstärkeregelung haben, das von rot nach grün wechselt während
  sein Wert sich vom Minimum zum Mmaximum ändert.).
  <literal>hpotmeter</literal> kann einen Button besitzen, der horizontal gezogen
  werden kann. Die Parameter sind:
    </para>
    <itemizedlist>
    <listitem><para><literal>button</literal> - die für den Button zu verwendende
    Grafik (muss drei untereinander liegende Teile aufweisen, wie im Fall des
    <link linkend="skin-button">Buttons</link>)
  </para></listitem>
    <listitem><para><literal>bwidth</literal>, <literal>bheight</literal> - Größe
    de Buttons
  </para></listitem>
   <listitem><para><literal>phases</literal> - die für die verschiedenen Phasen
   zu verwendende Grafik des hpotmeter. Ein spezieller Wert von <literal>NULL</literal>
   kann benutzt werden, wenn du keine solche Grafik anwenden willst. Die Grafik muss
   in vertikal <literal>numphases</literal> Teile wie folgt aufgeteilt werden:

</informalfigure>
    </listitem>
    <listitem><para><literal>numphases</literal> - Anzahl der Phasen, die in der
    <literal>phases</literal>-Grafik untergebracht sind
  </para></listitem>
    <listitem><para><literal>default</literal> - Standard Wert fürs hpotmeter
    (im Bereich <literal>0</literal> bis <literal>100</literal>)
  </para></listitem>
    <listitem><para><literal>X</literal>, <literal>Y</literal> - Position fürs hpotmeter
  </para></listitem>
    <listitem><para><literal>width</literal>, <literal>height</literal> - Breite und Höhe

  Das Label wird als dynamisch bezeichnet, weil sein Text periodisch
  aktualisiert wird. Die Maximallänge des Labels wird mit dem
  Wert <literal>length</literal> vorgegeben (seine Höhe ist die der
  Zeichen).
  Wird der anzuzeigende Text breiter als dieser Wert, wird er gescrollt,
  andernfalls wird er innerhalb des mittels des Wertes des
  <literal>align</literal>-Parameters festgelegten Zwischenraums ausgerichtet:
  <literal>0</literal> steht für rechts,
  <literal>1</literal> steht für zentriert,
  <literal>2</literal> steht für links.
</para>

  Der anzuzeigende Text wird mit <literal>text</literal> festgelegt:
  Er muss zwischen doppelten Anführungszeichen stehen (das &quot;-Zeichen kann jedoch
  nicht Teil des Textes sein).
  Das Label wird mittels der über die <literal>fontid</literal> identifizierten
  Schrift angezeigt.
  Kannst folgende Variablen im Text verwenden:
</para>

<informaltable>
<tgroup cols="2">
<thead>

<entry>$F</entry>
<entry>Dateiname in GROSSBUCHSTABEN</entry>
</row>
<row>
<entry>$T</entry>
<entry>Ein dem Stream-Typen entsprechendes Zeichen (Datei: <literal>f</literal>,
Video-CD: <literal>v</literal>, DVD: <literal>d</literal>, URL: <literal>u</literal>)</entry>
</row>
<row>
<entry>$p</entry>
<entry>Das <keycap>p</keycap>-Zeichen (wenn ein Film abgespielt wird und die Schrift

</para>

<variablelist>
<varlistentry>
  <term><literal>
  <anchor id="skin-sub-base"/>base = image, X, Y, breite, hoehe
  </literal></term>
  <listitem><para>
  Die im Fenster anzuzeigende Grafik. Das Fenster wird an der angegebenen
  Position <literal>X,Y</literal> auf dem Bildschirm erscheinen
  (<literal>0,0</literal> ist die obere linke Ecke).
  Du kannst <literal>-1</literal> für zentriert und <literal>-2</literal>
  für rechts (<literal>X</literal>) und unten (<literal>Y</literal>) festlegen.
  Das Fenster wird so groß sein wie die Grafik.
  <literal>width</literal> und <literal>height</literal>
  kennzeichnen die Größe des Fensters; sie sind optional (wenn sie fehlen, hat
  das Fenster die selbe Größe wie die Grafik).
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>

  <listitem><para>
  Lässt dich die Hintergrundfarbe setzen. Dies ist von Nutzen, wenn die Grafik
  kleiner ist als das Fenster.
  <literal>R</literal>, <literal>G</literal> und <literal>B</literal>
  spezifizieren die Rot-, Grün- und Blau-Komponenten der Farbe (jede davon ist
  eine Dzimalzahl von 0 bis 255).
  </para></listitem>
</varlistentry>
</variablelist>
</sect2>

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

<varlistentry>
  <term><literal>
  <anchor id="skin-menu"/>menu = X, Y, width, height, message
  </literal></term>
  <listitem><para>
  Definiert die Position <literal>X,Y</literal> und die Größe eines Menüeintrags
  innerhalb der Grafik. <literal>message</literal> ist die Meldung, die erzeugt
  werden soll, wenn die Maustaste über dem Eintrag losgelassen wird.
  </para></listitem>
</varlistentry>
</variablelist>
</sect2>

<title>Symbole</title>
<para>
  Einige Zeichen haben spezielle Bedeutungen, wenn sie von bestimmten
  Variablen in <link linkend="skin-dlabel">dlabel</link> zurückgegeben
  werden. Diese Zeichen sind dazu gedacht, als Symbole angezeigt zu werden,
  sodass Sachen wie ein hübsches DVD-Logo an Stelle des Zeichens
  '<literal>d</literal>' für einen DVD-Stream angezeigt werden können.
</para>
<para>
  Die folgende Tabelle listet alle Zeichen auf, die zum Anzeigen von
  Symbolen genutzt werden können (und daher eine andere Schrift benötigen).

  <term><emphasis role="bold">evPause</emphasis></term>
  <listitem><para>
  Formt einen Schalter zusammen mit <literal>evPlaySwitchToPause</literal>.
  Sie können dazu benutzt werden, einen gebräuchlichen Play/Pause-Button
  zu bekommen. Beide Meldungen sollten den Buttons zugewiesen werden, die
  an genau der selben Position inerhalb des Fensters dargestellt werden.
  Diese Meldung pausiert das Abspielen und die Grafik für den
  <literal>evPlaySwitchToPause</literal>-Button wird gezeigt
  (um anzudeuten, dass der Button zum Fortsetzen des Abspielens gedrückt
  werden kann).
  </para></listitem>

</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evMute</emphasis></term>
  <listitem><para>
   Schalte den Sound an/aus (Mute/Unmute).
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evSetBalance</emphasis></term>
  <listitem><para>
  Setze die Balance(kann von einem Potentiometer genutzt werden;
  mit dem relativen Wert (0-100%) des Potentiometers).
  </para></listitem>
</varlistentry>

<varlistentry>

</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evLoadPlay</emphasis></term>
  <listitem><para>
  Macht das selbe wie <literal>evLoad</literal>, es startet jedoch
  das Abspielen nach dem Laden der Datei automatisch.
  </para></listitem>
</varlistentry>

<varlistentry>

</variablelist>

</sect1>

<sect1 id="skin-quality">
<title>Herstellung von Qualitätsskins</title>

<para>
  Jetzt hast du dich über das Herstellen eines Skins für das
  <application>MPlayer</application>-GUI informiert, in
  <application>Gimp</application> dein bestes gegeben und willst
  deinen Skin an uns schicken?
  Lies weiter dann findest du einige Vorgaben häufige Irrtümer zu
  vermeiden und produiere einen hochwertigen Skin.
</para>

<para>
  Wir wollen dass Skins, die wir in unser Repository eingefügt werden,
  zu bestimmten Qualitätsstandars konform sind. Es gibt auch vieles, das
  du tun kannst, um uns das Leben leichter zu machen.
</para>

<para>
  Als ein Beispiel kannst du dir den <systemitem>Blue</systemitem>-Skin

</para>

<itemizedlist>
<listitem><para>
  Jeder Skin sollte mit einer
  <filename>README</filename>-Datei ankommen, die Iformationen über
  dich, den Autor, Copyright- und Licenzanmerkungen und alles, was du
  sonst noch anfügen willst, enthält.
  Willst du einen Changelog, ist diese Datei ein geeigneter Ort dafür.
</para></listitem>

<listitem><para>
  Es sollte eine Datei namens <filename>VERSION</filename>
  mit nicht mehr als der Versionsnummer des Skins in einer einzigen

18650:587abd8f3dab

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- in sync with r18600 -->
<appendix id="skin">
<title><application>MPlayer</application>s Skinformat</title>

<sect1 id="skin-overview">
<title>Überblick</title>
<para>
  Es hat nicht wirklich etwas mit dem Skinformat zu tun, aber du solltest
  wissen, dass <application>MPlayer</application> <emphasis role="bold">kein</emphasis>
  eingebautes Skin besitzt, also <emphasis role="bold">muss zumindest ein Skin
  installiert sein, damit das GUI verwendet werden kann.</emphasis>
</para>

<sect2 id="skin-overview-directories">
<title>Verzeichnisse</title>

  (siehe Argumente <option>--prefix</option> und <option>--datadir</option>
  des <command>configure</command>-Scripts).
</para>

<para>
  Jedes Skin wird in sein eigenes Verzeichnis unterhalb einem der oben
  aufgeführten Verzeichnisse installiert, zum Beispiel:
<screen>$(PREFIX)/share/mplayer/skins/default/</screen>
</para>
</sect2>

<para>
  Die Bilder müssen Truecolor-PNGs sein (24 oder 32 bpp).
</para>

<para>
  Im Hauptfenster und in der Abspieleiste (siehe unten) kannst du Bilder
  mit 'Transparenz' verwenden: Mit der Farbe #FF00FF (Magenta) gefüllte Bereiche
  sind beim Betrachten mit <application>MPlayer</application> voll transparent.
  Die bedeutet, dass du sogar Formfenster haben kannst, wenn dein X-Server die
  XShape-Extension besitzt.
</para>

<para>
  Zur Zeit sind vier Fenster zu dekorieren: das
  <link linkend="skin-file-main">Hauptfenster</link>, das
  <link linkend="skin-file-subwindow">Unterfenster</link>, die
  <link linkend="skin-file-main">Abspielleitse</link> und das
  <link linkend="skin-file-menu">Skin-Menü</link> (das durch einen
  Rechtsklick aktiviert werden kann).

<itemizedlist>
<listitem><para>
  Das <emphasis role="bold">Hauptfenster</emphasis> und/oder die
  <emphasis role="bold">Abspielleiste</emphasis> befindet sich dort, wo du
  <application>MPlayer</application> kontrollieren kannst. Der Hintergrund
  des Fensters ist ein Grafik.
  Ins Fenster können (und müssen) diverse Elemente platziert werden:
  <emphasis>Buttons</emphasis>, <emphasis>Potentiometer</emphasis> (Schieberegler)
  und <emphasis>Labels</emphasis>.
  Für jedes Element musst du dessen Position und Größe angeben.
</para><para>
  Ein <emphasis role="bold">Button</emphasis> besitzt drei Zustände (gedrückt,
  losgelassen, deaktiviert), deshalb muss seine Grafik vertikal in drei Teile
  getrennt werden. Siehe Eintrag <link linkend="skin-button">Button</link>
  mit mehr Details.
</para><para>
  Ein <emphasis role="bold">Potentiometer</emphasis> (hauptsächlich für
  die Suchleiste und die Lautstärke-/Balance-Regler) kann eine beliebige
  durch die Aufteilung der Grafik in verschiedene untereinander liegende Teile
  eine beliebige Anzahl von Phasen haben. Siehe
  <link linkend="skin-hpotmeter">hpotmeter</link> und
  <link linkend="skin-potmeter">Potentiometer</link> für Details.
</para><para>
  <emphasis role="bold">Labels</emphasis> sind ein wenig speziell: Die Zeichen,
  die man zu ihrer Darstellung benötigt, werden von einer Grafikdatei und
  die Zeichen in der Grafik durch eine
  <link linkend="skin-fonts">Schrift-Beschreibungsdatei</link> festgelegt.
  Letztere ist eine Volltextdatei, welche die x-,y-Position und Größe jedes
  Zeichens in der Grafik beschreibt (die Grafikdatei und ihre
  Schrift-Beschreibungsdatei bilden <emphasis>zusammen</emphasis> eine Schrift).
  Siehe
  <link linkend="skin-dlabel">dlabel</link>
  und
  <link linkend="skin-slabel">slabel</link> für Details.
</para>
<note>
<para>
  Alle Grafiken können wie im Abschnitt über die
  <link linkend="skin-overview-formats">Grafikformate</link> erklärt

</para>
</note>
</listitem>

<listitem><para>
  Das <emphasis role="bold">Unterfenster</emphasis> ist dort, wo der Film
  erscheint. Es kann eine festgelegte Grafik anzeigen, wenn kein Film geladen
  ist (es ist ziemlich langweilig, ein leeres Fenster vor sich zu haben :-))
  <emphasis role="bold">Beachte:</emphasis> Transparenz ist hier
  <emphasis role="bold">nicht erlaubt</emphasis>.
</para></listitem>

<listitem><para>
  Das <emphasis role="bold">Skin-Menü</emphasis> ist ganz einfach ein
  Weg, <application>MPlayer</application> mittels der Menüeinträge zu
  kontrollieren. Zwei Grafiken sind für das Menü erforderlich:
  eine davon ist die Basisgrafik, die den Normalzustand des Menüs darstellt,
  die andere wird zur Anzeige der gewählten Einträge verwendet.
  Wenn du das Menü aufklappst, wird die erste Grafik angezeigt. Bewegst du
  die Maus über die Menüeinträge, wird der aktuell gewählte Eintrag aus der
  zweiten Grafik über den Menüeintrag unterhalb des Mauszeigers kopiert
  (die zweite Grafik wird nie als ganzes angezeigt).
</para><para>
  Ein Menüeintrag wird definiert durch seine Position und Größe innerhalb
  der Grafik (sieh nach mehr Details im Abschnitt über das
  <link linkend="skin-file-menu">Skin-Menü</link>).
</para></listitem>
</itemizedlist>
</para>

</sect2>

<sect2 id="skin-files">
<title>Dateien</title>
<para>
  Du benötigst folgende Dateien, um ein Skin zu bauen:
<itemizedlist>
<listitem><para>
  Die Konfigurationsdatei genannt <link linkend="skin-file">skin</link> erzählt
  <application>MPlayer</application>, wie unterschiedliche Teile des Skins
  zusammengefügt werden und was er tun soll, wenn du irgendwo innerhalb des Fenster
  hinklickst.
</para></listitem>
<listitem><para>
  Die Hintergrundgrafik fürs Hauptfenster.
</para></listitem>
<listitem><para>
  Grafiken für die Elemente im Hauptfenster (einschließlich einer oder mehrerer
  Schrift-Beschreibungsdateien zum Zeichnen der Labels).
</para></listitem>
<listitem><para>
  Die Grafik, die im Unterfenster angezeigt werden soll (optional).
</para></listitem>
<listitem><para>
  Zwei Grafiken für das Skin-Menü (sie werden nur gebraucht, wenn du
  ein Menü erzeugen möchtest).
</para></listitem>
</itemizedlist>
  Mit Ausnahme der skin-Konfigurationsdatei kannst du die anderen Dateien
  benennen, wie es dir beliebt (beachte aber, dass Schrift-Beschreibungsdateien
  eine <filename>.fnt</filename>-Erweiterung besitzen müssen).
</para>
</sect2>
</sect1>

<sect1 id="skin-file">
<title>Die skin-Datei</title>
<para>
  Wie oben erwähnt, ist dies die skin-Konfigurationsdatei. Sie ist
  Zeilen-orientiert;
  Kommentarzeilen beginnen mit einem '<literal>;</literal>' Semikolon
  am Zeilenanfang (es sind nur Leer- und Tabulator-Zeichen vor dem
  '<literal>;</literal>' erlaubt).
</para>

<para>
  Die Datei ist in Abschnitte unterteilt. Jeder Abschnitt beschreibt den Skin
  für eine Anwendung und besitzt folgende Form:
<programlisting>
section = <replaceable>Abschnittsname</replaceable>
.
.
.
end
</programlisting>
</para>

<para>
  Zur Zeit gibt es nur eine Anwendung, somit brauchst du nur einen Abschnitt:
  Sein Name ist <emphasis role="bold">movieplayer</emphasis>.
</para>

<para>
  Innerhalb dieses Abschnitts wird jedes Fenster durch einen Block folgender
  Form beschrieben:
<programlisting>
window = <replaceable>Fenstername</replaceable>
.
.
.
end
</programlisting>
</para>

<para>
  wobei <replaceable>Fenstername</replaceable> einer dieser Zeichenketten sein
  kann:
<itemizedlist>
<listitem><para><emphasis role="bold">main</emphasis> - für das Hauptfenster</para></listitem>
<listitem><para><emphasis role="bold">sub</emphasis> - für das Unterfenster</para></listitem>
<listitem><para><emphasis role="bold">menu</emphasis> - für das Skin-Menü</para></listitem>
<listitem><para><emphasis role="bold">playbar</emphasis> - Abspielleiste</para></listitem>
</itemizedlist>
</para>

<para>
  (Die sub- und menu-Blöcke sind optional - du musst kein Menü erzeugen oder
  das Unterfenster dekorieren.)
</para>

<para>
  Innerhalb des Fensterblocks kannst du jedes Element für das Fenster durch eine
  Zeile dieser Form definieren:
<programlisting>item = Parameter</programlisting>
  Wobei <literal>item</literal> eine Zeichenkette ist, die den Typ des GUI-Elements
  identifiziert, <literal>parameter</literal> ist ein numerischer oder textueller
  Wert (oder eine Liste Komma-getrennter Werte).
</para>

<para>
  Fügt man nun das oben genannte zusammen, sieht die komplette Datei etwa so aus:
<programlisting>
section = movieplayer
  window = main
  ; ... Elemente für das Hauptfenster ...
  end

  window = sub
  ; ... Elemente für das Unterfenster ...
  end

  window = menu
  ; ... Elemente für das Menü ...
  end

  window = playbar
  ; ... Elemente für die Abspielleiste ...
  end
end
</programlisting>
</para>

<para>
  Der Name einer Grafikdatei muss ohne führende Pfadangaben angegeben werden -
  Grafiken werden im Verzeichnis <filename class="directory">skins</filename>
  gesucht.
  Du kannst (musst aber nicht) die Erweiterung der Datei spezifizieren.
  Existiert die Datei nicht, versucht <application>MPlayer</application> die Datei
  <filename>&lt;Dateiname&gt;.&lt;ext&gt;</filename> zu laden, wobei
  <literal>png</literal> und <literal>PNG</literal> als
  <filename>&lt;ext&gt;</filename> (Erweiterung) probiert werden
  (in dieser Reihenfolge). Die erste zutreffende Datei wird verwendet.
</para>

<para>
  Zum Schluss einige Worte zur Positionierung.

(0,-2)----(-1,-2)----(-2,-2)
</screen>
</informalfigure>

<para>
  Hier ein Beispiel, um es zu verdeutlichen. Angenommen, du hast eine Grafik
  mit Namen <filename>main.png</filename>, die für das Hauptfenster nutzt:
  <programlisting>base = main, -1, -1</programlisting>
  <application>MPlayer</application> versucht, die Dateien
  <filename>main</filename>,
  <filename>main.png</filename>,

  zu laden.
</para>


<sect2 id="skin-file-main">
<title>Hauptfenster und Abspielleiste</title>
<para>
  Unten steht eine Liste von Einträgen, die in den Blöcken
  '<literal>window = main</literal>' ... '<literal>end</literal>',
  und '<literal>window = playbar</literal>' ... '<literal>end</literal>'
  genutzt werden können.
</para>

<variablelist>
<varlistentry>

  <para>
  Platziere einen horizontal (hpotmeter) oder vertikal (vpotmeter) Potentiometer mit
  der Größe <literal>width</literal> * <literal>height</literal> an Position
  <literal>X,Y</literal>. Die Grafik kann in unterschiedliche Teile für die
  verschiedenen Phasen des Potentiometers aufgeteilt werden (du kannst zum Beispiel
  eines für die Lautstärkeregelung haben, das von rot nach grün wechselt, während sich
  sein Wert vom Minimum zum Maximum ändert.).
  <literal>hpotmeter</literal> kann einen Button besitzen, der horizontal gezogen
  werden kann. Die Parameter sind:
    </para>
    <itemizedlist>
    <listitem><para><literal>button</literal> - die für den Button zu verwendende
    Grafik (muss drei untereinander liegende Teile aufweisen, wie im Fall des
    <link linkend="skin-button">Buttons</link>)
  </para></listitem>
    <listitem><para><literal>bwidth</literal>, <literal>bheight</literal> - Größe
    des Buttons
  </para></listitem>
   <listitem><para><literal>phases</literal> - die für die verschiedenen Phasen
   zu verwendende Grafik des hpotmeter. Ein spezieller Wert von <literal>NULL</literal>
   kann benutzt werden, wenn du keine solche Grafik anwenden willst. Die Grafik muss
   in vertikal <literal>numphases</literal> Teile wie folgt aufgeteilt werden:

</informalfigure>
    </listitem>
    <listitem><para><literal>numphases</literal> - Anzahl der Phasen, die in der
    <literal>phases</literal>-Grafik untergebracht sind
  </para></listitem>
    <listitem><para><literal>default</literal> - Standardwert für hpotmeter
    (im Bereich <literal>0</literal> bis <literal>100</literal>)
  </para></listitem>
    <listitem><para><literal>X</literal>, <literal>Y</literal> - Position fürs hpotmeter
  </para></listitem>
    <listitem><para><literal>width</literal>, <literal>height</literal> - Breite und Höhe

  Das Label wird als dynamisch bezeichnet, weil sein Text periodisch
  aktualisiert wird. Die Maximallänge des Labels wird mit dem
  Wert <literal>length</literal> vorgegeben (seine Höhe ist die der
  Zeichen).
  Wird der anzuzeigende Text breiter als dieser Wert, wird er gescrollt,
  andernfalls wird er innerhalb des Mittels des Wertes des
  <literal>align</literal>-Parameters festgelegten Zwischenraums ausgerichtet:
  <literal>0</literal> steht für rechts,
  <literal>1</literal> steht für zentriert,
  <literal>2</literal> steht für links.
</para>

  Der anzuzeigende Text wird mit <literal>text</literal> festgelegt:
  Er muss zwischen doppelten Anführungszeichen stehen (das &quot;-Zeichen kann jedoch
  nicht Teil des Textes sein).
  Das Label wird mittels der über die <literal>fontid</literal> identifizierten
  Schrift angezeigt.
  Du kannst folgende Variablen im Text verwenden:
</para>

<informaltable>
<tgroup cols="2">
<thead>

<entry>$F</entry>
<entry>Dateiname in GROSSBUCHSTABEN</entry>
</row>
<row>
<entry>$T</entry>
<entry>Ein dem Streamtyp entsprechendes Zeichen (Datei: <literal>f</literal>,
Video-CD: <literal>v</literal>, DVD: <literal>d</literal>, URL: <literal>u</literal>)</entry>
</row>
<row>
<entry>$p</entry>
<entry>Das <keycap>p</keycap>-Zeichen (wenn ein Film abgespielt wird und die Schrift

</para>

<variablelist>
<varlistentry>
  <term><literal>
  <anchor id="skin-sub-base"/>base = image, X, Y, Breite, Hoehe
  </literal></term>
  <listitem><para>
  Die im Fenster anzuzeigende Grafik. Das Fenster wird an der angegebenen
  Position <literal>X,Y</literal> auf dem Bildschirm erscheinen
  (<literal>0,0</literal> ist die obere linke Ecke).
  Du kannst <literal>-1</literal> für zentriert und <literal>-2</literal>
  für rechts (<literal>X</literal>) und unten (<literal>Y</literal>) festlegen.
  Das Fenster wird so groß sein wie die Grafik.
  <literal>Breite</literal> und <literal>Höhe</literal>
  kennzeichnen die Größe des Fensters; sie sind optional (wenn sie fehlen, hat
  das Fenster dieselbe Größe wie die Grafik).
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><literal>

  <listitem><para>
  Lässt dich die Hintergrundfarbe setzen. Dies ist von Nutzen, wenn die Grafik
  kleiner ist als das Fenster.
  <literal>R</literal>, <literal>G</literal> und <literal>B</literal>
  spezifizieren die Rot-, Grün- und Blau-Komponenten der Farbe (jede davon ist
  eine Dezimalzahl von 0 bis 255).
  </para></listitem>
</varlistentry>
</variablelist>
</sect2>

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

<varlistentry>
  <term><literal>
  <anchor id="skin-menu"/>menu = X, Y, Breite, Höhe, Nachricht
  </literal></term>
  <listitem><para>
  Definiert die Position <literal>X,Y</literal> und die Größe eines Menüeintrags
  innerhalb der Grafik. <literal>Nachricht</literal> ist die Meldung, die erzeugt
  werden soll, wenn die Maustaste über dem Eintrag losgelassen wird.
  </para></listitem>
</varlistentry>
</variablelist>
</sect2>

<title>Symbole</title>
<para>
  Einige Zeichen haben spezielle Bedeutungen, wenn sie von bestimmten
  Variablen in <link linkend="skin-dlabel">dlabel</link> zurückgegeben
  werden. Diese Zeichen sind dazu gedacht, als Symbole angezeigt zu werden,
  so dass Dinge wie ein hübsches DVD-Logo an Stelle des Zeichens
  '<literal>d</literal>' für einen DVD-Stream angezeigt werden können.
</para>
<para>
  Die folgende Tabelle listet alle Zeichen auf, die zum Anzeigen von
  Symbolen genutzt werden können (und daher eine andere Schrift benötigen).

  <term><emphasis role="bold">evPause</emphasis></term>
  <listitem><para>
  Formt einen Schalter zusammen mit <literal>evPlaySwitchToPause</literal>.
  Sie können dazu benutzt werden, einen gebräuchlichen Play/Pause-Button
  zu bekommen. Beide Meldungen sollten den Buttons zugewiesen werden, die
  an genau derselben Position innerhalb des Fensters dargestellt werden.
  Diese Meldung pausiert das Abspielen und die Grafik für den
  <literal>evPlaySwitchToPause</literal>-Button wird gezeigt
  (um anzudeuten, dass der Button zum Fortsetzen des Abspielens gedrückt
  werden kann).
  </para></listitem>

</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evMute</emphasis></term>
  <listitem><para>
   Schalte den Ton an/aus.
  </para></listitem>
</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evSetBalance</emphasis></term>
  <listitem><para>
  Setze die Balance (kann von einem Potentiometer genutzt werden;
  mit dem relativen Wert (0-100%) des Potentiometers).
  </para></listitem>
</varlistentry>

<varlistentry>

</varlistentry>

<varlistentry>
  <term><emphasis role="bold">evLoadPlay</emphasis></term>
  <listitem><para>
  Macht dasselbe wie <literal>evLoad</literal>, es startet jedoch
  das Abspielen nach dem Laden der Datei automatisch.
  </para></listitem>
</varlistentry>

<varlistentry>

</variablelist>

</sect1>

<sect1 id="skin-quality">
<title>Erstellen von qualitativen Skins</title>

<para>
  Jetzt hast du dich über das Herstellen eines Skins für das
  <application>MPlayer</application>-GUI informiert, in
  <application>Gimp</application> dein bestes gegeben und willst
  deinen Skin an uns schicken?
  Lies weiter, dann findest du einige Vorgaben dafür, wie häufige Irrtümer
  vermieden und hochqualitative Skins erstellt werden können.
</para>

<para>
  Wir wollen, dass Skins, die wir in unser Repository eingefügt werden,
  bestimmten Qualitätsstandards entsprechen. Es gibt auch vieles, das
  du tun kannst, um uns das Leben leichter zu machen.
</para>

<para>
  Als ein Beispiel kannst du dir den <systemitem>Blue</systemitem>-Skin

</para>

<itemizedlist>
<listitem><para>
  Jeder Skin sollte mit einer
  <filename>README</filename>-Datei kommen, die Informationen über
  dich, den Autor, Copyright- und Lizenzanmerkungen und alles, was du
  sonst noch anfügen willst, enthält.
  Willst du ein Changelog, ist diese Datei ein geeigneter Ort dafür.
</para></listitem>

<listitem><para>
  Es sollte eine Datei namens <filename>VERSION</filename>
  mit nicht mehr als der Versionsnummer des Skins in einer einzigen