C.2. Die skin-Datei
Zurück | Anhang C. MPlayers Skinformat | Weiter

## C.2. Die skin-Datei

Wie oben erwähnt, ist dies die skin-Konfigurationsdatei. Sie ist Zeilen-orientiert; Kommentarzeilen beginnen mit einem '`;`' Semikolon am Zeilenanfang (es sind nur Leer- und Tabulator-Zeichen vor dem '`;`' erlaubt).

Die Datei ist in Abschnitte unterteilt. Jeder Abschnitt beschreibt den Skin für eine Anwendung und besitzt folgende Form:

    section = Abschnittsname
    .
    .
    .
    end

Zur Zeit gibt es nur eine Anwendung, somit brauchst du nur einen Abschnitt: Sein Name ist movieplayer.

Innerhalb dieses Abschnitts wird jedes Fenster durch einen Block folgender Form beschrieben:

    window = Fenstername
    .
    .
    .
    end

wobei `Fenstername` einer dieser Zeichenketten sein kann:

- main - für das Hauptfenster

- sub - für das Unterfenster

- menu - für das Skin-Menü

- playbar - Abspielleiste

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

Innerhalb des Fensterblocks kannst du jedes Element für das Fenster durch eine Zeile dieser Form definieren:

    Element = Parameter

Wobei `Element` eine Zeichenkette ist, die den Typ des GUI-Elements identifiziert, `Parameter` ist ein numerischer oder textueller Wert (oder eine Liste Komma-getrennter Werte).

Fügt man nun das oben genannte zusammen, sieht die komplette Datei etwa so aus:

    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

Der Name einer Grafikdatei muss ohne führende Pfadangaben angegeben werden - Grafiken werden im Verzeichnis `skins` gesucht. Du kannst (musst aber nicht) die Erweiterung der Datei spezifizieren. Existiert die Datei nicht, versucht MPlayer die Datei `<Dateiname>.<ext>` zu laden, wobei `png` und `PNG` als `<ext>` (Erweiterung) probiert werden (in dieser Reihenfolge). Die erste zutreffende Datei wird verwendet.

Zum Schluss einige Worte zur Positionierung. Hauptfenster und Unterfenster können in verschiedenen Ecken des Bilschirms über die `X`- und `Y`-Koordinaten platziert werden. `0` ist oben oder links, `-1` bedeutet zentriert und `-2` ist rechts oder unten, wie in dieser Illustration gezeigt:

    (0, 0)----(-1, 0)----(-2, 0)
    |          |          |
    |          |          |
    (0,-1)----(-1,-1)----(-2,-1)
    |          |          |
    |          |          |
    (0,-2)----(-1,-2)----(-2,-2)

Hier ein Beispiel, um es zu verdeutlichen. Angenommen, du hast eine Grafik mit Namen `main.png`, die du für das Hauptfenster nutzt:

    base = main, -1, -1

MPlayer versucht, die Dateien `main`, `main.png`, `main.PNG` zu laden.

### C.2.1. Hauptfenster und Abspielleiste

Unten steht eine Liste von Einträgen, die in den Blöcken '`window = main`' ... '`end`', und '`window = playbar`' ... '`end`' genutzt werden können.

