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

2026-07-20T12:50:26Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADKompo}}
Der Kompo ist das Verbund-/Gruppenobjekt des CAD: eine geordnete Komposition beliebiger CAD-Objekte (meist Linien, auch Punkte, Texte, andere Kompos). Delphi-Klasse ist <code>T3DKompo</code> (<code>CAD\GLGeometrics.pas</code>), XML-Tag <code>VC_CADKompo</code>. Ein geschlossener Linien-Kompo dient außerdem als Ring-Objekt für Flächenränder ([[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|VC_CADFlaeche]], [[CAD XML Syntax-Objekt VC Plotrahmen|VC_Plotrahmen]]). <code>T3DKompo</code> ist Basisklasse der [[CAD XML Syntax-Objekt VC CADBemassung|Bemaßung]] und (über <code>T3DVCCalcMess</code>) von [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|VC_CADVCBerechnung/VC_CADVCMessung]].

== Strukturregel ==
<pre>
<VC_CADKompo>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadKompo)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
<MemberGroup>
{<Member GUID="guid"/>}* (2..n — geordnete Kind-Referenzen)
</MemberGroup>
</VC_CADKompo>
</pre>
Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]] und [[CAD XML Syntax-Basiselemente|Basiselemente]]; Werteformate: [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

== Elemente ==
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>MemberGroup</code> || Container || '''ja''' || — || Liste der Kind-Objekte
|-
| <code>Member</code> || GUID-Attribut-Element (0..n) || '''ja''' (mindestens 2 fürs Laden) || — || Referenz auf ein Kind-Objekt. Die '''Reihenfolge der Member-Elemente = Kompositionsreihenfolge''' (bei Ring-Kompos die Umlaufreihenfolge der Randlinien)
|}
Hinweis: Beim reinen <code>VC_CADKompo</code> tragen die <code>Member</code>-Elemente nur das Attribut <code>GUID</code>. Die Variante mit zusätzlichen Attributen <code>RefGUID</code>/<code>Counter</code> kommt nur in den <code>MemberGroup</code>-Containern INNERHALB von <code>VC_CADVCBerechnungList</code>-Einträgen vor (siehe [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|VC_CADVCBerechnung]]).

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>Member</code> || beliebiges CAD-Objekt (meist [[CAD XML Syntax-Objekt VC CADSimpleLine|Linien]], auch Punkte, Texte, Kompos) || '''ja''' || siehe unten
|}
Auflösungsverhalten von <code>T3DKompo.SetReferencesAndUpdate</code> (Referenzen-Update nach dem Laden aller Objekte):
* '''Weniger als 2 Verweis-GUIDs''' → „Objekt wird nicht eingelesen": der Kompo wird verworfen (gilt nicht für die <code>T3DVCCalcMess</code>-Ableitungen Berechnung/Messung, die auch 1 Kind haben dürfen).
* '''Syntaktisch ungültige Member-GUID''' → Kompo wird verworfen.
* '''Member-Ziel selbst fehlerhaft''' (konnte nicht eingelesen werden) → dieser Member wird aus der Liste entfernt, der Kompo überlebt — sinkt die Zahl dabei unter 2, wird er doch verworfen.
* '''Member-Ziel (noch) nicht verarbeitet''' → Kompo kommt in die Wiedervorlage-Liste; bleibt das Ziel bis zum „LastTry" unauffindbar, wird der Kompo als fehlerhaft '''zerstört''' (Logeintrag „n von m Unter-Objekten nicht gefunden", siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]). Kinder eines verworfenen Kompos können einzeln überleben.
Nach erfolgreicher Auflösung wird jedes Kind-Objekt mit <code>Parent</code> auf den Kompo verlinkt.

== Minimalform ==
<pre>
<VC_CADKompo>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<MemberGroup>
<Member GUID="{XXXX…}"/>
<Member GUID="{XXXX…}"/>
</MemberGroup>
</VC_CADKompo>
</pre>
Mindestens 2 Member-GUIDs auf existierende Objekte sind Pflicht — mit weniger wird der Kompo beim Laden verworfen.

== Beispiele ==
=== Beispiel (Baden-Württemberg, echt — ALKIS-Repräsentant mit 2 Membern) ===
<pre>
<VC_CADKompo>
<VermCadID>
<GUID>{9EEC7079-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-101510</Layer>
<LayerErben>-1</LayerErben>
<MemberGroup>
<Member GUID="{CC3C9309-…}" />
<Member GUID="{32FA3AF1-…}" />
</MemberGroup>
</VC_CADKompo>
</pre>

=== Beispiel (Baden-Württemberg, echt — großer Ring-Kompo, gekürzt) ===
<pre>
<VC_CADKompo>
<VermCadID>
<GUID>{A7E2273A-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-100720</Layer>
<LayerErben>-1</LayerErben>
<MemberGroup>
<Member GUID="{97702235-…}" />
<Member GUID="{5879B99F-…}" />
<Member GUID="{78D742D2-…}" />
… (im Original 280 Member) …
</MemberGroup>
</VC_CADKompo>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen; Bestandsbelege in allen drei Beispielprojekten (BW: 370, Sachsen: 7.868, THR: 765).
* '''Leerer Kompo wird nicht gespeichert''': <code>DataToXMLLite</code> bricht bei 0 Kindern VOR dem Schreiben der VermCadID ab — es entsteht nur ein leeres Wurzelelement ohne Inhalt, das beim Lesen mangels <code>VermCadID</code> kein Objekt erzeugt. Bei genau 1 Kind wird nur eine Log-Warnung („Sinnlose Komposition") ausgegeben, geschrieben wird trotzdem.
* Als Ring einer Fläche muss der Kompo eine '''geschlossene Kurve''' bilden (<code>IsCurve</code> + <code>IsClosed</code>) — sonst verwirft die referenzierende Fläche sich selbst beim Laden.
* Ableitungen mit eigenen Wurzeltags: <code>VC_CADBemassung</code> (T3DBemassung), <code>VC_CADVCBerechnung</code>/<code>VC_CADVCMessung</code> (T3DVCCalcMess). Der Manager schreibt beim Speichern je nach Klasse das passende Tag; nur „echte" Kompos erhalten <code>VC_CADKompo</code>.
* Schreibreihenfolge im Manager: Kompos als Gruppe 9 (nach den Flächen!) — Flächen referenzieren ihre Rand-Kompos also vorwärts; der Leser löst das über die Wiedervorlage-Schleife auf.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:56202-56278</code> — <code>T3DKompo.DataToXMLLite</code> (Leer-Check vor VermCadID, MemberGroup/Member)
* <code>CAD\GLGeometrics.pas:56130-56194</code> — <code>InternalCreateComplexStructsFromXML</code> (Member-GUIDs → FChildrenGUIDS)
* <code>CAD\GLGeometrics.pas:57251-57347</code> — <code>SetReferencesAndUpdate</code> (Mindestanzahl 2, Fehlerverhalten, Parent-Verlinkung)
* <code>CAD\GLGeometrics.pas:56196-56200</code> — <code>GetXMLLinkError</code> (Fehlermeldung über fehlende Kind-GUIDs)
* <code>CAD\GLGeometrics.pas:9011-9021</code> — <code>IsClosedCurve</code> (Kompo als Flächenring)
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten <code>xn_Kompo</code>=<code>VC_CADKompo</code>, <code>xn_Members</code>=<code>MemberGroup</code>, <code>xn_Member</code>=<code>Member</code>

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

CAD XML Syntax-Objekt VC CADKompo - Versionsgeschichte

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