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

2026-07-20T12:50:29Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADPunktsymbol}}
Das Punktsymbol ist die Darstellungs-Instanz eines Symbols an einem CAD-Punkt (Symbolzuordnung, Drehwinkel, Skalierung). Delphi-Klasse ist <code>T3DPointSymbol</code> (<code>CAD\GLGeometrics.pas</code>), gespeichert unter dem XML-Tag <code>VC_CADPunktsymbol</code>. Es hat keine eigene Position — es hängt immer an einem [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]], der es über <code>PointSymbolGUID</code> bzw. <code>WeitereSymbole</code> referenziert.

'''Achtung Tag-Namen:''' Vier Elemente tragen im XML wörtlich das Präfix <code>xn_</code> (<code>xn_SymbolDrehwinkel</code>, <code>xn_SymbolSkalierung</code>, <code>xn_SymbolMitCADRotieren</code>, <code>xn_HilfsPunktSymbol</code>) — der Konstanten-Präfix wurde bei nachträglich ergänzten Feldern versehentlich Teil des Tag-Strings und ist persistent. Ein Erzeuger muss diese Namen exakt so schreiben.

== Strukturregel ==
<pre>
<VC_CADPunktsymbol>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt = cadPunktsymbol)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[<SymbolID>guid</SymbolID>] (GUID als ELEMENTTEXT, kein Attribut!)
[<SymbolName>text</SymbolName>] (nur zusammen mit SymbolID)
[<xn_SymbolDrehwinkel>ganzzahl</xn_SymbolDrehwinkel>]
[<xn_SymbolSkalierung>zahl</xn_SymbolSkalierung>]
[<xn_SymbolMitCADRotieren>ganzzahl</xn_SymbolMitCADRotieren>]
[<xn_HilfsPunktSymbol>bool</xn_HilfsPunktSymbol>]
[<PunktSymbolRefLinieGUID GUID="guid"/>]
</VC_CADPunktsymbol>
</pre>
Werteformate: [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]] (Bool = -1/0, Float mit Dezimalpunkt, GUID mit geschweiften Klammern).

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

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>SymbolID</code> || guid als '''Elementtext''' || nein || „Inherited" (kein individuelles Symbol) || ID der Symbol-Definition im Symbolmanager (<code>GUIDToString</code>). Nur geschrieben, wenn dem Punktsymbol ein individuelles Symbol zugeordnet ist (<code>FPunktSymbolIDType ≠ psgtInherited</code>, Enum <code>TPunktSymbolGUIDType</code>: <code>psgtInherited</code>, <code>psgtFromLayer</code>, <code>psgtFromNothing</code>, <code>psgtFromInvisible</code>, <code>psgtOther</code>); fehlt das Element, wird das Symbol aus Layer/Punktzuordnung geerbt.
|-
| <code>SymbolName</code> || Text || nein || — || Symbolname als Lese-Fallback; wird nur zusammen mit <code>SymbolID</code> geschrieben, wenn das Symbol im Symbolmanager gefunden wurde
|-
| <code>xn_SymbolDrehwinkel</code> || ganzzahl || nein || 0 || Drehwinkel des Symbols (Beispieldaten in gon, z. B. <code>300</code>)
|-
| <code>xn_SymbolSkalierung</code> || zahl (Float) || nein || <code>PROPERTY_VALUE_INHERIT</code> (2147483645 = erben) || Skalierungsfaktor; Plausibilitäts-Check beim Lesen: Werte > 1E6 oder < CADZero werden auf 1 gesetzt
|-
| <code>xn_SymbolMitCADRotieren</code> || ganzzahl (Int-kodiertes Bool/Inherit) || nein || <code>PROPERTY_VALUE_INHERIT</code> || Symbol rotiert mit der CAD-Ansicht mit (-1/0/Inherit-Magic-Wert)
|-
| <code>xn_HilfsPunktSymbol</code> || bool || nein || False || Kennzeichen Hilfssymbol (nur geschrieben, wenn True = <code>-1</code>)
|-
| <code>PunktSymbolRefLinieGUID</code> || GUID-Attribut-Element || nein || — || Referenzlinie zur Symbolausrichtung; nur geschrieben, wenn die Linie existiert und nicht gelöscht ist
|}

Magic-Werte (<code>2147483645</code> = erben u. a.): siehe [[CAD XML Syntax-Basiselemente|Basiselemente]].