`base = image, X, Y`

  Lässt dich die Hintergrundgrafik fürs Hauptfenster spezifizieren. Das Fenster wird an der angegebenen Position `X,Y` auf dem Bildschirm erscheinen. Es wird die Größe der Grafik besitzen.

  ### Anmerkung

  Diese Koordinaten funktionieren im Moment nicht beim Anzeigefenster.

  ### Warnung

  Transparente Bereiche innerhalb der Grafik (mit der Farbe #FF00FF) erscheinen auf X-Servern ohne die XShape-Extension schwarz. Die Breite der Grafik muss durch 8 teilbar sein.

`button = image, X, Y, width, height, message`

  Platziere einen Button mit der Größe `width` * `height` an Position `X,Y`. Die angegebene `message` wird erzeugt, wenn der Button angeklickt wird. Die mittels `image` festgelegte Grafik muss drei untereinander liegende Teile aufweisen (entsprechend der möglichen Zustände des Buttons), etwa so:

      +---------------+
      |    gedrückt   |
      +---------------+
      |  losgelassen  |
      +---------------+
      |  deaktiviert  |
      +---------------+

`decoration = enable|disable`

  Aktiviere oder deaktiviere die Fenstermanager-Dekoration des Hauptfensters. Standard ist disable.

  ### Anmerkung

  Dies funktioniert nicht beim Anzeigefenster, dort braucht man es nicht.

`hpotmeter = button, bwidth, bheight, phases, numphases, default, X, Y, width, height, message`

`vpotmeter = button, bwidth, bheight, phases, numphases, default, X, Y, width, height, message`

  Platziere einen horizontal (hpotmeter) oder vertikal (vpotmeter) Potentiometer mit der Größe `width` * `height` an Position `X,Y`. 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.). `hpotmeter` kann einen Button besitzen, der horizontal gezogen werden kann. Die Parameter sind:

  - `button` - die für den Button zu verwendende Grafik (muss drei untereinander liegende Teile aufweisen, wie im Fall des Buttons)

  - `bwidth`, `bheight` - Größe des Buttons

  - `phases` - die für die verschiedenen Phasen zu verwendende Grafik des hpotmeter. Ein spezieller Wert von `NULL` kann benutzt werden, wenn du keine solche Grafik anwenden willst. Die Grafik muss vertikal in `numphases` Teile wie folgt aufgeteilt werden:

        +------------+
        |  phase #1  |
        +------------+
        |  phase #2  |
        +------------+
             ...
        +------------+
        |  phase #n  |
        +------------+

  - `numphases` - Anzahl der Phasen, die in der `phases`-Grafik untergebracht sind

  - `default` - Standardwert für hpotmeter (im Bereich `0` bis `100`)

  - `X`, `Y` - Position fürs hpotmeter

  - `width`, `height` - Breite und Höhe des `hpotmeter`

  - `message` - die Meldung, die erzeugt werden soll, wenn der Wert des `hpotmeter` geändert wird

`potmeter = phases, numphases, default, X, Y, width, height, message`

  Ein `hpotmeter` ohne einen Button. (ich schätze, es ist dazu bestimmt, herumgedreht zu werden, reagiert aber nur auf horizontales Ziehen.) Eine Beschreibung der Parameter findest du unter hpotmeter. `phases` können `NULL` sein, dies ist aber ziemlich sinnlos, da du nicht sehen kannst, wo das `Potentiometer` hingesetzt wurde.

`font = fontfile, fontid`

  Definiert eine Schrift. `fontfile` ist der Name der Schrift-Beschreibungsdatei mit der Erweiterung `.fnt` (gieb hier keine Erweiterung an). `fontid` wird verwendet, um auf die Schrift zu verweisen (siehe dlabel und slabel). Bis zu 25 Schriften können definiert werden.

