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

2026-07-20T12:50:25Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADKlotoideLine und VC_CAD_Klothoide}}
Klotoiden (Übergangsbögen mit linear veränderlicher Krümmung, z. B. aus Trassierungsdaten) gibt es in VermCad in ZWEI Klassen: die ältere <code>T2DKlotoideLine</code> (XML-Tag <code>VC_CADKlotoideLine</code>) und die seit 07/2017 neue <code>T2DKlothoide</code> (XML-Tag <code>VC_CAD_Klothoide</code> — '''Achtung: Unterstrich nach „CAD"''' und Schreibweise mit „th"). Beide erben von <code>T2DStartEndPunktLine</code> (<code>CAD\GLGeometrics.pas</code>) und brauchen damit Start- und Endpunkt-Referenzen; sie unterscheiden sich in der Parametrisierung der Kurve.

== Strukturregel ==
<pre>
<VC_CADKlotoideLine> (ältere Klasse)
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadLinie)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[geerbte Linien-Elemente] (siehe VC_CADSimpleLine)
<Startpunkt GUID="guid"/> (Pflicht)
<Endpunkt GUID="guid"/> (Pflicht)
[<CuE_CurveLen>zahl</CuE_CurveLen>]
[<CuE_A>zahl</CuE_A>]
[<CuE_D>ganzzahl</CuE_D>]
[<CuE_Klotoidenwinkel>zahl</CuE_Klotoidenwinkel>]
[<CuE_KR>ganzzahl</CuE_KR>]
</VC_CADKlotoideLine>

<VC_CAD_Klothoide> (neue Klasse, seit 07/2017)
<VermCadID> … </VermCadID>
[Basiselemente]
[geerbte Linien-Elemente]
<Startpunkt GUID="guid"/> (Pflicht)
<Endpunkt GUID="guid"/> (Pflicht)
[<CurveLen>zahl</CurveLen>]
[<StartLen>zahl</StartLen>]
[<KlotParameter>zahl</KlotParameter>]
[<KlotWinkel>zahl</KlotWinkel>]
[<KlotCentre>zahl zahl</KlotCentre>]
[<Kruemmung>enum:TUmlaufSinn</Kruemmung>]
</VC_CAD_Klothoide>
</pre>
Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]], [[CAD XML Syntax-Basiselemente|Basiselemente]] und die Linien-Elemente der Zwischenklassen auf [[CAD XML Syntax-Objekt VC CADSimpleLine|VC_CADSimpleLine]]; Werteformate: [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

== Elemente ==
=== VC_CADKlotoideLine (T2DKlotoideLine) ===
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default (Init) !! Bedeutung
|-
| <code>CuE_CurveLen</code> || Float || nein || Fehlwert (nicht geschrieben) || Bogenlänge der Klotoide
|-
| <code>CuE_A</code> || Float || nein || Fehlwert || Klotoidenparameter A
|-
| <code>CuE_D</code> || Integer (geschrieben über die Float-Routine; ganzzahlige Werte ergeben normale Ganzzahl-Strings) || nein || 1 || D-Wert; beim Lesen mit <code>TryStrToInt</code> — nur ganzzahlige Strings werden übernommen
|-
| <code>CuE_Klotoidenwinkel</code> || Float || nein || Fehlwert || Klotoidenwinkel
|-
| <code>CuE_KR</code> || Integer || nein || 1 || Krümmungsrichtung (Integer-kodiert); Lesen mit <code>TryStrToInt</code>
|}

=== VC_CAD_Klothoide (T2DKlothoide) ===
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default (Init) !! Bedeutung
|-
| <code>CurveLen</code> || Float || nein || Fehlwert (nicht geschrieben) || Bogenlänge
|-
| <code>StartLen</code> || Float || nein || Fehlwert || Startlänge (Bogenlänge vom Klotoidenursprung bis zum Startpunkt)
|-
| <code>KlotParameter</code> || Float || nein || Fehlwert || Klotoidenparameter A
|-
| <code>KlotWinkel</code> || Float || nein || Fehlwert || Winkel
|-
| <code>KlotCentre</code> || Pos-String 2D (<code>X Y</code>) || nein || Init-Punkt (nicht geschrieben) || Zentrum/Ursprung der Klotoide als Koordinate
|-
| <code>Kruemmung</code> || enum:TUmlaufSinn || nein || <code>usEgal</code> (nicht geschrieben) || Krümmungsrichtung als Enum
|}

=== Enum TUmlaufSinn (alle Werte) ===
<code>usEgal</code>, <code>usImUhrzeigersinn</code>, <code>usGegenUhrzeigersinn</code> (<code>VERMCAD\GlobalTypes.pas:885</code>).

=== Unterschiede der beiden Klassen ===
* <code>VC_CADKlotoideLine</code> parametrisiert die Kurve rein über Zahlenwerte (A, D, Winkel, KR als Integer) ohne Zentrumskoordinate.
* <code>VC_CAD_Klothoide</code> modelliert zusätzlich die Startlänge (<code>StartLen</code> — die Kurve kann mitten in der Klotoide beginnen), das explizite Zentrum <code>KlotCentre</code> und die Krümmungsrichtung als sprechenden Enum-Wert statt Integer.
* Beide Klassen existieren parallel; die neue Klasse ersetzt die alte nicht beim Laden (kein Migrationsmechanismus zwischen den Tags).

