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

2026-07-20T12:50:24Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADFlaeche und VC_CADVCFlaeche}}
Flächenobjekte des CAD. Delphi-Klassen sind <code>T2DArea</code> (XML-Tag <code>VC_CADFlaeche</code>) und die davon abgeleitete <code>T2DVCArea</code> (XML-Tag <code>VC_CADVCFlaeche</code>, VC-generierte Fläche mit Makro-Verknüpfung), beide in <code>CAD\GLGeometrics.pas</code>. Gemeinsame Basis ist die abstrakte <code>T2DAreaBase</code> (ohne eigenes Wurzeltag), die den Flächenrand als GUID-Referenzen auf Ring-Objekte speichert: genau ein äußerer Umring (<code>Exterior</code>) plus beliebig viele Löcher (<code>Interior</code>).

== Strukturregel ==
<pre>
<VC_CADFlaeche> (bzw. <VC_CADVCFlaeche>)
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadFlaeche)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht;
Schraffur-Felder SchraffurStil,
SchraffurHauptkanteGUID, … siehe dort)
<Rand>
<Exterior GUID="guid"/> (genau 1 — äußerer Umring)
{<Interior GUID="guid"/>}* (0..n — Löcher)
</Rand>
[<BoeschungsInfos> (nur T2DArea, nur bei Böschungsschraffur)
[<BoeschungOKUKVertauschen>bool</BoeschungOKUKVertauschen>] (nur wenn True)
[<BoeschungOKUKAutomatisch>bool</BoeschungOKUKAutomatisch>] (nur wenn False)
[<BoeschungOKStart_GUID>guid</BoeschungOKStart_GUID> (GUID als Elementtext!
<BoeschungOKEnd_GUID>guid</BoeschungOKEnd_GUID> alle 4 zusammen
<BoeschungUKStart_GUID>guid</BoeschungUKStart_GUID> oder keine)
<BoeschungUKEnd_GUID>guid</BoeschungUKEnd_GUID>]
</BoeschungsInfos>]
</VC_CADFlaeche>

Zusätzlich NUR bei <VC_CADVCFlaeche> (Reihenfolge Type→Nr→Name):
[<MakroIDType>enum:TMakroType</MakroIDType>] (praktisch immer mt_Calc)
[<MakroIDNr>ganzzahl</MakroIDNr>] (Verknüpfung zur Berechnungs-Fläche)
[<MakroIDName>text</MakroIDName>] (informativ)
</pre>
Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]] und [[CAD XML Syntax-Basiselemente|Basiselemente]]; Werteformate (Float, Bool = -1/0, GUID): [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]]. Die Schraffur einer Fläche wird komplett über die Basiselemente gesteuert (<code>SchraffurStil</code>, <code>SchraffurHauptkanteGUID</code>, <code>SchraffurHauptkanteAutomatisch</code>, <code>BoeschungsSchraffurStil</code>, <code>Textur</code>) — die Fläche selbst hat dafür keine eigenen Elemente.

