Hahn: CAD-XML-Syntax-Dokumentation (automatischer Import)

2026-07-20T12:50:39Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Sektion Rissdaten und Auswahlen}}
Am Anfang jeder [[CAD XML Syntax-Sektion VCCADDaten|VCCADDaten-Sektion]] stehen die Verwaltungsdaten des Koordinatensystems: die '''Riss-Verwaltung''' (<code>Rissdaten</code>, Delphi-Klasse <code>TCADRissList</code> mit <code>TCADRiss</code>-Einträgen), der aktuelle Riss (<code>CurrRissID</code>), die gespeicherten '''Objektauswahlen''' (<code>ObjektAuswahlen</code>, Klasse <code>TCADSaveSelectionList</code>) und das '''Bearbeitungsgebiet'''. Risse sind projektspezifische Zeichnungs-Sichten (fachlich: [[CAD-Risse]]). Diese Seite beschreibt die Verwaltungslisten der Sektion — die riss-abhängigen Werte AN den einzelnen CAD-Objekten (<code>RissKoordinaten</code>, <code>Text_RissDaten</code> …) sind auf der Seite [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]] dokumentiert.

== Strukturregel ==
<pre>
<Rissdaten>
{ <RissEintrag_ID> (Tag = 'RissEintrag_' + Riss-ID; für JEDEN Riss
inkl. Standard-Riss ID 0)
<RissName>text</RissName>
<RissID>ganzzahl</RissID>
[<RissSzenarioID>ganzzahl</RissSzenarioID>]
[<RissViewMeasureScale>ganzzahl</RissViewMeasureScale>]
[<RissViewRotAngle>zahl</RissViewRotAngle>]
[<RissViewMinX>zahl</RissViewMinX>]
[<RissViewMaxX>zahl</RissViewMaxX>]
[<RissViewMinY>zahl</RissViewMinY>]
[<RissViewMaxY>zahl</RissViewMaxY>]
[<RissFreezeScale>bool</RissFreezeScale>]
[<RissSceneShowEnlargedSize>ganzzahl</RissSceneShowEnlargedSize>]
[<RissGesperrt>bool</RissGesperrt>]
</RissEintrag_ID> }*
</Rissdaten>
[<CurrRissID>ganzzahl</CurrRissID>]

[<BearbeitungsgebietAutomatisch>bool</BearbeitungsgebietAutomatisch>]
[<BearbeitungsgebietAutoMitFlaechen>bool</BearbeitungsgebietAutoMitFlaechen>]
[<Bearbeitungsgebiet>
{ <gml:pos>zahl zahl</gml:pos> }* (je Eckpunkt ein gml:pos, nur 2D)
</Bearbeitungsgebiet>]

<ObjektAuswahlen>
{ <ObjektAuswahlN> (Tag = 'ObjektAuswahl' + Integer-ID N,
z. B. 'ObjektAuswahl0')
<ObjektAuswahlName>text</ObjektAuswahlName>
<ObjektAuswahlID>ganzzahl</ObjektAuswahlID>
<ObjektAuswahlKDID>ganzzahl</ObjektAuswahlKDID> (KSID — Tag-Tippfehler, s. u.!)
<ObjektAuswahlGUIDs>guid
guid
…</ObjektAuswahlGUIDs> (GUID-Liste zeilenweise getrennt)
</ObjektAuswahlN> }*
</ObjektAuswahlen>
</pre>

