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

2026-07-20T12:50:23Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADCircleLine und VC_CADEllipseLine}}
Vollkreis und Ellipse als Linienobjekte. Delphi-Klassen sind <code>T2DCircleLine</code> (XML-Tag <code>VC_CADCircleLine</code>) und die davon abgeleitete <code>T2DEllipseLine</code> (XML-Tag <code>VC_CADEllipseLine</code>), beide in <code>CAD\GLGeometrics.pas</code>. Beide erben direkt von der abstrakten <code>T2DLine</code> — sie haben '''keinen Start-/Endpunkt''', sondern einen referenzierten Mittelpunkt.

== VC_CADCircleLine (Kreis) ==

=== Strukturregel ===
<pre>
<VC_CADCircleLine>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadLinie)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[<RichtungInvertiert>bool</RichtungInvertiert>] (T2DLine, siehe VC_CADSimpleLine)
[<VerbundIdentischerLinien>bool</VerbundIdentischerLinien>] (T2DLine)
<Mittelpunkt GUID="guid"/> (Pflicht)
<Radius>zahl</Radius> (wird immer geschrieben)
</VC_CADCircleLine>
</pre>
Die Elemente <code>Startpunkt</code>/<code>Endpunkt</code>/<code>LaengeGemessen</code>/<code>Verlaengerung…</code> der Klasse <code>T2DStartEndPunktLine</code> kommen hier NICHT vor (andere Vererbungslinie). Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]], [[CAD XML Syntax-Basiselemente|Basiselemente]], die beiden <code>T2DLine</code>-Elemente auf [[CAD XML Syntax-Objekt VC CADSimpleLine|VC_CADSimpleLine]]; Werteformate: [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

=== Elemente ===
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>Mittelpunkt</code> || GUID-Attribut-Element || '''ja''' || — || Referenz auf den Kreismittelpunkt ([[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]])
|-
| <code>Radius</code> || Float || ja (wird immer geschrieben) || — || Kreisradius in Metern
|}

== VC_CADEllipseLine (Ellipse) ==

=== Strukturregel ===
<pre>
<VC_CADEllipseLine>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadLinie)
[Basiselemente]
[<RichtungInvertiert>bool</RichtungInvertiert>]
[<VerbundIdentischerLinien>bool</VerbundIdentischerLinien>]
<Mittelpunkt GUID="guid"/> (geerbt von T2DCircleLine — Pflicht)
<Radius>zahl</Radius> (geerbt — erster Radius „Radius1")
<EllipseAnzeigetyp>enum:TCADEllipseViewType</EllipseAnzeigetyp> (wird immer geschrieben)
<Radius2>zahl</Radius2> (wird immer geschrieben)
<WinkelR1>zahl</WinkelR1> (wird immer geschrieben)
</VC_CADEllipseLine>
</pre>

=== Elemente ===
Zusätzlich zu den geerbten Kreis-Elementen:

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>EllipseAnzeigetyp</code> || enum:TCADEllipseViewType || ja (wird immer geschrieben) || — || Darstellungsart der Ellipse
|-
| <code>Radius2</code> || Float || ja (wird immer geschrieben) || — || zweiter Halbachsen-Radius
|-
| <code>WinkelR1</code> || Float || ja (wird immer geschrieben) || — || Winkel der Radius1-Achse (Radiant)
|}
Der erste Radius wird im geerbten Element <code>Radius</code> gespeichert; beim LESEN wird zusätzlich das Legacy-Tag <code>Radius1</code> akzeptiert (siehe Besonderheiten).

=== Enum TCADEllipseViewType (alle Werte) ===
{| class="wikitable"
! Wert !! Bedeutung
|-
| <code>cevtEllipse</code> || nur die Ellipse zeichnen
|-
| <code>cevtAxis</code> || nur die Achsen zeichnen
|-
| <code>cevtBoth</code> || Ellipse und Achsen zeichnen (real einziger beobachteter Wert)
|}

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>Mittelpunkt</code> || VC_CADPunkt || ja || harte Referenz: fehlt die GUID oder ist das Ziel nach dem LastTry des Referenzen-Updates nicht auffindbar, wird das Objekt mit Logeintrag „Objekt wird nicht eingelesen" '''zerstört''' (gilt für Kreis UND Ellipse)
|}

== Minimalform ==
Kreis:
<pre>
<VC_CADCircleLine>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Mittelpunkt GUID="{XXXX…}" />
<Radius>5.0</Radius>
</VC_CADCircleLine>
</pre>
Ellipse zusätzlich mit <code>EllipseAnzeigetyp</code>, <code>Radius2</code> und <code>WinkelR1</code> vor dem schließenden Tag. Die Mittelpunkt-GUID muss auf einen existierenden <code>VC_CADPunkt</code> zeigen — sonst wird das Objekt nach dem LastTry zerstört.