=== Symboldatei (Root VCSymbol) ===
<code>SymbolID</code> verweist NICHT auf ein CAD-Objekt der Projekt-XML, sondern auf eine Symbol-Definition des Symbolmanagers. Symbol-Definitionen liegen in separaten Symbol-Dateien mit dem Wurzelelement <code>VCSymbol</code> (Konstante <code>xn_SymbolRoot</code>, <code>VERMCAD\GlobalConsts.pas</code>). Der Aufbau dieser Symboldateien ist nicht Teil der Projekt-XML-Syntax und wird hier nicht dokumentiert.

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>SymbolID</code> || Symbol-Definition im Symbolmanager (keine Projekt-GUID) || nein || '''Selbstheilung''': Ist die SymbolID im Symbolmanager unbekannt, wird das Symbol im PostProcessing über <code>SymbolName</code> gesucht; sonst nur Log-Meldung
|-
| <code>PunktSymbolRefLinieGUID</code> || Linienobjekt (z. B. [[CAD XML Syntax-Objekt VC CADSimpleLine|VC_CADSimpleLine]]) || nein || weiche Referenz: fehlendes Ziel wird geloggt/ignoriert
|}
'''Rückverweis-Pflicht:''' Die Verknüpfung Symbol → Punkt läuft ausschließlich rückwärts über den Punkt (<code>PointSymbolGUID</code>/<code>WeitereSymbole</code> am [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]]). Ein Punktsymbol '''ohne referenzierenden Punkt wird beim Speichern übersprungen''' — ein Erzeuger muss also immer das Paar Punkt + Symbol mit passender GUID-Referenz schreiben (Schreibreihenfolge Punkte → Symbole, siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Minimalform ==
<pre>
<VC_CADPunktsymbol>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunktsymbol</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
</VC_CADPunktsymbol>
</pre>
Dazu MUSS ein <code>VC_CADPunkt</code> existieren, dessen <code><PointSymbolGUID GUID="{XXXXXXXX-…}"/></code> auf diese GUID zeigt (sonst geht das Symbol beim nächsten Speichern verloren). Ohne <code>SymbolID</code> gilt das Symbol als „geerbt" aus Layer/Punktzuordnung.

== Beispiele ==
=== Minimalfall (Baden-Württemberg, geerbtes Symbol) ===
<pre>
<VC_CADPunktsymbol>
<VermCadID>
<GUID>{A8653A46-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunktsymbol</CADObjektArt>
</VermCadID>
<Layer>-100900</Layer>
</VC_CADPunktsymbol>
</pre>

=== Reiches Beispiel (Baden-Württemberg) — individuelles Symbol mit Drehwinkel und Referenzlinie ===
<pre>
<VC_CADPunktsymbol>
<VermCadID>
<GUID>{95BBC564-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunktsymbol</CADObjektArt>
</VermCadID>
<Layer>-5212</Layer>
<SymbolID>{8CF9FB44-…}</SymbolID>
<xn_SymbolDrehwinkel>300</xn_SymbolDrehwinkel>
<PunktSymbolRefLinieGUID GUID="{FA2BB7DC-…}" />
</VC_CADPunktsymbol>
</pre>
Beachte: <code>SymbolID</code> trägt die GUID als Elementtext, <code>PunktSymbolRefLinieGUID</code> dagegen als <code>GUID</code>-Attribut.

=== Beispiel (Sachsen) — Hilfssymbol ===
In der Sachsen-Beispieldatei ist <code>xn_HilfsPunktSymbol</code> 7.051-mal belegt (immer <code>-1</code> = True), z. B.:
<pre>
<VC_CADPunktsymbol>
<VermCadID>
<GUID>{XXXXXXXX-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunktsymbol</CADObjektArt>
</VermCadID>
<Layer>-100850</Layer>
<xn_HilfsPunktSymbol>-1</xn_HilfsPunktSymbol>
</VC_CADPunktsymbol>
</pre>
(GUIDs gekürzt; Feldkombination gemäß belegten Vorkommen konstruiert, auch <code>xn_SymbolSkalierung</code> ist in Sachsen belegt.)

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen; in den Beispielprojekten existiert praktisch zu jedem Punkt (mindestens) ein Punktsymbol.
* '''Legacy-Tag <code>xn_SymbolNummer</code>''' (Tag-String ebenfalls wörtlich mit <code>xn_</code>-Präfix): alte Integer-Symbolnummer aus der Zeit vor der GUID-Umstellung; wird nur noch gelesen und über <code>GetSymbolIDByOldSymbolnummer</code> in eine Symbol-GUID gewandelt (Werte ≤ 0/Fehlwert → „Inherited").
* '''PostProcessing''': Unbekannte <code>SymbolID</code> → Suche über <code>SymbolName</code> (Selbstheilung); schlägt auch das fehl, bleibt das Objekt mit Log-Meldung bestehen.
* In sehr alten Projekten lagen die Symbolfelder direkt am Punkt; <code>T3DPoint</code> reicht unbekannte Tags deshalb beim Lesen an sein PointSymbol weiter (Migration, siehe [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]]).
* Symbole werden im Manager direkt nach den Punkten geschrieben (Objektgruppen-Reihenfolge, siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:30535-30602</code> — <code>T3DPointSymbol.DataToXMLLite</code> (Bedingungen, Elementtext vs. Attribut)
* <code>CAD\GLGeometrics.pas:31059-31110</code> — <code>InternalCreateFromXML</code> (inkl. Legacy <code>xn_SymbolNummer</code>, Skalierungs-Plausi)
* <code>CAD\GLGeometrics.pas:31147-31174</code> — <code>InternalCreateComplexStructsFromXML</code> (PunktSymbolRefLinieGUID)
* <code>CAD\GLGeometrics.pas:31112-31145</code> — PostProcessing (Selbstheilung über SymbolName)
* <code>CAD\GLGeometrics.pas:26344-26394</code> — <code>SetReferencesAndUpdate</code> (Rückverknüpfung Punkt → Symbol)
* <code>CAD\GLGeometrics.pas:79712</code> — Symbole ohne ReferenzPoint werden beim Speichern übersprungen
* <code>CAD\GLTypes.pas:990</code> — <code>TPunktSymbolGUIDType</code>; <code>CAD\GLConsts.pas:500-503</code> — Init-Werte der Symbolfelder
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten (inkl. wörtlicher <code>xn_</code>-Präfixe und <code>xn_SymbolRoot</code> = <code>VCSymbol</code>)

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

CAD XML Syntax-Objekt VC CADPunktsymbol - Versionsgeschichte

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