== Elemente ==
=== Rissdaten / RissEintrag_<ID> (TCADRissList) ===
Der Standard-Riss (ID 0, Konstante <code>cCAD_RISS_ID_STANDARD</code>, Name <code>[Standard]</code>) existiert in jedem Projekt und wird mitgespeichert. Beim Lesen legt jedes Element, dessen Name mit <code>RissEintrag_</code> beginnt, einen neuen Riss an; ein Riss wird nur übernommen, wenn <code>RissName</code> ≠ leer und <code>RissID</code> ≠ −1 gelesen wurden — beide sind also '''Pflicht'''. Ein doppelt eingelesener Standard-Riss (ID 0) wird mit dem vorab angelegten zusammengeführt (SzenarioID wird übernommen).

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>RissName</code> || text || ja || — || Anzeigename des Risses (Standard-Riss: <code>[Standard]</code>)
|-
| <code>RissID</code> || ganzzahl || ja || — || Riss-ID; identisch mit der ID im Tag-Namen. ID 0 = Standard-Riss. Auf diese ID beziehen sich die <code>RissEintrag_<ID></code>-Einträge an den Objekten ([[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]]).
|-
| <code>RissSzenarioID</code> || ganzzahl || nein || −1 || zugeordnetes Präsentations-Szenario
|-
| <code>RissViewMeasureScale</code> || ganzzahl || nein || 0 || Ansichts-Maßstab (ganzzahlig). Ersetzt das Legacy-Float-Element <code>RissViewScale</code>; liegt intern nur der alte Float-Wert vor, schreibt VermCad <code>Round(PixelProPapierMeter/ViewScale)</code>.
|-
| <code>RissViewRotAngle</code> || zahl || nein || 0.0 || Rotationswinkel der Ansicht
|-
| <code>RissViewMinX</code> / <code>RissViewMaxX</code> / <code>RissViewMinY</code> / <code>RissViewMaxY</code> || zahl || nein || 0.0 || gespeicherte Ansichts-'''Ausdehnung'''; ersetzt die Legacy-Elemente <code>RissViewMoveX</code>/<code>RissViewMoveY</code> (Verschiebungs-Speicherung bis 05/2017)
|-
| <code>RissFreezeScale</code> || bool (−1/0) || nein || 0 (False) || Maßstab eingefroren (Konstantenname <code>xn_RissMassstabEinfrieren</code> ≠ Tag-String!)
|-
| <code>RissSceneShowEnlargedSize</code> || ganzzahl || nein || 0 || Detail-Zoom-Größe bei eingefrorenem Maßstab (Konstantenname <code>xn_RissMassstabEinfrierenDetailZoomSize</code>)
|-
| <code>RissGesperrt</code> || bool (−1/0) || nein || 0 (False) || Riss ist gegen Bearbeitung gesperrt
|}

=== CurrRissID ===
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>CurrRissID</code> || ganzzahl || nein || 0 || ID des beim Speichern aktiven Risses; muss auf einen <code>RissEintrag_<ID></code> verweisen
|}

=== ObjektAuswahlen (TCADSaveSelectionList) ===
Gespeicherte benannte Objekt-Auswahlen. '''Achtung, persistenter Tippfehler:''' Das Kindelement für die Koordinatensystem-ID heißt im Tag-String <code>ObjektAuswahlKDID</code> (nicht „KSID"!) — die Delphi-Konstante heißt korrekt <code>xn_ObjektAuswahlKSID</code>, ihr Tag-String enthält aber den historischen Tippfehler „KDID". Der Tippfehler ist auf beiden Seiten (Schreiben und Lesen) identisch und darf beim Erzeugen/Reparieren '''nicht korrigiert''' werden — ein Element <code>ObjektAuswahlKSID</code> würde ignoriert.

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>ObjektAuswahl<ID></code> || Container || — || — || ein Eintrag je Auswahl; der Tag-Name muss mit <code>ObjektAuswahl</code> beginnen und mit einer '''Ganzzahl''' enden (sonst wird das Element beim Lesen nicht als Auswahl erkannt)
|-
| <code>ObjektAuswahlName</code> || text || ja || — || Name der Auswahl; Pflicht fürs Lesen: Eintrag wird nur übernommen, wenn ID ≥ 0 UND Name ≠ leer
|-
| <code>ObjektAuswahlID</code> || ganzzahl || ja || −1 || ID der Auswahl (≥ 0)
|-
| <code>ObjektAuswahlKDID</code> || ganzzahl || nein || −1 || KSID des Koordinatensystems der Auswahl ('''Tippfehler-Tag''', s. o.)
|-
| <code>ObjektAuswahlGUIDs</code> || GUID-Liste || nein || leer || GUIDs der ausgewählten Objekte als <code>TStringList.Text</code> — '''zeilenweise''' getrennt (echte Zeilenumbrüche im Elementtext). Die Auflösung der GUIDs erfolgt erst beim Aktivieren der Auswahl (mit CADID-Fallback); fehlende Ziele sind unkritisch.
|}

