Wie ein Symbol in die Bibliothek kommt
3.1 CSV-Aufbau
*GENERAL;;;;;;;;;
;DEVICE;Systemlibrary SVG;;;;;;;
;MANUFACTURER;myGEKKO;;;;;;;
;TYPE;Graphical user interface;;;;;;;
;PROTOCOL;LIBRARY;;;;;;;
;VERSION_NR;1;;;;;;;
;MODEL_NR;1;;;;;;;
;ID;0xC800000100010100;;;;;;;
…
*SVGGROUP;ID;ALIAS;DE;IT;EN;;;;
;0;GEN;Geräte;;Devices;;;;
;1;TELENOT;Telenot;Telenot;Telenot;;;;
;2;UNITS;Einheiten;;Units;;;;
;3;STATUS;;;;;;;
;4;HEATING;Heizung;Riscaldamento;Heating;;;;
*SVG;GROUP;ID;ALIAS;DE;IT;EN;DESCRIPTION;SVG;";"
;3;7;RAFFSTORE;Raffstore;Frangisole;Venetian blind;Venetian blind;"<svg viewBox='0 0 100 100' …> … </svg>";
(Kopfzeilen wörtlich aus der Systembibliothek, SVG gekürzt.)
- Spalten
*SVG:GROUP;ID;ALIAS;DE;IT;EN;DESCRIPTION;"SVG". Ein Datensatz endet mit";und einem Zeilenende CRLF. - Die Kopfzeile
*SVGendet in der Systembibliothek aufSVG;";". Die Bedeutung dieser letzten Zelle ist zu klären. Sie zählt bei der Anführungszeichen-Prüfung mit. - Der interne Schlüssel ist
GROUP·1000 + ID. Der Aliasname lautet<GRUPPENALIAS>.<ALIAS>, z. B.STATUS.RAFFSTORE(siehe Bibliotheken). - Gruppen in der Systembibliothek: 0 GEN (3 Symbole), 1 TELENOT (3), 2 UNITS (9, IDs 3–11), 3 STATUS (9, IDs 0–8), 4 HEATING (7, IDs 0–6), zusammen 31 Symbole.
- Reihenfolge: Die Datensätze stehen nach Gruppe und ID sortiert, jede Gruppe zusammenhängend. Neue Symbole werden am Ende ihrer Gruppe mit der nächsten freien ID eingefügt.
- Ob der Loader eine Sortierung verlangt, ist zu klären. Die Prüfroutinen der Entwurfsarbeit verlangen sie („Gruppen 0–4 zusammenhängend“).
- Bestehende IDs nicht umnummerieren: Das Schema speichert eine numerische Kennung (Auswahl des Symbols).
- Auf dem Controller wird die Symbolbibliothek bei Änderung neu geladen im DDF-Handbuch. Im Schema wird sie mit
LIBhochgeladen und mitRLDneu geladen (siehe Aktionsleiste).
3.2 Kodierung, Zeilenenden, Anführungszeichen, Länge
- Windows-1252 (Umlaute z. B.
Geräte,Tür,Heizkörper,Plattenwärmetauscher). Nicht als UTF-8 speichern. - Zeilenenden: Datensätze enden mit CRLF (272×). Innerhalb der SVG-Zellen stehen LF (1051×) bei den neueren Symbolen. Ältere Symbole (z. B. HEAT BUFFER) haben CRLF in der Zelle. Beides wird gelesen. Beim Bearbeiten die vorhandene Form des Datensatzes beibehalten.
- Anführungszeichen: Die SVG-Zelle ist in
"…"gefasst, im SVG stehen nur'. In der aktuellen Systembibliothek sind es genau 64"(31 Datensätze × 2 + 2 in der Kopfzeile).""in einer Zelle wird zu'(siehe CSV-Grundregeln). - Zellenlänge: Excel begrenzt eine Zelle auf 32 767 Zeichen. Das längste Symbol der Systembibliothek ist MARKISE mit 4013 Zeichen. Eine Grenze im Loader ist nicht belegt (zu klären). Bei
textgilt: Inhalt max. 255 Zeichen. - Excel-Sperre beachten: Ist die CSV in Excel geöffnet, nicht schreiben (Lock-Datei
~$…).
3.3 Aufruf
GUI.paintSvgLib('STATUS.RAFFSTORE', x, y, w, h, 0, 'positionLevel', 55.4, 'rotationLevel', 30, 'COLOR', '#4499C5');
GUI.paintSvgLib('STATUS.BATTERY', x, y, w, h, 0, 'STATE', 75, 'COLOR', '#4499C5');
- Die Parameter folgen der GUI-API für
GUI.paintSvgLib. - Die Beispielwerte sind frei gewählt. Die erste Zeile zeigt, dass Feldnamen in Formeln wie normale KEYs übergeben werden.
- Im Schema setzt der Controller die Werte selbst (2.3/2.4).
3.4 Echte Beispiele aus der aktuellen Systembibliothek (gekürzt, Ausdrücke wörtlich)
RAFFSTORE v2 (;3;7;): Position und Neigung sind getrennt animiert, es gibt kein $(STATE).
<!-- Lamelle 1 und 2 (insgesamt 12, y = 24, 30, 36 … 84, 88) -->
<rect x='22' y='24' width='56' height='2+$(rotationLevel)*0.045' rx='1' ry='1' fill='$(COLOR)' stroke='black' stroke-width='1' visibility='$(positionLevel)>0'/>
<rect x='22' y='30' width='56' height='2+$(rotationLevel)*0.045' rx='1' ry='1' fill='$(COLOR)' stroke='black' stroke-width='1' visibility='$(positionLevel)*0.70>=6'/>
…
<rect x='22' y='88' width='56' height='2+$(rotationLevel)*0.045' … visibility='$(positionLevel)*0.70>=66'/>
<!-- Leiterkordeln -->
<line x1='36' y1='24' x2='36' y2='24+$(positionLevel)*0.70' stroke='black' stroke-width='1' visibility='$(positionLevel)>0'/>
<!-- Endleiste -->
<rect x='20' y='24+$(positionLevel)*0.70-3.5' width='60' height='3.5' fill='black' visibility='$(positionLevel)>4'/>
positionLevel0…100 ergibt einen Behang von 0…70 Einheiten (*0.70).rotationLevel0…100 ergibt eine Lamellenhöhe von 2…6.5 (2+…*0.045): 0 = schmal/offen, 100 = breit/geschlossen. Die Richtung ist zu klären (Abschnitt 6).- Im Datensatz: 18×
$(positionLevel), 12×$(rotationLevel).
MARKISE v5 (;3;8;): konisches Tuch aus Kern-Rect und 7 überlappenden Bändern, Volant mit einfachen Ausdrücken.
<rect x='20' y='24' width='60' height='$(STATE)*0.48' fill='$(COLOR)' visibility='$(STATE)>0'/>
<rect x='18.25' y='30' width='63.5' height='$(STATE)*0.48-6' fill='$(COLOR)' visibility='$(STATE)*0.48>=6'/>
…
<rect x='7.75' y='66' width='84.5' height='$(STATE)*0.48-42' fill='$(COLOR)' visibility='$(STATE)*0.48>=42'/>
<line x1='21.92' y1='24.56' x2='21.92-$(STATE)*0.14' y2='24.56+$(STATE)*0.48' stroke='$(COLOR)' stroke-width='4' visibility='$(STATE)>0'/>
<line x1='20' y1='24' x2='20-$(STATE)*0.14' y2='24+$(STATE)*0.48' stroke='black' stroke-width='2' visibility='$(STATE)>0'/>
<circle cx='26-$(STATE)*0.112' cy='24+$(STATE)*0.48+3.2' r='5' fill='$(COLOR)' stroke='black' stroke-width='2' visibility='$(STATE)>8'/>
<circle cx='50' cy='24+$(STATE)*0.48+3.2' r='5' fill='$(COLOR)' stroke='black' stroke-width='2' visibility='$(STATE)>8'/>
<rect x='20-$(STATE)*0.14' y='24+$(STATE)*0.48-3' width='60+$(STATE)*0.28' height='5' rx='1' ry='1' fill='$(COLOR)' stroke='black' stroke-width='2' visibility='$(STATE)>0'/>
- Ausfahrweg 0…48 Einheiten (
*0.48), seitliche Spreizung 0…14 je Seite (*0.14). - Jeder Ausdruck hat höchstens ein Produkt (siehe 5.4).
BATTERY (;3;4;): Füllstand von unten nach oben.
<rect x='38' y='6' width='24' height='14' rx='4' ry='4' fill='white' stroke='black' stroke-width='2'/>
<rect x='38' y='6' width='24' height='14' rx='4' ry='4' fill='$(COLOR)' stroke='black' stroke-width='2' visibility='$(STATE)>=100'/>
<rect x='22' y='14' width='56' height='76' rx='8' ry='8' fill='white' stroke='black' stroke-width='2'/>
<rect x='27' y='86-$(STATE)*0.68' width='46' height='$(STATE)*0.68' rx='4' ry='4' fill='$(COLOR)' visibility='$(STATE)>0'/>
<line x1='27' y1='69' x2='36' y2='69' stroke='black' stroke-width='2'/> <!-- Skalenstriche bei 69/52/35 -->
STATE0…100 ergibt eine Füllhöhe von 0…68 Einheiten, die Unterkante bleibt bei 86.- Der Pluspol wird erst bei 100 farbig.