Claude: Rechtschreibung: Links auf umbenannte Seiten umgestellt

2026-09-22T09:57:30Z

Rechtschreibung: Links auf umbenannte Seiten umgestellt

← Nächstältere Version		Version vom 22. September 2026, 10:57 Uhr
Zeile 135:		Zeile 135:

	== Regeln fürs Erzeugen einer Projekt-XML ==		== Regeln fürs Erzeugen einer Projekt-XML ==
	# Dateirahmen nach [[CAD XML Syntax-~~Uebersicht~~\|Übersicht]] aufbauen (Prolog, Kommentar, <code>VCDaten</code> mit Namespaces, Metadaten inkl. <code>ObjectFileVersion</code>/<code>ObjectFileVCVersion</code> — nie höher als die Zielinstallation, siehe [[CAD XML Syntax-Versionierung und ~~Kompatibilitaet~~\|Versionierung]]).		# Dateirahmen nach [[CAD XML Syntax-Übersicht\|Übersicht]] aufbauen (Prolog, Kommentar, <code>VCDaten</code> mit Namespaces, Metadaten inkl. <code>ObjectFileVersion</code>/<code>ObjectFileVCVersion</code> — nie höher als die Zielinstallation, siehe [[CAD XML Syntax-Versionierung und Kompatibilität\|Versionierung]]).
	# Je Koordinatensystem eine <code>VCCADDaten</code>-Sektion mit <code>KSID</code>-Attribut; darin zuerst <code>Rissdaten</code> (mindestens <code>RissEintrag_0</code> mit <code>RissName</code>+<code>RissID</code>) und <code>CurrRissID</code>.		# Je Koordinatensystem eine <code>VCCADDaten</code>-Sektion mit <code>KSID</code>-Attribut; darin zuerst <code>Rissdaten</code> (mindestens <code>RissEintrag_0</code> mit <code>RissName</code>+<code>RissID</code>) und <code>CurrRissID</code>.
	# Objekte in der Schreibreihenfolge oben ausgeben; jedes Objekt: Wurzeltag → <code>VermCadID</code> (eindeutige GUID!) → benötigte [[CAD XML Syntax-Basiselemente\|Basiselemente]] (mindestens <code>Layer</code>) → Klassen-Elemente.		# Objekte in der Schreibreihenfolge oben ausgeben; jedes Objekt: Wurzeltag → <code>VermCadID</code> (eindeutige GUID!) → benötigte [[CAD XML Syntax-Basiselemente\|Basiselemente]] (mindestens <code>Layer</code>) → Klassen-Elemente.
	# Nur Nicht-Default-Werte schreiben (fehlendes Element = Default); Formate strikt nach [[CAD XML Syntax-Werte- und Koordinatenformate\|Werte- und Koordinatenformate]].		# Nur Nicht-Default-Werte schreiben (fehlendes Element = Default); Formate strikt nach [[CAD XML Syntax-Werte- und Koordinatenformate\|Werte- und Koordinatenformate]].
	# Alle GUID-Referenzen müssen auf existierende Objekte derselben Datei zeigen — fehlende harte Referenzen führen zur Zerstörung des referenzierenden Objekts beim Laden.		# Alle GUID-Referenzen müssen auf existierende Objekte derselben Datei zeigen — fehlende harte Referenzen führen zur Zerstörung des referenzierenden Objekts beim Laden.
	# Keine Legacy-Tags schreiben ([[CAD XML Syntax-Versionierung und ~~Kompatibilitaet~~\|Alias-Tabelle]]).		# Keine Legacy-Tags schreiben ([[CAD XML Syntax-Versionierung und Kompatibilität\|Alias-Tabelle]]).

	== Verfügbarkeit und Besonderheiten ==		== Verfügbarkeit und Besonderheiten ==

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

2026-07-20T12:50:16Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Lesemechanik und Pflichtfelder}}
Diese Seite beschreibt, wie VermCad die CAD-Objekte der Projekt-XML einliest (Factory, Element-Dispatch, Referenzen-Update), in welcher Reihenfolge die Objektgruppen geschrieben werden und welche Minimalanforderungen ein Objekt erfüllen muss, damit es korrekt geladen wird. Sie ist damit die zentrale Regelseite für das ERZEUGEN und REPARIEREN von Projekt-XMLs.

