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

2026-07-20T12:50:28Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADPunkt}}
Der CAD-Punkt ist das Grundobjekt der CAD-Daten: Träger von Koordinaten, Punktqualität und (bei VC-Punkten) der Punktnummer. Delphi-Klasse ist <code>T3DPoint</code> (<code>CAD\GLGeometrics.pas</code>), gespeichert unter dem XML-Tag <code>VC_CADPunkt</code> innerhalb einer <code>VCCADDaten</code>-Sektion. Fast alle anderen Objekte (Linien, Texte, Symbole, Flächen) referenzieren Punkte über deren GUID.

== Strukturregel ==
<pre>
<VC_CADPunkt>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; bei VC-Punktnummer
zusätzlich VCPktID_NV + VCPktID_NR)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[<Verankert>bool</Verankert>]
[<PunktQualitaet>enum:TPointQualType</PunktQualitaet>]
[<VCPktArtTransferActivated>bool</VCPktArtTransferActivated>]
[<VCPktArtTransferForce>bool</VCPktArtTransferForce>]
[<VCPktArtTransfer>enum:TAZ_Punktobjekt | leer</VCPktArtTransfer>]
[<PktNrTextType>enum:TPktNrTextType</PktNrTextType>]
[<VCPktSiblTransferedConnected>enum:TVCPktSiblTransferedConnected</VCPktSiblTransferedConnected>]
[<VerwendungsStatus>enum:TPktBenutzPart</VerwendungsStatus>]
<Position>
<gml:Point>
<gml:pos>zahl zahl [zahl]</gml:pos> (X Y [Z]; ECHTE Koordinaten, keine Riss-Deltas)
</gml:Point>
[<OriginalCADPos>zahl zahl [zahl]</OriginalCADPos>]
</Position>
[<PointSymbolGUID GUID="guid"/>]
[<WeitereSymbole>
{<WeitereSymboleMember GUID="guid"/>}* </WeitereSymbole>]
<RissKoordinaten> {<RissEintrag_ID>zahl zahl zahl</RissEintrag_ID>}* </RissKoordinaten>
<RissPktNrTextType> {<RissEintrag_ID>enum:TPktNrTextType</RissEintrag_ID>}* </RissPktNrTextType>
</VC_CADPunkt>
</pre>
Die Reihenfolge entspricht der Schreibreihenfolge in <code>T3DPoint.DataToXMLLite</code>. Die Container <code>RissKoordinaten</code>/<code>RissPktNrTextType</code> werden beim Speichern IMMER geschrieben — meist leer als <code><RissKoordinaten /></code> — dürfen beim Erzeugen aber auch fehlen. Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]] und [[CAD XML Syntax-Basiselemente|Basiselemente]]; Werteformate (Float mit Dezimalpunkt, Bool = -1/0, gml:pos): [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

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

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>Verankert</code> || bool || nein || False || Punkt ist verankert (nicht verschiebbar)
|-
| <code>PunktQualitaet</code> || enum:TPointQualType || praktisch ja || <code>pqConst</code> (Init) || Punktqualität; da der Init-Wert die Konstruktionsphase bezeichnet, steht das Element an praktisch jedem realen Punkt
|-
| <code>VCPktArtTransferActivated</code> || bool || nein || False || Punktart-Transfer aktiv
|-
| <code>VCPktArtTransferForce</code> || bool || nein || False || Punktart-Transfer erzwingen
|-
| <code>VCPktArtTransfer</code> || Enum-Name aus TAZ_Punktobjekt ODER leer || nein || <code>cVCPktArtTransferNone</code> (nicht geschrieben) || Ziel-Punktart des Transfers. Sonderfall: „Inherited" wird als '''leeres Element''' <code><VCPktArtTransfer /></code> gespeichert; beim Lesen wird der Name über <code>GetAlkisObjektByName</code> aufgelöst, leer/unbekannt → Inherited. Wertebereich = ALKIS-Punktobjekt-Typen (Teilbereich <code>ZAX_Grenzpunkt</code> … <code>ZSD_Erhebungspunkt</code> der Enum <code>TAZ_AlkisObjekte</code>, <code>Alkis\AlkisTypes.pas:467</code>)
|-
| <code>PktNrTextType</code> || enum:TPktNrTextType || nein || <code>TT_INHERITED</code> || Art des Punktnummern-Texts; beim Schreiben wird <code>TT_NVNR</code> → <code>TT_NR</code> gewandelt, wenn die Bundesland-Version keine NV/GV-Nummern nutzt (<code>USE_NV_OR_GV</code> aus)
|-
| <code>VCPktSiblTransferedConnected</code> || enum:TVCPktSiblTransferedConnected || nein || <code>vcpstc_None</code> || Zwillings-Übertragungsstatus
|-
| <code>VerwendungsStatus</code> || enum:TPktBenutzPart || nein || <code>pb_None</code> || Verwendungsstatus des VC-Punkts; nur geschrieben, wenn der Punkt eine VCPktID hat und der Status ≠ <code>pb_None</code> ist (Feld seit 09/2023 am CAD-Punkt)
|-
| <code>Position</code> || Container || ja || — || enthält <code>gml:Point/gml:pos</code>; ohne gültige Position bleiben die Koordinaten Fehlwert und der Punkt wird beim '''nächsten Speichern verworfen'''
|-
| <code>gml:pos</code> || <code>X Y [Z]</code> (Floats, leerzeichengetrennt) || ja || — || echte Koordinaten (<code>FCoords</code>, keine Riss-Deltas); Z nur, wenn kein Fehlwert; Fehlwert-Koordinaten werden als Fehlwert-Zahl geschrieben
|-
| <code>OriginalCADPos</code> || <code>X Y [Z]</code> || nein || — || ursprüngliche CAD-Position vor dem Punktart-Transfer; steht INNERHALB von <code>Position</code> (nach <code></gml:Point></code>); nur wenn Transfer aktiv und Original ≠ aktuelle 2D-Koordinate
|-
| <code>PointSymbolGUID</code> || GUID-Attribut-Element || nein || — || Referenz auf das Haupt-[[CAD XML Syntax-Objekt VC CADPunktsymbol|VC_CADPunktsymbol]] des Punkts
|-
| <code>WeitereSymbole</code> || Container mit <code><WeitereSymboleMember GUID="{…}"/></code> (0..n) || nein || leer || weitere Punktsymbol-Objekte desselben Punkts
|-
| <code>RissKoordinaten</code> || Container, je Riss <code><RissEintrag_ID>dX dY dZ</RissEintrag_ID></code> || nein (wird aber immer geschrieben) || leer || rissabhängige Koordinaten-'''Deltas''' zur Standardposition; Eintrag nur, wenn mind. ein Delta ≠ 0/Fehlwert
|-
| <code>RissPktNrTextType</code> || Container, je Riss <code><RissEintrag_ID>enum:TPktNrTextType</RissEintrag_ID></code> || nein (wird aber immer geschrieben) || leer || rissabhängiger PNR-Text-Typ; Eintrag nur ≠ <code>TT_UNDEFINED</code>
|}

