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

2026-07-20T12:50:37Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{DISPLAYTITLE:CAD XML Syntax-Rissdaten an Objekten}}
Risse sind projektspezifische Zeichnungs-Sichten (siehe klassische Wiki-Seite [[CAD-Risse]]). Viele CAD-Objekte können '''rissabhängige Werte''' speichern — z. B. eine je Riss abweichende Punktnummern-Verschiebung oder eine riss-spezifische Unsichtbarkeit. Diese Querschnittsseite beschreibt das gemeinsame XML-Muster <code>RissEintrag_<RissID></code> und die vier Container, in denen es an Objekten vorkommt. Die '''Riss-Verwaltung selbst''' (Liste der Risse mit Name, Maßstab, Ansicht) steht nicht am Objekt, sondern am Anfang jeder <code>VCCADDaten</code>-Sektion — siehe [[CAD XML Syntax-Sektion Rissdaten und Auswahlen|Sektion Rissdaten und Auswahlen]].

== Strukturregel ==
Gemeinsames Muster: Ein Container-Element am Objekt enthält je Riss ein Element bzw. einen Unter-Container, dessen Tag-Name aus dem Präfix <code>RissEintrag_</code> (Konstante <code>xn_RissEintrag</code>) plus der Integer-Riss-ID zusammengesetzt ist. Der Standard-Riss hat immer die ID 0 (<code>cCAD_RISS_ID_STANDARD</code>, Name <code>[Standard]</code>) und existiert in jedem Projekt.

<pre>
(1) RissSichtbarkeit — an JEDEM CAD-Objekt (Basisklasse T3DBaseObject):
<RissSichtbarkeit>
{<RissEintrag_ID>0</RissEintrag_ID>}* (Wert immer '0' = unsichtbar in diesem Riss)
</RissSichtbarkeit>

(2) RissKoordinaten + RissPktNrTextType — an VC_CADPunkt/VC_CADBMPunkt (T3DPointRissValueList):
<RissKoordinaten>
{<RissEintrag_ID>zahl zahl zahl</RissEintrag_ID>}* (dX dY dZ = Koordinaten-DELTAS zum Standard)
</RissKoordinaten>
<RissPktNrTextType>
{<RissEintrag_ID>enum:TPktNrTextType</RissEintrag_ID>}*
</RissPktNrTextType>

(3) Text_RissDaten — an allen Textobjekten (T2DTextRissValueList):
<Text_RissDaten>
{<RissEintrag_ID>
[<Text_RissRefPktMove>zahl zahl 0</Text_RissRefPktMove>]
[<Text_RissDrehwinkel>zahl</Text_RissDrehwinkel>]
[<Text_RissNieAufDemKopf>ganzzahl</Text_RissNieAufDemKopf>]
[<Text_RissAusrichtungRefLinieGUID GUID="guid"/>]
[<Text_RissAmRefObjAusr>ganzzahl</Text_RissAmRefObjAusr>]
[<Text_RissStrStauHor>zahl</Text_RissStrStauHor>]
[<Text_RissStrStauVert>zahl</Text_RissStrStauVert>]
</RissEintrag_ID>}*
</Text_RissDaten>

(4) Bemassung_RissDaten — an VC_CADBemassung (T3DBemassungRissValueList):
<Bemassung_RissDaten>
{<RissEintrag_ID>
[<Bemassung_RissDistToBase>zahl</Bemassung_RissDistToBase>]
</RissEintrag_ID>}*
</Bemassung_RissDaten>
</pre>

Zwei Bauformen des <code>RissEintrag_ID</code>-Elements:
* '''Wert-Element''' (RissSichtbarkeit, RissKoordinaten, RissPktNrTextType): der Wert steht direkt als Textknoten im Element.
* '''Unter-Container''' (Text_RissDaten, Bemassung_RissDaten): der Eintrag enthält eigene Kind-Elemente, jedes optional.