== Strukturregel ==
<pre>
<VCCADDaten KSID="…">
… Rissdaten, CurrRissID, ObjektAuswahlen, Bearbeitungsgebiet … (siehe Sektion VCCADDaten)
{ <objekt-wurzeltag> (muss in der Factory-Tabelle stehen,
<VermCadID> … </VermCadID> sonst wird das Element ignoriert)
[Basiselemente]
… klassenspezifische Elemente …
</objekt-wurzeltag> }*
</VCCADDaten>
</pre>

== Factory: Objekt-Wurzeltag → Delphi-Klasse ==
Beim Lesen wird jedes Kind-Element von <code>VCCADDaten</code> über die Hash-Tabelle <code>CreateCADObj_HashTable</code> auf eine Erzeugerfunktion abgebildet. '''Nur die folgenden 29 Tags erzeugen Objekte; alle anderen Tags werden still ignoriert.'''

{| class="wikitable"
! XML-Tag !! Delphi-Klasse !! Detailseite !! Bundesland
|-
| <code>VC_CADPunkt</code> || T3DPoint || [[CAD XML Syntax-Objekt VC CADPunkt|Objekt VC_CADPunkt]] || alle
|-
| <code>VC_CADBMPunkt</code> || T3DBMPoint (Bogenmittenpunkt) || [[CAD XML Syntax-Objekt VC CADBMPunkt|Objekt VC_CADBMPunkt]] || alle
|-
| <code>VC_CADPunktsymbol</code> || T3DPointSymbol || [[CAD XML Syntax-Objekt VC CADPunktsymbol|Objekt VC_CADPunktsymbol]] || alle
|-
| <code>VC_CADSimpleLine</code> || T2DSimpleLine || [[CAD XML Syntax-Objekt VC CADSimpleLine|Objekt VC_CADSimpleLine]] || alle
|-
| <code>VC_CADMeteredSimpleLine</code> || T2DMeteredSimpleLine || [[CAD XML Syntax-Objekt VC CADMeteredSimpleLine|Objekt VC_CADMeteredSimpleLine]] || alle
|-
| <code>VC_CADArcLine</code> || T2DArcLine || [[CAD XML Syntax-Objekt VC CADArcLine|Objekt VC_CADArcLine]] || alle
|-
| <code>VC_CADCircleLine</code> || T2DCircleLine || [[CAD XML Syntax-Objekt VC CADCircleLine und EllipseLine|Objekt VC_CADCircleLine/EllipseLine]] || alle
|-
| <code>VC_CADEllipseLine</code> || T2DEllipseLine || [[CAD XML Syntax-Objekt VC CADCircleLine und EllipseLine|Objekt VC_CADCircleLine/EllipseLine]] || alle
|-
| <code>VC_CADKlotoideLine</code> || T2DKlotoideLine || [[CAD XML Syntax-Objekt VC CADKlotoide|Objekt VC_CADKlotoide]] || alle
|-
| <code>VC_CAD_Klothoide</code> || T2DKlothoide || [[CAD XML Syntax-Objekt VC CADKlotoide|Objekt VC_CADKlotoide]] || alle
|-
| <code>VC_CADFlaeche</code> || T2DArea || [[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|Objekt VC_CADFlaeche/VCFlaeche]] || alle
|-
| <code>VC_CADVCFlaeche</code> || T2DVCArea || [[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|Objekt VC_CADFlaeche/VCFlaeche]] || alle
|-
| <code>VC_Plotrahmen</code> || T2DPlotFrame || [[CAD XML Syntax-Objekt VC Plotrahmen|Objekt VC_Plotrahmen]] || alle
|-
| <code>VC_AreaCADLTK</code> || T2DAreaLTK || [[CAD XML Syntax-Objekt VC AreaCADLTK und AlkisDE|Objekt VC_AreaCADLTK/AlkisDE]] || nur Sachsen-Anhalt (Anhalt)
|-
| <code>VC_AreaCADAlkisDE</code> || T2DAreaAlkisDE || [[CAD XML Syntax-Objekt VC AreaCADLTK und AlkisDE|Objekt VC_AreaCADLTK/AlkisDE]] || nur Sachsen-Anhalt (Anhalt)
|-
| <code>VC_CADVCBerechnung</code> || T3DVCBerechnung || [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|Objekt VC_CADVCBerechnung/VCMessung]] || alle
|-
| <code>VC_CADVCMessung</code> || T3DVCMessung || [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|Objekt VC_CADVCBerechnung/VCMessung]] || alle
|-
| <code>VC_CADBemassung</code> || T3DBemassung || [[CAD XML Syntax-Objekt VC CADBemassung|Objekt VC_CADBemassung]] || alle
|-
| <code>VC_CADKompo</code> || T3DKompo || [[CAD XML Syntax-Objekt VC CADKompo|Objekt VC_CADKompo]] || alle
|-
| <code>VC_CADText</code> || T2DText || [[CAD XML Syntax-Objekt VC CADText|Objekt VC_CADText]] || alle
|-
| <code>VC_CADVCPNRText</code> || T2DVCPNRText || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || alle
|-
| <code>VC_CADVCPNRParVMAKuerzelText</code> || T2DVCPNRParameterVMAKuerzelText || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || alle
|-
| <code>VC_CADVCPNRParVMAKuerzelOriginalText</code> || T2DVCPNRParameterVMAKuerzelText (mit <code>IsOriginal</code>-Flag) || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || alle
|-
| <code>VC_CADVCPNRParInGeradeText</code> || T2DVCPNRParameterInGeradeText || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || nur BW
|-
| <code>VC_CADVCPNRParInGeradeOriginalText</code> || T2DVCPNRParameterInGeradeText (mit <code>IsOriginal</code>-Flag) || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || nur BW
|-
| <code>VC_CADVCPNRParAufKreisbogenText</code> || T2DVCPNRParameterAufKreisbogenText || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || nur BW
|-
| <code>VC_CADVCPNRParAufKreisbogenOriginalText</code> || T2DVCPNRParameterAufKreisbogenText (mit <code>IsOriginal</code>-Flag) || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || nur BW
|-
| <code>VC_CADBoeschung</code> || T2DBoeschung || [[CAD XML Syntax-Objekt VC CADBoeschung|Objekt VC_CADBoeschung]] || alle
|-
| <code>VC_Hintergrundbild</code> || T2DBackgroundPicture || [[CAD XML Syntax-Objekt VC Hintergrundbild|Objekt VC_Hintergrundbild]] || alle
|}