=== Bearbeitungsgebiet ===
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>BearbeitungsgebietAutomatisch</code> || bool (−1/0) || nein || Initialwert (nur bei Abweichung geschrieben) || Gebiet wird automatisch ermittelt (dann wird kein Polygon gespeichert)
|-
| <code>BearbeitungsgebietAutoMitFlaechen</code> || bool (−1/0) || nein || Initialwert || automatische Ermittlung bezieht Flächen ein
|-
| <code>Bearbeitungsgebiet</code> || Container mit n×<code>gml:pos</code> || nein || — || manuelles Bearbeitungsgebiets-Polygon; je Eckpunkt ein <code><gml:pos>X Y</gml:pos></code> (nur 2D, [[CAD XML Syntax-Werte- und Koordinatenformate|Float-Format]]). Wird '''nur''' geschrieben, wenn <code>BearbeitungsgebietAutomatisch</code> = False und das Polygon ≥ 3 Punkte hat.
|}

== Beispiele ==
=== Beispiel (Sachsen, echt) — Rissdaten mit mehreren Rissen ===
<pre>
<Rissdaten>
<RissEintrag_0>
<RissName>[Standard]</RissName>
<RissID>0</RissID>
<RissSzenarioID>28</RissSzenarioID>
<RissViewMeasureScale>1</RissViewMeasureScale>
<RissViewMinX>3332480.51544114</RissViewMinX>
<RissViewMaxX>3332480.70299164</RissViewMaxX>
<RissViewMinY>5683146.38093415</RissViewMinY>
<RissViewMaxY>5683146.46763282</RissViewMaxY>
<RissSceneShowEnlargedSize>1000</RissSceneShowEnlargedSize>
</RissEintrag_0>
<RissEintrag_1>
<RissName>neue Grenzen</RissName>
<RissID>1</RissID>
<RissSzenarioID>32</RissSzenarioID>
<RissViewMeasureScale>7</RissViewMeasureScale>
<RissViewMinX>3332479.28436286</RissViewMinX>
<RissViewMaxX>3332483.40339641</RissViewMaxX>
<RissViewMinY>5683145.22719967</RissViewMinY>
<RissViewMaxY>5683147.13129865</RissViewMaxY>
<RissSceneShowEnlargedSize>458</RissSceneShowEnlargedSize>
</RissEintrag_1>
…
</Rissdaten>
<CurrRissID>0</CurrRissID>
<ObjektAuswahlen />
</pre>

=== Minimalform (echt) — Rissdaten einer Nebensektion ===
<pre>
<Rissdaten>
<RissEintrag_0>
<RissName>[Standard]</RissName>
<RissID>0</RissID>
</RissEintrag_0>
</Rissdaten>
<CurrRissID>0</CurrRissID>
</pre>

=== Konstruiertes Beispiel — gefüllte ObjektAuswahl (kein Bestandsbeleg; in allen Beispielprojekten nur leer) ===
<pre>
<ObjektAuswahlen>
<ObjektAuswahl0>
<ObjektAuswahlName>Grenzpunkte Nord</ObjektAuswahlName>
<ObjektAuswahlID>0</ObjektAuswahlID>
<ObjektAuswahlKDID>0</ObjektAuswahlKDID>
<ObjektAuswahlGUIDs>{4406BFC8-…}
{D3287E10-…}
{FE697113-…}</ObjektAuswahlGUIDs>
</ObjektAuswahl0>
</ObjektAuswahlen>
</pre>

