Graphlcd-Skin Referenz

Aus VDR Wiki
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(<variable>)
K
 
Zeile 79: Zeile 79:
 
  <variable id="ButtonWidth" value="sub(#ButtonPitch,2)"/>
 
  <variable id="ButtonWidth" value="sub(#ButtonPitch,2)"/>
 
|}
 
|}
 +
[[Kategorie:Graphlcd-plugin]]

Aktuelle Version vom 8. Dezember 2007, 11:02 Uhr

Hinweis
Hinweis

Diese Dokumentation gilt für die Version "1.0" des Skin-Formates des graphlcd-plugins ab Version "0.2.0".


Dies ist eine Kurzreferenz des auf XML-basierenden Skin-Formates des graphlcd Plugins.

Inhaltsverzeichnis

[Bearbeiten] Elemente

[Bearbeiten] <skin>

Dies ist das Wurzelelement des Skins. Alle weiteren Elemente liegen verschachtelt in diesem.

Attribut Wert Beschreibung
version VERSION Version des Skin-Formates (fester Wert, aktuell "1.0")
name NAME Name des Skins
Beispiel
<?xml version="1.0"?>
<skin version="1.0" name="default">
  .
  .
  .
</skin>

[Bearbeiten] <font>

Eine Referenz auf eine Schriftart und -größe, die in anderen Skin-Elementen über ihren Namen (id) referenziert wird.

Attribut Wert Beschreibung
id STRING Möglichst eindeutiger Name des Fonts, über den er in anderen Elementen referenziert wird. Falls mehrere Fonts mit dem gleichen Namen existieren, entscheidet im konkreten Fall die Eigenschaft "condition".
url STRING URL des Fonts, die Angaben über Typ, Dateiname und Schriftgröße enthält.
condition FUNKTION/TOKEN Komplexe Bedingung
Beispiel
<font id="FontInfo" url="fnt:verdana-018.fnt"/>
<font id="FontChannel" url="ft2:verdana.ttf:26"/>

[Bearbeiten] <variable>

Eine Variable vom Typ Zahl, Boolean oder String. Variablen können beispielsweise zum Vereinfachen komplexer Ausdrücke in Bedingungen verwendet werten oder um Wiederholungen zu vermeiden. Außerdem vereinfachen sie die Unterstützung verschiedener LCD-Größen mit ein und demselben Skin. Dabei sollte beachtet werden, dass die Auswertung der Funktionen ihrer Werte schon beim Laden des Skins erfolgt. Variablen sind also eher als Konstanten zu betrachten.

Die Referenzierung von Variablen in anderen Elementen (welche auch Variablen sein können) erfolgt mit vorangestelltem '#' vor dem Bezeichner ("id").

Attribut Wert Beschreibung
id STRING Möglichst eindeutiger Name der Variable, über den sie in anderen Elementen referenziert wird. Falls mehrere Variablen mit dem gleichen Namen existieren, entscheidet im konkreten Fall die Eigenschaft "condition".
value ZAHL/STRING/FUNKTION/TOKEN Wert der Variablen. Dies kann eine Zahl oder Zeichenkette sein. Möglich sind auch Funktionen oder Token, die wiederum eine Zahl oder einen String ergeben.
condition FUNKTION/TOKEN Komplexe Bedingung
Beispiel
<variable id="LogoW" value="40" condition="le({ScreenHeight},64)"/>
<variable id="LogoW" value="64"/>
<variable id="ButtonPitch" value="div({ScreenWidth},4)"/>
<variable id="ButtonWidth" value="sub(#ButtonPitch,2)"/>