Die Punktnummer selbst (<code>VCPktID_NV</code>/<code>VCPktID_NR</code>) steht im [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]]; eine gültige VC-Punktnummer verlangt NV ≠ '' UND NR ≠ ''.

=== Enum TPointQualType (alle Werte) ===
{| class="wikitable"
! Wert !! Bedeutung
|-
| <code>pqExtern</code> || externes Objekt: VermCad-Punkt, ALKIS-Punkt, Messgerät
|-
| <code>pqCAD</code> || als Punkt gezeichnetes CAD-Objekt
|-
| <code>pqHelp</code> || Nicht-Punkte (z. B. Linienenden, ALKIS-Repräsentanten)
|-
| <code>pqOnlyFang</code> || reine Fangpunkte
|-
| <code>pqConst</code> || Konstruktionsphase (Init-Wert — wird nicht geschrieben)
|-
| <code>pqTemp</code> || temporär
|}

=== Enum TPktNrTextType (alle Werte) ===
<code>TT_NONE</code>, <code>TT_NR</code>, <code>TT_NVNR</code>, <code>TT_SPECIAL</code>, <code>TT_INHERITED</code>, <code>TT_UNDEFINED</code>.

=== Enum TVCPktSiblTransferedConnected (alle Werte) ===
<code>vcpstc_None</code>, <code>vcpstc_AutoToNP</code>, <code>vcpstc_ToGoDown</code>, <code>vcpstc_ToNotGoDown</code>.

