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

2026-07-20T12:50:30Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADSimpleLine}}
Die einfache Linie (Gerade zwischen zwei Punkten) ist das häufigste Linienobjekt der CAD-Daten. Delphi-Klasse ist <code>T2DSimpleLine</code> (<code>CAD\GLGeometrics.pas</code>), gespeichert unter dem XML-Tag <code>VC_CADSimpleLine</code>. Die Klasse selbst hat '''keine eigenen XML-Elemente''' — sie erbt alles von den abstrakten Zwischenklassen <code>T2DLine</code> und <code>T2DStartEndPunktLine</code>, die kein eigenes Wurzeltag besitzen. Deren Elemente sind deshalb '''auf dieser Seite''' dokumentiert; die übrigen Linienseiten ([[CAD XML Syntax-Objekt VC CADMeteredSimpleLine|VC_CADMeteredSimpleLine]], [[CAD XML Syntax-Objekt VC CADArcLine|VC_CADArcLine]], [[CAD XML Syntax-Objekt VC CADKlotoide|Klotoiden]]) verweisen hierauf.

== Strukturregel ==
<pre>
<VC_CADSimpleLine>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadLinie)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[<RichtungInvertiert>bool</RichtungInvertiert>] (T2DLine)
[<VerbundIdentischerLinien>bool</VerbundIdentischerLinien>] (T2DLine)
<Startpunkt GUID="guid"/> (T2DStartEndPunktLine — Pflicht)
<Endpunkt GUID="guid"/> (T2DStartEndPunktLine — Pflicht)
[<LaengeGemessen>zahl</LaengeGemessen>]
[<VerlaengerungAmStartpunkt>zahl</VerlaengerungAmStartpunkt>]
[<VerlaengerungAmEndpunkt>zahl</VerlaengerungAmEndpunkt>]
</VC_CADSimpleLine>
</pre>
Die Reihenfolge entspricht der Schreibkette <code>T3DBaseObject → T2DLine → T2DStartEndPunktLine</code>: die beiden <code>T2DLine</code>-Elemente stehen vor <code>Startpunkt</code>/<code>Endpunkt</code>. Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]] und [[CAD XML Syntax-Basiselemente|Basiselemente]]; Zahlen-/GUID-Formate: [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

== Elemente ==
Elemente der Zwischenklassen <code>T2DLine</code> und <code>T2DStartEndPunktLine</code> (gelten für alle davon abgeleiteten Linien):

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>RichtungInvertiert</code> || bool || nein || False || Linienrichtung invertiert (T2DLine)
|-
| <code>VerbundIdentischerLinien</code> || bool || nein || '''True''' || Darstellung im Verbund trotz identischer Linien; wird nur geschrieben, wenn der Wert False ist (T2DLine)
|-
| <code>Startpunkt</code> || GUID-Attribut-Element || '''ja''' || — || Referenz auf den Start-[[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]]
|-
| <code>Endpunkt</code> || GUID-Attribut-Element || '''ja''' || — || Referenz auf den End-[[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]]
|-
| <code>LaengeGemessen</code> || Float || nein || 0.0 || manuell gemessene Länge
|-
| <code>VerlaengerungAmStartpunkt</code> || Float || nein || 0.0 || optische Verlängerung über den Startpunkt hinaus
|-
| <code>VerlaengerungAmEndpunkt</code> || Float || nein || 0.0 || optische Verlängerung über den Endpunkt hinaus
|}

