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

2026-07-20T12:50:18Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADArcLine}}
Der Kreisbogen zwischen einem Start- und einem Endpunkt. Delphi-Klasse ist <code>T2DArcLine</code> (<code>CAD\GLGeometrics.pas</code>), abgeleitet von <code>T2DStartEndPunktLine</code>, gespeichert unter dem XML-Tag <code>VC_CADArcLine</code>. Die Bogengeometrie wird über das Verhältnis <code>RatioDistRad</code> und das Flag <code>Spiegeln</code> definiert; der Bogenmittenpunkt ist ein eigenes Objekt [[CAD XML Syntax-Objekt VC CADBMPunkt|VC_CADBMPunkt]], auf das per GUID referenziert wird.

== Strukturregel ==
<pre>
<VC_CADArcLine>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadLinie)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht;
darunter ggf. AlkisInitialDataErrors)
[geerbte Linien-Elemente] (siehe VC_CADSimpleLine)
<Startpunkt GUID="guid"/> (Pflicht)
<Endpunkt GUID="guid"/> (Pflicht)
<RatioDistRad>zahl</RatioDistRad> (wird immer geschrieben)
[<BogenMittePoint GUID="guid"/>]
[<BogenMittePointCoords>zahl zahl</BogenMittePointCoords>]
[<BogenZwischenPunkt GUID="guid"/>]
<Spiegeln>bool</Spiegeln> (wird immer geschrieben)
[<AlkisInitialBMCoords>zahl zahl</AlkisInitialBMCoords>]
[<AlkisInitialSPCoords>zahl zahl</AlkisInitialSPCoords>]
[<AlkisInitialEPCoords>zahl zahl</AlkisInitialEPCoords>]
[<AlkisInitialMPCoords>zahl zahl</AlkisInitialMPCoords>]
</VC_CADArcLine>
</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]]; Koordinaten-Strings („X Y" mit Dezimalpunkt): [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

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

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>RatioDistRad</code> || Float || ja (wird immer geschrieben, kein Init-Check) || — || Verhältnis Abstand(Startpunkt, Endpunkt) zu Radius; definiert die Bogenkrümmung. Beim Setzen im Programm auf den Bereich [−2, +2] begrenzt (Bogendurchmesser darf nicht kleiner als der Punktabstand sein); das Vorzeichen entspricht dem Radius-Vorzeichen (Bogenseite)
|-
| <code>BogenMittePoint</code> || GUID-Attribut-Element || nein (empfohlen) || — || Referenz auf den Bogenmittenpunkt [[CAD XML Syntax-Objekt VC CADBMPunkt|VC_CADBMPunkt]]
|-
| <code>BogenMittePointCoords</code> || Pos-String 2D (<code>X Y</code>) || nein || Init-Punkt (nicht geschrieben) || Koordinaten der Bogenmitte (redundant zum BM-Punkt gespeichert)
|-
| <code>BogenZwischenPunkt</code> || GUID-Attribut-Element || nein || — || Zwischenpunkt auf dem Bogen (Referenz auf einen [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]])
|-
| <code>Spiegeln</code> || bool || ja (wird immer geschrieben) || False || Bogen gespiegelt (Seite des Bogens relativ zur Sehne)
|-
| <code>AlkisInitialBMCoords</code> || Pos-String 2D || nein || Init-Punkt || initiale ALKIS-Koordinaten der Bogenmitte (seit 03/2021, korrekte Fassung; kein write-Schalter — wird geschrieben, sobald belegt)
|-
| <code>AlkisInitialSPCoords</code> || Pos-String 2D || nein || Init-Punkt || initiale ALKIS-Koordinaten des Startpunkts
|-
| <code>AlkisInitialEPCoords</code> || Pos-String 2D || nein || Init-Punkt || initiale ALKIS-Koordinaten des Endpunkts
|-
| <code>AlkisInitialMPCoords</code> || Pos-String 2D || nein || Init-Punkt || initiale ALKIS-Koordinaten des Kreismittelpunkts
|}

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>Startpunkt</code> / <code>Endpunkt</code> || VC_CADPunkt || ja || harte Referenz: Objekt wird nach dem LastTry '''zerstört''' („Objekt wird nicht eingelesen", siehe [[CAD XML Syntax-Objekt VC CADSimpleLine|VC_CADSimpleLine]])
|-
| <code>BogenMittePoint</code> || VC_CADBMPunkt || nein || '''weiche''' Referenz (seit 08.01.2025): beim LastTry wird der Bogen auch ohne gefundenen Bogenmittenpunkt eingelesen (nur Warnung im Log). Zeigt die GUID auf einen normalen <code>VC_CADPunkt</code> statt eines BM-Punkts, wird dieser beim Referenzen-Update automatisch in einen <code>VC_CADBMPunkt</code> umgewandelt (Migration alter Beta-Dateien)
|-
| <code>BogenZwischenPunkt</code> || VC_CADPunkt || nein || weiche Referenz: fehlendes Ziel wird nur geloggt, der Bogen bleibt bestehen („Objekt wird dennoch eingelesen")
|}
Zusammenspiel mit [[CAD XML Syntax-Objekt VC CADBMPunkt|VC_CADBMPunkt]]: Die Zuordnung Bogen ↔ Bogenmittenpunkt wird ausschließlich HIER (am Bogen) gespeichert; beim Auflösen setzt der Bogen am BM-Punkt dessen <code>ParentArcLine</code>.

== Minimalform ==
<pre>
<VC_CADArcLine>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Startpunkt GUID="{XXXX…}" />
<Endpunkt GUID="{XXXX…}" />
<RatioDistRad>1.0</RatioDistRad>
<Spiegeln>0</Spiegeln>
</VC_CADArcLine>
</pre>
Ohne <code>BogenMittePoint</code>/<code>BogenMittePointCoords</code> ist der Bogen ladbar; sinnvoll ist mindestens <code>BogenMittePointCoords</code> oder die Referenz auf einen <code>VC_CADBMPunkt</code>.

== Beispiele ==
=== Echtes Beispiel (BW) — ALKIS-Bogen mit BM-Punkt-Referenz und AlkisInitial-Feldern ===
<pre>
<VC_CADArcLine>
<VermCadID>
<GUID>{7EF4E8B8-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Layer>-100890</Layer>
<LayerErben>-1</LayerErben>
<AlkisInitialDataErrors>
<AlkisInitialDataError ErrorType="aideBogenMitte">
<Diff>0 -0.001</Diff>
</AlkisInitialDataError>
</AlkisInitialDataErrors>
<Startpunkt GUID="{93B4DE7D-…}" />
<Endpunkt GUID="{4C33136D-…}" />
<RatioDistRad>-1.11830822656901</RatioDistRad>
<BogenMittePoint GUID="{2CC14BB5-…}" />
<BogenMittePointCoords>32518700.95 5308973.874</BogenMittePointCoords>
<BogenZwischenPunkt GUID="{2CC14BB5-…}" />
<Spiegeln>0</Spiegeln>
<AlkisInitialBMCoords>32518700.95 5308973.874</AlkisInitialBMCoords>
<AlkisInitialSPCoords>32518702.12 5308969.35</AlkisInitialSPCoords>
<AlkisInitialEPCoords>32518702.51 5308978.28</AlkisInitialEPCoords>
<AlkisInitialMPCoords>32518708.9353029 5308973.52587143</AlkisInitialMPCoords>
</VC_CADArcLine>
</pre>
<code>AlkisInitialDataErrors</code> ist ein [[CAD XML Syntax-Basiselemente|Basiselement]]; der einzige in den Beispielprojekten beobachtete <code>ErrorType</code> ist <code>aideBogenMitte</code>. Die Minimalform in den Bestandsdaten kommt ohne den Fehlerblock und ohne <code>BogenMittePoint</code>-Referenz aus (dann nur <code>BogenMittePointCoords</code> + <code>BogenZwischenPunkt</code>).

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen (Factory-Eintrag ohne IFDEF).
* Belegt in den Beispielprojekten: BW 282, Sachsen 583, Thüringen 0 Exemplare.
* '''Legacy-Aliase''' (werden nur gelesen, nie geschrieben): <code>AlkisInitialBogenMitte</code> → gleiche Reader-ID wie <code>BogenMittePoint</code>; <code>AlkisInitialBogenMitteCoords</code> → gleiche Reader-ID wie <code>BogenMittePointCoords</code> (alte, falsch benannte Fassung dieser Felder).
* Die <code>AlkisInitial*Coords</code>-Felder werden nur bei aus ALKIS stammenden Bögen belegt (Vergleichsbasis für die Fehlerprüfung <code>AlkisInitialDataErrors</code>).
* Das Tag <code>EllipseAnzeigetyp</code> ist historisch bedingt auch im Kontext des ArcLine registriert; der aktuelle Lesecode von <code>T2DArcLine</code> wertet es nicht aus (es wird still ignoriert).
* <code>RatioDistRad</code> und <code>Spiegeln</code> werden ohne Default-Vergleich '''immer''' geschrieben — beim Erzeugen ebenfalls immer angeben.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:2058-2216</code> — Klassendeklaration <code>T2DArcLine</code> (<code>FRatioDistRad</code> = „Verhaeltnis zw. Abstand(SP, EP) und Radius")
* <code>CAD\GLGeometrics.pas:39654-39776</code> — <code>DataToXMLLite</code> (Schreibreihenfolge, RatioDistRad/Spiegeln immer)
* <code>CAD\GLGeometrics.pas:39583-39621</code> — <code>InternalCreateFromXML</code> (einfache Werte)
* <code>CAD\GLGeometrics.pas:39552-39581</code> — <code>InternalCreateComplexStructsFromXML</code> (BogenMittePoint-/BogenZwischenPunkt-GUID)
* <code>CAD\GLGeometrics.pas:42833-42930</code> — <code>SetReferencesAndUpdate</code> (weiche BM-Referenz, LastTry-Verhalten, T3DPoint→T3DBMPoint-Migration)
* <code>CAD\GLGeometrics.pas:42614-42649</code> — <code>CalcRatioDistRad</code>/Setter (Begrenzung auf [−2, +2])
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten inkl. Legacy-Aliase (Reader-Registrierung <code>GLGeometrics.pas:96817, 96964</code>)

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

CAD XML Syntax-Objekt VC CADArcLine - Versionsgeschichte

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