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

2026-07-20T12:50:22Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADBoeschung}}
Die Böschung stellt eine Böschungsschraffur zwischen zwei Kantenobjekten (Oberkante und Unterkante) dar. Delphi-Klasse ist <code>T2DBoeschung</code> (<code>CAD\GLGeometrics.pas</code>), abgeleitet direkt von <code>T3DBaseObject</code>, XML-Tag <code>VC_CADBoeschung</code>. '''Nicht verwechseln''' mit dem <code>BoeschungsInfos</code>-Container an Flächen ([[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|VC_CADFlaeche]]) — das ist eine andere, flächengebundene Böschungs-Variante.

== Strukturregel ==
<pre>
<VC_CADBoeschung>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadBoeschung)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
<Oberkante GUID="guid"/>
<Unterkante GUID="guid"/>
[<NumBoxes>ganzzahl</NumBoxes>]
</VC_CADBoeschung>
</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 ==
Nur die eigenen Elemente von <code>T2DBoeschung</code>:

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>Oberkante</code> || GUID-Attribut-Element || '''ja''' || — || Referenz auf das Oberkanten-Objekt
|-
| <code>Unterkante</code> || GUID-Attribut-Element || '''ja''' || — || Referenz auf das Unterkanten-Objekt
|-
| <code>NumBoxes</code> || ganzzahl || nein || 0 (<code>INIT_T2DBOESCHUNG_FNUMBOXES</code>, nicht geschrieben) || Anzahl der Schraffur-Boxen (Unterteilungen der Böschungsschraffur); 0 = automatisch
|}

Der Schraffur-Stil der Böschung kommt aus dem geerbten Basiselement <code>BoeschungsSchraffurStil</code> (Integer-Config-ID einer Böschungsschraffur-Definition; Default <code>2147483644</code> = nicht gesetzt/erben) — siehe [[CAD XML Syntax-Basiselemente|Basiselemente]].

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>Oberkante</code> || beliebiges <code>T3DBaseObject</code> mit Kanten-Geometrie — typischerweise eine [[CAD XML Syntax-Objekt VC CADSimpleLine|Linie]] oder ein Linien-[[CAD XML Syntax-Objekt VC CADKompo|Kompo]] || '''ja''' || siehe unten
|-
| <code>Unterkante</code> || wie Oberkante || '''ja''' || siehe unten
|}
Auflösungsverhalten von <code>T2DBoeschung.SetReferencesAndUpdate</code> (nach dem Laden aller Objekte):
* Fehlt eine der beiden GUIDs im XML → Logeintrag „hat nicht alle Verweis-GUIDs belegt. Objekt wird nicht eingelesen" — die Böschung wird verworfen.
* Ziel-GUID (noch) nicht verarbeitet → Wiedervorlage-Liste; bleibt ein Ziel bis zum „LastTry" unauffindbar, wird die Böschung als fehlerhaft '''zerstört''' (harte Referenzen, siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).
* Syntaktisch ungültige GUID → Böschung wird verworfen.
Nach der Auflösung trägt sich die Böschung bei beiden Kantenobjekten in deren <code>ConnectedCADObjects</code> ein; die Darstellung (Boxen, Schraffurlinien) wird komplett aus den Kanten-Geometrien neu berechnet und '''nicht''' gespeichert.

== Minimalform ==
<pre>
<VC_CADBoeschung>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadBoeschung</CADObjektArt>
</VermCadID>
<Layer>0</Layer>
<Oberkante GUID="{XXXX…}"/>
<Unterkante GUID="{XXXX…}"/>
</VC_CADBoeschung>
</pre>
Beide GUIDs müssen auf existierende Objekte derselben Datei zeigen — sonst wird die Böschung beim Laden verworfen.

== Beispiele ==
=== Beispiel (konstruiert — kein Bestandsbeleg) ===
'''Hinweis:''' In keinem der drei untersuchten Beispielprojekte (BW/Sachsen/THR) kommt ein <code>VC_CADBoeschung</code>-Objekt vor. Das folgende Beispiel ist nach den Code-Regeln konstruiert:
<pre>
<VC_CADBoeschung>
<VermCadID>
<GUID>{A1B2C3D4-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadBoeschung</CADObjektArt>
</VermCadID>
<Layer>346</Layer>
<BoeschungsSchraffurStil>3</BoeschungsSchraffurStil>
<Oberkante GUID="{B2C3D4E5-…}"/>
<Unterkante GUID="{C3D4E5F6-…}"/>
<NumBoxes>12</NumBoxes>
</VC_CADBoeschung>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen (kein IFDEF); in den drei Beispielprojekten aber ohne Bestandsbeleg.
* Beim interaktiven Erzeugen (<code>NewBoeschung</code>) übernimmt die Böschung Farbe und Alpha von Ober-/Unterkante; im XML stehen diese Werte wie üblich nur bei Abweichung vom Default.
* Schreibreihenfolge im Manager: Böschungen sind die '''letzte''' Objektgruppe (nach Punkten, Linien, Flächen, Kompos, Texten, Bildern, Plotrahmen) — ihre Kantenobjekte stehen beim Lesen also bereits im GUID-Suchbaum.
* Renderreihenfolge (<code>TCADObjArt</code>): <code>cadBoeschung</code> liegt zwischen <code>cadKompo</code> und <code>cadLinie</code>.
* Es werden nur die zwei Referenzen und <code>NumBoxes</code> persistiert; sämtliche Boxen-/Schraffurkoordinaten sind Laufzeitdaten.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:3782-3860</code> — Klassendeklaration <code>T2DBoeschung</code> (OK/UK als <code>T3DBaseObject</code>, <code>FNumBoxes</code>)
* <code>CAD\GLGeometrics.pas:67258-67313</code> — <code>DataToXMLLite</code> (Oberkante/Unterkante als GUID-Attribut-Elemente, NumBoxes nur ≠ 0)
* <code>CAD\GLGeometrics.pas:67174-67202</code> — <code>InternalCreateComplexStructsFromXML</code> (Lesen der OK/UK-GUIDs)
* <code>CAD\GLGeometrics.pas:67232-67255</code> — <code>InternalCreateFromXML</code> (NumBoxes)
* <code>CAD\GLGeometrics.pas:67803-67865</code> — <code>SetReferencesAndUpdate</code> (beide GUIDs Pflicht, Fehlerverhalten)
* <code>CAD\GLGeometrics.pas:66684-66738</code> — Konstruktoren (Init-Werte, Farb-/Alpha-Übernahme)
* <code>CAD\GLConsts.pas:513-583</code> — <code>INIT_T2DBOESCHUNG_FNUMBOXES = 0</code>
* <code>VERMCAD\GlobalConsts.pas</code> — Tag-Konstanten <code>xn_CADBoeschung</code>=<code>VC_CADBoeschung</code>, <code>xn_OK</code>=<code>Oberkante</code>, <code>xn_UK</code>=<code>Unterkante</code>, <code>xn_NumBoxes</code>

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

CAD XML Syntax-Objekt VC CADBoeschung - Versionsgeschichte

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