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

2026-07-20T12:50:17Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_AreaCADLTK und VC_AreaCADAlkisDE}}
Spezial-Flächen der Sachsen-Anhalt-Version (LTK = Linien-Teilungs-Kennzeichnung/„Zitronenschalen", DE = ALKIS-Dateneinheiten). Delphi-Klassen sind <code>T2DAreaLTK</code> (XML-Tag <code>VC_AreaCADLTK</code>) und <code>T2DAreaAlkisDE</code> (XML-Tag <code>VC_AreaCADAlkisDE</code>), beide in <code>CAD\GLGeometrics.pas</code> und '''nur unter <code>{$IFDEF Anhalt}</code>''' übersetzt. Beide erben über die Zwischenklasse <code>T2DAreaLTKDE</code> von <code>T2DArea</code> — die gesamte Rand-Mechanik entspricht [[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|VC_CADFlaeche]].

== VC_AreaCADLTK ==

=== Strukturregel ===
<pre>
<VC_AreaCADLTK>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadFlaeche)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
<Rand>
<Exterior GUID="guid"/>
{<Interior GUID="guid"/>}*
</Rand>
</VC_AreaCADLTK>
</pre>
<code>T2DAreaLTK</code> hat '''keine eigenen XML-Elemente''' — es wird exakt die <code>T2DArea</code>-Serialisierung geerbt (Rand + optional BoeschungsInfos + Basiselemente). Das einzige Unterscheidungsmerkmal in der Datei ist das Wurzeltag.

=== Referenzen ===
Wie bei [[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|VC_CADFlaeche]]: <code>Exterior</code> ist harte Pflicht-Referenz auf eine geschlossene Kurve, <code>Interior</code> weich. Die Verknüpfung zu den beiden LTK-Bezugspunkten (<code>BezugspunkteItem</code>) wird '''nicht im Objekt gespeichert''' — sie wird nach dem Laden von der ALKIS-Seite (LTK-Daten in der <code>VC_AlkisDaten</code>-Sektion) wiederhergestellt.

== VC_AreaCADAlkisDE ==

=== Strukturregel ===
<pre>
<VC_AreaCADAlkisDE>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadFlaeche)
[Basiselemente]
<Rand>
<Exterior GUID="guid"/>
{<Interior GUID="guid"/>}*
</Rand>
<AlkisDEShowPermanent>bool</AlkisDEShowPermanent> (wird immer geschrieben)
<AlkisDEItemName>text</AlkisDEItemName> (wird immer geschrieben)
</VC_AreaCADAlkisDE>
</pre>

=== Elemente ===
Nur die eigenen Elemente von <code>T2DAreaAlkisDE</code>:

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>AlkisDEShowPermanent</code> || bool (-1/0) || nein (wird aber immer geschrieben) || False || DE-Fläche permanent anzeigen (sonst nur, wenn das DE-Item die aktuelle CAD-Repräsentation ist)
|-
| <code>AlkisDEItemName</code> || String || ja (für die DE-Verknüpfung) || '' || Name der ALKIS-Dateneinheit — '''namensbasierte Verknüpfung''': die ALKIS-Seite (<code>TAlkisDE</code>) sucht nach dem Laden die CAD-Fläche, deren <code>AlkisDEItemName</code> ihrem Namen entspricht. Fehlt der Name oder gibt es die DE nicht mehr, bleibt die Fläche unverknüpft (weich, kein Objektverlust)
|}

== Minimalform ==
<pre>
<VC_AreaCADAlkisDE>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Rand>
<Exterior GUID="{XXXX…}"/>
</Rand>
<AlkisDEShowPermanent>0</AlkisDEShowPermanent>
<AlkisDEItemName>DE 10-56 / 10-57</AlkisDEItemName>
</VC_AreaCADAlkisDE>
</pre>
Für <code>VC_AreaCADLTK</code> gilt dieselbe Minimalform ohne die beiden DE-Elemente. Die <code>Exterior</code>-GUID muss auf ein existierendes geschlossenes Ring-Objekt zeigen, sonst wird die Fläche beim Laden verworfen.

== Beispiele ==
=== Beispiel (KONSTRUIERT — die drei Beispielprojekte sind BW/Sachsen/THR, kein Anhalt-Beleg vorhanden) ===
<pre>
<VC_AreaCADLTK>
<VermCadID>
<GUID>{1A2B3C4D-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Rand>
<Exterior GUID="{5E6F7A8B-…}"/>
</Rand>
</VC_AreaCADLTK>
</pre>

== Verfügbarkeit und Besonderheiten ==
* '''Nur Sachsen-Anhalt''' (<code>{$IFDEF Anhalt}</code>): In allen anderen Bundesland-Versionen sind die Tags nicht in der Objekt-Factory registriert — die Elemente würden beim Laden '''stillschweigend ignoriert'''.
* Kein Bestandsbeleg: In den drei untersuchten Beispielprojekten (BW/Sachsen/THR) kommen beide Tags nicht vor; alle Beispiele auf dieser Seite sind nach den Code-Regeln konstruiert.
* '''KS-0-Bindung''': Beim Referenzen-Update setzen beide Klassen <code>Deleted := True</code>, wenn die umgebende <code>VCCADDaten</code>-Sektion nicht KSID 0 ist — LTK-/DE-Flächen leben nur im Koordinatensystem 0 und werden in anderen KS-Sektionen beim Laden entsorgt (und nicht erneut gespeichert).
* Beide Objekte sind im CAD '''nie verschiebbar''' — sie folgen ihren Bezugspunkten (Geometrie wird von der ALKIS-Seite aktualisiert).
* Schreibreihenfolge im Manager: <code>T2DAreaLTK</code> wird in der Objektgruppe „Flächen" geschrieben, <code>T2DAreaAlkisDE</code> als eigene Gruppe direkt danach (beide nur Anhalt).
* Sichtbarkeit der DE-Fläche zur Laufzeit: nur wenn <code>AlkisDEShowPermanent</code> gesetzt ist oder das DE-Item gerade als CAD-Repräsentation aktiv ist.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:3601-3651</code> — Klassendeklarationen <code>T2DAreaLTKDE</code>/<code>T2DAreaLTK</code> (keine eigenen XML-Methoden bei LTK)
* <code>CAD\GLGeometrics.pas:3653-3702</code> — Klassendeklaration <code>T2DAreaAlkisDE</code>
* <code>CAD\GLGeometrics.pas:65419-65454</code> — <code>T2DAreaAlkisDE.DataToXMLLite</code> (beide Elemente bedingungslos)
* <code>CAD\GLGeometrics.pas:65528-65554</code> — <code>T2DAreaAlkisDE.InternalCreateFromXML</code>
* <code>CAD\GLGeometrics.pas:65115-65125</code> und <code>65380-65389</code> — <code>SetReferencesAndUpdate</code> (Deleted bei KSID ≠ 0)
* <code>Alkis\TAlkisDEUnit.pas:334</code> — namensbasierte Suche der CAD-Fläche über <code>AlkisDEItemName</code>
* <code>CAD\GLGeometrics.pas:97015, 97016ff</code> — Factory-Registrierung (nur Anhalt)
* <code>VERMCAD\GlobalConsts.pas:4702</code> — Tag-Konstanten <code>xn_AlkisDEItemName</code>/<code>xn_AlkisDEShowPermanent</code>

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

CAD XML Syntax-Objekt VC AreaCADLTK und AlkisDE - Versionsgeschichte

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