## Einheiten

Was ist eine Einheit?

> Meter, Zentimeter, Millimeter, Micrometer, Lichtjar, usw. sind beispielsweise Einheiten der Kategorie Länge. Um Einheiten einer Kategorie hinzuzufügen, zu ändern oder zu löschen, editieren Sie die *.list Dateien in einem Texteditor: `Installationsverzeichnis/data/units/*.list`

Beschreibung der Datei für Einheiten

> Die `.list`-Dateien werden benutzt, um die Einheiten mit ihren Faktoren gegenüber der Grundeinheit (bei Länge z. B. Meter) zu spezifizieren. Leerzeilen und Zeilen mit einem führenden Gartenzaun (#) werden vom Programm als Kommentar erkannt und ignoriert. Die Einheiten erscheinen in der Reihenfolge auf der Programmoberfläche wie sie in den `.list`-Dateien definiert wurden.

Format einer Zeile

> Jedes Feld ist durch einen Doppelpunkt getrennt. Jede Zeile muß mindestens die Felder `Name` und `Wert` besitzen. Hier das komplette Format einer Zeile:
> `Name:Wert:Ländercode:Gültigkeit:Auswahl`

Beschreibung der Felder

`Name`

> Der Name erscheint in der Programmoberfläche, z. B. "Lichtjahr".

`Wert`

> Der Faktor gegenüber der Grundeinheit. Grundeinheiten haben stets den Faktor 1. Hier sind einige Beispiele, um die Syntax von gültigen Werten zu demonstrieren:
> `1 = 1.0`
> `2.45 = 2.45`
> `1e-4 = 0.0001`
> `2.45e3 = 2450`
> `1/2 = 0.5`
> `1e-4/9 = 0.00001111...`

`Ländercode`

> In welchem Land ist die Einheit gültig? Eine kleine Fahne zeigt i. d. R. das Land oder die Länder an, in dem die Einheit verwendet wird oder wurde. In der Datei "`lib/flags30x15iso3166.jar`" werden alle Fahen gefunden, die dem ISO 3166 Standard entsprechen. Der Ländercode ist hier in Kleinbuchstaben anzugeben ("de" für Deutschland"). Selbst erstellte Fahnen werden als "`data/images/flags/Ländercode.png`" im Installationsverzeichnis erkannt. Wegen der verlustbehafteten und nicht-animationsfähigen Speicherung bei jpg und der begrenzten Farbtiefe von 8 Bit bei gif wird ausschließlich png unterstützt, da dieses die Vorteile von jpg und gif vereint und die Nachteile minimiert. Wenn Sie kein Bildchen für die Kategorie zur Verfügung stellen, wird nur Text angezeigt.

`Gültigkeit`

> Einheiten, die veraltet ist und eigentlich nicht mehr verwendet wird, bzw. gesetztlich nicht mehr verwendet werden darf oder eher unüblich ist, werden mit grauer Textfarbe dargestellt (z. B. "Decameter"). Im anderen Fall ("true") wird Schwarz als Textfarbe verwendet. Gültige Werte sind "true" und "false".

`Auswahl`

> Wenn die Kategorie gewechselt wird, wird das Token "Auswahl" berücksichtigt. Gültige Werte:
> source = Einheit wird als "Quelle" ausgewählt
> target = Einheit wird als "Ziel" ausgewählt
> source,target = Einheit wird sowohl als "Quelle" als auch als "Ziel" ausgewählt