Graphlcd-Skin Referenz
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 |
Elemente
<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> | ||
<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"/> | ||
<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)"/>
| ||