`slabel = X, Y, fontid, "text"`

  Platziere ein statisches Label an Position `X,Y`. `text` wird mittels der identifizierten `fontid` angezeigt. Der Text ist einfach ein eine Ausgangszeichenkette (`$x`-Variablen funktionieren nicht), eingeschlossen von doppelten Anführungszeichen (das "-Zeichen kann jedoch nicht Teil des Textes sein). Das Label wird mittels der über die `fontid` identifizierten Schrift angezeigt.

`dlabel = X, Y, length, align, fontid, "text"`

  Platziere ein dynamisches Label an Position `X,Y`. Das Label wird als dynamisch bezeichnet, weil sein Text periodisch aktualisiert wird. Die Maximallänge des Labels wird mit dem Wert `length` 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 vom `align`-Parameter festgelegten Zwischenraums ausgerichtet: `0` steht für rechts, `1` steht für zentriert, `2` steht für links.

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

  Variable | Bedeutung
  --- | ---
  $1 | Abspieldauer im hh:mm:ss-Format
  $2 | Abspieldauer im mmmm:ss-Format
  $3 | Abspieldauer im hh-Format (Stunden)
  $4 | Abspieldauer im mm-Format (Minuten)
  $5 | Abspieldauer im ss-Format (Sekunden)
  $6 | Filmlänge im hh:mm:ss-Format
  $7 | Filmlänge im mmmm:ss-Format
  $8 | Abspieldauer im h:mm:ss-Format
  $v | Lautstärke im xxx.xx%-Format
  $V | Lautstärke im xxx.xx-Format
  $b | Balance im xxx.xx%-Format
  $B | Balance in xxx.xx-Format
  $$ | das $-Zeichen
  $a | ein dem Audio-Typ entsprechendes Zeichen (Nichts: `n`, Mono: `m`, Stereo: `t`)
  $t | Track-Nummer (in der Playliste)
  $o | Dateiname
  $f | Dateiname in kleinbuchstaben
  $F | Dateiname in GROSSBUCHSTABEN
  $T | Ein dem Streamtyp entsprechendes Zeichen (Datei: `f`, Video-CD: `v`, DVD: `d`, URL: `u`)
  $p | Das p-Zeichen (wenn ein Film abgespielt wird und die Schrift das Zeichen p enthält)
  $s | Das s-Zeichen (wenn ein Film angehalten wird und die Schrift das Zeichen s enthält)
  $e | Das e-Zeichen (wenn ein Film pausiert wird und die Schrift das Zeichen e enthält)
  $x | Filmbreite
  $y | Filmhöhe
  $C | Name des verwendeten Codecs

### Anmerkung

Die Variablen `$a, $T, $p, $s` und `$e` geben alle Zeichen zurück, die als spezielle Symbole angezeigt werden sollen (zum Beispiel steht e für das Pause-Symbol, welches gewöhnlich etwa so || aussieht). Du solltest eine Schrift für normale Zeichen und eine weitere Schrift für Symbole haben. Schau in den Abschnitt über Symbole für mehr Informationen.

### C.2.2. Unterfenster

Die folgenden Einträge können in diesem Block verwendet werden '`window = sub`' . . . '`end`'.

`base = image, X, Y, Breite, Hoehe`

  Die im Fenster anzuzeigende Grafik. Das Fenster wird an der angegebenen Position `X,Y` auf dem Bildschirm erscheinen (`0,0` ist die obere linke Ecke). Du kannst `-1` für zentriert und `-2` für rechts (`X`) und unten (`Y`) festlegen. Das Fenster wird so groß sein wie die Grafik. `Breite` und `Höhe` kennzeichnen die Größe des Fensters; sie sind optional (wenn sie fehlen, hat das Fenster dieselbe Größe wie die Grafik).

`background = R, G, B`

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

### C.2.3. Skin-Menü

Wie bereits zuvor erwähnt, wird das Menü mittels zweier Grafiken dargestellt. Normale Menüeinträge werden aus der Grafik entnommen, die durch das Element `base` festgelegt sind, während der aktuell gewählte Eintrag aus der Grafik entnommen wird, die durch das Element `selected` spezifiziert wurde. Du musst Position und Größe jedes Menüeintrags mittels des Elements `menu` definieren.

Die folgenden Einträge können im Block '`window = menu`'. . .'`end`' genutzt werden.

`base = image`

  Die Grafik für normale Menüeinträge.

`selected = image`

  Die Grafik, die das Menü mit allen gewählten Einträgen anzeigt.

`menu = X, Y, Breite, Höhe, Nachricht`

  Definiert die Position `X,Y` und die Größe eines Menüeintrags innerhalb der Grafik. `Nachricht` ist die Meldung, die erzeugt werden soll, wenn die Maustaste über dem Eintrag losgelassen wird.

Zurück | Nach oben | Weiter
C.1. Überblick | Zum Anfang | C.3. Schriften