== Elemente ==
{| class="wikitable"
! Container !! An Objekttyp !! Eintrag je Riss !! Schreibbedingung !! Bedeutung
|-
| <code>RissSichtbarkeit</code> || alle CAD-Objekte ([[CAD XML Syntax-Basiselemente|Basiselement]]) || Wert immer <code>0</code> (BoolToStr(False)) || Container nur, wenn das Objekt in mindestens einem Riss unsichtbar ist; je unsichtbarem Riss ein Eintrag || Objekt ist in den gelisteten Rissen '''unsichtbar''' (fehlender Eintrag = sichtbar)
|-
| <code>RissKoordinaten</code> || [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]], VC_CADBMPunkt || <code>dX dY dZ</code> (drei Floats, leerzeichengetrennt) || Container wird beim Speichern IMMER geschrieben (meist leer <code><RissKoordinaten /></code>); Eintrag nur, wenn mind. ein Delta ≠ 0 und kein Fehlwert || riss-spezifische Koordinaten-'''Deltas''' zur echten Punktposition (<code>Position/gml:pos</code> enthält immer die echten Koordinaten)
|-
| <code>RissPktNrTextType</code> || VC_CADPunkt, VC_CADBMPunkt || Enum-Name aus TPktNrTextType || Container wird IMMER geschrieben (meist leer); Eintrag nur ≠ <code>TT_UNDEFINED</code> || riss-spezifische Art des Punktnummern-Texts (überstimmt <code>PktNrTextType</code> des Punkts im jeweiligen Riss)
|-
| <code>Text_RissDaten</code> || alle Textobjekte ([[CAD XML Syntax-Objekt VC CADText|VC_CADText]], [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|PNR-Texte]]) || Unter-Container mit bis zu 7 Kindern (s. u.) || Container wird IMMER geschrieben (meist leer <code><Text_RissDaten /></code>); je Kind nur, wenn Wert ≠ Fehlwert || riss-spezifische Text-Darstellung
|-
| <code>Bemassung_RissDaten</code> || VC_CADBemassung || Unter-Container mit <code>Bemassung_RissDistToBase</code> || Container wird IMMER geschrieben; Kind nur, wenn kein Fehlwert || riss-spezifischer Abstand der Maßlinie zur Basislinie
|}

=== Kinder eines Text_RissDaten-Eintrags ===
Jedes Kind entspricht einem Element des Textobjekts und überstimmt es im jeweiligen Riss:
{| class="wikitable"
! Kind-Element !! Typ/Format !! Gegenstück am Objekt
|-
| <code>Text_RissRefPktMove</code> || <code>dX dY 0</code> (drei Floats; dritter Wert immer <code>0</code>) || <code>Text_RefPktMoveX</code>/<code>Text_RefPktMoveY</code>
|-
| <code>Text_RissDrehwinkel</code> || zahl || <code>Text_Drehwinkel</code>
|-
| <code>Text_RissNieAufDemKopf</code> || ganzzahl (Bool/Inherit-kodiert) || <code>Text_NieAufDemKopf</code>
|-
| <code>Text_RissAusrichtungRefLinieGUID</code> || GUID-'''Attribut'''-Element || <code>Text_AusrichtungRefLinieGUID</code> — gleiche Schreiblogik inkl. NOTHING-GUID <code>{AD59FD8E-A1B2-40E8-B2E3-199A7F3E7F89}</code> für aktiv „ENTFERNT“ (Bugfix 01/2022: GUID wird auch geschrieben, wenn die Referenz noch nicht aufgelöst wurde, damit die Riss-Ausrichtung beim Speichern ohne Riss-Öffnung nicht verloren geht)
|-
| <code>Text_RissAmRefObjAusr</code> || ganzzahl || <code>Text_AmRefObjAusrichten</code>
|-
| <code>Text_RissStrStauHor</code> / <code>Text_RissStrStauVert</code> || zahl || <code>Text_StrStauHor</code>/<code>Text_StrStauVert</code>
|}

=== Enum TPktNrTextType (alle Werte) ===
<code>TT_NONE</code>, <code>TT_NR</code>, <code>TT_NVNR</code>, <code>TT_SPECIAL</code>, <code>TT_INHERITED</code>, <code>TT_UNDEFINED</code> (<code>TT_UNDEFINED</code> = kein riss-spezifischer Wert, wird nicht geschrieben).

== Beispiele ==
=== Beispiel (Sachsen) — gefüllte RissKoordinaten am Punkt ===
<pre>
<VC_CADPunkt>
… (VermCadID, Layer, PunktQualitaet, Position) …
<PointSymbolGUID GUID="{49A895D7-…}" />
<RissKoordinaten>
<RissEintrag_0>-0.000279225409030914 0.000412030145525932 0</RissEintrag_0>
</RissKoordinaten>
<RissPktNrTextType />
</VC_CADPunkt>
</pre>

=== Beispiel (Sachsen) — Text_RissDaten mit Einträgen für mehrere Risse (Punktnummerntext) ===
<pre>
<VC_CADVCPNRText>
… (VermCadID, Layer, Text_Referenzobjekt, VC_CADText) …
<Text_RissDaten>
<RissEintrag_0>
<Text_RissRefPktMove>-6.13705911999569 2.45703685283661 0</Text_RissRefPktMove>
</RissEintrag_0>
<RissEintrag_1>
<Text_RissRefPktMove>-6.13705911999569 2.45703685283661 0</Text_RissRefPktMove>
</RissEintrag_1>
<RissEintrag_2>
<Text_RissRefPktMove>-6.13705911999569 2.45703685283661 0</Text_RissRefPktMove>
</RissEintrag_2>
</Text_RissDaten>
</VC_CADVCPNRText>
</pre>