Hinweise:
* Nicht alle Objekte heißen <code>VC_CAD*</code>: Plotrahmen und Hintergrundbild werden als <code>VC_Plotrahmen</code>/<code>VC_Hintergrundbild</code> (ohne „CAD") serialisiert.
* <code>T2DLine</code>, <code>T2DStartEndPunktLine</code>, <code>T2DAreaBase</code> sind abstrakte Zwischenklassen ohne eigenes Wurzeltag.
* Die PNRText-„Original"-Varianten sind KEINE eigenen Klassen: Die Factory erzeugt dieselbe Klasse wie die Normal-Variante und setzt zusätzlich das Flag <code>IsOriginal := True</code> (GLGeometrics.pas:83807/83819/83830). Die Unterscheidung steckt allein im Wurzeltag.

== Lesemechanik (drei Stufen) ==
# '''Factory''': Wurzeltag → Erzeugerfunktion (<code>Init_CreateCADObj_HashTable</code> → <code>NewObjectFromXML</code>). Die Objekt-Erzeugung wird erst beim Fund des <code>VermCadID</code>-Kindes ausgelöst.
# '''Element-Dispatch''' (<code>T3DBaseObject.CreateFromXML</code>, XmlLite-SAX-Reader): Elementknoten werden über die <code>CAD_XML_Reader_ComplexStructures_HashTable</code> (Struktur-/GUID-Referenz-Elemente, Attribute werden mitgegeben), Text-/CDATA-Knoten über die <code>CAD_XML_Reader_HashTable</code> (einfache Werte) auf Reader-IDs (<code>TCAD_XML_Reader_ID</code>) abgebildet. Das Ende eines Objekts wird über die Element-TIEFE erkannt (Tiefenzähler), nicht über End-Tag-Namen.
# '''PostProcessing''': nach dem Einlesen des Objekts (<code>InternalCreateFromXMLPostProcessing</code>, z. B. Qualitäts-Reparatur beim Punkt, Symbol-Selbstheilung); die GUID→Objekt-Auflösung erfolgt erst nach dem Laden ALLER Objekte über den GUID-Suchbaum ([[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID und GUID-Referenzen]]).

Fehlertoleranz:
* '''Unbekannte Tags werden stillschweigend übersprungen''' (nur im VCDEBUG-Build geloggt) — zusätzliche/fremde Elemente machen eine Datei nicht ungültig.
* Defekte Einzelwerte: Exception wird gefangen und geloggt, die restlichen Elemente des Objekts werden weitergelesen. Ein defektes Objekt bricht das Projektladen nicht ab.
* Objekte mit <code>Deleted=-1</code> werden nach dem Laden entfernt.

== Schreibreihenfolge der Objektgruppen ==
Innerhalb jeder <code>VCCADDaten</code>-Sektion schreibt VermCad in dieser festen Reihenfolge (referenzierte Objekte stehen dadurch VOR ihren Referenzierern — ein Erzeuger sollte sie einhalten, der Leser ist dank nachgelagerter Referenz-Auflösung aber tolerant):

# Rissdaten + <code>CurrRissID</code> ([[CAD XML Syntax-Sektion Rissdaten und Auswahlen|Sektion Rissdaten und Auswahlen]])
# Bearbeitungsgebiet (<code>BearbeitungsgebietAutomatisch</code>, <code>BearbeitungsgebietAutoMitFlaechen</code>, <code>Bearbeitungsgebiet</code>)
# <code>ObjektAuswahlen</code>
# '''Punkte''' (<code>VC_CADPunkt</code>, <code>VC_CADBMPunkt</code>) — nur mit gültigen X/Y-Koordinaten
# '''Punktsymbole''' — nur mit vorhandenem Referenz-Punkt
# '''Linien''' (SimpleLine, MeteredSimpleLine, Arc, Circle, Ellipse, Klotoide, Klothoide)
# '''Flächen''' (VCFlaeche, LTK [Anhalt], Flaeche)
# AlkisDE-Flächen (nur Anhalt)
# '''Kompos''' (VCBerechnung, VCMessung, Bemassung, Kompo)
# '''Texte''' (PNR-Text-Varianten, Text) — leere Texte werden nicht gespeichert
# '''Hintergrundbilder''' — nur wenn Textur geladen und Bilddatei existiert
# '''Plotrahmen'''
# '''Spezialobjekte''' (Böschung)

Speicherfilter: keine temporären Objekte; VC-generierte Objekte (<code>oaVC</code>/<code>oaVCDeleted</code>) nur, wenn Default-Eigenschaften geändert wurden oder ein verbundenes Objekt gespeichert werden muss.

== Minimalanforderungen je Objekt (Pflichtfelder) ==
{| class="wikitable"
! Regel !! Bedeutung
|-
| Registrierter Wurzeltag || sonst wird das gesamte Element ignoriert (Tabelle oben)
|-
| <code>VermCadID</code>-Block || '''zwingend''' — ohne ihn entsteht KEIN Objekt; <code>GUID</code> faktisch Pflicht, Duplikat-GUID → Objekt übersprungen; <code>ObjektArt</code> VOR <code>CADObjektArt</code> ([[CAD XML Syntax-VermCadID und GUID-Referenzen|Details]])
|-
| <code>Layer</code> || wird immer geschrieben; beim Lesen über den LayerManager aufgelöst ([[CAD XML Syntax-Basiselemente|Basiselemente]])
|}

Klassen-Minimum (Details auf den Objektseiten):
* '''Punkt''': <code>Position/gml:pos</code> — Punkte mit Fehlwert-Koordinaten werden beim nächsten Speichern verworfen.
* '''Linien''' (Start/End-Typen): <code>Startpunkt</code>- und <code>Endpunkt</code>-GUID; '''Kreis/Ellipse''': <code>Mittelpunkt</code>-GUID + Radius/Radien; '''Bogen''': zusätzlich <code>RatioDistRad</code> + <code>Spiegeln</code> (werden immer geschrieben), sinnvollerweise <code>BogenMittePoint</code>.
* '''Flächen''': <code>Rand/Exterior</code>-GUID auf ein Kompo, dessen <code>MemberGroup</code> die Randlinien enthält.
* '''Kompo''': <code>MemberGroup</code> mit ≥ 1 (sinnvoll ≥ 2) <code>Member</code>-GUIDs; ein leerer Kompo wird nicht gespeichert.
* '''Bemaßung''': <code>BasePoint1</code> + <code>BasePoint2</code> — sonst wird das Objekt beim Referenzen-Update verworfen.
* '''Texte''': Textinhalt im Kind-Element <code>VC_CADText</code> (leere Texte werden verworfen); für positionsgebundene Texte <code>Text_Referenzobjekt</code>.
* '''Punktsymbol''': Rückverweis nötig — der zugehörige Punkt braucht <code>PointSymbolGUID</code>/<code>WeitereSymbole</code> auf das Symbol; Symbole ohne Referenz-Punkt werden beim Speichern übersprungen.
* '''VCBerechnung/VCMessung''': strikte Element-Reihenfolge <code>MakroIDType</code> → <code>MakroIDNr</code> → <code>MakroIDName</code> → <code>VC_CADVCBerCalcKind</code> → <code>VC_CADVCBerechnungSettings</code> zwingend.

== Regeln fürs Erzeugen einer Projekt-XML ==
# Dateirahmen nach [[CAD XML Syntax-Uebersicht|Übersicht]] aufbauen (Prolog, Kommentar, <code>VCDaten</code> mit Namespaces, Metadaten inkl. <code>ObjectFileVersion</code>/<code>ObjectFileVCVersion</code> — nie höher als die Zielinstallation, siehe [[CAD XML Syntax-Versionierung und Kompatibilitaet|Versionierung]]).
# Je Koordinatensystem eine <code>VCCADDaten</code>-Sektion mit <code>KSID</code>-Attribut; darin zuerst <code>Rissdaten</code> (mindestens <code>RissEintrag_0</code> mit <code>RissName</code>+<code>RissID</code>) und <code>CurrRissID</code>.
# Objekte in der Schreibreihenfolge oben ausgeben; jedes Objekt: Wurzeltag → <code>VermCadID</code> (eindeutige GUID!) → benötigte [[CAD XML Syntax-Basiselemente|Basiselemente]] (mindestens <code>Layer</code>) → Klassen-Elemente.
# Nur Nicht-Default-Werte schreiben (fehlendes Element = Default); Formate strikt nach [[CAD XML Syntax-Werte- und Koordinatenformate|Werte- und Koordinatenformate]].
# Alle GUID-Referenzen müssen auf existierende Objekte derselben Datei zeigen — fehlende harte Referenzen führen zur Zerstörung des referenzierenden Objekts beim Laden.
# Keine Legacy-Tags schreiben ([[CAD XML Syntax-Versionierung und Kompatibilitaet|Alias-Tabelle]]).

== Verfügbarkeit und Besonderheiten ==
* Factory-Einträge <code>VC_AreaCADLTK</code>/<code>VC_AreaCADAlkisDE</code> existieren nur in der Sachsen-Anhalt-Version (IFDEF <code>Anhalt</code>); die vier <code>InGerade</code>/<code>AufKreisbogen</code>-PNR-Varianten nur in BW. Eine Datei mit solchen Tags wird in anderen Bundesland-Versionen trotzdem geladen — die unbekannten Tags werden dann still ignoriert (Datenverlust beim erneuten Speichern!).
* In den drei Referenz-Beispielprojekten (BW/Sachsen/THR) kommen <code>VC_CADBemassung</code>, <code>VC_CADBoeschung</code> und die beiden Anhalt-Flächentypen nicht vor — die Tags sind gleichwohl in der Factory registriert.
* Die Reader-IDs sind der Enum <code>TCAD_XML_Reader_ID</code>; Registrierung der einfachen Tags in <code>CAD_XML_Reader_HashTable</code>, der Struktur-Tags in <code>CAD_XML_Reader_ComplexStructures_HashTable</code>.

== Quellen im Code ==
* CAD\GLGeometrics.pas:96996-97034 — <code>Init_CreateCADObj_HashTable</code>: Factory-Tabelle (29 Tags)
* CAD\GLGeometrics.pas:83845-83952 — <code>TCADObjectManager.NewObjectFromXML</code>: VermCadID-Pflicht, Duplikat-GUID-Skip
* CAD\GLGeometrics.pas:6189-6261 — <code>T3DBaseObject.CreateFromXML</code>: Element-Dispatch, unbekannte Tags (6242-6246)
* CAD\GLGeometrics.pas:96747-96992 — Reader-Hash-Tabellen (einfach + komplex)
* CAD\GLTypes.pas:1782-2017 — <code>TCAD_XML_Reader_ID</code>
* CAD\GLGeometrics.pas:79499-80190 — <code>SaveXMLLite</code>: Schreibreihenfolge, Speicherfilter (79516/79524), Punkt-/Symbol-/Text-Filter (79669, 79712, 79982)
* CAD\GLGeometrics.pas:86090-86325 — <code>UpdateReferencesOrClean</code>: Referenz-Auflösung, Zerstörung fehlerhafter Objekte, <code>ClearAll(True)</code> für Deleted (86312)
* CAD\GLGeometrics.pas:5969-5975 — <code>IsCADObjectName</code> (= Factory-ContainsKey)

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

CAD XML Syntax-Lesemechanik und Pflichtfelder - Versionsgeschichte

Claude: Rechtschreibung: Links auf umbenannte Seiten umgestellt

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