DDF-Handbuch / Teil D – Symbole für Schemen entwickeln und designen
Ablauf vom Entwurf bis zum fertigen Symbol
2.1 SVG-Aufbau (Vorlage, wie in der Systembibliothek)
<svg viewBox='0 0 100 100'
width='100%'
height='100%'
xmlns='http://www.w3.org/2000/svg'>
<defs>
<style>
.style {
fill: none;
stroke: black;
stroke-width: 2;
stroke-linejoin: round;
stroke-linecap: round
}
</style>
</defs>
<g id='raffstore'>
… statische Teile, animierte Teile, Deckteile …
</g>
</svg>
- Nur einfache Hochkommas verwenden.
" beendet das CSV-Feld (siehe Vorlagen im Feld SVG).
xmlns und font-family werden toleriert, aber ignoriert (siehe SVG-Wurzel). stroke-linejoin und stroke-linecap werden nicht ausgewertet (siehe gemeinsame Attribute).
- Unterstützte Elemente:
rect circle ellipse line polyline polygon path text style linearGradient radialGradient stop (siehe unterstützte Elemente). Attribute von <g> werden nicht ausgewertet (zu klären).
- CSS-Klassen überschreiben Attribute des Elements (siehe CSS). Ein Element mit
class='style' bekommt also fill: none, auch wenn fill='$(COLOR)' daneben steht. Deshalb .style nur für reine Konturen verwenden und farbige Flächen ohne Klasse anlegen, wie in der Systembibliothek.
2.2 Zustände und Varianten
- Entwurfsweise: Jeder Zustand wird als Rasterbild durchgespielt, typischerweise 0/25/50/75/100 %. Bei zwei Werten nimmt man das Produkt, z. B. RAFFSTORE positionLevel 0/25/50/75/100 × rotationLevel 0/50/100. In der Entwurfsarbeit wurden dafür Zustandsraster als Vorschau erzeugt.
- Pro Zustand prüfen:
- Sind alle sichtbaren Elemente geschlossen?
- Gibt es keine Lücken?
- Ist der Unterschied zwischen 0 und >0 deutlich?
- Ist 100 % ein klarer Endzustand?
- Ein- und Aus-Zustand müssen gut unterscheidbar sein. Bei HEATING wurde das nachgebessert: Rückmeldung „der Unterschied an und aus ist nicht sehr gut sichtbar“.
2.3 Animation mit einem Wert: $(STATE)
- Ohne Feldformat setzt das Schema die Platzhalter
STATE (Zahl als Text) und COLOR.
- In Formeln:
GUI.paintSvgLib('STATUS.DOOR', 10,10,40,40, 0, 'STATE', ITEM.DOOROPEN, 'COLOR', '#2DB42D'); (siehe Konventionen der Symbole).
- Die Paare KEY/WERT stehen ab dem siebten Parameter. Mit weniger als sieben Parametern wird nichts gezeichnet (siehe GUI-API).
2.4 Animation mit mehreren Werten: Aliasnamen aus die Alias-Tabelle
- Hat das gebundene Item ein Feldformat, wird jeder Feldwert unter seinem Feldnamen als Platzhalter gesetzt.
STATE wird dann nicht gesetzt, COLOR schon. Die Feldnamen sind die Aliasnamen der Konfigurations-Items des Elementtyps.
- Beispiel Rollladen/Raffstore, Abschnitt für Rollläden/Raffstores in der Alias-Tabelle (Elemente typischerweise
alg.rp%INDEX):
| Zeile |
Alias |
Feld |
Format |
Bedeutung (laut Alias-Tabelle) |
| 115 |
currentState |
0 |
enum[-2=holdDown,-1=movingDown,0=stop,1=movingUp,2=holdUp] |
Bewegungszustand |
| 116 |
positionLevel |
1 |
float[0.00,100.00](%) |
0 % = ganz oben, 100 % = ganz unten, invertiert umgekehrt |
| 117 |
rotationLevel |
2 |
float[0.00,100.00](%) |
0 % = ganz nach unten gedreht, 100 % = ganz nach oben gedreht |
| 118 |
elementInfo |
3 |
enum |
Hand-/Alarm-/Sperrstatus |
| 119 |
rotationRange |
4 |
enum[90=…,180=…] |
maximaler Drehbereich in Grad |
| 120 |
sumstate |
– |
%AUTO(ALL_FIELDS) |
Summenzustand aller Felder |
- Schreibweise ist bindend: Ersetzt wird genau der Text
$( + Schlüssel + ). $(positionlevel) oder $(PositionLevel) bleiben also unersetzt stehen, und der Ausdruck ergibt 0.
- An welches Item ein SYMBOL-Element gebunden werden muss, damit das Feldformat greift (vermutlich
sumstate), ist zu klären.
- Folge für COLOR bei Feld-Symbolen:
STATE bleibt im Feldformat-Zweig 0. Damit wird immer die Farbe OFF gewählt. Zu klären, ob das beabsichtigt ist.
2.5 visibility-Muster
visibility ist ein Ausdruck. Ergebnis 0 blendet aus, Default 1 (siehe gemeinsame Attribute).
- Das Ergebnis wird auf eine ganze Zahl abgeschnitten. Ein Ausdruck mit Ergebnis 0.7 blendet also aus. Deshalb immer Vergleiche verwenden (
>, >=, <=), die 0 oder 1 liefern.
- Bewährte Muster aus der Systembibliothek:
| Zweck |
Muster |
Symbol |
| an/aus |
visibility='$(STATE)>0' bzw. '$(STATE)<=0' |
WINDOW, DOOR, HEATING |
| voll |
visibility='$(STATE)>=100' (Pluspol farbig) |
BATTERY |
| Lamelle n erscheint ab Behanghöhe |
visibility='$(positionLevel)*0.70>=12' (Schritt 6) |
RAFFSTORE, BLINDS |
| Band erscheint ab Ausfahrweg |
visibility='$(STATE)*0.48>=18' |
MARKISE |
| Mindestweg für Endleiste |
visibility='$(positionLevel)>4' |
RAFFSTORE, BLINDS |
- Ausgeblendete Elemente werden komplett übersprungen. Für den Ausdruck darf ein Element daher auch „negative“ Höhen haben, solange es ausgeblendet ist.