=== Enum TPktBenutzPart (alle Werte) ===
<code>pb_None</code>, <code>pb_SollUnused</code>, <code>pb_SollUsed</code>, <code>pb_ChangedKoord</code>, <code>pb_Changed</code>, <code>pb_New</code>, <code>pb_Deleted</code>, <code>pb_DeletedZwilling</code>.

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>PointSymbolGUID</code> || [[CAD XML Syntax-Objekt VC CADPunktsymbol|VC_CADPunktsymbol]] || nein || weiche Referenz: fehlendes Ziel wird nur geloggt/ignoriert, der Punkt bleibt bestehen
|-
| <code>WeitereSymboleMember</code> || VC_CADPunktsymbol (0..n) || nein || weiche Referenz, wie oben
|}
Umgekehrt ist der Punkt selbst Ziel harter Referenzen (Startpunkt/Endpunkt von Linien, Member von Kompos, Text_Referenzobjekt …) — fehlt der Punkt, wird das '''referenzierende''' Objekt beim Referenzen-Update zerstört (siehe [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]]).

== Minimalform ==
<pre>
<VC_CADPunkt>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<PunktQualitaet>pqCAD</PunktQualitaet>
<Position>
<gml:Point>
<gml:pos>545123.456 5721456.789</gml:pos>
</gml:Point>
</Position>
</VC_CADPunkt>
</pre>
<code>VermCadID</code> mit GUID, <code>Layer</code> und eine gültige <code>Position</code> sind das Minimum fürs korrekte Laden; Punkte mit Fehlwert-Koordinaten werden beim nächsten Speichern verworfen (siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Beispiele ==
=== Minimalfall (Baden-Württemberg, häufigster Fall — ALKIS-Repräsentant) ===
<pre>
<VC_CADPunkt>
<VermCadID>
<GUID>{AEFE2E5B-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>
<Layer>-100780</Layer>
<PunktQualitaet>pqHelp</PunktQualitaet>
<Position>
<gml:Point>
<gml:pos>32519146.78 5308557.85</gml:pos>
</gml:Point>
</Position>
<PointSymbolGUID GUID="{9AB3B261-…}" />
<RissKoordinaten />
<RissPktNrTextType />
</VC_CADPunkt>
</pre>

=== Beispiel (Sachsen) — VC-Punkt mit Punktnummer, VerwendungsStatus und WeitereSymbole ===
<pre>
<VC_CADPunkt>
<VermCadID>
<GUID>{6083B9B4-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
<VCPktID_NV>10</VCPktID_NV>
<VCPktID_NR>56</VCPktID_NR>
</VermCadID>
<Layer>804</Layer>
<UseLayerAusSymboldefinition>-1</UseLayerAusSymboldefinition>
<PunktQualitaet>pqExtern</PunktQualitaet>
<VerwendungsStatus>pb_SollUnused</VerwendungsStatus>
<Position>
<gml:Point>
<gml:pos>3331817.374 5682842.57</gml:pos>
</gml:Point>
</Position>
<PointSymbolGUID GUID="{4263AD83-…}" />
<WeitereSymbole>
<WeitereSymboleMember GUID="{27D026D3-…}" />
</WeitereSymbole>
<RissKoordinaten />
<RissPktNrTextType />
</VC_CADPunkt>
</pre>

=== Beispiel (Sachsen) — gefüllte RissKoordinaten (Deltas je Riss) ===
<pre>
<VC_CADPunkt>
<VermCadID>
<GUID>{A45C4265-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>
<Layer>-100850</Layer>
<PunktQualitaet>pqHelp</PunktQualitaet>
<Position>
<gml:Point>
<gml:pos>3332413.7 5683111.729</gml:pos>
</gml:Point>
</Position>
<PointSymbolGUID GUID="{49A895D7-…}" />
<RissKoordinaten>
<RissEintrag_0>-0.000279225409030914 0.000412030145525932 0</RissEintrag_0>
</RissKoordinaten>
<RissPktNrTextType />
</VC_CADPunkt>
</pre>
Details zur RissEintrag-Struktur: [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]].

=== Beispiel (Thüringen) — ALKIS-Repräsentant mit AlkisID und leerem VCPktArtTransfer ===
<pre>
<VC_CADPunkt>
<VermCadID>
<GUID>{XXXXXXXX-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>
<AlkisID>DETHL53P0000GTXJ</AlkisID>
<Layer>-100360</Layer>
<PunktQualitaet>pqExtern</PunktQualitaet>
<VCPktArtTransfer />
<Position>
<gml:Point>
<gml:pos>2581116.89 5624174.596</gml:pos>
</gml:Point>
</Position>
<PointSymbolGUID GUID="{80A4225D-…}" />
<RissKoordinaten />
<RissPktNrTextType />
</VC_CADPunkt>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen.
* '''PostProcessing''': Nach dem Einlesen des Objekts läuft <code>CheckPktQuality(True)</code> und repariert inkonsistente Kombinationen aus Punktqualität und ObjektArt (es gab z. B. Punkte mit gültiger VCPktID, die <code>pqHelp</code>/<code>oaCAD</code> waren). Dieselbe Prüfung läuft auch vor jedem Speichern.
* '''UTM-Y-Korrektur''': Beim Lesen von <code>gml:pos</code>/<code>OriginalCADPos</code> alter Projekte greift ggf. <code>VKS489YKorrektur</code> (Erkennung UTM-Hochwerte, setzt ggf. Lagestatus 489). Ein leerer pos-String lässt die Koordinaten unverändert.
* '''Migrations-Weiche''': Unbekannte Reader-IDs und Komplexstrukturen werden an das PointSymbol weitergereicht — in sehr alten Projekten lagen die Symboldaten (SymbolID, Drehwinkel …) direkt am Punkt; solche Tags werden also beim Lesen des Punkts akzeptiert.
* <code>VCPktID_KSID</code> wird von CAD-Punkten nicht mehr geschrieben; fehlt sie, gilt die KSID des Projekts. In lokalen Systemen kann <code>VCPktID_NV</code> ein beliebiger String sein (z. B. <code>xx</code>) und Koordinaten können klein oder negativ sein.
* <code>VerwendungsStatus</code> wird erst seit 09/2023 am CAD-Punkt gespeichert — ältere Dateien enthalten es nie.
* Punkte '''ohne gültige X/Y-Koordinaten werden beim Speichern übersprungen''' (Fehlwert-Filter im Manager).

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:26063-26262</code> — <code>T3DPoint.DataToXMLLite</code> (Schreibreihenfolge, Bedingungen)
* <code>CAD\GLGeometrics.pas:26496-26618</code> — <code>InternalCreateFromXML</code> (einfache Werte, UTM-Korrektur, Migrations-Weiche)
* <code>CAD\GLGeometrics.pas:26406-26494</code> — <code>InternalCreateComplexStructsFromXML</code> (Position, PointSymbolGUID, WeitereSymbole, Rissdaten)
* <code>CAD\GLGeometrics.pas:26396-26404</code> — PostProcessing <code>CheckPktQuality(True)</code>
* <code>CAD\GLGeometrics.pas:26620-26636</code> — <code>SetVCPktIDFromXML</code> (NV/NR-Pflicht der Punktnummer)
* <code>CAD\GLGeometrics.pas:21178-21278</code> — <code>T3DPointRissValueList.DataToXMLLite</code> (RissKoordinaten/RissPktNrTextType)
* <code>CAD\GLTypes.pas:952-957</code> — TPointQualType; <code>GLTypes.pas:58, 60-64</code> — TPktNrTextType, TVCPktSiblTransferedConnected
* <code>VERMCAD\GlobalTypes.pas:809</code> — TPktBenutzPart; <code>Alkis\AlkisTypes.pas:467</code> — TAZ_Punktobjekt
* <code>CAD\GLConsts.pas:513-583</code> — Init-Werte (<code>INIT_T3DPOINT_*</code>); <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten
* <code>CAD\GLGeometrics.pas:79669-79670</code> — Fehlwert-Punkte werden nicht gespeichert

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

CAD XML Syntax-Objekt VC CADPunkt - Versionsgeschichte

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