<code>T2DSimpleLine</code> selbst fügt keine weiteren Elemente hinzu — die Objektart ergibt sich allein aus dem Wurzeltag.

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>Startpunkt</code> || VC_CADPunkt || ja || harte Referenz: fehlt die GUID oder ist das Ziel nach dem LastTry des Referenzen-Updates nicht auffindbar, wird die Linie mit Logeintrag „Objekt wird nicht eingelesen" '''zerstört'''
|-
| <code>Endpunkt</code> || VC_CADPunkt || ja || wie Startpunkt
|}
Beim Lesen landen die GUIDs zunächst in Merk-Feldern (<code>FSPGUID</code>/<code>FEPGUID</code>); die Auflösung zu Objektzeigern geschieht erst nach dem Einlesen ALLER Objekte im Referenzen-Update des Managers (Wiederholungsschleife mit LastTry, siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Minimalform ==
<pre>
<VC_CADSimpleLine>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Startpunkt GUID="{XXXX…}" />
<Endpunkt GUID="{XXXX…}" />
</VC_CADSimpleLine>
</pre>
Beide Punkt-GUIDs müssen auf existierende <code>VC_CADPunkt</code>-Objekte in derselben Datei zeigen — sonst wird die Linie nach dem LastTry zerstört.

== Beispiele ==
=== Minimalfall (echtes Beispiel — reine Topologie) ===
<pre>
<VC_CADSimpleLine>
<VermCadID>
<GUID>{FB786524-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Startpunkt GUID="{5E840B97-…}" />
<Endpunkt GUID="{4B8E94CA-…}" />
</VC_CADSimpleLine>
</pre>

=== Reiches Exemplar (echtes Beispiel — voller Linien-Darstellungsblock) ===
<pre>
<VC_CADSimpleLine>
<VermCadID>
<GUID>{E7EF1789-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Farbe>2147483644</Farbe>
<Alpha>2147483644</Alpha>
<VCBerLayerID>-5704</VCBerLayerID>
<Layer>-5704</Layer>
<LayerErben>-1</LayerErben>
<Linienstaerke>2147483644</Linienstaerke>
<LinienendenFreistellen>2147483644</LinienendenFreistellen>
<Liniensymbol>2147483644</Liniensymbol>
<Linienmuster>2147483644</Linienmuster>
<LineCloseType>2147483644</LineCloseType>
<Startpunkt GUID="{7ADD6286-…}" />
<Endpunkt GUID="{99443D76-…}" />
</VC_CADSimpleLine>
</pre>
Alle Stil-Elemente sind [[CAD XML Syntax-Basiselemente|Basiselemente]]; <code>2147483644</code> = „vom Layer erben". In den Beispielprojekten kommt <code>LineCloseType</code> nur mit den Werten <code>1</code> oder <code>2147483644</code> vor, <code>Linienmuster</code>/<code>Liniensymbol</code> ausschließlich mit <code>2147483644</code>.

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen (Factory-Eintrag ohne IFDEF).
* Belegt in allen drei Beispielprojekten: BW 5.050, Sachsen 53.743, Thüringen 9.069 Exemplare — das mit Abstand häufigste Linienobjekt.
* Keine Legacy-Aliase an dieser Klasse.
* Die Enden der Linie sind eigenständige <code>VC_CADPunkt</code>-Objekte (meist <code>PunktQualitaet=pqHelp</code>) — eine Linie ohne ihre beiden Punkte ist nicht ladbar.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:1735, 1813, 1929</code> — Klassendeklarationen <code>T2DLine</code>, <code>T2DStartEndPunktLine</code>, <code>T2DSimpleLine</code>
* <code>CAD\GLGeometrics.pas:32670-32702</code> — <code>T2DLine.DataToXMLLite</code> (RichtungInvertiert, VerbundIdentischerLinien)
* <code>CAD\GLGeometrics.pas:34503-34564</code> — <code>T2DStartEndPunktLine.DataToXMLLite</code> (Startpunkt, Endpunkt, LaengeGemessen, Verlängerungen)
* <code>CAD\GLGeometrics.pas:34473-34500</code> — <code>InternalCreateComplexStructsFromXML</code> (GUID-Attribute → FSPGUID/FEPGUID)
* <code>CAD\GLGeometrics.pas:36651-36710</code> — <code>SetReferencesAndUpdate</code> („Objekt wird nicht eingelesen" bei fehlender SP/EP-Referenz)
* <code>CAD\GLGeometrics.pas:96996-97034</code> — Factory-Registrierung des Wurzeltags
* <code>CAD\GLConsts.pas:513-583</code> — Init-Werte (<code>INIT_T2DLINE_*</code>)

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

CAD XML Syntax-Objekt VC CADSimpleLine - Versionsgeschichte

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