== Beispiele ==
=== Echtes Beispiel Kreis (Sachsen) ===
<pre>
<VC_CADCircleLine>
<VermCadID>
<GUID>{3988174E-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Farbe>2147483644</Farbe>
<Alpha>2147483644</Alpha>
<VCBerLayerID>-5703</VCBerLayerID>
<Layer>-5703</Layer>
<LayerErben>-1</LayerErben>
<Linienstaerke>2147483644</Linienstaerke>
<Liniensymbol>2147483644</Liniensymbol>
<Linienmuster>2147483644</Linienmuster>
<LineCloseType>2147483644</LineCloseType>
<Mittelpunkt GUID="{B1A6B6F4-…}" />
<Radius>6.99942951886962</Radius>
</VC_CADCircleLine>
</pre>

=== Echtes Beispiel Ellipse (Sachsen) ===
<pre>
<VC_CADEllipseLine>
<VermCadID>
<GUID>{B2B147DB-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Sichtbar>0</Sichtbar>
<Farbe>2147483644</Farbe>
<Alpha>2147483644</Alpha>
<VCBerLayerID>-6200</VCBerLayerID>
<Layer>-6200</Layer>
<Linienstaerke>2147483644</Linienstaerke>
<Liniensymbol>2147483644</Liniensymbol>
<Linienmuster>2147483644</Linienmuster>
<LineCloseType>2147483644</LineCloseType>
<Mittelpunkt GUID="{0900FCF6-…}" />
<Radius>0.76489509741409</Radius>
<EllipseAnzeigetyp>cevtBoth</EllipseAnzeigetyp>
<Radius2>0.493921285145275</Radius2>
<WinkelR1>1.2172768749572</WinkelR1>
</VC_CADEllipseLine>
</pre>
Die Thüringen-Variante ist identisch, nur ohne <code>Sichtbar</code>/<code>VCBerLayerID</code>.

== Verfügbarkeit und Besonderheiten ==
* Beide Klassen sind in '''allen''' Bundesland-Versionen verfügbar (Factory-Einträge ohne IFDEF). Belegt in den Beispielprojekten: <code>VC_CADCircleLine</code> nur Sachsen (4 Exemplare); <code>VC_CADEllipseLine</code> Sachsen 445, Thüringen 2, BW 0.
* '''Legacy-Alias <code>Radius1</code>''' (nur Lesen, nur Ellipse): <code>T2DEllipseLine</code> war früher direkt von <code>T2DLine</code> abgeleitet und hatte einen eigenen ersten Radius unter dem Tag <code>Radius1</code>; alte Projekte werden über diesen WORKAROUND weiterhin korrekt gelesen. Geschrieben wird der erste Radius heute immer als <code>Radius</code>.
* <code>Radius</code>, <code>EllipseAnzeigetyp</code>, <code>Radius2</code> und <code>WinkelR1</code> werden ohne Default-Vergleich '''immer''' geschrieben — beim Erzeugen ebenfalls immer angeben.
* <code>WinkelR1</code> ist ein Winkel im Bogenmaß (Radiant), kein Gon-/Grad-Wert.
* In den Beispielprojekten kommt <code>EllipseAnzeigetyp</code> ausschließlich mit <code>cevtBoth</code> vor.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:2291, 2394</code> — Klassendeklarationen <code>T2DCircleLine</code> (erbt von <code>T2DLine</code>), <code>T2DEllipseLine</code>
* <code>CAD\GLGeometrics.pas:44310-44352</code> — <code>T2DCircleLine.DataToXMLLite</code> (Mittelpunkt, Radius immer)
* <code>CAD\GLGeometrics.pas:44286-44308</code> — <code>T2DCircleLine.InternalCreateFromXML</code> (Radius)
* <code>CAD\GLGeometrics.pas:45831-45880</code> — <code>T2DCircleLine.SetReferencesAndUpdate</code> (Mittelpunkt-Pflicht, „Objekt wird nicht eingelesen")
* <code>CAD\GLGeometrics.pas:46179-46216</code> — <code>T2DEllipseLine.DataToXMLLite</code> (EllipseAnzeigetyp, Radius2, WinkelR1 immer)
* <code>CAD\GLGeometrics.pas:46144-46176</code> — <code>T2DEllipseLine.InternalCreateFromXML</code> (inkl. Radius1-WORKAROUND, Zeilen 46160-46162)
* <code>CAD\GLTypes.pas:1010</code> — Enum <code>TCADEllipseViewType</code>

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

CAD XML Syntax-Objekt VC CADCircleLine und EllipseLine - Versionsgeschichte

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