Designregeln
Dieser Teil beschreibt, wie Sie SVG-Symbole für Schemen entwerfen und in die Symbolbibliothek übernehmen. Grundlage sind die 31 Symbole der aktuellen Systembibliothek, das Verhalten des Renderers und Messungen am Formelinterpreter (Stand 14.11.2026, Europe/Berlin).
Platzhalter wie $(COLOR), $(STATE) oder $(positionLevel) werden zur Laufzeit ersetzt. DDF-Anweisungen (zum Beispiel GUI.paintSvgLib(…);) müssen mit ; enden. Typpräfixe d/i/r/s an Variablennamen werden nicht verwendet.
1.1 Raster und viewBox
- Alle 31 Symbole der Systembibliothek verwenden
viewBox='0 0 100 100',width='100%',height='100%'(alle*SVG-Datensätze der Systembibliothek; siehe Konventionen der Symbole). - Die viewBox-Werte werden nur ganzzahlig gelesen. Gebrochene viewBox-Werte sind daher nicht sinnvoll.
- Koordinaten im Symbol dürfen Dezimalzahlen sein (z. B. MARKISE
x='18.25',x1='21.92'). Sie werden erst beim Skalieren auf ganze Pixel abgeschnitten (siehe 1.6). - Ausnahme
points(polygon/polyline): Die Punkte werden schon in viewBox-Einheiten auf ganze Zahlen gerundet. Fürpointsdeshalb nur ganzzahlige Koordinaten verwenden.
1.2 Größe und Einpassung
- Schema (SYMBOL-Element): Im Schema werden Breite und Höhe getrennt skaliert. Das Symbol wird auf die Elementfläche gestreckt, nicht seitenverhältnistreu eingepasst. Empfehlung: SYMBOL-Elemente quadratisch anlegen, damit die 100×100-Zeichnung nicht verzerrt.
GUI.paintSvgLibin DDF-Formeln: Laut SVG-Elemente wird die Vorlage verzerrungsfrei eingepasst und zentriert. Ob das auch fürGUI.paintSvgLibgilt, ist zu klären.- Drehung: im Schema um den Mittelpunkt mit
ROTATION0–360° (Darstellung von SYMBOL), in Formeln über den Parameterwinkel.
1.3 Linienstärken
| Verwendung | Wert in der Systembibliothek | Beleg |
|---|---|---|
| Hauptkontur (Rahmen, Fensterflügel, Kasten, Akku-Körper) | stroke-width='2' bzw. Klasse .style { stroke-width: 2 } |
WINDOW, BATTERY, BLINDS, RAFFSTORE, MARKISE, HEATING, Gruppe HEATING |
| Feindetails (Lamellen, Kordeln, Kasten-Innenlinie) | stroke-width='1' |
RAFFSTORE, BLINDS, MARKISE |
| Farbige Stoffkanten | stroke-width='4' mit stroke='$(COLOR)' |
MARKISE |
| Ältere Symbole | 1.3, 3, 3.2, 4, 6 |
BASE, PICO, NOVA, TELENOT, SUN, COUNTER, AIRQUALITY |
Renderer-Verhalten:
- Werte zwischen 0 und 1 werden auf 1 angehoben (siehe gemeinsame Attribute).
- Die Stärke wird als ganze Zahl an die Zeichenfunktion übergeben. 1.3 wirkt also wie 1. Gebrochene Stärken bringen nichts.
- Ob
stroke-widthmit der Symbolgröße skaliert wird, ist zu klären. In der untersuchten Zeichnung wird die Stärke nicht mit dem Skalierungsfaktor multipliziert. stroke-widthals Attribut wird ohne Platzhalterersetzung gelesen. Nur der CSS-Wert wird ersetzt. Eine animierte Linienstärke ist deshalb nicht möglich bzw. zu klären.
1.4 Farben und Zustandsfarbe $(COLOR)
- Grundstil der neueren STATUS-Symbole (WINDOW, BATTERY, HEATING, BLINDS, RAFFSTORE, MARKISE):
- weiße Fläche (
fill='white'), - schwarze Kontur (
stroke='black'), - Statusfarbe nur über
$(COLOR). - Feste Farben kommen nur in
GEN.BASEvor (#4499C5,#77AF4E,#DC8A35,#E5E8ED; Datensatz;0;0;BASE;in der Systembibliothek). - Alle 31 Symbole verwenden
$(COLOR). - Woher
COLORkommt: - Im Schema:
COLOR= ElementfarbeCOLOR, wenn Zustand > 0, sonstOFF. Bei Alias-EinheitRGBist es der Zahlenwert selbst (siehe Darstellung von SYMBOL). - Übergeben wird eine Dezimalzahl (ARGB als Ganzzahl). Der Renderer liest sie als ganze Zahl.
- In DDF-Formeln übergibt man
'COLOR', '#2DB42D'(siehe Konventionen der Symbole). - Verstandene Farbschreibweisen:
#RGB,#RRGGBB,0xAARRGGBB,0xRRGGBB,rgb/rgba, Dezimalzahl;- Namen nur
black,white,red,green,blue,none. - Andere Namen ergeben schwarz. Also keine Namen wie
greyoderorangeverwenden. - Vorschaufarbe für Entwürfe war
#4499C5(Hausblau ausGEN.BASE). Das ist eine Konvention aus der Entwurfsarbeit, keine Renderer-Vorgabe. - Die
state-/$COLOR1-Klassen-Notation ist im Zeichenpfad nicht verdrahtet, die Zustandsliste bleibt leer (siehe Bibliotheks-Platzhalter). Kein Symbol der Systembibliothek verwendet sie noch.
1.5 Gemeinsames Fenster (BLINDS, RAFFSTORE, MARKISE, WINDOW)
Belegt in der Systembibliothek:
| Bauteil | WINDOW (3;0) | BLINDS (3;6) | RAFFSTORE (3;7) | MARKISE (3;8) |
|---|---|---|---|---|
| Rahmen weiß, stroke 2, rx 3 | x=18 y=14 w=64 h=72 |
x=18 y=22 w=64 h=72 |
x=18 y=22 w=64 h=72 |
x=18 y=24 w=64 h=70 |
Glasfläche .style, rx 2 |
x=25 y=22 w=50 h=58 |
x=25 y=30 w=50 h=58 |
x=25 y=30 w=50 h=58 |
x=25 y=32 w=50 h=56 |
| Sprossenkreuz | x=50, y=51 |
x=50, y=59 |
x=50, y=59 |
x=50, y=60 |
| Kasten oben | – | x=12 y=6 w=76 h=18 + innen x=16 y=10 w=68 h=10 (stroke 1) |
wie BLINDS | x=12 y=6 w=76 h=20 + innen h=12 + Mittellinie y=16 |
| Seitenschienen | – | x=15 / x=79, w=6 h=72 |
wie BLINDS | – |
- Regel: gleiche Breite (64), gleiche Glasbreite (50), gleicher Kasten (76×18 bzw. 76×20). Beim Behang ist das Fenster um 8 Einheiten nach unten versetzt, damit oben Platz für den Kasten bleibt.
- WINDOW hat keinen Kasten und sitzt höher (
y=14). - Zeichenreihenfolge in der Systembibliothek: Rahmen → Glas → Behang (
$(COLOR)) → Endleiste → Seitenschienen → Kasten. Spätere Elemente liegen oben, deshalb verdecken die Schienen die Lamellenenden.
1.6 Pixelraster
- Alle Koordinaten und Maße von rect, circle, ellipse, line und text werden beim Skalieren auf ganze Pixel abgeschnitten (nicht gerundet).
xundwidthwerden unabhängig abgeschnitten. Aneinandergesetzte Teilflächen können dadurch je nach Zielgröße eine 1-Pixel-Lücke oder Überlappung bekommen.- Designregel aus der Praxis (MARKISE v5, RAFFSTORE v2):
- Flächen überlappen lassen statt exakt aneinandersetzen;
- keine Elemente mit Höhe/Breite 1 in viewBox-Einheiten;
- Mindesthöhe für animierte Streifen 2.