=== Konstruiertes Beispiel — Bearbeitungsgebiet (kein Bestandsbeleg) ===
<pre>
<BearbeitungsgebietAutomatisch>0</BearbeitungsgebietAutomatisch>
<Bearbeitungsgebiet>
<gml:pos>545100.0 5721100.0</gml:pos>
<gml:pos>545200.0 5721100.0</gml:pos>
<gml:pos>545200.0 5721200.0</gml:pos>
<gml:pos>545100.0 5721200.0</gml:pos>
</Bearbeitungsgebiet>
</pre>
(Nach den Code-Regeln konstruiert: manuelles Rechteck-Gebiet mit 4 Eckpunkten.)

== Verfügbarkeit und Besonderheiten ==
* Struktur in '''allen''' Bundesland-Versionen identisch.
* '''Legacy-Aliase''' (werden gelesen, nicht mehr geschrieben):
** <code>RissViewScale</code> (Float; bis 03/2025) → ersetzt durch <code>RissViewMeasureScale</code> (Integer); Umrechnung beim Schreiben: <code>Round(PixelProPapierMeter/ViewScale)</code>.
** <code>RissViewMoveX</code>/<code>RissViewMoveY</code> (bis 05/2017) → ersetzt durch die Ausdehnung <code>RissViewMinX</code>/<code>RissViewMaxX</code>/<code>RissViewMinY</code>/<code>RissViewMaxY</code> (die Move-Speicherung ließ die Szene bei Fenstergrößen-Änderung springen).
* '''Tippfehler-Tag <code>ObjektAuswahlKDID</code>''' ist absichtlich persistent — nicht „reparieren".
* In den drei untersuchten Bestandsprojekten kommen <code>ObjektAuswahlen</code> ausschließlich '''leer''' (<code><ObjektAuswahlen /></code>) vor und <code>Bearbeitungsgebiet</code> gar nicht — die gefüllten Beispiele oben sind aus dem Code konstruiert.
* Ältere Dateien enthalten nach <code>ObjektAuswahlen</code> das inzwischen entfernte Element <code><AlkisStatusOptionen /></code> — siehe [[CAD XML Syntax-Sektion VCCADDaten|Sektion VCCADDaten]].
* Fachliche Bedienung der Risse: [[CAD-Risse]].

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:72745-72869</code> — <code>TCADRissList.DataToXMLLite</code> (alle Riss-Felder, Legacy-Umrechnung ViewScale)
* <code>CAD\GLGeometrics.pas:72882-73005</code> — <code>TCADRissList.ReadFromXML</code> (Legacy-Tags, Pflichtprüfung Name/ID, Standard-Riss-Zusammenführung)
* <code>CAD\GLGeometrics.pas:74328-74449</code> — <code>TCADSaveSelectionList.DataToXMLLite</code>/<code>ReadFromXML</code> (ObjektAuswahlen, Integer-Suffix-Prüfung)
* <code>CAD\GLGeometrics.pas:74280-74298</code> — GUID-Auflösung erst beim Aktivieren einer Auswahl
* <code>CAD\GLGeometrics.pas:79596-79635</code> — <code>SaveXMLLite</code>: CurrRissID und Bearbeitungsgebiet
* <code>CAD\GLConsts.pas:152-162</code> — <code>CADRISS_DEFAULT_*</code>-Defaultwerte; <code>CAD\GLConsts.pas:776</code> — <code>cCAD_RISS_ID_STANDARD = 0</code>
* <code>VERMCAD\GlobalConsts.pas</code> (Bereich xn_Rissdaten/xn_ObjektAuswahl*) — Tag-Konstanten inkl. Tippfehler <code>xn_ObjektAuswahlKSID = 'ObjektAuswahlKDID'</code>

{{Hilfe:NachOben}}
[[Kategorie:CAD XML Syntax]]

CAD XML Syntax-Sektion Rissdaten und Auswahlen - Versionsgeschichte

Hahn: CAD-XML-Syntax-Dokumentation (automatischer Import)