== Elemente ==
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>Rand</code> || Container || '''ja''' || — || Flächenrand; enthält Exterior + Interiors
|-
| <code>Exterior</code> || GUID-Attribut-Element || '''ja''' (genau 1) || — || äußerer Umring. Mehrfache <code>Exterior</code>-Knoten: nur der '''erste''' zählt, weitere werden mit Fehlerlog ignoriert
|-
| <code>Interior</code> || GUID-Attribut-Element (0..n) || nein || keine || Löcher der Fläche; '''doppelte GUIDs werden beim Lesen ignoriert''' (Schutz vor Aufsummierung bei wiederholtem Öffnen)
|-
| <code>BoeschungsInfos</code> || Container || nein || — || Böschungskanten-Zuordnung (nur <code>T2DArea</code>); geschrieben nur, wenn ein Böschungs-Info-Container existiert (Fläche mit Böschungsschraffur). Die 4 Kanten-Punkt-GUIDs stehen als '''Elementtext''' (nicht als Attribut) und werden nur geschrieben, wenn nicht automatisch und alle 4 Punkte existieren
|-
| <code>MakroIDType</code> || enum:TMakroType || nein || — || nur <code>VC_CADVCFlaeche</code>; Werte: <code>mt_Calc</code>, <code>mt_Mess</code>, <code>mt_NetzMess</code>, <code>mt_GNSSMess</code> — bei Flächen praktisch immer <code>mt_Calc</code>. '''Beim Lesen ignoriert''' (siehe unten)
|-
| <code>MakroIDNr</code> || Int || ja (für die VC-Verknüpfung) || — || nur <code>VC_CADVCFlaeche</code>; Nummer der VC-Fläche. Beim Lesen wird '''nur dieses Element''' ausgewertet: die MakroID wird mit <code>mt_Calc</code> und der Projekt-KSID neu über den IDServer geholt
|-
| <code>MakroIDName</code> || String || nein || — || nur <code>VC_CADVCFlaeche</code>; Name (informativ, beim Lesen ignoriert)
|}

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>Exterior</code> || geschlossene Kurve: [[CAD XML Syntax-Objekt VC CADKompo|VC_CADKompo]] (geschlossener Linienring) oder [[CAD XML Syntax-Objekt VC CADCircleLine und EllipseLine|VC_CADCircleLine/VC_CADEllipseLine]] || '''ja''' || '''harte Referenz''': fehlende/ungültige GUID, nicht gefundenes Ziel oder ein Ziel, das keine geschlossene Kurve ist → „Objekt wird nicht eingelesen" — die Fläche wird beim Referenzen-Update verworfen und zerstört. Ist das Exterior-Objekt selbst fehlerhaft, wird auch die Fläche verworfen
|-
| <code>Interior</code> || geschlossene Kurve (wie Exterior), je Loch eine || nein || überwiegend '''weich''': nicht gefundene oder fehlerhafte Interior-Ziele und ungeschlossene Ringe werden mit Logeintrag ignoriert, die Fläche bleibt bestehen. Ausnahme: eine syntaktisch '''ungültige''' Interior-GUID (nicht parsebar) verwirft die ganze Fläche
|-
| <code>BoeschungOK/UK…_GUID</code> || [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]] (4 Kanten-Punkte) || nein || weich (nur Darstellung der Böschungsschraffur)
|}
Prüfkriterium „geschlossene Kurve" (<code>T3DBaseObject.IsClosedCurve</code>): Kreis, Ellipse oder ein <code>T3DKompo</code>, dessen Member eine geschlossene Kurve bilden.