== Referenzen ==
Für beide Klassen gilt: <code>Startpunkt</code>- und <code>Endpunkt</code>-GUID sind Pflicht (Referenzen auf [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]]); fehlt eine GUID oder ist das Ziel nach dem LastTry des Referenzen-Updates nicht auffindbar, wird das Objekt mit Logeintrag „Objekt wird nicht eingelesen" '''zerstört''' (Details auf [[CAD XML Syntax-Objekt VC CADSimpleLine|VC_CADSimpleLine]]).

== Minimalform ==
<pre>
<VC_CADKlotoideLine>
<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_CADKlotoideLine>
</pre>
Gleiches Muster für <code>VC_CAD_Klothoide</code>. Ohne die Kurvenparameter ist das Objekt zwar ladbar, aber geometrisch unbestimmt — beim Erzeugen sollten die Parameter der jeweiligen Klasse mitgegeben werden.

== Beispiele ==
In keinem der drei Beispielprojekte (BW, Sachsen, Thüringen) kommt eines der beiden Tags vor. Die folgenden Beispiele sind daher '''konstruiert''' (nach den Schreibregeln des Codes, nicht aus Bestandsdaten):

=== Konstruiertes Beispiel VC_CADKlotoideLine ===
<pre>
<VC_CADKlotoideLine>
<VermCadID>
<GUID>{11111111-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Startpunkt GUID="{22222222-…}" />
<Endpunkt GUID="{33333333-…}" />
<CuE_CurveLen>85.43</CuE_CurveLen>
<CuE_A>120</CuE_A>
<CuE_D>2</CuE_D>
<CuE_Klotoidenwinkel>0.2966</CuE_Klotoidenwinkel>
<CuE_KR>-1</CuE_KR>
</VC_CADKlotoideLine>
</pre>

=== Konstruiertes Beispiel VC_CAD_Klothoide ===
<pre>
<VC_CAD_Klothoide>
<VermCadID>
<GUID>{44444444-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Startpunkt GUID="{55555555-…}" />
<Endpunkt GUID="{66666666-…}" />
<CurveLen>85.43</CurveLen>
<StartLen>12.5</StartLen>
<KlotParameter>120</KlotParameter>
<KlotWinkel>0.2966</KlotWinkel>
<KlotCentre>545100.25 5721350.8</KlotCentre>
<Kruemmung>usImUhrzeigersinn</Kruemmung>
</VC_CAD_Klothoide>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Beide Klassen sind in '''allen''' Bundesland-Versionen verfügbar (Factory-Einträge ohne IFDEF), aber in den drei Beispielprojekten nicht belegt — Klotoiden sind ein Sonderfall (Trassierung/LandXML-Import).
* '''Legacy-Migration <code>Kruemmung</code>''' (nur VC_CAD_Klothoide): sehr alte Dateien enthalten die Werte <code>kr_Unknown</code>/<code>kr_ClockWise</code>/<code>kr_CounterClockWise</code> (alte Enum <code>TKruemmungsRichtung</code>); sie werden beim Lesen auf <code>usEgal</code>/<code>usImUhrzeigersinn</code>/<code>usGegenUhrzeigersinn</code> migriert (Konsolidierung 03/2018).
* Die Tag-Konstanten <code>StartRadius</code>/<code>EndRadius</code> existieren in <code>GlobalConsts.pas</code>, haben aber keine Reader-ID und werden nicht geschrieben — '''ungenutzt''', beim Erzeugen nicht verwenden.
* <code>CuE_D</code>/<code>CuE_KR</code> werden über die Float-Schreibroutine ausgegeben, aber mit <code>TryStrToInt</code> gelesen — beim Erzeugen nur ganzzahlige Werte schreiben (Dezimalstrings würden beim Lesen stillschweigend verworfen).
* Die genaue fachliche Semantik von <code>CuE_D</code> und <code>CuE_KR</code> (Kodierung der Krümmungsrichtung) ist im Code nicht kommentiert — konservativ die vom Programm geschriebenen Werte übernehmen.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:2218-2251</code> — Klassendeklaration <code>T2DKlotoideLine</code>
* <code>CAD\GLGeometrics.pas:2253-2289</code> — Klassendeklaration <code>T2DKlothoide</code> („(CP) 25.07.2017 - neue Klothoiden-Klasse")
* <code>CAD\GLGeometrics.pas:43131-43181</code> — <code>T2DKlotoideLine.DataToXMLLite</code>; Lesen <code>43093-43128</code> (TryStrToInt für CuE_D/CuE_KR)
* <code>CAD\GLGeometrics.pas:43631-43690</code> — <code>T2DKlothoide.DataToXMLLite</code>; Lesen <code>43583-43628</code> (inkl. kr_*-Migration 43609-43619)
* <code>CAD\GLGeometrics.pas:96996-97034</code> — Factory-Registrierung beider Wurzeltags
* <code>VERMCAD\GlobalTypes.pas:885</code> — Enum <code>TUmlaufSinn</code>
* <code>CAD\GLConsts.pas:513-583</code> — Init-Werte (<code>INIT_T2DKLOTOIDELINE_*</code>, <code>INIT_T2DKLOTHOIDE_*</code>)
* <code>VERMCAD\GlobalConsts.pas:4634-4635</code> — ungenutzte Konstanten StartRadius/EndRadius

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

CAD XML Syntax-Objekt VC CADKlotoide - Versionsgeschichte

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