=== Konstruiertes Beispiel — RissSichtbarkeit (kein Bestandsbeispiel in den drei Beispielprojekten) ===
<pre>
<VC_CADSimpleLine>
… (VermCadID, Layer, Startpunkt, Endpunkt) …
<RissSichtbarkeit>
<RissEintrag_1>0</RissEintrag_1>
<RissEintrag_3>0</RissEintrag_3>
</RissSichtbarkeit>
</VC_CADSimpleLine>
</pre>
(Nach den Regeln konstruiert: die Linie ist in den Rissen 1 und 3 unsichtbar, in allen anderen sichtbar.)

=== Konstruiertes Beispiel — Bemassung_RissDaten (kein Bestandsbeispiel) ===
<pre>
<VC_CADBemassung>
… (VermCadID, Layer, MemberGroup, BasePoint1/2, BemassungDistToBase) …
<Bemassung_RissDaten>
<RissEintrag_2>
<Bemassung_RissDistToBase>1.25</Bemassung_RissDistToBase>
</RissEintrag_2>
</Bemassung_RissDaten>
</VC_CADBemassung>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Das Muster ist in '''allen''' Bundesland-Versionen identisch.
* '''Riss-ID-Bezug''': Die ID im Tag-Namen muss zu einem <code>RissEintrag_<ID></code> der Riss-Verwaltung in derselben <code>VCCADDaten</code>-Sektion gehören ([[CAD XML Syntax-Sektion Rissdaten und Auswahlen|Sektion Rissdaten und Auswahlen]]); die Riss-Verwaltung wird VOR den Objekten geschrieben/gelesen. Standard-Riss-ID 0 existiert immer.
* '''Leere Container''': <code>RissKoordinaten</code>, <code>RissPktNrTextType</code>, <code>Text_RissDaten</code> und <code>Bemassung_RissDaten</code> werden beim Speichern auch ohne Einträge geschrieben (z. B. <code><Text_RissDaten /></code>) — fürs Erzeugen dürfen sie fehlen. <code>RissSichtbarkeit</code> wird dagegen NUR geschrieben, wenn mindestens ein Unsichtbar-Eintrag existiert.
* '''Belege aus den Beispielprojekten''' (getrennt von der Code-Verfügbarkeit): gefüllte <code>RissKoordinaten</code> und gefüllte <code>Text_RissDaten</code> (<code>Text_RissRefPktMove</code>, <code>Text_RissDrehwinkel</code>) nur in Sachsen belegt; <code>RissPktNrTextType</code> kommt ausschließlich leer vor; <code>RissSichtbarkeit</code> und <code>Bemassung_RissDaten</code> sind nicht belegt (Beispiele oben konstruiert).
* Fehler beim Schreiben einzelner Riss-Einträge brechen das Speichern nicht ab (nur Logeintrag; Absicherung nach Praxisfällen 2021/2022).
* Die riss-spezifischen Werte sind immer '''Abweichungen''' vom Standardwert des Objekts — die echten Koordinaten/Texteinstellungen stehen weiterhin in den regulären Elementen; ein Reparierer darf Riss-Deltas nicht in die Hauptkoordinaten einrechnen.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:21178-21278</code> — <code>T3DPointRissValueList.DataToXMLLite</code> (RissKoordinaten, RissPktNrTextType; ReadFromXML ab 21313)
* <code>CAD\GLGeometrics.pas:47496-47628</code> — <code>T2DTextRissValueList.DataToXMLLite</code> (Text_RissDaten inkl. GUID-Schreiblogik)
* <code>CAD\GLGeometrics.pas:59037-59079</code> — <code>T3DBemassungRissValueList.DataToXMLLite</code> (Bemassung_RissDaten)
* <code>CAD\GLGeometrics.pas:6738-6775</code> — <code>T3DBaseObject.DataToXMLLite</code> (RissSichtbarkeit)
* <code>CAD\GLGeometrics.pas:72745-72869</code> — <code>TCADRissList.DataToXMLLite</code> (Riss-Verwaltung in der Sektion, zum Abgleich der Riss-IDs)
* <code>VERMCAD\GlobalConsts.pas:4736-4742</code> — Tag-Konstanten <code>xn_TxtRissDaten*</code>; ca. 4372-5004 — <code>xn_RissEintrag</code> (Präfix!), <code>xn_RissKoordinaten</code>, <code>xn_RissPktNrTextType</code>, <code>xn_RissSichtbarkeit</code>, <code>xn_BemassungRissDaten</code>
* <code>VERMCAD\GlobalConsts.pas:1965</code> / <code>CAD\GLConsts.pas:454</code> — NOTHING-GUID (<code>MisGUIDString</code> = <code>PROPERTY_GUID_VALUE_NOTHING</code>)

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

CAD XML Syntax-Rissdaten an Objekten - Versionsgeschichte

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