Layerstile¶
Alle Layer eines Anwendungsschemas teilen sich einen CartoSym-Stil, <appschema>.yaml – für xplan also xplan.yaml. Er liegt im Stilverzeichnis der Einstellungen, sonst im Plugin (<Plugin-Dir>/resources/styles/; im Repository: style/definitions/xplan.yaml). Eine Datei des Stilverzeichnisses hat keine Prüfung durchlaufen: Ist sie fehlerhaft, gilt die des Plugins, mit einer Warnung. Existiert die Datei, ersetzt sie die style-Angaben der Layerkonfiguration; andernfalls gilt style, das nur auf QML-Dateien verweisen kann.
Aufbau¶
Die Datei folgt festen Konventionen, damit jeder Layer genau seinen Teil sieht und ihn nach dem Bearbeiten in QGIS wieder zurückschreiben kann:
- Oberste Ebene: Featuretype-Regeln –
featuretype = 'X'oderfeaturetype IN (...), optional in Gruppen zusammengefasst (in xplan z.B.featuretype LIKE 'BP_%'). Diese Regeln werden von allen Layern geteilt. Überfeaturetype_regex(verglichen ab Anfang des Featuretype-Namens, wie beim Laden der Objekte) blendet ein Layer Featuretype-Regeln aus, die er nie enthält. Eine Gruppe blendet er nur aus, wenn sie ausschließlich Featuretype-Regeln enthält, von denen er keine sieht. - Darunter: Kontextknoten –
dataLayer.featuresGeometryDimensions = 0|1|2für Punkt-, Linien- bzw. Flächenlayer (geometry), darunter ggf. Layer-Eigenschaften wieflaechenschluss = true|false(aus demtemplatedes Layers). Was unter einem Kontextknoten steht, gehört allein den passenden Layern. - Darunter: der Inhalt des Layers – Symbolisierungen und weitere Regeln mit Filtern auf Attribute.
stylingRules:
- vendor.xleitstelle.id: 4f0c…
name: BP_AnpflanzungBindungErhaltung
selector:
op: =
args: [{sysId: dataLayer.id}, BP_AnpflanzungBindungErhaltung]
nestedRules:
- vendor.xleitstelle.id: 9a1e…
selector:
op: =
args: [{sysId: dataLayer.featuresGeometryDimensions}, 0.0]
nestedRules:
- vendor.xleitstelle.id: c27b…
symbolizer:
marker: …
Weitere Regeln:
- Filter dürfen nur
featuretypeundproperties[...]verwenden. - Jede Regel trägt eine
vendor.xleitstelle.id; darüber werden Regeln beim Zurückschreiben wiedererkannt. - Alle Größen sind in Karteneinheiten (Meter) angegeben.
- Bildpfade (SVG) sind relativ zum Unterverzeichnis
svgdes Stilverzeichnisses, sonst zuresources/styles/svgdes Plugins; eine gleichnamige Datei des Stilverzeichnisses geht vor.
Legendentexte¶
Der $comment einer Regel ist ihr Legendentext, den die Planurkunde verwendet; in QGIS ist er die Beschreibung der Regel und wird mit Layerstile exportieren zurückgeschrieben. Hat eine Regel keinen, steht in der Legende ihr Name. Legendentexte brauchen alle Regeln, die ein Symbol erhalten (die Featuretype-Regel, wenn ihre Symbolisierung direkt darunter liegt, sonst die Attributregeln darunter); die Texte folgen der Planzeichenverordnung, wo sie ein Planzeichen hat. Abweichende Texte für einzelne Pläne oder Gemeinden gehören nicht hierher, sondern in layout.yaml.
Planzeichen¶
Ein Präsentationsobjekt erhält seine stylesheetId nach den Regeln von XMAS-Core aus den Attributen des Fachobjekts, die es mit art darstellt, z.B. besondereArtDerBaulNutzung 1200 → Allgemeines Wohngebiet (PZ 1.1.3, Text WA). Damit die Legende einer Stilregel ihr Planzeichen zuordnen kann, gilt:
- Eine Stilregel legt ihr Planzeichen mit
=,INoderarray_containsfest, über ihr bis zur Featuretype-Regel ggf. weitere benannte Regeln (deren Werte zählen mit). Eine Regel für mehrere Planzeichen wird je Wert geteilt: Die Baugebiete vonBP_BaugebietsTeilFlaechehaben je eine Regel für ihrebesondereArtDerBaulNutzung; die Regel der Baufläche (allgArtDerBaulNutzung) gilt nur ohne sie oder mit 9999, damit keine Fläche doppelt gezeichnet wird. - Unter
XP_PTOundXP_PPOwählt je eine benannte Regel einestylesheetIdaus, mit der UUID, wie die Webapp sie an QGIS gibt (ohne die URL der CodelisteXP_StylesheetListe):stylesheetId = '<UUID>'. Ihre Regel Allgemein zeichnet die übrigen Präsentationsobjekte; ihr Filter schließt die UUIDs der Regeln daneben aus, damit kein Objekt doppelt erscheint. Eine neue Regel für einestylesheetIdgehört deshalb auch in diese Liste. - Ein Text aus
schriftinhalterscheint in der Legende als der Text, den die Webapp für das Planzeichen nennt; ein Legendeneintrag hat kein Objekt, aus dem er ihn lesen könnte.
Stile in QGIS bearbeiten¶
- Plan laden, Layer-Eigenschaften → Symbolisierung öffnen (Stil
Standardmuss aktiv sein) und die regelbasierte Darstellung wie gewohnt bearbeiten. - Im Plugin-Dock Layerstile exportieren klicken. Jeder geänderte Layer ersetzt den Teil von
<appschema>.yaml, den er sieht; danach werden alle Plugin-Layer neu aus der Datei gestylt. Layer, deren StilEditierenaktiv ist oder deren Darstellung nicht regelbasiert ist, werden weder exportiert noch neu gestylt. Wurde derselbe Layer in mehreren Plänen unterschiedlich geändert, bricht der Export ohne Änderung ab. - Was das YAML-Format nicht abbilden kann (z.B. Strichart, Markerfarbe, andere Symbollayer-Typen, ELSE-Regeln, Maßstabsbereiche), wird nicht übernommen: Die Meldung nennt die Zahl, die Einzelheiten stehen im Protokoll (Reiter des Plugins). Ein Filter, der sich nicht übertragen lässt, bricht den Export ab.
- Mit einem Stilverzeichnis wird die Datei dort geschrieben, z.B. in der Arbeitskopie eines Stilprojekts, auch wenn die Layer aus der des Plugins gestylt sind (dem Stilverzeichnis fehlte sie); die Meldung nennt sie. Ohne Stilverzeichnis liegt sie im installierten Plugin; um sie zu behalten, nach
style/definitions/im Repository kopieren –pixi run build-zipüberschreibtresources/styles/*.yamlmit den Dateien von dort. - Wurde nach dem Laden der Pläne außerhalb von QGIS geändert, was ein Layer von der Datei sieht (z.B. durch
git pull), oder stand für eine fehlerhafte Datei die des Plugins ein, zeigt der Layer eine ältere Fassung. Der Export schreibt sie nicht zurück: Einen unveränderten Layer übergeht er und stylt ihn danach neu; wurde der Layer geändert, bricht er ab – dann die Pläne neu laden. Ebenso bei einem geänderten Layer aus einem Projekt, das vor dieser Prüfung gespeichert wurde. Änderungen an Teilen der Datei, die der Layer nicht sieht (andere Layer, andere Featuretypes), stören nicht.
Stile aus QML-Dateien¶
Ein Stil lässt sich auch mit Stil laden… (Layer-Eigenschaften oder Layerstil-Fenster) oder Stil einfügen auf einen Planlayer übertragen, aus einer QML-Datei oder von einem anderen Layer, mit allen Kategorien. Welchen Plan ein Layer zeigt, steht in seiner Datenquelle, und welchen Bereich er zeigt, hält das Plugin selbst – beides ändert kein Stil. Alles andere übernimmt der Layer aus dem Stil, auch Attributformular und Eingabewidgets, Anzeigeausdruck, Geometrieprüfungen und das Bereich-Auswahlfeld im Layerbaum. Was sich damit nicht speichern lässt (eine geänderte ID, Objektart, Version, Eigenschaften, die kein Objekt sind), lehnt das Plugin beim Speichern mit einer Meldung ab. Das Formular des Plugins stellt der Eintrag Plugin-Formular wiederherstellen im Kontextmenü des Layers wieder her; das Auswahlfeld lässt sich unter Layer-Eigenschaften → Legende → Eingebettete Widgets wieder hinzufügen, die Geometrieprüfungen unter Digitalisierung; ein erneut geladener Plan hat alles wieder wie anfangs. Der Filter von QGIS (Filter… am Layer) bleibt der eigene und wirkt zusätzlich zum Bereich.
YAML für ein neues Anwendungsschema erzeugen¶
Gibt es für ein Anwendungsschema der geladenen Layer (z.B. xtrasse) noch keine YAML-Datei, bietet Layerstile exportieren an, sie aus den aktuellen Layerstilen zu erzeugen. Dabei wird die Darstellung jedes Layers übernommen – auch die zufälligen Standardfarben bisher ungestylter Layer – und unter eine Featuretype-Regel gehängt:
- Featuretype-Regeln an oberster Stelle der Darstellung bleiben erhalten.
- Alle übrigen Regeln kommen unter eine Regel für
featuretype_regex, der dafür ein einfacher Featuretype-Name sein muss (z.B.PFS_Baugrube→featuretype = 'PFS_Baugrube'). - Ist er das nicht (z.B.
^.*Plan$), wird die Datei nicht erzeugt. Dann in QGIS über die bestehenden Regeln eine Regel wie"featuretype" IN ('PFS_Plan', 'RVP_Plan')legen und erneut exportieren. - Gehört derselbe Featuretype zu mehreren Layern (z.B. Punkt und Fläche), landen beide unter einer gemeinsamen Featuretype-Regel.
- Ist ein Layer in mehreren Plänen geladen, wird der erste übernommen. Mit QML gestylte Kopien müssen dabei übereinstimmen, sonst wird die Datei wegen eines Konflikts nicht erzeugt; bisher ungestylte Kopien werden nicht verglichen.
Kann die Datei nicht erzeugt werden, behalten die Layer des Anwendungsschemas ihre aktuelle Darstellung; die übrigen Stildateien werden trotzdem exportiert.
Größen werden als Karteneinheiten übernommen: Ein in Millimetern angegebener Wert wird zu Metern und sieht damit im Maßstab 1:1000 gleich aus. Mit der neuen Datei ersetzt diese die QML-Stile des Anwendungsschemas. Sie entsteht im Stilverzeichnis, ohne eines im Plugin; dann wie unter Schritt 4 nach style/definitions/ übernehmen.