'''Wichtig für Erzeuger:''' In der Schreibreihenfolge des Managers stehen die Flächen VOR den Kompos — das referenzierte Rand-Kompo steht in echten Dateien also typischerweise NACH der Fläche. Der Leser löst das über die Wiedervorlage-Schleife des Referenzen-Updates auf (siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Minimalform ==
<pre>
<VC_CADFlaeche>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Rand>
<Exterior GUID="{XXXX…}"/>
</Rand>
</VC_CADFlaeche>
</pre>
Die <code>Exterior</code>-GUID muss auf ein existierendes, geschlossenes Ring-Objekt zeigen (in der Regel ein <code>VC_CADKompo</code>, dessen <code>MemberGroup</code> die Randlinien enthält) — sonst wird die Fläche beim Laden verworfen.

== Beispiele ==
=== Minimalfall (Baden-Württemberg, echt) ===
<pre>
<VC_CADFlaeche>
<VermCadID>
<GUID>{E91D72F2-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Rand>
<Exterior GUID="{E25CC64B-…}" />
</Rand>
</VC_CADFlaeche>
</pre>

=== Fläche mit Löchern (Baden-Württemberg, echt — ALKIS-Repräsentant mit 6 Interiors) ===
<pre>
<VC_CADFlaeche>
<VermCadID>
<GUID>{5F2F5D3E-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<AlkisID>DEBWL001000h42SS</AlkisID>
<Layer>-100360</Layer>
<Rand>
<Exterior GUID="{93AD309C-…}" />
<Interior GUID="{58E5F5D0-…}" />
<Interior GUID="{ECC12FEE-…}" />
<Interior GUID="{9D2A3BF2-…}" />
<Interior GUID="{44CED532-…}" />
<Interior GUID="{E22A2480-…}" />
<Interior GUID="{504A1A3A-…}" />
</Rand>
</VC_CADFlaeche>
</pre>

=== VC_CADVCFlaeche (KONSTRUIERT nach den Code-Regeln — kein Bestandsbeleg in den Beispielprojekten) ===
<pre>
<VC_CADVCFlaeche>
<VermCadID>
<GUID>{XXXXXXXX-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Rand>
<Exterior GUID="{XXXX…}"/>
</Rand>
<MakroIDType>mt_Calc</MakroIDType>
<MakroIDNr>7</MakroIDNr>
<MakroIDName>Flurstück 123</MakroIDName>
</VC_CADVCFlaeche>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen; Bestandsbelege für <code>VC_CADFlaeche</code> in allen drei Beispielprojekten (BW/Sachsen/THR), für <code>VC_CADVCFlaeche</code> keiner.
* '''Sichtbar-Sonderfall''' bei <code>VC_CADVCFlaeche</code>: Das Basiselement <code>Sichtbar</code> wird beim Schreiben aus dem Koordinatensystem der verknüpften VC-Fläche abgeleitet (Basisklasse GLGeometrics.pas:6630-6633), nicht direkt aus dem Objektzustand.
* Beim Lesen von <code>VC_CADVCFlaeche</code> zählt nur <code>MakroIDNr</code> — Typ und Name werden verworfen und die Makro-ID mit <code>mt_Calc</code> neu vom IDServer geholt. Ein Reparierer darf <code>MakroIDType</code>/<code>MakroIDName</code> also gefahrlos ergänzen/korrigieren.
* Anhalt-Ableitungen der Fläche: siehe [[CAD XML Syntax-Objekt VC AreaCADLTK und AlkisDE|VC_AreaCADLTK und VC_AreaCADAlkisDE]]; der [[CAD XML Syntax-Objekt VC Plotrahmen|VC_Plotrahmen]] erbt ebenfalls den <code>Rand</code>-Mechanismus.
* Schreibreihenfolge im Manager: Flächen als Gruppe 7 (nach Linien, vor Kompos); <code>T2DVCArea</code> → Tag <code>VC_CADVCFlaeche</code>, sonst <code>VC_CADFlaeche</code>.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:61035-61096</code> — <code>T2DAreaBase.DataToXMLLite</code> (Rand/Exterior/Interior schreiben)
* <code>CAD\GLGeometrics.pas:60860-60949</code> — <code>T2DAreaBase.InternalCreateComplexStructsFromXML</code> (Exterior nur erster, Interior-Duplikatfilter)
* <code>CAD\GLGeometrics.pas:62342-62470</code> — <code>T2DAreaBase.SetReferencesAndUpdate</code> (harte Exterior-/weiche Interior-Referenz, IsClosedCurve-Prüfung)
* <code>CAD\GLGeometrics.pas:9011-9021</code> — <code>T3DBaseObject.IsClosedCurve</code>
* <code>CAD\GLGeometrics.pas:64261-64283</code> — <code>T2DArea.DataToXMLLite</code> (BoeschungsInfos); <code>64229-64258</code> — Lesen
* <code>CAD\GLBoeschungsSchraffuren.pas:3387-3438</code> — <code>TBoeschungInfoContainer.DataToXMLLite</code>; <code>3341-3385</code> — Lesen
* <code>CAD\GLGeometrics.pas:64482-64516</code> — <code>T2DVCArea.DataToXMLLite</code> (MakroID-Elemente); <code>64518-64549</code> — Lesen (nur MakroIDNr, IDServer)
* <code>VERMCAD\VCObjID.pas:11</code> — Enum <code>TMakroType</code>
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten (<code>xn_Rand</code>, <code>xn_Exterior</code>, <code>xn_Interior</code>, <code>xn_MakroID*</code>, <code>xn_Boeschung*</code>)

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

CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche - Versionsgeschichte

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