VermCAD Hilfe Wiki - Benutzerbeiträge [de]

Kategorie:CAD XML Syntax

2026-07-20T12:50:45Z

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

Regelbasierte Referenz der VermCad-Projekt-XML-Datei (CAD-Objekte-Struktur), maschinenlesbar aufbereitet. Einstieg: [[CAD XML Syntax]].

[[Kategorie:CAD]]

CAD XML Syntax-Werte- und Koordinatenformate

2026-07-20T12:50:44Z

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

{{DISPLAYTITLE:CAD XML Syntax-Werte- und Koordinatenformate}}
Alle Werte in der Projekt-XML stehen als Textknoten oder Attribute in einheitlichen Formaten: Floats mit Dezimalpunkt, Bool als <code>-1</code>/<code>0</code>, Enums als Delphi-Bezeichner, GUIDs mit geschweiften Klammern, Koordinaten als leerzeichengetrennte Zahlenpaare. Diese Seite ist die zentrale Format-Referenz; die Objektseiten verweisen hierher.

== Strukturregel ==
<pre>
zahl ::= Float mit Dezimal-PUNKT, variable Stellenzahl (123456.789012)
ganzzahl ::= vorzeichenbehafteter Dezimal-Integer (-100780)
bool ::= -1 (wahr) | 0 (falsch)
text ::= beliebiger Text, ggf. mehrzeilig
guid ::= {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX} (Hex-Großbuchstaben)
enum:TName ::= exakter Delphi-Bezeichner des Enum-Werts (pqExtern, oaCAD, TARP_TopRight)
pos ::= zahl " " zahl [" " zahl] (X Y [Z], leerzeichengetrennt)
posliste ::= { <gml:pos>pos</gml:pos> }* (Polygon-Eckpunkte)
datum ::= yyyy-MM-dd hh:nn:ss (auch mit T-Trenner lesbar)
</pre>

== Elemente ==
{| class="wikitable"
! Typ !! Schreiben !! Lesen !! Beispiel
|-
| Float || <code>OurFloatToStr</code> = Delphi <code>FloatToStr</code> mit Dezimal-PUNKT: bis ~15 signifikante Stellen, keine festen Nachkommastellen, keine Tausendertrennung; sehr große/kleine Werte theoretisch in E-Notation (in echten Dateien nicht beobachtet) || <code>OurStrToFloat</code>; der Text <code>NAN</code> wird an vielen Stellen explizit ignoriert || <code><RatioDistRad>-1.11830822656901</RatioDistRad></code>
|-
| Bool || <code>BoolToStr</code> ohne UseBoolStrs → '''True = <code>-1</code>, False = <code>0</code>''' || <code>TryStrToBool</code>/<code>StrToBoolDef</code>: akzeptiert <code>-1</code>, <code>0</code>, <code>1</code>, <code>True</code>, <code>False</code> (Zahl ≠ 0 → True) || <code><Sichtbar>0</Sichtbar></code>, <code><LayerErben>-1</LayerErben></code>
|-
| Integer / Farben || <code>IntToStr</code>; Farben sind TColor als vorzeichenbehafteter Dezimal-Integer (BGR-Kodierung); Markerwerte <code>PROPERTY_VALUE_*</code> siehe [[CAD XML Syntax-Basiselemente|Basiselemente]] || <code>StrToInt(Def)</code> || <code><Farbe>255</Farbe></code> (rot), real meist <code><Farbe>2147483644</Farbe></code>
|-
| Enum || <code>GetEnumName(TypeInfo(…), Ord(x))</code> → exakter Delphi-Bezeichner; die Namen sind Teil des Dateiformats und dürfen nie geändert werden || <code>GetEnumValue</code>; unbekannter Name → −1 → meist Default bzw. Exception→Log || <code><PunktQualitaet>pqCAD</PunktQualitaet></code>
|-
| GUID || <code>GUIDToString</code>: geschweifte Klammern, Hex-Großbuchstaben; als Elementtext (<code>GUID</code>, <code>SymbolID</code>) oder als Attribut (<code>GUID="…"</code>, <code>RefGUID="…"</code>) || <code>OurStringToGUID</code>/<code>StringToGUID</code> || <code>GUID="{D3287E10-…}"</code>
|-
| Datum/Zeit || <code>OurDateTimeToStr</code>: <code>yyyy-MM-dd hh:nn:ss</code> (DecimalSeparator <code>.</code>, DateSeparator <code>-</code>, TimeSeparator <code>:</code>); in ALKIS-Attributen ISO-8601-UTC (<code>2026-06-01T16:14:54Z</code>) || <code>GetDateTimeFromAlkisString</code> (akzeptiert auch <code>T</code>-Trenner) || <code>2026-07-17 14:30:00</code>
|}

== Koordinatenformate ==
=== Punktposition (Position/gml:Point/gml:pos) ===
Die Position eines Punkts steht in einem gml-Container; Koordinaten leerzeichengetrennt, Z optional (nur wenn kein Fehlwert):
<pre>
<Position>
<gml:Point>
<gml:pos>32519146.78 5308557.85</gml:pos> (2D)
</gml:Point>
</Position>

<gml:pos>32518996.39 5308998.82 0</gml:pos> (3D-Hilfspunkt)
</pre>
* Geschrieben werden die ECHTEN Koordinaten (nicht Riss-Koordinaten); Fehlwerte werden als Fehlwert-Zahl geschrieben, Punkte ganz ohne gültige X/Y-Koordinaten werden gar nicht gespeichert.
* Lesen über <code>Fill3DKoordFromPosString</code> (whitespace-getrennt, 2 oder 3 Werte); leerer pos-String lässt die Koordinaten unverändert. Beim Lesen alter Projekte greift ggf. die <code>VKS489YKorrektur</code> (UTM-Erkennung).
* Nachkommastellen real: 0 bis 8 (dominant 2–3 bei Messkoordinaten, volle Double-Präzision bei gerechneten Werten, z. B. <code>32518906.3203554</code>). Koordinaten in lokalen Systemen können klein oder negativ sein (<code>-59517.61 172806.44</code>).

=== Koordinaten als einfacher Elementtext ===
Strukturfelder wie <code>BogenMittePointCoords</code>, <code>KlotCentre</code>, <code>Text_RefObjPkt</code>, <code>AlkisInitial*Coords</code> nutzen <code>R3DPunkt.ToPosString(cd2D, True)</code> — volle Präzision, 2D <code>X Y</code>:
<pre>
<BogenMittePointCoords>32518700.95 5308973.874</BogenMittePointCoords>
</pre>

=== posliste (Polygon) ===
Das <code>Bearbeitungsgebiet</code> schreibt je Eckpunkt ein eigenes <code>gml:pos</code>-Element (nur 2D, mind. 3 Punkte):
<pre>
<Bearbeitungsgebiet>
<gml:pos>545000.1 5721000.2</gml:pos>
<gml:pos>545100.3 5721000.2</gml:pos>
<gml:pos>545050.0 5721100.9</gml:pos>
</Bearbeitungsgebiet>
</pre>

=== Riss-Deltas (Zahlentripel) ===
Rissabhängige Koordinaten sind DELTAS zum Standard, drei Floats im Elementtext — siehe [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]]:
<pre>
<RissEintrag_0>-0.000279225409030914 0.000412030145525932 0</RissEintrag_0>
</pre>

== Sonderfälle ==
* '''Bool-Ausnahme <code>Active</code>:''' Im RTTI-basierten Container <code>VC_CADVCBerechnungSettings</code> steht <code><Active>True</Active></code> als String — die einzige beobachtete Abweichung vom <code>-1</code>/<code>0</code>-Schema ([[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|Objekt VC_CADVCBerechnung/VCMessung]]).
* '''Mehrzeilige Textknoten:''' Elementtexte können echte Zeilenumbrüche enthalten, z. B. <code>PktNrText_SpecialOutputText</code> ([[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|PNR-Texte]]) und die zeilenweise GUID-Liste in <code>ObjektAuswahlGUIDs</code> (<code>TStringList.Text</code>).
* '''Leere Elemente''' werden selbstschließend mit Leerzeichen geschrieben: <code><RissKoordinaten /></code>, <code><MakroIDName /></code>.
* '''Winkel''' werden in gon gespeichert (<code>xn_SymbolDrehwinkel</code> 0…400, <code>Text_Drehwinkel</code> auch krumm: <code>349.000001697572</code>); <code>WinkelR1</code> der Ellipse dagegen im Bogenmaß (Radiant).
* '''ProjektID''' = 24-stelliger Präfix + GUID: <code>202606010024414000000000{70453D69-…}</code> (Format siehe [[CAD XML Syntax-Uebersicht|Übersicht]]).
* '''AlkisIDs''' sind 16-stellige GML-IDs: <code>DEBWL00100087JA9</code> (BW), <code>DETHL53P0000GTXJ</code> (THR).
* Das gml-Präfix der Positions-Elemente setzt die Namespace-Deklaration am Root voraus ([[CAD XML Syntax-Uebersicht|Übersicht]]).

== Verfügbarkeit und Besonderheiten ==
* Alle Formate gelten bundesland-übergreifend; Unterschiede bestehen nur in den Zonen-Präfixen der Koordinaten (BW/THR Zone 32: <code>32…</code>/<code>25…</code>, Sachsen Zone 33: <code>33…</code>).
* Beim Erzeugen: niemals Lokalisierungs-Formate verwenden (kein Dezimalkomma, keine Tausendertrennung); Enum-Strings exakt in Delphi-Schreibweise inkl. Groß-/Kleinschreibung.
* Beim Reparieren: <code>NAN</code>-Floats sind tolerierbar (werden ignoriert), unbekannte Enum-Namen führen je nach Feld zu Default oder Logeintrag, aber nicht zum Abbruch ([[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Quellen im Code ==
* VERMCAD\GlobalStaticMethods.pas:2590-2597 — <code>OurFloatToStr</code> (Float-Format)
* VERMCAD\GlobalTypConsts.pas:29083-29101 — <code>XMLDateTimeFormatSettings</code> (Punkt/Minus/Doppelpunkt)
* VERMCAD\GlobalRecords.pas:1214-1297 — <code>R3DPunkt.ToPosString</code> (Pos-Strings, volle Präzision bei aForVC=True)
* CAD\GLGeometrics.pas:26146-26207 — Schreiben von <code>Position/gml:Point/gml:pos</code> (Z optional, Fehlwert-Behandlung)
* CAD\GLGeometrics.pas:26521-26538 — <code>VKS489YKorrektur</code> (UTM-Erkennung alter Projekte)
* CAD\GLGeometrics.pas:79609-79635 — <code>SaveXMLLite</code>: Bearbeitungsgebiet als gml:pos-Liste
* VERMCAD\VCObjBase.pas:397-398, 597 — GUID-/Datumsformate im VermCadID-Block

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

CAD XML Syntax-Versionierung und Kompatibilität

2026-07-20T12:50:43Z

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

{{DISPLAYTITLE:CAD XML Syntax-Versionierung und Kompatibilität}}
Die XML-Projektdatei trägt zwei Versionsangaben: die Dateiformat-Version <code>ObjectFileVersion</code> und die Programmversion <code>ObjectFileVCVersion</code>. Beide steuern beim Laden Kompatibilitätsprüfungen und Migrationen. Diese Seite beschreibt die Versionslogik und listet alle Legacy-Aliase (alte Tag-Namen, die nur noch gelesen werden) mit Verweis auf die jeweilige Detailseite.

== Strukturregel ==
<pre>
<ObjectFileVersion>ganzzahl</ObjectFileVersion> (aktuell: 10)
<ObjectFileVCVersion>text</ObjectFileVCVersion> (Programmversion, z. B. 5.0.57)
[<ObjectFileVCVersionWas45orOlder>bool</...>] (nur wenn True)
</pre>

{| class="wikitable"
! Regelelement !! Bedeutung
|-
| <code>ObjectFileVersion</code> || Version des Dateiformats. Beim Schreiben wird immer der aktuelle Wert <code>VermcadObjectFileVersion</code> = '''10''' geschrieben. Beim Lesen steuert der Wert die Migrationsroutine <code>UpdateObjectFileVersion</code> (läuft vor und nach dem Referenzen-Update); Dateien mit ObjectFileVersion < 10 werden automatisch angepasst (u. a. Behandlung des Gelöscht-Dummy-Layers durch <code>GLGeometricsUpdateSkript</code>).
|-
| <code>ObjectFileVCVersion</code> || VermCad-Programmversion, mit der die Datei gespeichert wurde. Beim Lesen liefert <code>CheckObjectFileVCVersion</code> ein <code>TFileVersionCheck</code>: <code>fvcEqual</code>, <code>fvcOlder</code>, <code>fvcNewer</code>.
|-
| <code>ObjectFileVCVersionWas45orOlder</code> || Merker, dass das Projekt ursprünglich mit Version 4.5 oder älter erzeugt wurde (Workaround für den Text-Versatz alter Projekte); wird nur geschrieben, wenn True, und beim Lesen zusätzlich aus <code>fvcOlder</code> abgeleitet (<code>ProjectVCVersionWas45orOlder</code>).
|}

== Versionsprüfung beim Laden ==
* '''<code>fvcNewer</code> — Datei stammt von einer neueren VermCad-Version: das Laden wird ABGEBROCHEN.''' Eine ältere Programmversion öffnet keine neueren Projektdateien. Ein Erzeuger sollte deshalb nie eine höhere <code>ObjectFileVCVersion</code> eintragen als die Zielinstallation.
* <code>fvcOlder</code> — Datei stammt von einer älteren Version: die alte Versionsnummer wird gemerkt (<code>XMLOlderVCVersion</code>) und für die Sicherung der alten Datei (Backup-Umbenennung vor dem Überschreiben) sowie für Migrationsentscheidungen verwendet (z. B. die Umsetzung von <code>VC_CADVCBerechnungListKind</code> in die neuen Kind-Felder).
* <code>fvcEqual</code> — gleiche Version: normales Laden.
* Beim erneuten Speichern eines alten Projekts kann die ALTE <code>ObjectFileVCVersion</code> beibehalten werden (<code>NoXMLVCVersionLock</code>), damit das Projekt für die Ursprungs-Version lesbar bleibt.
* <code>ObjectFileVCVersion</code> sollte in der Datei VOR den <code>VCCADDaten</code>-Sektionen stehen, damit Abbruch-/Migrationsentscheidungen greifen, bevor Objekte gelesen werden.
* Die drei Referenz-Beispielprojekte dieser Doku tragen <code>ObjectFileVersion 9</code> und die Programmversionen 5.0.0 (BW), 5.0.35 (THR), 5.0.57 (Sachsen).

== Legacy-Aliase (werden nur noch gelesen) ==
Fehlende Elemente bedeuten in dieser Syntax immer „Defaultwert" ([[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]); Legacy-Tags dürfen von einem Erzeuger nie geschrieben werden, ein Reparierer darf sie unverändert stehen lassen — der Reader versteht beide Formen.

{| class="wikitable"
! Legacy-Tag !! aktueller Tag / Nachfolger !! Kontext !! Detailseite
|-
| <code>ALKIS_GMLID</code> || <code>AlkisID</code> || Objekt-Basisdaten || [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID und GUID-Referenzen]]
|-
| <code>Erzeugt</code>, <code>LetzteAenderung</code>, <code>NutzerID</code> || entfallen (werden nicht mehr geschrieben) || VermCadID-Block || [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID und GUID-Referenzen]]
|-
| <code>MaxUsedGMLID</code> || <code>MaxUsedAlkisID</code> || Projekt-Metadaten || [[CAD XML Syntax-Uebersicht|Übersicht]]
|-
| <code>xn_SymbolNummer</code> (alte Integer-Symbolnummer) || <code>SymbolID</code> (GUID) || Punktsymbol || [[CAD XML Syntax-Objekt VC CADPunktsymbol|Objekt VC_CADPunktsymbol]]
|-
| <code>AlkisInitialBogenMitte</code> || <code>BogenMittePoint</code> || Bogen || [[CAD XML Syntax-Objekt VC CADArcLine|Objekt VC_CADArcLine]]
|-
| <code>AlkisInitialBogenMitteCoords</code> || <code>BogenMittePointCoords</code> || Bogen || [[CAD XML Syntax-Objekt VC CADArcLine|Objekt VC_CADArcLine]]
|-
| <code>Radius1</code> || <code>Radius</code> || Ellipse || [[CAD XML Syntax-Objekt VC CADCircleLine und EllipseLine|Objekt VC_CADCircleLine/EllipseLine]]
|-
| <code>kr_Unknown</code>/<code>kr_ClockWise</code>/<code>kr_CounterClockWise</code> (Enum-Werte) || <code>usEgal</code>/<code>usImUhrzeigersinn</code>/<code>usGegenUhrzeigersinn</code> (<code>Kruemmung</code>) || Klothoide || [[CAD XML Syntax-Objekt VC CADKlotoide|Objekt VC_CADKlotoide]]
|-
| <code>Text_Referenzpunkt</code> || <code>Text_Referenzobjekt</code> || Text || [[CAD XML Syntax-Objekt VC CADText|Objekt VC_CADText]]
|-
| <code>Text_UnterDurchstrichfarbe</code> (setzte beide Farben) || <code>Text_Unterstrichfarbe</code> + <code>Text_Durchstrichfarbe</code> || Text || [[CAD XML Syntax-Objekt VC CADText|Objekt VC_CADText]]
|-
| <code>RissViewScale</code> (Float, bis 03/2025) || <code>RissViewMeasureScale</code> (Int) || Rissdaten || [[CAD XML Syntax-Sektion Rissdaten und Auswahlen|Sektion Rissdaten und Auswahlen]]
|-
| <code>RissViewMoveX</code>/<code>RissViewMoveY</code> (bis 05/2017) || <code>RissViewMinX</code>/<code>MaxX</code>/<code>MinY</code>/<code>MaxY</code> || Rissdaten || [[CAD XML Syntax-Sektion Rissdaten und Auswahlen|Sektion Rissdaten und Auswahlen]]
|-
| <code>HBild_Scale</code> (eine Skalierung) || <code>HBild_ScaleWidth</code> + <code>HBild_ScaleHeight</code> || Hintergrundbild || [[CAD XML Syntax-Objekt VC Hintergrundbild|Objekt VC_Hintergrundbild]]
|-
| <code>Plotrahmen_TextOben</code>/<code>Unten</code>/<code>Links</code>/<code>Rechts</code>/<code>Allgemein</code> || <code>Plotrahmen_Texte</code>-Container || Plotrahmen || [[CAD XML Syntax-Objekt VC Plotrahmen|Objekt VC_Plotrahmen]]
|-
| <code>VC_CADVCBerechnungListKind</code> (Int, bis 28.01.2026) || <code>VC_CADVCBerechnungListKindBaseType</code> + <code>VC_CADVCBerechnungListKindType</code> || Berechnung/Messung || [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|Objekt VC_CADVCBerechnung/VCMessung]]
|-
| negative Stil-Werte (−1 „vom Layer" u. ä.) || <code>PROPERTY_VALUE_*</code>-Markerwerte (2147483642…2147483645) || Basiselemente || [[CAD XML Syntax-Basiselemente|Basiselemente]]
|-
| <code>VCPktID_WasMisNV</code> || wird nicht mehr geschrieben, aber gelesen || VermCadID-Block || [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID und GUID-Referenzen]]
|}

== Verfügbarkeit und Besonderheiten ==
* Die Versionslogik gilt in allen Bundesland-Versionen gleich.
* Struktur-Evolution der Berechnungslisten über die Versionen: 5.0.0 ohne Kind-Felder → 5.0.35 <code>VC_CADVCBerechnungListKind</code> als Zahl → 5.0.57 <code>ListKindBaseType</code>/<code>ListKindType</code> als Enum-Strings (Details auf der [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|Berechnungs-Seite]]).
* Enum-Namen (GetEnumName-Strings) sind Teil des Dateiformats und dürfen laut Quellcode-Kommentar nie geändert werden — sie sind über alle Versionen stabil.
* Alte „von Layer"-Kodierungen (negative Werte) werden beim Einlesen über WORKAROUND-Blöcke in die aktuellen Markerwerte umgesetzt; System-Konfig-IDs (≤ −101) bleiben dabei erhalten.

== Quellen im Code ==
* CAD\GLConsts.pas:163 — <code>VermcadObjectFileVersion = 10</code>
* VERMCAD\VcParser_XmlLite_VC.pas:386-393 — ProjektID-Prüfung (DoStop)
* VERMCAD\VcParser_XmlLite_VC.pas:461-465 — <code>fvcNewer</code> → Abbruch des Ladens
* VERMCAD\GlobalTypes.pas:883 — <code>TFileVersionCheck</code> (<code>fvcEqual</code>, <code>fvcOlder</code>, <code>fvcNewer</code>)
* VERMCAD\VcProject.pas:20686-20689 — <code>NoXMLVCVersionLock</code> (alte Version beim Speichern beibehalten)
* CAD\GLGeometrics.pas:86191, 86323 — <code>UpdateObjectFileVersion</code> (Migrationen vor/nach Referenz-Update)
* CAD\GLGeometrics.pas:96748, 96817, 96964, 96933-96937 — Legacy-Reader-Registrierungen (ALKIS_GMLID, AlkisInitialBogenMitte*, Plotrahmen_Text*)
* CAD\GLVCCalcMessBase.pas:2897-2918 — Migration <code>VC_CADVCBerechnungListKind</code> → KindBaseType/KindType

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

CAD XML Syntax-VermCadID und GUID-Referenzen

2026-07-20T12:50:42Z

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

{{DISPLAYTITLE:CAD XML Syntax-VermCadID und GUID-Referenzen}}
Jedes CAD-Objekt in der Projekt-XML beginnt mit dem Identitätsblock <code>VermCadID</code> (GUID, Objektart, ggf. Punktnummer). Über die GUID referenzieren sich die Objekte gegenseitig (Linie → Start-/Endpunkt, Kompo → Member usw.). Diese Seite beschreibt den kompletten Block, die drei Referenz-Schreibweisen und das Fehlerverhalten bei doppelten oder fehlenden GUIDs. '''Ohne <code>VermCadID</code>-Block entsteht beim Laden KEIN Objekt.'''

== Strukturregel ==
<pre>
<VermCadID>
<GUID>guid</GUID> (faktisch Pflicht — sonst neue Zufalls-GUID,
alle Referenzen auf das Objekt brechen)
[<ObjektArt>enum:TObjektArt</ObjektArt>] (nur wenn ≠ oaDontCare;
MUSS VOR CADObjektArt stehen!)
[<CADObjektArt>enum:TCADObjArt</CADObjektArt>] (nur bei CAD-artiger ObjektArt, ≠ cadDontCare)
[<VCPktID_NV>text</VCPktID_NV>] (nur Punkte mit VC-Punktnummer:
Nummerierungsbezirk)
[<VCPktID_A>text</VCPktID_A>] (nur Versionen mit A-Nummern, IFDEF A_NR)
[<VCPktID_NR>text</VCPktID_NR>] (Punktnummer)
[<VCPktID_KSID>ganzzahl</VCPktID_KSID>] (wird von CAD-Punkten nicht mehr geschrieben;
fehlt sie, gilt die KSID des Projekts)
[<VCPktID_WasMisNV>bool</VCPktID_WasMisNV>] (nur Lesen, Legacy)
[<Erzeugt>datum</Erzeugt>] (nur Lesen, Legacy)
[<LetzteAenderung>datum</LetzteAenderung>] (nur Lesen, Legacy)
[<NutzerID>ganzzahl</NutzerID>] (nur Lesen, Legacy)
</VermCadID>
</pre>

* Der Block ist immer das ERSTE Kindelement eines Objekts.
* Reihenfolge-Regel: <code>ObjektArt</code> muss vor <code>CADObjektArt</code> stehen — <code>CADObjektArt</code> wird nur ausgewertet, wenn die ObjektArt zuvor als CAD-artig gelesen wurde.
* Beim Lesen wird exakt der Knoten <code>VermCadID</code> erwartet; jedes Kind wird nur einmal ausgewertet. Fehlerhafte Einzel-Elemente erzeugen Meldung + Log, aber keinen Abbruch.
* Datumsformate und GUID-Format: siehe [[CAD XML Syntax-Werte- und Koordinatenformate|Werte- und Koordinatenformate]].

== Elemente ==
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>GUID</code> || guid (<code>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</code>, Großbuchstaben) || faktisch ja || Zufalls-GUID || eindeutige Objekt-ID; Ziel aller Referenzen
|-
| <code>ObjektArt</code> || enum:TObjektArt || ja (für CAD-Objekte) || <code>oaDontCare</code> || Herkunft/Art des Objekts (Werteliste unten)
|-
| <code>CADObjektArt</code> || enum:TCADObjArt || ja (für CAD-Objekte) || <code>cadDontCare</code> || CAD-Objektklasse-Kategorie (Werteliste unten); steuert Render- und Verwaltungslogik
|-
| <code>VCPktID_NV</code> || Text || nein || '' || Nummerierungsbezirk der VC-Punktnummer (in lokalen Systemen auch Nicht-Zahlen, z. B. <code>xx</code>)
|-
| <code>VCPktID_A</code> || Text || nein || '' || Punktart-Zeichen — nur in Bundesland-Versionen mit A-Nummern (IFDEF <code>A_NR</code>)
|-
| <code>VCPktID_NR</code> || Text || nein || '' || Punktnummer; eine gültige VC-Punktnummer verlangt NV ≠ '' UND NR ≠ ''
|-
| <code>VCPktID_KSID</code> || ganzzahl || nein || KSID des Projekts || Koordinatensystem-Nr. der Punktnummer; von CAD-Punkten nicht mehr geschrieben (ALKIS-Objekte schreiben sie noch)
|-
| <code>VCPktID_WasMisNV</code> || bool || nein || False || Legacy: NV war der Fehl-NV; True ersetzt beim Lesen den NV durch den MisNV
|-
| <code>Erzeugt</code> / <code>LetzteAenderung</code> || Datum <code>yyyy-MM-dd hh:nn:ss</code> (auch mit <code>T</code>-Trenner lesbar) || nein || aktuelles Datum || Legacy, wird nicht mehr geschrieben
|-
| <code>NutzerID</code> || ganzzahl || nein || Login-User || Legacy, wird nicht mehr geschrieben
|}

=== Enum TObjektArt (alle Werte) ===
<code>oaVC</code> (VC-generiert), <code>oaVCBer</code> (aus Berechnung), <code>oaVCDeleted</code>, <code>oaAlkisFFA</code>, <code>oaAlkis</code> (ALKIS-Objekt, nur in <code>VC_AlkisDaten</code>), <code>oaAlkisCADRepr</code> (CAD-Repräsentation eines ALKIS-Objekts), <code>oaCAD</code> (manuell gezeichnet), <code>oaDontCare</code> (Default/Init).

In CAD-Objekten kommen praktisch vor: <code>oaCAD</code>, <code>oaVC</code>, <code>oaVCBer</code>, <code>oaVCDeleted</code>, <code>oaAlkisCADRepr</code>. Die [[CAD XML Syntax-Basiselemente|Basiselemente]] werden nur bei diesen CAD-artigen ObjektArten geschrieben.

=== Enum TCADObjArt (alle Werte, Reihenfolge = Renderreihenfolge) ===
<code>cadDontCare</code>, <code>cadPlotFrame</code>, <code>cadBackgroundPicture</code>, <code>cadFlaeche</code>, <code>cadKompo</code>, <code>cadBoeschung</code>, <code>cadLinie</code>, <code>cadText</code>, <code>cadPunktsymbol</code>, <code>cadPunkt</code>.

=== AlkisID (Hinweis) ===
Die ALKIS-Objekt-ID (<code>AlkisID</code>, 16-stellige GML-ID wie <code>DETHL53P0000GTXJ</code>) steht NICHT im VermCadID-Block, sondern als erstes [[CAD XML Syntax-Basiselemente|Basiselement]] direkt nach <code></VermCadID></code>. Der Legacy-Tag <code>ALKIS_GMLID</code> wird beim Lesen gleichbehandelt (siehe [[CAD XML Syntax-Versionierung und Kompatibilitaet|Versionierung und Kompatibilität]]).

== Referenzen ==
Objekte referenzieren einander ausschließlich über GUIDs. Drei Schreibweisen:

{| class="wikitable"
! Form !! Syntax !! Verwendung
|-
| GUID-Attribut-Element (Standard) || <code><Startpunkt GUID="{…}"/></code> || alle Objekt-zu-Objekt-Referenzen: <code>Startpunkt</code>/<code>Endpunkt</code>/<code>Mittelpunkt</code>, <code>PointSymbolGUID</code>, <code>Member</code>, <code>Exterior</code>/<code>Interior</code>, <code>Text_Referenzobjekt</code>, <code>SchraffurHauptkanteGUID</code> …; Attributname ist immer <code>GUID</code>
|-
| Member mit Zusatz-Attributen || <code><Member GUID="{…}" RefGUID="{…}" Counter="n"/></code> || nur in <code>MemberGroup</code> von <code>VC_CADVCBerechnungList</code>: <code>RefGUID</code> verzahnt Mess-Objekt und Zielobjekt, <code>Counter</code> nummeriert — siehe [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|Objekt VC_CADVCBerechnung/VCMessung]]
|-
| GUID als Elementtext || <code><SymbolID>{…}</SymbolID></code> || Verweise auf Nicht-CAD-Objekte bzw. Sonderfälle: <code>SymbolID</code> (Symbolmanager), <code>BoeschungOKStart_GUID</code> u. a. Böschungskanten-Punkte, <code>Plotrahmen_Text_Eintrag_ID</code>, GUID-Liste in <code>ObjektAuswahlGUIDs</code> (zeilenweise)
|}

Ablauf beim Lesen: GUID-Referenzen werden zunächst nur gemerkt (z. B. <code>FSPGUID</code>/<code>FEPGUID</code>). Nach dem Einlesen ALLER Objekte löst <code>UpdateReferencesOrClean</code> sie über den GUID-Suchbaum des Managers auf — in einer Wiederholungsschleife mit ToDo-Liste und abschließendem „LastTry". Ein Erzeuger sollte referenzierte Objekte trotzdem VOR den Referenzierern schreiben (Schreibreihenfolge siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik und Pflichtfelder]]).

=== Fehlerverhalten ===
* '''Duplikat-GUID''' (GUID bereits im Suchbaum): das gesamte Objekt wird '''übersprungen'''.
* '''Fehlende harte Referenz''' (z. B. Startpunkt-GUID existiert nicht): das referenzierende Objekt wird nach dem LastTry als fehlerhaft markiert, aus dem GUID-Suchbaum entfernt und '''zerstört''' — mit Logeintrag „…konnte nicht eingelesen werden" und Detail „n von m Unter-Objekten nicht gefunden". Kinder eines fehlerhaften Eltern-Objekts können einzeln überleben.
* '''Weiche Referenzen''' (Symbol-GUID des Punktsymbols, <code>WeitereSymbole</code>, Text-Ausrichtungslinie): fehlende Ziele werden nur geloggt/ignoriert, das Objekt bleibt bestehen (beim Punktsymbol Selbstheilung über <code>SymbolName</code>).
* Sonderwert: für „Referenz explizit ENTFERNT" existiert die spezielle NOTHING-GUID (<code>PROPERTY_GUID_VALUE_NOTHING</code>), belegt bei <code>Text_AusrichtungRefLinieGUID</code> — siehe [[CAD XML Syntax-Objekt VC CADText|Objekt VC_CADText]].

== Minimalform ==
<pre>
<VermCadID>
<GUID>{AEFE2E5B-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>
</pre>

== Beispiele ==
=== Beispiel (Sachsen, echt — Punkt mit VC-Punktnummer in lokalem System) ===
<pre>
<VermCadID>
<GUID>{F3EBC8C1-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
<VCPktID_NV>xx</VCPktID_NV>
<VCPktID_NR>2000</VCPktID_NR>
</VermCadID>
</pre>

=== Beispiel (BW, echt — ALKIS-Objekt in VC_AlkisDaten mit KSID) ===
<pre>
<VermCadID>
<GUID>{FE697113-…}</GUID>
<ObjektArt>oaAlkis</ObjektArt>
<VCPktID_NV>9220</VCPktID_NV>
<VCPktID_NR>1066/259</VCPktID_NR>
<VCPktID_KSID>0</VCPktID_KSID>
</VermCadID>
</pre>

=== Beispiel (echt — GUID-Referenzen einer Linie) ===
<pre>
<Startpunkt GUID="{5E840B97-…}" />
<Endpunkt GUID="{4B8E94CA-…}" />
</pre>

== Verfügbarkeit und Besonderheiten ==
* Struktur in allen Bundesland-Versionen identisch; nur <code>VCPktID_A</code> ist auf A-Nummern-Versionen (IFDEF <code>A_NR</code>) beschränkt.
* <code>Erzeugt</code>/<code>LetzteAenderung</code>/<code>NutzerID</code> und <code>VCPktID_WasMisNV</code> stehen nur noch in alten Dateien (write-Schalter auf False).
* CAD-Punkte schreiben ihre Punktnummer als DIREKTE Kinder von <code>VermCadID</code> (<code>VCPktID_NV</code>, ggf. <code>VCPktID_A</code>, <code>VCPktID_NR</code>) — ohne <code>VCPktID</code>-Zwischenknoten und ohne <code>VCPktID_KSID</code>; die fehlende KSID wird beim Lesen aus dem Projekt ergänzt.
* GUID-Lesen läuft über <code>OurStringToGUID(…, gctCADObjectID)</code>; ungültige GUID-Strings erzeugen Meldung + Log.
* Beim Punkt gilt: <code>VerwendungsStatus</code> wird nur geschrieben, wenn eine VCPktID vorhanden ist — Details auf [[CAD XML Syntax-Objekt VC CADPunkt|Objekt VC_CADPunkt]].

== Quellen im Code ==
* VERMCAD\VCObjBase.pas:328-389 — <code>TObjBase.DataToXMLLite</code>: Schreiben des VermCadID-Blocks
* VERMCAD\VCObjBase.pas:537-664 — <code>InternalInitIDsFromXML</code>: Lesen, Reihenfolge ObjektArt→CADObjektArt, KSID-Fallback (657-658)
* VERMCAD\VCObjBase.pas:508-527 — <code>InitIDsAsFromXML</code> (XmlLite-Pfad über <code>TVCIDData</code>)
* VERMCAD\GlobalTypes.pas:848-871 — <code>TObjektArt</code>, <code>TCADObjArt</code>
* VERMCAD\VcPktID.pas:838-894 — <code>TVCPktID.DataToXMLLite</code> (ohne Zwischenknoten/KSID)
* CAD\GLGeometrics.pas:83845-83952 — <code>NewObjectFromXML</code>: Objekt-Erzeugung erst bei <code>VermCadID</code>-Fund, Duplikat-GUID → Skip (83905-83906)
* CAD\GLGeometrics.pas:86090-86325 — <code>UpdateReferencesOrClean</code>: Referenz-Auflösung, LastTry, Zerstörung (86274-86282)
* CAD\GLGeometrics.pas:6527-6576 — <code>GetXMLLinkErrorFromGUIDs</code>: Fehlermeldung fehlender Kind-GUIDs

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

CAD XML Syntax-Übersicht

2026-07-20T12:50:41Z

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

{{DISPLAYTITLE:CAD XML Syntax-Übersicht}}
Die XML-Projektdatei (Endung <code>.xml</code>) speichert alle CAD-Objekte und CAD-bezogenen Projektdaten eines VermCad-Projekts. Sie bildet zusammen mit der zugehörigen <code>.mwt</code>-Datei und ggf. einer <code>.nas</code>-Datei ein VermCad-Projekt (siehe [[MWT Syntax]] und [[MWT Syntax-Uebersicht|MWT Syntax-Übersicht]]; die GUID in der <code>ProjektID</code> verbindet .mwt und .xml). Diese Seite beschreibt den Gesamtaufbau der Datei: Prolog, Wurzelelement <code>VCDaten</code>, Projekt-Metadaten und die Reihenfolge der Sektionen. Nicht zu verwechseln mit den Import-/Export-Schnittstellen (Trimble XML, Land XML, XML-Nummernreservierung) — diese Seitengruppe dokumentiert ausschließlich das interne Projektdateiformat.

== Strukturregel ==
<pre>
<?xml version="1.0" encoding="UTF-8"?>

<VCDaten xmlns="http://www.adv-online.de/namespaces/adv/gid/6.0 | .../gid/7.1"
xmlns:adv="..." xmlns:gml="..." xmlns:xsi="..." ... xsi:schemaLocation="...">
<ProjektID>text(62)</ProjektID>
[<NASVersion>enum:TAlkisNASVersion</NASVersion>]
[<MaxUsedAlkisID>ganzzahl</MaxUsedAlkisID>]
[<MaxUsedFehlPktNr>ganzzahl</MaxUsedFehlPktNr>]
[<MaxUsedFehlFSK>ganzzahl</MaxUsedFehlFSK>]
[<MaxUsedBuchungsblattNummer>ganzzahl</MaxUsedBuchungsblattNummer>]
[<MaxVorlaeufigeNummerForDatenAndererStellen>ganzzahl</...>] (nur Sachsen)
[<LokaleZuordnungSettings LSID="..." Radius="..." GST="..."/>] (nur Thüringen)
[<IsPruefProject>bool</IsPruefProject>] (nur wenn True)
[<ValidationAndMarkingObsoleteObjectsPossibleAfter240125>bool</...>] (nur wenn True)
<ObjectFileVersion>ganzzahl</ObjectFileVersion>
<ObjectFileVCVersion>text</ObjectFileVCVersion>
[<ObjectFileVCVersionWas45orOlder>bool</...>] (nur wenn True)
[<ObjectFileData>text</ObjectFileData>] (informativ)
[<ObjectCount>ganzzahl</ObjectCount>] (nur wenn > 0)
{ <VCCADDaten KSID="ganzzahl" [LSID="ganzzahl"] [Zone="ganzzahl"]> (je Koordinatensystem
... CAD-Sektion ... eine Sektion)
</VCCADDaten> }*
[<VC_PlotDaten> ... </VC_PlotDaten>] (VC-Key-/Schlüsselwortdaten)
[<VC_AlkisDaten> ... </VC_AlkisDaten>] (ALKIS-Sektion)
</VCDaten>
</pre>

* Die Datei ist UTF-8-kodiert (ohne BOM); der Prolog deklariert <code>encoding="UTF-8"</code>, das Standalone-Attribut fehlt. Der Writer schreibt mit Einrückung (Indent).
* Direkt nach dem Prolog folgt ein Kommentar mit erzeugender Programmversion und Bundesland-Edition, z. B. <code></code>.
* Wurzelelement ist immer <code>VCDaten</code>. Der Default-Namespace und <code>xmlns:adv</code> sind je nach NAS-Version <code>…/adv/gid/6.0</code> oder <code>…/adv/gid/7.1</code>; deklariert werden außerdem die Prefixe <code>adv</code>, <code>gco</code>, <code>gmd</code>, <code>gml</code>, <code>wfs</code>, <code>xlink</code>, <code>xsi</code>, <code>ows</code>, <code>wfsext</code>, <code>xsd</code>, <code>ogc</code> (GID 7 zusätzlich <code>fes</code>; Niedersachsen zusätzlich <code>asd</code>). <code>xsi:schemaLocation</code> zeigt auf den lokalen Pfad der <code>VC.xsd</code> der erzeugenden Installation und variiert daher je Rechner.
* Die Metadaten-Elemente können in beliebiger Reihenfolge vor <code>VCCADDaten</code> stehen (der Parser dispatcht nach Tag-Namen); <code>ObjectFileVCVersion</code> sollte VOR den CAD-Daten stehen, weil daran der Versionsabbruch und Migrationsentscheidungen hängen (siehe [[CAD XML Syntax-Versionierung und Kompatibilitaet|Versionierung und Kompatibilität]]).

== Elemente ==
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>ProjektID</code> || Text, 62 Zeichen || ja || — || <code>Datum(8, yyyymmdd) + BüroID(6) + Code(10) + GUID(38 mit geschweiften Klammern)</code>. Erstes Code-Zeichen: 0=Standard, 1=nur MWT, 2=MWT+XML, 3=MWT+NAS, 4=MWT+XML+NAS. Legacy-Format ohne Code (52 Zeichen) wird beim Lesen akzeptiert. Beim Laden wird die ProjektID gegen das offene Projekt geprüft — '''bei Nichtübereinstimmung wird das Laden gestoppt.'''
|-
| <code>NASVersion</code> || enum:TAlkisNASVersion || nein || <code>gid6</code> || NAS-/Namespace-Version: <code>gidUnknown</code>, <code>gid6</code>, <code>gid601</code>, <code>gid7</code>
|-
| <code>MaxUsedAlkisID</code> || ganzzahl || nein || 0 || höchste vergebene interne Alkis-ID; Legacy-Tag <code>MaxUsedGMLID</code> wird beim Lesen akzeptiert
|-
| <code>MaxUsedFehlPktNr</code> || ganzzahl || nein || 0 || höchste vergebene Fehlpunktnummer
|-
| <code>MaxUsedFehlFSK</code> || ganzzahl || nein || 0 || höchstes vergebenes Fehl-Flurstückskennzeichen
|-
| <code>MaxUsedBuchungsblattNummer</code> || ganzzahl || nein || 0 || höchste vergebene Buchungsblattnummer
|-
| <code>MaxVorlaeufigeNummerForDatenAndererStellen</code> || ganzzahl || nein || 0 || nur Sachsen: höchste vorläufige Nummer für Daten anderer Stellen
|-
| <code>LokaleZuordnungSettings</code> || Element mit Attributen <code>LSID</code>/<code>Radius</code>/<code>GST</code> || nein || — || nur Thüringen: Einstellungen der lokalen Zuordnung
|-
| <code>IsPruefProject</code> || bool || nein || False || Kennzeichen Prüfprojekt (nur geschrieben, wenn True)
|-
| <code>ValidationAndMarkingObsoleteObjectsPossibleAfter240125</code> || bool || nein || False || Migrations-Flag (nur geschrieben, wenn True)
|-
| <code>ObjectFileVersion</code> || ganzzahl || ja (fürs Erzeugen) || — || Dateiformat-Version, aktuell '''10''' (<code>VermcadObjectFileVersion</code>); ältere Werte lösen Migrationen aus — siehe [[CAD XML Syntax-Versionierung und Kompatibilitaet|Versionierung]]
|-
| <code>ObjectFileVCVersion</code> || Text || ja (fürs Erzeugen) || — || VermCad-Programmversion (z. B. <code>5.0.0</code>); '''Datei von neuerer Version → Laden wird abgebrochen''' — siehe [[CAD XML Syntax-Versionierung und Kompatibilitaet|Versionierung]]
|-
| <code>ObjectFileVCVersionWas45orOlder</code> || bool || nein || False || Workaround-Flag für Text-Versatz alter Projekte (nur geschrieben, wenn True)
|-
| <code>ObjectFileData</code> || Text || nein || — || rein informativ: <code>Delphi-Version: … ::: Timestamp: … ::: User: …</code>
|-
| <code>ObjectCount</code> || ganzzahl || nein || 0 || Anzahl nicht gelöschter CAD-Objekte; dient beim Lesen nur der Fortschrittsanzeige
|-
| <code>VCCADDaten</code> || Container (0..n) || ja (mind. 1 für CAD-Inhalt) || — || CAD-Sektion je Koordinatensystem, Attribute <code>KSID</code> (Pflicht), <code>LSID</code>, <code>Zone</code> — Details: [[CAD XML Syntax-Sektion VCCADDaten|Sektion VCCADDaten]]
|-
| <code>VC_PlotDaten</code> || Container || nein || leer || VC-Key-Daten (historischer Name „Plot"): Schlüsselwort-Liste aus <code>Plot_Schluesselwort</code>/<code>Plot_String</code> — Kurzüberblick: [[CAD XML Syntax-Sektion AlkisDaten und PlotDaten|Sektion AlkisDaten und PlotDaten]]
|-
| <code>VC_AlkisDaten</code> || Container || nein || — || ALKIS-Sektion (importierte NAS-Dateien, <code>VC_AlkisObjekt</code>-Liste, Fortführungsfälle) — Kurzüberblick: [[CAD XML Syntax-Sektion AlkisDaten und PlotDaten|Sektion AlkisDaten und PlotDaten]]
|}

Innerhalb jeder <code>VCCADDaten</code>-Sektion stehen zuerst Rissdaten/Auswahlen ([[CAD XML Syntax-Sektion Rissdaten und Auswahlen|Sektion Rissdaten und Auswahlen]]) und dann die CAD-Objekte in fester Gruppenreihenfolge ([[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik und Pflichtfelder]]). Alle Objekte teilen sich den [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]], die [[CAD XML Syntax-Basiselemente|Basiselemente]] und die [[CAD XML Syntax-Werte- und Koordinatenformate|Werte- und Koordinatenformate]].

== Beispiele ==
=== Beispiel (Baden-Württemberg, echt — Dateikopf mit gid/7.1) ===
<pre>
<?xml version="1.0" encoding="UTF-8"?>

<VCDaten xmlns="http://www.adv-online.de/namespaces/adv/gid/7.1" xmlns:adv="http://www.adv-online.de/namespaces/adv/gid/7.1" xmlns:gco="http://www.isotc211.org/2005/gco" xmlns:gmd="http://www.isotc211.org/2005/gmd" xmlns:gml="http://www.opengis.net/gml/3.2" xmlns:wfs="http://www.opengis.net/wfs/2.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:fes="http://www.opengis.net/fes/2.0" xmlns:ows="http://www.opengis.net/ows/1.1" xmlns:wfsext="http://www.adv-online.de/namespaces/adv/gid/wfsext/2.0" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:ogc="http://www.adv-online.de/namespaces/adv/gid/ogc" xsi:schemaLocation="http://www.vermcad.de/namespaces/vc/0.1 D:\...\resource\schema\Nas_6\VC.xsd">
<ProjektID>202606010024414000000000{70453D69-…}</ProjektID>
<NASVersion>gid7</NASVersion>
<MaxUsedAlkisID>40</MaxUsedAlkisID>
<MaxUsedFehlPktNr>7</MaxUsedFehlPktNr>
<MaxUsedFehlFSK>0</MaxUsedFehlFSK>
<MaxUsedBuchungsblattNummer>0</MaxUsedBuchungsblattNummer>
<ValidationAndMarkingObsoleteObjectsPossibleAfter240125>-1</ValidationAndMarkingObsoleteObjectsPossibleAfter240125>
<ObjectFileVersion>9</ObjectFileVersion>
<ObjectFileVCVersion>5.0.0</ObjectFileVCVersion>
<ObjectFileData>Delphi-Version: (64 Bit) ::: Timestamp: 2026-06-23 12:31:29 ::: User: 25</ObjectFileData>
<ObjectCount>20483</ObjectCount>
<VCCADDaten KSID="0" LSID="489" Zone="32">
…
</pre>

=== Beispiel (Grobstruktur einer kompletten Datei) ===
<pre>
VCDaten
├─ ProjektID, NASVersion, MaxUsed*, ObjectFileVersion, ObjectFileVCVersion, ObjectFileData, ObjectCount
├─ VCCADDaten KSID="0" LSID="489" Zone="32" ← Hauptkoordinatensystem, enthält fast alle Objekte
│ ├─ Rissdaten (RissEintrag_0 … RissEintrag_n)
│ ├─ CurrRissID
│ ├─ ObjektAuswahlen
│ ├─ AlkisStatusOptionen ← nur in Altdateien (Legacy, wird nicht mehr geschrieben)
│ └─ VC_CAD*-Objekte, VC_Hintergrundbild, VC_Plotrahmen …
├─ VCCADDaten KSID="-1" … ← weitere Sektionen je Koordinatensystem
├─ VCCADDaten KSID="-1894" LSID="894" ← lokale Systeme (BW/THR: negative KSID,
│ Sachsen: positive KSID 1..4, ohne Zone-Attribut)
├─ VC_PlotDaten ← Plot-Schlüsselwörter (ggf. leer: <VC_PlotDaten />)
└─ VC_AlkisDaten ← ImportedAlkisFile*, VC_AlkisObjekt*, FFFallManager
</pre>

== Verfügbarkeit und Besonderheiten ==
* Namespaces je Bundesland/NAS-Version: BW/THR (gid 7.1) mit <code>xmlns:fes</code>, <code>wfs/2.0</code>, <code>ows/1.1</code> und <code>NASVersion=gid7</code>; Sachsen (gid 6.0) mit adv-internen <code>wfs</code>/<code>ows</code>-URIs, ohne <code>fes</code>, <code>NASVersion=gid601</code>.
* <code>MaxVorlaeufigeNummerForDatenAndererStellen</code> nur Sachsen; <code>LokaleZuordnungSettings</code> nur Thüringen; alle übrigen Metadaten in allen Bundesland-Versionen.
* Legacy-Tag <code>MaxUsedGMLID</code> (statt <code>MaxUsedAlkisID</code>) wird weiterhin gelesen, aber nicht mehr geschrieben.
* Laut Code-Kommentar würden die <code>VCCADDaten</code>-Attribute <code>LSID</code>/<code>Zone</code> nicht eingelesen — der Kommentar ist veraltet: der aktuelle Parser liest KSID, LSID und Zone aus (LSID → Lagestatus des Managers, Zone → UTM-Zone).
* Unbekannte Elemente auf jeder Ebene werden still ignoriert — fremde Zusatz-Tags machen die Datei nicht ungültig (siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).
* Zur Bedienoberfläche des CAD siehe die Portalseite [[CAD]].

== Quellen im Code ==
* VERMCAD\VcProject.pas:24937-25065 — <code>InitXMLLiteWriterWrapper</code>: Prolog, Versions-Kommentar, Root <code>VCDaten</code>, Namespaces, schemaLocation
* VERMCAD\VcProject.pas:20560-20928 — <code>SaveXML</code>: Sektions-Reihenfolge und alle Metadaten-Elemente
* VERMCAD\VCProjectBase.pas:1342-1390 — <code>TProjectID.SetProjectID</code>: ProjektID-Format (62 Zeichen, Legacy 52 Zeichen)
* VERMCAD\VcParser_XmlLite_VC.pas:200-528 — <code>ParseCAD</code>: Lesen der Metadaten, ProjektID-Prüfung, VCCADDaten-Attribute
* Alkis\AlkisTypes.pas:35 — <code>TAlkisNASVersion</code>
* CAD\GLConsts.pas:163 — <code>VermcadObjectFileVersion = 10</code>
* VERMCAD\GlobalConsts.pas:4372-5004 — Tag-Konstanten (<code>xn_*</code>)

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

CAD XML Syntax-Sektion VCCADDaten

2026-07-20T12:50:40Z

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

{{DISPLAYTITLE:CAD XML Syntax-Sektion VCCADDaten}}
Die Sektion <code>VCCADDaten</code> ist der Container für alle CAD-Objekte '''eines Koordinatensystems'''. Eine Projektdatei enthält je Koordinatensystem (KSID) eine eigene <code>VCCADDaten</code>-Sektion — das Hauptsystem (KSID 0) und ggf. weitere Systeme (z. B. lokale Systeme). Geschrieben wird die Sektion von <code>TProject.SaveXML</code> (Kopf-Attribute) und <code>TCADObjectManager.SaveXMLLite</code> (Inhalt). Der Gesamtrahmen der Datei ist auf der Seite [[CAD XML Syntax-Uebersicht|Übersicht]] beschrieben.

== Strukturregel ==
Die drei Kopf-Werte <code>KSID</code>, <code>LSID</code> und <code>Zone</code> sind '''echte XML-Attribute''' am Element <code>VCCADDaten</code> — keine Kindelemente.

<pre>
{ <VCCADDaten KSID="ganzzahl" [LSID="ganzzahl"] [Zone="ganzzahl"]> (je Koordinatensystem
eine Sektion)
(1) Verwaltungsdaten — siehe Sektion Rissdaten und Auswahlen:
[<Rissdaten> … </Rissdaten>]
[<CurrRissID>ganzzahl</CurrRissID>]
[<BearbeitungsgebietAutomatisch>bool</BearbeitungsgebietAutomatisch>]
[<BearbeitungsgebietAutoMitFlaechen>bool</BearbeitungsgebietAutoMitFlaechen>]
[<Bearbeitungsgebiet> {<gml:pos>zahl zahl</gml:pos>}* </Bearbeitungsgebiet>]
[<ObjektAuswahlen> … </ObjektAuswahlen>]

(2) CAD-Objekte in fester Gruppenreihenfolge (Objekt-Tags siehe Lesemechanik):
{ <VC_CADPunkt> | <VC_CADBMPunkt> … }* (Punkte)
{ <VC_CADPunktsymbol> … }* (Punktsymbole)
{ <VC_CADSimpleLine> | <VC_CADMeteredSimpleLine>
| <VC_CADArcLine> | <VC_CADCircleLine>
| <VC_CADEllipseLine> | <VC_CADKlotoideLine>
| <VC_CAD_Klothoide> … }* (Linien)
{ <VC_CADFlaeche> | <VC_CADVCFlaeche>
| <VC_AreaCADLTK> … }* (Flächen; LTK nur Sachsen-Anhalt)
{ <VC_AreaCADAlkisDE> … }* (AlkisDE-Flächen, nur Sachsen-Anhalt)
{ <VC_CADKompo> | <VC_CADVCBerechnung>
| <VC_CADVCMessung> | <VC_CADBemassung> … }* (Kompos)
{ <VC_CADText> | <VC_CADVCPNRText>
| VC_CADVCPNRPar…-Varianten … }* (Texte)
{ <VC_Hintergrundbild> … }* (Hintergrundbilder)
{ <VC_Plotrahmen> … }* (Plotrahmen)
{ <VC_CADBoeschung> … }* (Böschungen)
</VCCADDaten> }*
</pre>

Beim Lesen dispatcht der Parser nach Tag-Namen — die Verwaltungsdaten und Objekte werden auch in abweichender Reihenfolge korrekt gelesen. Ein Erzeuger sollte die Reihenfolge oben trotzdem einhalten (siehe unten).

== Attribute ==
{| class="wikitable"
! Attribut !! Typ/Format !! Pflicht !! Bedeutung
|-
| <code>KSID</code> || ganzzahl || ja || Koordinatensystem-ID. <code>0</code> = Hauptsystem des Projekts. Weitere Sektionen je System: in BW/THR '''negative''' KSIDs für lokale Systeme (beobachtet: <code>-1</code>, <code>-1100</code>, <code>-1894</code> — Muster −(1000+LSID)), in Sachsen '''positive''' fortlaufende KSIDs (<code>1</code>…<code>4</code>). Beim Lesen wird über die KSID der zugehörige CAD-Manager ermittelt bzw. neu angelegt (<code>GetCAD_DataByKSID_LSID</code>).
|-
| <code>LSID</code> || ganzzahl || nein || Lagestatus des Systems (z. B. <code>489</code> = ETRS89/UTM). Wird nur geschrieben, wenn der Lagestatus des Managers gesetzt ist (≠ <code>MisStatus</code>); beim Lesen → <code>Manager.Lagestatus</code>.
|-
| <code>Zone</code> || ganzzahl || nein || UTM-Zone. Wird nur geschrieben, wenn die Zone des Managers in <code>[1..5, 31, 32, 33]</code> liegt; beim Lesen → <code>Manager.UTMZone</code>. Lokale Systeme haben i. d. R. kein Zone-Attribut.
|}

Hinweis: Der Kommentar in <code>GlobalConsts.pas:4386</code> („LSID/Zone werden derzeit nicht eingelesen") ist '''veraltet''' — der aktuelle XmlLite-Parser liest alle drei Attribute aus.

== Elemente ==
Die Verwaltungs-Kindelemente (<code>Rissdaten</code>, <code>CurrRissID</code>, <code>Bearbeitungsgebiet*</code>, <code>ObjektAuswahlen</code>) sind im Detail auf der Seite [[CAD XML Syntax-Sektion Rissdaten und Auswahlen|Sektion Rissdaten und Auswahlen]] dokumentiert. Alle übrigen Kinder sind CAD-Objekte; die vollständige Tabelle Tag → Delphi-Klasse → Objektseite steht auf der Seite [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik und Pflichtfelder]].

=== Schreibreihenfolge und Speicherfilter ===
<code>TCADObjectManager.SaveXMLLite</code> schreibt in dieser festen Reihenfolge:

# '''Rissdaten''' + <code>CurrRissID</code>
# '''Bearbeitungsgebiet''' (<code>BearbeitungsgebietAutomatisch</code>, <code>BearbeitungsgebietAutoMitFlaechen</code>, <code>Bearbeitungsgebiet</code> — jeweils nur abweichend vom Default)
# '''ObjektAuswahlen'''
# '''Punkte''' — nur Punkte mit gültigen X/Y-Koordinaten (Fehlwert-Punkte werden NICHT gespeichert)
# '''Punktsymbole''' — nur Symbole mit vorhandenem ReferenzPoint
# '''Linien''' — Tag je LineType; unbekannte LineTypes werden übersprungen
# '''Flächen''' (inkl. <code>VC_AreaCADLTK</code>, nur Sachsen-Anhalt)
# '''AlkisDE-Flächen''' (nur Sachsen-Anhalt)
# '''Kompos''' (inkl. Berechnungen, Messungen, Bemaßungen)
# '''Texte''' — leere Texte werden nicht gespeichert
# '''Hintergrundbilder''' — nur wenn Textur geladen und Bilddatei existiert
# '''Plotrahmen'''
# '''Böschungen'''

Generelle Filter: temporäre Objekte werden nie gespeichert; VC-generierte Objekte (ObjektArt <code>oaVC</code>/<code>oaVCDeleted</code>) nur, wenn Default-Eigenschaften geändert wurden oder ein verbundenes Objekt gespeichert werden muss.

'''Wichtig fürs Erzeugen:''' Die Reihenfolge Punkte→Symbole→Linien→Flächen→Kompos stellt sicher, dass referenzierte Objekte VOR den Referenzierern stehen. Der Leser ist zwar tolerant (Referenz-Auflösung erst nach dem Laden aller Objekte, mit Wiedervorlage-Liste — siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]), aber ein Erzeuger sollte diese Reihenfolge einhalten.

== Beispiele ==
=== Beispiel (echt) — vorkommende VCCADDaten-Startzeilen ===
<pre>
<VCCADDaten KSID="0" LSID="489" Zone="32"> ← BW/THR Hauptsystem
<VCCADDaten KSID="0" LSID="489" Zone="33"> ← Sachsen Hauptsystem
<VCCADDaten KSID="-1" Zone="32"> ← BW; THR: KSID="-1" ohne Zone
<VCCADDaten KSID="-1894" LSID="894"> ← BW lokales System
<VCCADDaten KSID="-1100" LSID="100"> ← BW lokales System
<VCCADDaten KSID="-1120" LSID="120"> ← THR lokales System
<VCCADDaten KSID="1" LSID="0"> ← Sachsen lokale Systeme KSID 1..4
</pre>

=== Beispiel (Sachsen, echt) — Sektion eines lokalen Systems (Beginn, gekürzt) ===
<pre>
<VCCADDaten KSID="1" LSID="0">
<Rissdaten>
<RissEintrag_0>
<RissName>[Standard]</RissName>
<RissID>0</RissID>
<RissViewMeasureScale>3260</RissViewMeasureScale>
<RissViewMinX>-646.576364871892</RissViewMinX>
<RissViewMaxX>1239.80229459881</RissViewMaxX>
<RissViewMinY>107.559913785975</RissViewMinY>
<RissViewMaxY>989.940064745008</RissViewMaxY>
</RissEintrag_0>
</Rissdaten>
<CurrRissID>0</CurrRissID>
<ObjektAuswahlen />
<AlkisStatusOptionen />
<VC_CADPunkt>
<VermCadID>
<GUID>{F3EBC8C1-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
<VCPktID_NV>xx</VCPktID_NV>
<VCPktID_NR>2000</VCPktID_NR>
</VermCadID>
<Layer>-1001</Layer>
…
</VC_CADPunkt>
…
</VCCADDaten>
</pre>
(In lokalen Systemen sind die Koordinaten kleine lokale Werte, in BW-Nebensektionen auch negativ; <code>VCPktID_NV</code> kann dort ein String sein.)

== Verfügbarkeit und Besonderheiten ==
* Sektions-Aufbau in '''allen''' Bundesland-Versionen identisch; nur die Objekt-Tags <code>VC_AreaCADLTK</code>/<code>VC_AreaCADAlkisDE</code> sind auf Sachsen-Anhalt beschränkt, einzelne PNRText-Varianten auf BW (siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).
* '''Legacy-Element <code>AlkisStatusOptionen</code>''': Ältere Dateien (bis VermCad 5.0.x) enthalten nach <code>ObjektAuswahlen</code> ein Element <code><AlkisStatusOptionen /></code> (in allen untersuchten Bestandsdateien leer). Das Feature wurde 2026 aus dem Code entfernt — aktuelle Versionen schreiben das Element nicht mehr; beim Laden alter Dateien wird es als unbekanntes Tag schadlos übersprungen.
* Mehrfachauftreten: <code>VCCADDaten</code> darf beliebig oft vorkommen; pro KSID sollte es genau eine Sektion geben (der Leser legt je KSID einen Manager an und hängt die Objekte an diesen — doppelte KSIDs würden in demselben Manager landen).
* Nach dem Ende jeder Sektion führt der Leser <code>UpdateReferencesOrClean</code> (Referenz-Auflösung, Zerstörung unvollständiger Objekte) und die ALKIS-Initialdaten-Fehlerprüfung aus.
* Leere Sektionen (nur Rissdaten-Grundgerüst, keine Objekte) kommen real vor (z. B. <code>KSID="-1"</code>).

== Quellen im Code ==
* <code>VERMCAD\VcProject.pas:20745-20804</code> — <code>SaveXML</code>: Schreiben der <code>VCCADDaten</code>-Elemente und der Attribute KSID/LSID/Zone
* <code>CAD\GLGeometrics.pas:79499-80190</code> — <code>TCADObjectManager.SaveXMLLite</code>: Schreibreihenfolge und Speicherfilter (<code>_CheckCanSaveObject</code> 79516, <code>_SaveCheckVCObject</code> 79524)
* <code>VERMCAD\VcParser_XmlLite_VC.pas:240-320</code> — Lesen der Attribute KSID/LSID/Zone, Manager-Ermittlung, <code>ProcessCADNode</code>
* <code>VERMCAD\GlobalConsts.pas:4380-4386</code> — Tag-Konstanten <code>xn_CAD_Daten</code>, <code>xn_KSID</code>, <code>xn_LSID</code>, <code>xn_Zone</code> (mit veraltetem Kommentar)

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

CAD XML Syntax-Sektion Rissdaten und Auswahlen

2026-07-20T12:50:39Z

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

{{DISPLAYTITLE:CAD XML Syntax-Sektion Rissdaten und Auswahlen}}
Am Anfang jeder [[CAD XML Syntax-Sektion VCCADDaten|VCCADDaten-Sektion]] stehen die Verwaltungsdaten des Koordinatensystems: die '''Riss-Verwaltung''' (<code>Rissdaten</code>, Delphi-Klasse <code>TCADRissList</code> mit <code>TCADRiss</code>-Einträgen), der aktuelle Riss (<code>CurrRissID</code>), die gespeicherten '''Objektauswahlen''' (<code>ObjektAuswahlen</code>, Klasse <code>TCADSaveSelectionList</code>) und das '''Bearbeitungsgebiet'''. Risse sind projektspezifische Zeichnungs-Sichten (fachlich: [[CAD-Risse]]). Diese Seite beschreibt die Verwaltungslisten der Sektion — die riss-abhängigen Werte AN den einzelnen CAD-Objekten (<code>RissKoordinaten</code>, <code>Text_RissDaten</code> …) sind auf der Seite [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]] dokumentiert.

== Strukturregel ==
<pre>
<Rissdaten>
{ <RissEintrag_ID> (Tag = 'RissEintrag_' + Riss-ID; für JEDEN Riss
inkl. Standard-Riss ID 0)
<RissName>text</RissName>
<RissID>ganzzahl</RissID>
[<RissSzenarioID>ganzzahl</RissSzenarioID>]
[<RissViewMeasureScale>ganzzahl</RissViewMeasureScale>]
[<RissViewRotAngle>zahl</RissViewRotAngle>]
[<RissViewMinX>zahl</RissViewMinX>]
[<RissViewMaxX>zahl</RissViewMaxX>]
[<RissViewMinY>zahl</RissViewMinY>]
[<RissViewMaxY>zahl</RissViewMaxY>]
[<RissFreezeScale>bool</RissFreezeScale>]
[<RissSceneShowEnlargedSize>ganzzahl</RissSceneShowEnlargedSize>]
[<RissGesperrt>bool</RissGesperrt>]
</RissEintrag_ID> }*
</Rissdaten>
[<CurrRissID>ganzzahl</CurrRissID>]

[<BearbeitungsgebietAutomatisch>bool</BearbeitungsgebietAutomatisch>]
[<BearbeitungsgebietAutoMitFlaechen>bool</BearbeitungsgebietAutoMitFlaechen>]
[<Bearbeitungsgebiet>
{ <gml:pos>zahl zahl</gml:pos> }* (je Eckpunkt ein gml:pos, nur 2D)
</Bearbeitungsgebiet>]

<ObjektAuswahlen>
{ <ObjektAuswahlN> (Tag = 'ObjektAuswahl' + Integer-ID N,
z. B. 'ObjektAuswahl0')
<ObjektAuswahlName>text</ObjektAuswahlName>
<ObjektAuswahlID>ganzzahl</ObjektAuswahlID>
<ObjektAuswahlKDID>ganzzahl</ObjektAuswahlKDID> (KSID — Tag-Tippfehler, s. u.!)
<ObjektAuswahlGUIDs>guid
guid
…</ObjektAuswahlGUIDs> (GUID-Liste zeilenweise getrennt)
</ObjektAuswahlN> }*
</ObjektAuswahlen>
</pre>

== Elemente ==
=== Rissdaten / RissEintrag_<ID> (TCADRissList) ===
Der Standard-Riss (ID 0, Konstante <code>cCAD_RISS_ID_STANDARD</code>, Name <code>[Standard]</code>) existiert in jedem Projekt und wird mitgespeichert. Beim Lesen legt jedes Element, dessen Name mit <code>RissEintrag_</code> beginnt, einen neuen Riss an; ein Riss wird nur übernommen, wenn <code>RissName</code> ≠ leer und <code>RissID</code> ≠ −1 gelesen wurden — beide sind also '''Pflicht'''. Ein doppelt eingelesener Standard-Riss (ID 0) wird mit dem vorab angelegten zusammengeführt (SzenarioID wird übernommen).

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>RissName</code> || text || ja || — || Anzeigename des Risses (Standard-Riss: <code>[Standard]</code>)
|-
| <code>RissID</code> || ganzzahl || ja || — || Riss-ID; identisch mit der ID im Tag-Namen. ID 0 = Standard-Riss. Auf diese ID beziehen sich die <code>RissEintrag_<ID></code>-Einträge an den Objekten ([[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]]).
|-
| <code>RissSzenarioID</code> || ganzzahl || nein || −1 || zugeordnetes Präsentations-Szenario
|-
| <code>RissViewMeasureScale</code> || ganzzahl || nein || 0 || Ansichts-Maßstab (ganzzahlig). Ersetzt das Legacy-Float-Element <code>RissViewScale</code>; liegt intern nur der alte Float-Wert vor, schreibt VermCad <code>Round(PixelProPapierMeter/ViewScale)</code>.
|-
| <code>RissViewRotAngle</code> || zahl || nein || 0.0 || Rotationswinkel der Ansicht
|-
| <code>RissViewMinX</code> / <code>RissViewMaxX</code> / <code>RissViewMinY</code> / <code>RissViewMaxY</code> || zahl || nein || 0.0 || gespeicherte Ansichts-'''Ausdehnung'''; ersetzt die Legacy-Elemente <code>RissViewMoveX</code>/<code>RissViewMoveY</code> (Verschiebungs-Speicherung bis 05/2017)
|-
| <code>RissFreezeScale</code> || bool (−1/0) || nein || 0 (False) || Maßstab eingefroren (Konstantenname <code>xn_RissMassstabEinfrieren</code> ≠ Tag-String!)
|-
| <code>RissSceneShowEnlargedSize</code> || ganzzahl || nein || 0 || Detail-Zoom-Größe bei eingefrorenem Maßstab (Konstantenname <code>xn_RissMassstabEinfrierenDetailZoomSize</code>)
|-
| <code>RissGesperrt</code> || bool (−1/0) || nein || 0 (False) || Riss ist gegen Bearbeitung gesperrt
|}

=== CurrRissID ===
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>CurrRissID</code> || ganzzahl || nein || 0 || ID des beim Speichern aktiven Risses; muss auf einen <code>RissEintrag_<ID></code> verweisen
|}

=== ObjektAuswahlen (TCADSaveSelectionList) ===
Gespeicherte benannte Objekt-Auswahlen. '''Achtung, persistenter Tippfehler:''' Das Kindelement für die Koordinatensystem-ID heißt im Tag-String <code>ObjektAuswahlKDID</code> (nicht „KSID"!) — die Delphi-Konstante heißt korrekt <code>xn_ObjektAuswahlKSID</code>, ihr Tag-String enthält aber den historischen Tippfehler „KDID". Der Tippfehler ist auf beiden Seiten (Schreiben und Lesen) identisch und darf beim Erzeugen/Reparieren '''nicht korrigiert''' werden — ein Element <code>ObjektAuswahlKSID</code> würde ignoriert.

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>ObjektAuswahl<ID></code> || Container || — || — || ein Eintrag je Auswahl; der Tag-Name muss mit <code>ObjektAuswahl</code> beginnen und mit einer '''Ganzzahl''' enden (sonst wird das Element beim Lesen nicht als Auswahl erkannt)
|-
| <code>ObjektAuswahlName</code> || text || ja || — || Name der Auswahl; Pflicht fürs Lesen: Eintrag wird nur übernommen, wenn ID ≥ 0 UND Name ≠ leer
|-
| <code>ObjektAuswahlID</code> || ganzzahl || ja || −1 || ID der Auswahl (≥ 0)
|-
| <code>ObjektAuswahlKDID</code> || ganzzahl || nein || −1 || KSID des Koordinatensystems der Auswahl ('''Tippfehler-Tag''', s. o.)
|-
| <code>ObjektAuswahlGUIDs</code> || GUID-Liste || nein || leer || GUIDs der ausgewählten Objekte als <code>TStringList.Text</code> — '''zeilenweise''' getrennt (echte Zeilenumbrüche im Elementtext). Die Auflösung der GUIDs erfolgt erst beim Aktivieren der Auswahl (mit CADID-Fallback); fehlende Ziele sind unkritisch.
|}

=== Bearbeitungsgebiet ===
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>BearbeitungsgebietAutomatisch</code> || bool (−1/0) || nein || Initialwert (nur bei Abweichung geschrieben) || Gebiet wird automatisch ermittelt (dann wird kein Polygon gespeichert)
|-
| <code>BearbeitungsgebietAutoMitFlaechen</code> || bool (−1/0) || nein || Initialwert || automatische Ermittlung bezieht Flächen ein
|-
| <code>Bearbeitungsgebiet</code> || Container mit n×<code>gml:pos</code> || nein || — || manuelles Bearbeitungsgebiets-Polygon; je Eckpunkt ein <code><gml:pos>X Y</gml:pos></code> (nur 2D, [[CAD XML Syntax-Werte- und Koordinatenformate|Float-Format]]). Wird '''nur''' geschrieben, wenn <code>BearbeitungsgebietAutomatisch</code> = False und das Polygon ≥ 3 Punkte hat.
|}

== Beispiele ==
=== Beispiel (Sachsen, echt) — Rissdaten mit mehreren Rissen ===
<pre>
<Rissdaten>
<RissEintrag_0>
<RissName>[Standard]</RissName>
<RissID>0</RissID>
<RissSzenarioID>28</RissSzenarioID>
<RissViewMeasureScale>1</RissViewMeasureScale>
<RissViewMinX>3332480.51544114</RissViewMinX>
<RissViewMaxX>3332480.70299164</RissViewMaxX>
<RissViewMinY>5683146.38093415</RissViewMinY>
<RissViewMaxY>5683146.46763282</RissViewMaxY>
<RissSceneShowEnlargedSize>1000</RissSceneShowEnlargedSize>
</RissEintrag_0>
<RissEintrag_1>
<RissName>neue Grenzen</RissName>
<RissID>1</RissID>
<RissSzenarioID>32</RissSzenarioID>
<RissViewMeasureScale>7</RissViewMeasureScale>
<RissViewMinX>3332479.28436286</RissViewMinX>
<RissViewMaxX>3332483.40339641</RissViewMaxX>
<RissViewMinY>5683145.22719967</RissViewMinY>
<RissViewMaxY>5683147.13129865</RissViewMaxY>
<RissSceneShowEnlargedSize>458</RissSceneShowEnlargedSize>
</RissEintrag_1>
…
</Rissdaten>
<CurrRissID>0</CurrRissID>
<ObjektAuswahlen />
</pre>

=== Minimalform (echt) — Rissdaten einer Nebensektion ===
<pre>
<Rissdaten>
<RissEintrag_0>
<RissName>[Standard]</RissName>
<RissID>0</RissID>
</RissEintrag_0>
</Rissdaten>
<CurrRissID>0</CurrRissID>
</pre>

=== Konstruiertes Beispiel — gefüllte ObjektAuswahl (kein Bestandsbeleg; in allen Beispielprojekten nur leer) ===
<pre>
<ObjektAuswahlen>
<ObjektAuswahl0>
<ObjektAuswahlName>Grenzpunkte Nord</ObjektAuswahlName>
<ObjektAuswahlID>0</ObjektAuswahlID>
<ObjektAuswahlKDID>0</ObjektAuswahlKDID>
<ObjektAuswahlGUIDs>{4406BFC8-…}
{D3287E10-…}
{FE697113-…}</ObjektAuswahlGUIDs>
</ObjektAuswahl0>
</ObjektAuswahlen>
</pre>

=== Konstruiertes Beispiel — Bearbeitungsgebiet (kein Bestandsbeleg) ===
<pre>
<BearbeitungsgebietAutomatisch>0</BearbeitungsgebietAutomatisch>
<Bearbeitungsgebiet>
<gml:pos>545100.0 5721100.0</gml:pos>
<gml:pos>545200.0 5721100.0</gml:pos>
<gml:pos>545200.0 5721200.0</gml:pos>
<gml:pos>545100.0 5721200.0</gml:pos>
</Bearbeitungsgebiet>
</pre>
(Nach den Code-Regeln konstruiert: manuelles Rechteck-Gebiet mit 4 Eckpunkten.)

== Verfügbarkeit und Besonderheiten ==
* Struktur in '''allen''' Bundesland-Versionen identisch.
* '''Legacy-Aliase''' (werden gelesen, nicht mehr geschrieben):
** <code>RissViewScale</code> (Float; bis 03/2025) → ersetzt durch <code>RissViewMeasureScale</code> (Integer); Umrechnung beim Schreiben: <code>Round(PixelProPapierMeter/ViewScale)</code>.
** <code>RissViewMoveX</code>/<code>RissViewMoveY</code> (bis 05/2017) → ersetzt durch die Ausdehnung <code>RissViewMinX</code>/<code>RissViewMaxX</code>/<code>RissViewMinY</code>/<code>RissViewMaxY</code> (die Move-Speicherung ließ die Szene bei Fenstergrößen-Änderung springen).
* '''Tippfehler-Tag <code>ObjektAuswahlKDID</code>''' ist absichtlich persistent — nicht „reparieren".
* In den drei untersuchten Bestandsprojekten kommen <code>ObjektAuswahlen</code> ausschließlich '''leer''' (<code><ObjektAuswahlen /></code>) vor und <code>Bearbeitungsgebiet</code> gar nicht — die gefüllten Beispiele oben sind aus dem Code konstruiert.
* Ältere Dateien enthalten nach <code>ObjektAuswahlen</code> das inzwischen entfernte Element <code><AlkisStatusOptionen /></code> — siehe [[CAD XML Syntax-Sektion VCCADDaten|Sektion VCCADDaten]].
* Fachliche Bedienung der Risse: [[CAD-Risse]].

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:72745-72869</code> — <code>TCADRissList.DataToXMLLite</code> (alle Riss-Felder, Legacy-Umrechnung ViewScale)
* <code>CAD\GLGeometrics.pas:72882-73005</code> — <code>TCADRissList.ReadFromXML</code> (Legacy-Tags, Pflichtprüfung Name/ID, Standard-Riss-Zusammenführung)
* <code>CAD\GLGeometrics.pas:74328-74449</code> — <code>TCADSaveSelectionList.DataToXMLLite</code>/<code>ReadFromXML</code> (ObjektAuswahlen, Integer-Suffix-Prüfung)
* <code>CAD\GLGeometrics.pas:74280-74298</code> — GUID-Auflösung erst beim Aktivieren einer Auswahl
* <code>CAD\GLGeometrics.pas:79596-79635</code> — <code>SaveXMLLite</code>: CurrRissID und Bearbeitungsgebiet
* <code>CAD\GLConsts.pas:152-162</code> — <code>CADRISS_DEFAULT_*</code>-Defaultwerte; <code>CAD\GLConsts.pas:776</code> — <code>cCAD_RISS_ID_STANDARD = 0</code>
* <code>VERMCAD\GlobalConsts.pas</code> (Bereich xn_Rissdaten/xn_ObjektAuswahl*) — Tag-Konstanten inkl. Tippfehler <code>xn_ObjektAuswahlKSID = 'ObjektAuswahlKDID'</code>

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

CAD XML Syntax-Sektion AlkisDaten und PlotDaten

2026-07-20T12:50:38Z

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

{{DISPLAYTITLE:CAD XML Syntax-Sektion AlkisDaten und PlotDaten}}
Nach der letzten [[CAD XML Syntax-Sektion VCCADDaten|VCCADDaten-Sektion]] folgen in der Projektdatei zwei weitere Sektionen: <code>VC_PlotDaten</code> (die VC-Key-/Schlüsselwortdaten, Klasse <code>TVCKeyValuePairs</code>) und <code>VC_AlkisDaten</code> (die ALKIS-Sektion mit allen importierten Katasterdaten). Diese Seite gibt nur einen '''Kurzüberblick''' über beide Sektionen.

'''Die Detaildokumentation der ALKIS-Sektion (<code>VC_AlkisDaten</code>) folgt in einem eigenen Task.'''

== VC_PlotDaten (VC-Key-Daten) ==
Schlüsselwort/Wert-Paare des Projekts (z. B. für Dokumentvorlagen und Plots). Der Tag-String <code>VC_PlotDaten</code> ist historisch („Plot"-Stichworte) — die Delphi-Konstante heißt <code>xn_VCKeyDaten</code>. Ein eigenständiges Element namens „VCKeyDaten" gibt es in der Datei '''nicht'''; gemeint ist immer diese Sektion.

=== Strukturregel ===
<pre>
<VC_PlotDaten>
{ <Plot_Schluesselwort key="text"> (Attribut key = 'Gruppenname.Schluessel')
{ <Plot_String>text</Plot_String> }* (je Wert-Zeile ein Plot_String)
</Plot_Schluesselwort> }*
</VC_PlotDaten>
</pre>

* <code>key</code> ist ein echtes XML-'''Attribut''' im Format <code>Gruppenname.Schlüsselname</code> (z. B. <code>Grenztermin.Ort</code>).
* Geschrieben werden nur Schlüssel, deren Wert vom globalen Vorgabewert abweicht; mehrzeilige Werte ergeben mehrere <code>Plot_String</code>-Kinder.
* Ohne abweichende Schlüssel wird die Sektion leer geschrieben: <code><VC_PlotDaten /></code>.
* Beim Lesen werden nur <code>Plot_Schluesselwort</code>-Elemente MIT <code>key</code>-Attribut ausgewertet.

== VC_AlkisDaten (Überblick) ==
Container aller ALKIS-Daten des Projekts (deutsche Kataster-Fachobjekte aus NAS-Importen). Kinder in Schreibreihenfolge:

{| class="wikitable"
! Kind-Element !! Anzahl !! Bedeutung (Kurzfassung)
|-
| <code>ImportedAlkisFile</code> || 0..n || je eingelesener NAS-Datei ein Eintrag; Attribute <code>ImportedOn</code>/<code>DateiDatum</code> (ISO-8601-UTC) und optional <code>LowerLeft</code>/<code>UpperRight</code> (Bounding-Box als Pos-Strings), Elementtext = NAS-Dateiname.
|-
| <code>HerausgeschnitteneAlkisObjekte</code> || 0..1 || AlkisIDs der beim Szenenbeschnitt entfernten Objekte als CommaText; nur bei erfolgtem Beschnitt.
|-
| <code>SzenenBeschnittBoundingBox</code> || 0..1 || Beschnitt-Rechteck; Attribute <code>LowerLeft</code>/<code>UpperRight</code> als Pos-Strings; nur bei gültigen Koordinaten.
|-
| <code>RandobjektContainer</code> || 0..1 || Verwaltung der Randobjekte (am Import-/Beschnittrand liegende Objekte).
|-
| <code>VC_AlkisObjekt</code> || 0..n || je ALKIS-Fachobjekt ein Eintrag: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]] (ObjektArt <code>oaAlkis</code>), <code>AlkisObjektStatus</code> (z. B. <code>aosBenutzt</code>) und das eingebettete AX-Fachobjekt (<code>AX_Grenzpunkt</code>, <code>AX_Flurstueck</code> …), serialisiert über die ALKIS-Basisklasse <code>TAX_Base</code>.
|-
| <code>AlkisDateneinheiten</code> || 0..1 || '''nur Thüringen/Sachsen-Anhalt''' (Compound-Define <code>THR_Anhalt</code>): Liste der Dateneinheiten, je Einheit ein <code>AlkisDE</code>-Kind.
|-
| <code>FFFallManager</code> || 0..1 || Fortführungsfall-Verwaltung (Struktur <code>FFFallDaten</code>/<code>FFFall</code>); wird als letztes Kind geschrieben, nur wenn Fälle existieren.
|}

== Beispiele ==
=== Beispiel (Baden-Württemberg, echt) — VC_PlotDaten und Beginn VC_AlkisDaten ===
<pre>
<VC_PlotDaten>
<Plot_Schluesselwort key="Grenztermin.Ort">
<Plot_String>Nossen Hauptstraße1</Plot_String>
</Plot_Schluesselwort>
</VC_PlotDaten>
<VC_AlkisDaten>
<ImportedAlkisFile ImportedOn="2026-06-01T16:14:54Z" DateiDatum="2026-06-01T13:29:11Z" LowerLeft="32517461.23 5308162.12" UpperRight="32519697.95 5312347.3">G13453438-0000000000.be.000000.20260601-15283363.0000100001.xml</ImportedAlkisFile>
<VC_AlkisObjekt>
<VermCadID>
<GUID>{FE697113-…}</GUID>
<ObjektArt>oaAlkis</ObjektArt>
<VCPktID_NV>9220</VCPktID_NV>
<VCPktID_NR>1066/259</VCPktID_NR>
<VCPktID_KSID>0</VCPktID_KSID>
</VermCadID>
…
</VC_AlkisObjekt>
…
<FFFallManager> … </FFFallManager>
</VC_AlkisDaten>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Beide Sektionen sind optional; VermCad schreibt sie aber immer (ggf. leer). Thüringen-Beispielprojekt: <code><VC_PlotDaten /></code> (leer, selbstschließend).
* Sachsen-Beispielprojekt: mehrere <code>ImportedAlkisFile</code>-Einträge, teils ohne <code>LowerLeft</code>/<code>UpperRight</code> und mit Dummy-Datum <code>DateiDatum="8888-01-01T00:00:00Z"</code>.
* <code>AlkisDateneinheiten</code>/<code>AlkisDE</code> nur in den Editionen Thüringen und Sachsen-Anhalt (<code>THR_Anhalt</code>); alle übrigen Kinder in allen Bundesland-Versionen.
* Die <code>VC_AlkisObjekt</code>-Inhalte (AX-Fachobjekte, Punktorte, Präsentationsobjekte) gehören zur ALKIS-Syntax, nicht zur CAD-Syntax — '''Detaildokumentation folgt in einem eigenen Task.'''

== Quellen im Code ==
* <code>VERMCAD\VcProject.pas:20806-20916</code> — <code>SaveXML</code>: Schreiben von <code>VC_PlotDaten</code> (via <code>SavePlotKeywordDatenXMLLite</code>, 22615) und <code>VC_AlkisDaten</code> inkl. aller Kinder und <code>{$IFDEF THR_Anhalt}</code>-Block
* <code>VERMCAD\VCAdaptiveTextElementUnit.pas:498-559</code> — <code>TVCKeyValuePairs.DataToXMLLite</code> (key-Attribut, Vorgabewert-Filter); Lesen ab 367
* <code>Alkis\TAX_BaseUnit.pas</code> — <code>TAX_Base.DataToXMLLite</code> (Serialisierung der ALKIS-Fachobjekte, u. a. <code>AlkisObjektStatus</code> bei 2451)
* <code>VERMCAD\GlobalConsts.pas:4866-4988</code> — Tag-Konstanten <code>xn_HerausgeschnitteneAlkisObjekte</code>, <code>xn_SzenenBeschnittBoundingBox</code>, <code>xn_AlkisDateneinheiten</code>, <code>xn_AlkisDE</code>, <code>xn_FFFallManager</code>, <code>xn_RandobjektContainer</code>; 4939 — <code>xn_VCKeyword = 'Plot_Schluesselwort'</code>

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

CAD XML Syntax-Rissdaten an Objekten

2026-07-20T12:50:37Z

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

{{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-Objekt VC Plotrahmen

2026-07-20T12:50:36Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_Plotrahmen}}
Der Plotrahmen definiert einen druckbaren Kartenausschnitt (Drucker, Layout, Papierformat, Maßstab) als Flächenobjekt im CAD. Delphi-Klasse ist <code>T2DPlotFrame</code> (<code>CAD\GLGeometrics.pas</code>), abgeleitet von der Flächen-Basisklasse <code>T2DAreaBase</code>. '''Achtung: Das XML-Tag heißt <code>VC_Plotrahmen</code> — OHNE das sonst übliche „CAD" im Namen''' (wie auch <code>VC_Hintergrundbild</code>).

== Strukturregel ==
<pre>
<VC_Plotrahmen>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadPlotFrame)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht,
in der Praxis System-Layer -11)
<Rand>
<Exterior GUID="guid"/> (Rahmen-Geometrie, wie bei VC_CADFlaeche)
</Rand>
<Plotrahmen_Printer>text</Plotrahmen_Printer> (alle folgenden Elemente
<Plotrahmen_LayoutID>ganzzahl</Plotrahmen_LayoutID> werden IMMER geschrieben)
<Plotrahmen_LayoutName>text</Plotrahmen_LayoutName>
<Plotrahmen_Papersize>text</Plotrahmen_Papersize>
<Plotrahmen_ResolutionHorizontal>ganzzahl</Plotrahmen_ResolutionHorizontal>
<Plotrahmen_ResolutionVertical>ganzzahl</Plotrahmen_ResolutionVertical>
<Plotrahmen_Scale1To>ganzzahl</Plotrahmen_Scale1To>
<Plotrahmen_Alpha>bool</Plotrahmen_Alpha>
<Plotrahmen_Texte>
{<Plotrahmen_Text_Eintrag>
<Plotrahmen_Text_Eintrag_ID>guid</Plotrahmen_Text_Eintrag_ID> (GUID als Elementtext!)
[<Plotrahmen_Text_Eintrag_Text>text</Plotrahmen_Text_Eintrag_Text>] (nur wenn vom
</Plotrahmen_Text_Eintrag>}* globalen Text abweichend)
</Plotrahmen_Texte>
<Plotrahmen_Dokumente>
{<Plotrahmen_Dokument_Eintrag>
<Plotrahmen_Dokument_Eintrag_ID>guid</Plotrahmen_Dokument_Eintrag_ID>
[<Plotrahmen_Dokument_Eintrag_DocFileName>text</Plotrahmen_Dokument_Eintrag_DocFileName>]
</Plotrahmen_Dokument_Eintrag>}*
</Plotrahmen_Dokumente>
<Plotrahmen_NameAnzeigeOrte>ganzzahl</Plotrahmen_NameAnzeigeOrte> (Bitmaske, siehe unten)
</VC_Plotrahmen>
</pre>
Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]], [[CAD XML Syntax-Basiselemente|Basiselemente]], Rand-Mechanik siehe [[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|VC_CADFlaeche]]; Werteformate: [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]]. Da <code>T2DPlotFrame</code> direkt von <code>T2DAreaBase</code> erbt (nicht von <code>T2DArea</code>), gibt es KEINEN <code>BoeschungsInfos</code>-Container.

== Elemente ==
Alle eigenen einfachen Elemente werden '''bedingungslos''' geschrieben (kein Default-Vergleich):

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Bedeutung
|-
| <code>Plotrahmen_Printer</code> || String || nein || Druckername (z. B. <code>Microsoft Print to PDF</code>)
|-
| <code>Plotrahmen_LayoutID</code> || Int || nein || ID des Plot-Layouts
|-
| <code>Plotrahmen_LayoutName</code> || String || nein || Layout-Name (z. B. <code>FR_A3Q</code>)
|-
| <code>Plotrahmen_Papersize</code> || String || nein || Papierformat (z. B. <code>A3</code>)
|-
| <code>Plotrahmen_ResolutionHorizontal</code> / <code>…Vertical</code> || Int || nein || Druckauflösung in dpi
|-
| <code>Plotrahmen_Scale1To</code> || Int || nein || Maßstab 1:n (z. B. <code>500</code>)
|-
| <code>Plotrahmen_Alpha</code> || bool (-1/0) || nein || Transparenz-Flag
|-
| <code>Plotrahmen_Texte</code> || Container || nein || Rahmen-Texte, je Eintrag ein <code>Plotrahmen_Text_Eintrag</code>. Die <code>…_ID</code> ist die GUID eines '''global konfigurierten Plotrahmen-Texts''' (VcPrefs), als Elementtext — KEINE CAD-Objekt-Referenz. <code>…_Text</code> nur, wenn der lokale Text vom globalen abweicht
|-
| <code>Plotrahmen_Dokumente</code> || Container || nein || analog: <code>Plotrahmen_Dokument_Eintrag</code> mit <code>…_ID</code> und optional <code>…_DocFileName</code> (nur bei Abweichung vom globalen Wert)
|-
| <code>Plotrahmen_NameAnzeigeOrte</code> || Int (Bitmaske) || nein || Anzeigeorte des Rahmennamens; Bit je <code>TPlotFrameNameAnzeigeOrt</code>-Wert: 1 = <code>pfnaoLO</code> (links oben), 2 = <code>pfnaoRO</code> (rechts oben), 4 = <code>pfnaoRU</code> (rechts unten), 8 = <code>pfnaoLU</code> (links unten); Kombinationen als Summe
|}

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>Exterior</code> (im <code>Rand</code>) || geschlossene Kurve, i. d. R. [[CAD XML Syntax-Objekt VC CADKompo|VC_CADKompo]] aus den 4 Rahmenlinien || '''ja''' || harte Referenz wie bei der Fläche: ohne auflösbares, geschlossenes Exterior wird der Plotrahmen beim Referenzen-Update verworfen
|-
| <code>Plotrahmen_Text_Eintrag_ID</code> / <code>Plotrahmen_Dokument_Eintrag_ID</code> || global konfigurierter Text-/Dokument-Eintrag (kein CAD-Objekt) || nein || weich: unbekannte IDs werden beim Lesen ignoriert (der Eintrag verfällt)
|}

== Minimalform ==
<pre>
<VC_Plotrahmen>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPlotFrame</CADObjektArt>
</VermCadID>
<Layer>-11</Layer>
<Rand>
<Exterior GUID="{XXXX…}"/>
</Rand>
</VC_Plotrahmen>
</pre>
Alle <code>Plotrahmen_*</code>-Elemente dürfen beim Erzeugen fehlen (die Werte bleiben dann leer/0 und werden aus den globalen Einstellungen ergänzt); die Rahmen-Geometrie über <code>Rand/Exterior</code> ist Pflicht.

== Beispiele ==
=== Beispiel (Sachsen, echt — einziges Bundesland mit Bestandsbelegen, 17 Exemplare) ===
<pre>
<VC_Plotrahmen>
<VermCadID>
<GUID>{CA72551A-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPlotFrame</CADObjektArt>
</VermCadID>
<Name>1</Name>
<Layer>-11</Layer>
<Rand>
<Exterior GUID="{4138C046-…}" />
</Rand>
<Plotrahmen_Printer>Microsoft Print to PDF</Plotrahmen_Printer>
<Plotrahmen_LayoutID>3</Plotrahmen_LayoutID>
<Plotrahmen_LayoutName>FR_A3Q</Plotrahmen_LayoutName>
<Plotrahmen_Papersize>A3</Plotrahmen_Papersize>
<Plotrahmen_ResolutionHorizontal>600</Plotrahmen_ResolutionHorizontal>
<Plotrahmen_ResolutionVertical>600</Plotrahmen_ResolutionVertical>
<Plotrahmen_Scale1To>500</Plotrahmen_Scale1To>
<Plotrahmen_Alpha>-1</Plotrahmen_Alpha>
<Plotrahmen_Texte>
<Plotrahmen_Text_Eintrag>
<Plotrahmen_Text_Eintrag_ID>{XXXXXXXX-…}</Plotrahmen_Text_Eintrag_ID>
</Plotrahmen_Text_Eintrag>
… (im Original 22 Einträge, gekürzt) …
</Plotrahmen_Texte>
<Plotrahmen_Dokumente />
<Plotrahmen_NameAnzeigeOrte>1</Plotrahmen_NameAnzeigeOrte>
</VC_Plotrahmen>
</pre>
<code>Plotrahmen_Dokumente</code> kommt in allen Bestandsbelegen nur leer vor; das gefüllte Format ist aus dem Code abgeleitet.

== Verfügbarkeit und Besonderheiten ==
* Code-Verfügbarkeit: '''alle''' Bundesland-Versionen (Factory-Eintrag ohne IFDEF); Bestandsbelege nur im Sachsen-Beispielprojekt.
* '''Tag ohne „CAD"-Präfix''': <code>VC_Plotrahmen</code>, nicht <code>VC_CADPlotrahmen</code> (Konstante <code>xn_CADPlotrahmen</code> täuscht).
* '''Legacy-Aliase''' (nur Lesen, alte Plotrahmen): <code>Plotrahmen_TextOben</code>, <code>Plotrahmen_TextUnten</code>, <code>Plotrahmen_TextLinks</code>, <code>Plotrahmen_TextRechts</code>, <code>Plotrahmen_TextAllgemein</code> — Einzeltexte, die beim Lesen auf Standard-Text-Einträge mit festen Default-GUIDs (<code>PLOTFRAME_DEFAULT_ID_TEXT*</code>) gemappt werden.
* Die Text-/Dokument-Listen werden beim Schreiben gegen die '''globalen''' Listen synchronisiert (gleiche Anzahl erwartet, sonst Warn-Log); beim Lesen werden Einträge über <code>GetEntryByID</code> der globalen Liste zugeordnet — ein leeres <code>…_Text</code>-Element setzt den Text bewusst auf leer.
* In der Praxis liegt der Plotrahmen auf dem System-Layer <code>-11</code>; <code>CADObjektArt=cadPlotFrame</code> ist der erste (unterste) Wert der Renderreihenfolge.
* Schreibreihenfolge im Manager: Plotrahmen als vorletzte Objektgruppe (nach Hintergrundbildern, vor Böschungen).

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:3704ff</code> — Klassendeklaration <code>T2DPlotFrame</code> (erbt von <code>T2DAreaBase</code>)
* <code>CAD\GLGeometrics.pas:65733-65882</code> — <code>T2DPlotFrame.DataToXMLLite</code> (alle Elemente bedingungslos; Text/DocFileName nur bei Abweichung vom globalen Wert)
* <code>CAD\GLGeometrics.pas:65884-65952</code> — <code>InternalCreateFromXML</code> inkl. Legacy-Mapping <code>Plotrahmen_Text*</code> → Default-GUIDs
* <code>CAD\GLGeometrics.pas:65954ff</code> — <code>InternalCreateComplexStructsFromXML</code> (Texte-/Dokumente-Container, Zuordnung per <code>GetEntryByID</code>)
* <code>CAD\GLGeometrics.pas:66359-66363</code> — Bitmasken-Auswertung <code>PlotFrameNameAnzeigeOrteIncluded</code>; <code>CAD\GLTypes.pas:1128</code> — Enum <code>TPlotFrameNameAnzeigeOrt</code>
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten (<code>xn_Plot*</code>)

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

CAD XML Syntax-Objekt VC Hintergrundbild

2026-07-20T12:50:35Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_Hintergrundbild}}
Das Hintergrundbild bindet eine Rasterbild-Datei (z. B. gescannter Riss, Orthofoto) lagerichtig in die CAD-Szene ein. Delphi-Klasse ist <code>T2DBackgroundPicture</code> (<code>CAD\GLGeometrics.pas</code>), abgeleitet von <code>T3DBaseObject</code>. '''Achtung: Das XML-Tag heißt <code>VC_Hintergrundbild</code> — OHNE das sonst übliche „CAD" im Namen''' (wie auch <code>VC_Plotrahmen</code>).

== Strukturregel ==
<pre>
<VC_Hintergrundbild>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadBackgroundPicture)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[<Verankert>bool</Verankert>]
<HBild_Dateiname>text</HBild_Dateiname> (Dateiname/Pfad der Bilddatei)
<HBild_Centre0>zahl</HBild_Centre0> (Bildmittelpunkt X)
<HBild_Centre1>zahl</HBild_Centre1> (Bildmittelpunkt Y)
<HBild_Centre2>zahl</HBild_Centre2> (Bildmittelpunkt Z)
<HBild_ZLevel>ganzzahl</HBild_ZLevel>
<HBild_Width>zahl</HBild_Width>
<HBild_Height>zahl</HBild_Height>
<HBild_RotAngle>zahl</HBild_RotAngle>
<HBild_ScaleWidth>zahl</HBild_ScaleWidth>
<HBild_ScaleHeight>zahl</HBild_ScaleHeight>
<HBild_SpiegelHor>bool</HBild_SpiegelHor>
<HBild_SpiegelVert>bool</HBild_SpiegelVert>
<HBild_Ausblenden>bool</HBild_Ausblenden>
<HBild_HasMWTRef>bool</HBild_HasMWTRef>
</VC_Hintergrundbild>
</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]].

'''Schreib-Vorbedingung:''' Die eigenen <code>HBild_*</code>-Elemente werden beim Speichern NUR geschrieben, wenn die Textur geladen ist UND die Bilddatei auf der Platte existiert — sonst landen nur VermCadID und Basisdaten in der Datei (und das Objekt überlebt das nächste Laden nicht, siehe Referenzen).

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

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>Verankert</code> || bool || nein || False || Bild ist verankert (nicht verschiebbar); wird beim Einpassen über World-File automatisch gesetzt
|-
| <code>HBild_Dateiname</code> || text || '''ja''' || — || Bilddatei. Geschrieben wird der '''projektrelative''' Pfad, wenn vorhanden (relativ zur Projektdatei), sonst der absolute; die Nutzereinstellung „Absolute Pfade" erzwingt absolute Pfade. Beim Lesen werden Pfade ohne Laufwerksangabe gegen den Projektdatei-Ordner aufgelöst
|-
| <code>HBild_Centre0</code> / <code>HBild_Centre1</code> / <code>HBild_Centre2</code> || zahl (Float) || praktisch ja || 0 || Bildmittelpunkt X / Y / Z in Weltkoordinaten
|-
| <code>HBild_ZLevel</code> || ganzzahl || nein || 0 || Z-Ebene (Zeichenreihenfolge mehrerer Bilder)
|-
| <code>HBild_Width</code> / <code>HBild_Height</code> || zahl (Float) || praktisch ja || — || Bildgröße in Pixeln; historisch Integer — der Leser akzeptiert Float
|-
| <code>HBild_RotAngle</code> || zahl (Float) || nein || 0 || Drehwinkel des Bildes
|-
| <code>HBild_ScaleWidth</code> / <code>HBild_ScaleHeight</code> || zahl (Float) || praktisch ja || — || Skalierungsfaktor Breite / Höhe (Weltmaß pro Pixel-Anteil); bei unverzerrten Bildern identisch
|-
| <code>HBild_SpiegelHor</code> / <code>HBild_SpiegelVert</code> || bool || nein || False || horizontale / vertikale Spiegelung
|-
| <code>HBild_Ausblenden</code> || bool || nein || False || Bild ist ausgeblendet
|-
| <code>HBild_HasMWTRef</code> || bool || nein || False || Bild stammt aus einer Referenz in der MWT-Datei ([[MWT Syntax]])
|}
Beim Lesen wird der Textknoten <code>NAN</code> bei allen Float-Elementen ignoriert (Wert bleibt Default).

== Referenzen ==
Das Hintergrundbild hat keine GUID-Referenzen auf andere CAD-Objekte, aber eine harte '''Datei-Referenz''': In <code>SetReferencesAndUpdate</code> (nach dem Laden) gilt
* leerer Dateiname → „Objekt wird nicht eingelesen" — das Bild wird verworfen;
* Laufwerk oder Datei nicht vorhanden → Logeintrag „Hintergrundbild … konnte nicht gefunden werden. Objekt wird nicht eingelesen" — das Bild wird '''zerstört''' (siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).
Ein gültiges <code>VC_Hintergrundbild</code> setzt also voraus, dass die Bilddatei beim Laden erreichbar ist.

== Minimalform ==
<pre>
<VC_Hintergrundbild>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadBackgroundPicture</CADObjektArt>
</VermCadID>
<Layer>0</Layer>
<HBild_Dateiname>bild.jpg</HBild_Dateiname>
<HBild_Centre0>545000.0</HBild_Centre0>
<HBild_Centre1>5721000.0</HBild_Centre1>
<HBild_Centre2>0</HBild_Centre2>
<HBild_Width>2000</HBild_Width>
<HBild_Height>1500</HBild_Height>
<HBild_ScaleWidth>0.1</HBild_ScaleWidth>
<HBild_ScaleHeight>0.1</HBild_ScaleHeight>
</VC_Hintergrundbild>
</pre>
<code>bild.jpg</code> muss neben der Projektdatei existieren, sonst wird das Objekt beim Laden verworfen.

== Beispiele ==
=== Beispiel (Sachsen, echt) ===
<pre>
<VC_Hintergrundbild>
<VermCadID>
<GUID>{76E4D488-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadBackgroundPicture</CADObjektArt>
</VermCadID>
<Layer>1018</Layer>
<Verankert>-1</Verankert>
<HBild_Dateiname>4267USR3-3.jpg</HBild_Dateiname>
<HBild_Centre0>3332591.62810421</HBild_Centre0>
<HBild_Centre1>5683956.65895749</HBild_Centre1>
<HBild_Centre2>0</HBild_Centre2>
<HBild_ZLevel>0</HBild_ZLevel>
<HBild_Width>21252</HBild_Width>
<HBild_Height>28818</HBild_Height>
<HBild_RotAngle>22.4573631286621</HBild_RotAngle>
<HBild_ScaleWidth>0.0861217868039655</HBild_ScaleWidth>
<HBild_ScaleHeight>0.0861217868039655</HBild_ScaleHeight>
<HBild_SpiegelHor>0</HBild_SpiegelHor>
<HBild_SpiegelVert>0</HBild_SpiegelVert>
<HBild_Ausblenden>0</HBild_Ausblenden>
<HBild_HasMWTRef>0</HBild_HasMWTRef>
</VC_Hintergrundbild>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen (kein IFDEF); in den drei Beispielprojekten nur in Sachsen belegt (1 Exemplar).
* '''Legacy-Alias <code>HBild_Scale</code>''': einheitlicher Skalierungsfaktor alter Dateien; wird nicht mehr geschrieben (write=False), beim Lesen setzt er '''sowohl''' <code>ScaleWidth</code> als auch <code>ScaleHeight</code>. Folgen in einer alten Datei danach noch <code>HBild_ScaleWidth</code>/<code>HBild_ScaleHeight</code>, überschreiben diese den Wert.
* <code>HBild_Width</code>/<code>HBild_Height</code> wurden früher als Integer geschrieben; aktueller Stand ist Float — der Leser verarbeitet beides.
* Schreibreihenfolge im Manager: Bilder als eigene Gruppe nach den Texten, vor den Plotrahmen.
* Unterstützte Bildformate verarbeitet die FreeImage-Bibliothek (u. a. JPG, TIF, PNG, BMP); World-File-Einpassung (z. B. .jgw/.tfw) setzt <code>Verankert</code> automatisch.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:68197-68302</code> — <code>T2DBackgroundPicture.DataToXMLLite</code> (Schreib-Vorbedingung Textur+Datei, alle HBild_*-Elemente)
* <code>CAD\GLGeometrics.pas:68100-68195</code> — <code>InternalCreateFromXML</code> (Lesen inkl. Legacy <code>HBild_Scale</code>, NAN-Behandlung)
* <code>CAD\GLGeometrics.pas:68728-68755</code> — <code>SetReferencesAndUpdate</code> (Dateiname Pflicht, Datei muss existieren)
* <code>CAD\GLGeometrics.pas:69209-69237</code> — <code>SetFileName</code>/<code>GetSaveFileName</code> (relative/absolute Pfadlogik, Einstellung „Absolute Pfade")
* <code>VERMCAD\GlobalConsts.pas</code> — Tag-Konstanten <code>xn_Hintergrundbild</code>=<code>VC_Hintergrundbild</code>, <code>xn_HBild*</code> (write_xn_HBildScale=False)

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

CAD XML Syntax-Objekt VC CADVCPNRText und Varianten

2026-07-20T12:50:34Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADVCPNRText und Varianten}}
Punktnummerntexte sind spezialisierte Textobjekte, die die Punktnummer (bzw. Punktparameter) eines referenzierten [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]] darstellen. Basisklasse ist <code>T2DVCPNRText</code> (<code>CAD\GLGeometrics.pas</code>), Wurzeltag <code>VC_CADVCPNRText</code>; daneben existieren sechs Parameter-Varianten-Tags für VMA-Kürzel-, InGerade- und AufKreisbogen-Texte (je „normal“ und „Original“). Alle erben die komplette Serialisierung von [[CAD XML Syntax-Objekt VC CADText|VC_CADText]] — auch hier steht der Textinhalt im inneren Element <code><VC_CADText>…</VC_CADText></code>.

== Tag-Übersicht (Tag → Klasse → Verfügbarkeit) ==
{| class="wikitable"
! XML-Wurzeltag !! Delphi-Klasse !! IsOriginal !! Verfügbarkeit (Code/IFDEF)
|-
| <code>VC_CADVCPNRText</code> || <code>T2DVCPNRText</code> || — || alle Bundesländer
|-
| <code>VC_CADVCPNRParVMAKuerzelText</code> || <code>T2DVCPNRParameterVMAKuerzelText</code> || False || alle Bundesländer
|-
| <code>VC_CADVCPNRParVMAKuerzelOriginalText</code> || <code>T2DVCPNRParameterVMAKuerzelText</code> || True || alle Bundesländer
|-
| <code>VC_CADVCPNRParInGeradeText</code> || <code>T2DVCPNRParameterInGeradeText</code> || False || nur BW (<code>{$IFDEF BW}</code>)
|-
| <code>VC_CADVCPNRParInGeradeOriginalText</code> || <code>T2DVCPNRParameterInGeradeText</code> || True || nur BW
|-
| <code>VC_CADVCPNRParAufKreisbogenText</code> || <code>T2DVCPNRParameterAufKreisbogenText</code> || False || nur BW
|-
| <code>VC_CADVCPNRParAufKreisbogenOriginalText</code> || <code>T2DVCPNRParameterAufKreisbogenText</code> || True || nur BW
|}

'''Wichtig:''' Die „Original“-Varianten sind KEINE eigenen Klassen, sondern dieselbe Klasse mit gesetztem Flag <code>IsOriginal=True</code>. Die Factory-Funktionen der Original-Tags setzen beim Lesen das Flag; beim Schreiben wählt der Manager anhand von <code>IsOriginal</code> den Original- oder Normal-Tag (<code>GLGeometrics.pas:79993-80026</code>). Die Variante steckt also '''allein im Wurzeltag''', nicht in einem XML-Element.

Klassenhierarchie: <code>T2DText</code> → <code>T2DVCPNRTextBase</code> → <code>T2DVCPNRText</code> (Punktnummerntext) bzw. <code>T2DVCPNRTextBase</code> → <code>T2DVCPNRParameterText</code> → die drei Parameter-Klassen. In Nicht-BW-Versionen sind die InGerade-/AufKreisbogen-Tags nicht registriert — solche Elemente würden dort als unbekannte Objekt-Tags komplett ignoriert.

== Strukturregel ==
<pre>
<VC_CADVCPNRText> (bzw. einer der 6 Varianten-Tags)
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt = cadText,
ObjektArt typisch oaVC)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[alle Text-Elemente von VC_CADText] (siehe Objektseite VC_CADText;
Textinhalt im inneren <VC_CADText>-Element)
<Text_RissDaten> … </Text_RissDaten>
[<PktNrText_SpecialOutputText>text</PktNrText_SpecialOutputText>] (NUR VC_CADVCPNRText; mehrzeilig möglich)
[<IsAdditionalVCPNRText>bool</IsAdditionalVCPNRText>] (NUR VC_CADVCPNRText)
</VC_CADVCPNRText>
</pre>

== Elemente ==
Nur die eigenen Elemente gegenüber [[CAD XML Syntax-Objekt VC CADText|VC_CADText]]. Die beiden Zusatzelemente gehören zur Klasse <code>T2DVCPNRText</code> — die '''Parameter-Varianten haben KEINE eigenen XML-Elemente''' (sie erben von <code>T2DVCPNRTextBase</code>, nicht von <code>T2DVCPNRText</code>, und serialisieren exakt wie ein VC_CADText).

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>PktNrText_SpecialOutputText</code> || text — '''mehrzeiliger Textknoten möglich''' (Zeilenumbrüche stehen roh im Element) || nein || '''' || Sondertext, der statt der Punktnummer ausgegeben wird (bei <code>PktNrTextType=TT_SPECIAL</code> am Referenzpunkt); nur geschrieben, wenn der Textinhalt und der Sondertext nicht leer sind
|-
| <code>IsAdditionalVCPNRText</code> || bool (-1/0) || nein || False || Kennzeichnung als zusätzlicher (zweiter) Punktnummerntext eines Punkts; nur geschrieben, wenn True
|}

Besonderheiten des Textinhalts:
* Default-Textinhalt neuer PNR-Texte ist der Platzhalter <code>#TEXTVONTEXTSTIL</code> (<code>PROPERTY_TEXT_FROMTEXTSTIL</code>; seit 06/2025 — vorher <code>$PNR$</code>). In den Bestandsdaten ist <code><VC_CADText>#TEXTVONTEXTSTIL</VC_CADText></code> der Regelfall.
* Der Platzhalter <code>$PNR$</code> (<code>TEXT_PLACEHOLDER_PUNKTNUMMER</code>) wird bei der Darstellung durch die Punktnummer (bzw. NV+NR oder den SpecialOutputText) des Referenzpunkts ersetzt — er kann auch in Kombination stehen (z. B. <code>Meine NR: $PNR$</code>).
* Welche Nummer dargestellt wird, steuert <code>PktNrTextType</code> '''am referenzierten Punkt''' (bzw. rissabhängig dessen <code>RissPktNrTextType</code>), nicht am Text.

== Referenzen ==
Wie bei [[CAD XML Syntax-Objekt VC CADText|VC_CADText]]: <code>Text_Referenzobjekt</code> zeigt auf den zugehörigen VC_CADPunkt und ist praktisch Pflicht (ohne Referenzpunkt kann kein Punktnummern-/Parametertext dargestellt werden; fehlt das Ziel endgültig, wird der Text beim Referenzen-Update zerstört).

== Minimalform ==
<pre>
<VC_CADVCPNRText>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Layer>-235</Layer>
<Text_Referenzobjekt GUID="{XXXX…}" />
<VC_CADText>#TEXTVONTEXTSTIL</VC_CADText>
<Text_RissDaten />
</VC_CADVCPNRText>
</pre>
Für die Varianten denselben Aufbau mit dem jeweiligen Wurzeltag verwenden.

== Beispiele ==
=== Beispiel (Baden-Württemberg) — Standardform (alle BW-Exemplare identisch aufgebaut) ===
<pre>
<VC_CADVCPNRText>
<VermCadID>
<GUID>{E09395D3-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Layer>-235</Layer>
<LayerErben>-1</LayerErben>
<Text_Referenzobjekt GUID="{1CB09C10-…}" />
<VC_CADText>#TEXTVONTEXTSTIL</VC_CADText>
<Text_RissDaten />
</VC_CADVCPNRText>
</pre>

=== Beispiel (Sachsen) — RefPkt-Verschiebung, gefüllte Text_RissDaten und mehrzeiliger SpecialOutputText ===
<pre>
<VC_CADVCPNRText>
<VermCadID>
<GUID>{E8AFB7D5-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Layer>787</Layer>
<LayerErben>-1</LayerErben>
<Text_Referenzobjekt GUID="{798B27AC-…}" />
<Text_RefPktMoveX>-6.79097226588056</Text_RefPktMoveX>
<Text_RefPktMoveY>2.55763887800276</Text_RefPktMoveY>
<VC_CADText>#TEXTVONTEXTSTIL</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>
</Text_RissDaten>
<PktNrText_SpecialOutputText>189
DES:[1800]
GST:[2100]
ENT:[4267R0702]</PktNrText_SpecialOutputText>
</VC_CADVCPNRText>
</pre>
Der Wert von <code>PktNrText_SpecialOutputText</code> ist hier ein '''mehrzeiliger Textknoten''' — die Zeilenumbrüche gehören zum Wert. Details zu <code>Text_RissDaten</code>: [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]].

=== Beispiel (Baden-Württemberg) — Parameter-Variante InGerade ===
<pre>
<VC_CADVCPNRParInGeradeText>
<VermCadID>
<GUID>{1BAA940B-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Layer>-1007</Layer>
<Text_Referenzobjekt GUID="{37EE340E-…}" />
<VC_CADText>#TEXTVONTEXTSTIL</VC_CADText>
<Text_RissDaten />
</VC_CADVCPNRParInGeradeText>
</pre>
<code>VC_CADVCPNRParVMAKuerzelText</code> (Layer −1006) und <code>VC_CADVCPNRParVMAKuerzelOriginalText</code> (Layer −1009) sind in den Bestandsdaten strukturell identisch aufgebaut — nur der Wurzeltag (und der System-Layer) unterscheidet sich.

=== Konstruiertes Beispiel — AufKreisbogen-Original-Variante (nur BW; kein Bestandsbeispiel vorhanden) ===
<pre>
<VC_CADVCPNRParAufKreisbogenOriginalText>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Layer>-1010</Layer>
<Text_Referenzobjekt GUID="{XXXX…}" />
<VC_CADText>#TEXTVONTEXTSTIL</VC_CADText>
<Text_RissDaten />
</VC_CADVCPNRParAufKreisbogenOriginalText>
</pre>
(Nach den Regeln konstruiert — in den drei untersuchten Beispielprojekten kommen die AufKreisbogen-Tags nicht vor; Layer-ID beispielhaft.)

== Verfügbarkeit und Besonderheiten ==
* '''Code-Verfügbarkeit''': <code>VC_CADVCPNRText</code> und beide VMAKuerzel-Tags in allen Bundesland-Versionen; die vier InGerade-/AufKreisbogen-Tags nur in BW (<code>{$IFDEF BW}</code> in Factory und Klassendeklaration).
* '''Belege aus den Beispielprojekten''' (getrennt von der Code-Verfügbarkeit): <code>VC_CADVCPNRText</code> in BW/Sachsen/THR belegt; <code>VC_CADVCPNRParInGeradeText</code> (254×) und <code>VC_CADVCPNRParVMAKuerzelText</code> (219×) nur in BW belegt; <code>VC_CADVCPNRParVMAKuerzelOriginalText</code> in BW (1×) und Sachsen (86×); die beiden AufKreisbogen-Tags und die InGerade-Original-Variante sind in keinem der drei Projekte belegt.
* '''Speicher-Weiche''': Beim Speichern entscheidet der Klassentyp plus <code>IsOriginal</code> über den Wurzeltag; beim Lesen setzt der Factory-Eintrag des Original-Tags <code>IsOriginal:=True</code>.
* PNR-Texte entstehen normalerweise automatisch (ObjektArt <code>oaVC</code>) und liegen auf System-Layern (negativ, z. B. −235, −1006, −1007, −1009) oder erben den Layer des Punkts (<code>LayerErben</code>).
* Es gelten alle Besonderheiten von [[CAD XML Syntax-Objekt VC CADText|VC_CADText]] (doppelter Tag <code>VC_CADText</code> als Inhaltselement, leere Texte werden nicht gespeichert, Legacy-Aliase).

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:55198-55233</code> — <code>T2DVCPNRText.DataToXMLLite</code> (SpecialOutputText, IsAdditionalVCPNRText)
* <code>CAD\GLGeometrics.pas:55161-55185</code> — <code>T2DVCPNRText.InternalCreateFromXML</code>
* <code>CAD\GLGeometrics.pas:55139-55150</code> — <code>AfterConstruction</code> (Default-Text <code>PROPERTY_TEXT_FROMTEXTSTIL</code>)
* <code>CAD\GLGeometrics.pas:2989-3081</code> — Klassendeklarationen <code>T2DVCPNRTextBase</code>, <code>T2DVCPNRText</code>, <code>T2DVCPNRParameterText</code> (+ Varianten, BW-IFDEF)
* <code>CAD\GLGeometrics.pas:83800-83832</code> — Factory-Funktionen (Original-Varianten setzen <code>IsOriginal:=True</code>)
* <code>CAD\GLGeometrics.pas:97023-97031</code> — Factory-Registrierung der 7 Tags (BW-IFDEF)
* <code>CAD\GLGeometrics.pas:79982-80026</code> — Speicher-Weiche Tag je Klasse/IsOriginal; leere Texte werden nicht gespeichert
* <code>CAD\GLConsts.pas:245, 458</code> — <code>TEXT_PLACEHOLDER_PUNKTNUMMER</code> (<code>$PNR$</code>), <code>PROPERTY_TEXT_FROMTEXTSTIL</code> (<code>#TEXTVONTEXTSTIL</code>)
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten (<code>xn_CADVCPNRText</code>, <code>xn_CADVCPNRParameter*</code>, <code>xn_SpecialOutputText</code>, <code>xn_IsAdditionalVCPNRText</code>)

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

CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung

2026-07-20T12:50:33Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADVCBerechnung und VC_CADVCMessung}}
Berechnung und Messung sind die CAD-Repräsentanten der VermCad-Rechenmakros und Messblöcke: Sie bündeln alle zu einem Makro gehörenden Darstellungs-Objekte (Punkte, Linien, Maßtexte …) als Kompo und verknüpfen sie über die Makro-ID mit der Berechnung/Messung im Projekt. Delphi-Klassen sind <code>T3DVCBerechnung</code> (<code>CAD\GLVCBerechnung.pas</code>, XML-Tag <code>VC_CADVCBerechnung</code>) und <code>T3DVCMessung</code> (<code>CAD\GLVCMessung.pas</code>, XML-Tag <code>VC_CADVCMessung</code>). Die komplette XML-Serialisierung liegt in der gemeinsamen Basisklasse <code>T3DVCCalcMess</code> (<code>CAD\GLVCCalcMessBase.pas</code>), die von [[CAD XML Syntax-Objekt VC CADKompo|T3DKompo (VC_CADKompo)]] erbt — beide Objekte sind also Kompos mit Zusatzdaten. Die Element-Namen tragen aus historischen Gründen für beide Objekte das Präfix <code>VC_CADVCBerechnung…</code>/<code>VC_CADVCBer…</code>.

== Strukturregel ==
<pre>
<VC_CADVCBerechnung> | <VC_CADVCMessung>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadKompo)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht,
typisch negativer System-Layer)
<MemberGroup> (geerbt von Kompo: alle zugehörigen CAD-Objekte)
{<Member GUID="guid"/>}*
</MemberGroup>
### REIHENFOLGE DER FOLGENDEN 5 ELEMENTE IST ZWINGEND ###
<MakroIDType>enum:TMakroType</MakroIDType> (1. — Makrotyp)
<MakroIDNr>ganzzahl</MakroIDNr> (2. — Makronummer)
<MakroIDName>text | leer</MakroIDName> (3. — Makroname, darf leer sein)
<VC_CADVCBerCalcKind>enum:TCalcKind</VC_CADVCBerCalcKind> (4. — Berechnungsart)
<CalcItemActive>bool</CalcItemActive>
[<VC_CADVCBerechnungSettings> (5. — NACH CalcKind!)
{<PropertyName>wert</PropertyName>}* (RTTI: Elementname = Delphi-Property-Name)
</VC_CADVCBerechnungSettings>]
{<VC_CADVCBerechnungList> (0..n Ergebnis-/Untergliederungslisten;
<VC_CADVCBerechnungListName>text</VC_CADVCBerechnungListName> KEINE eigenen Objekte!)
<VC_CADVCBerechnungListNR>ganzzahl</VC_CADVCBerechnungListNR>
[<VC_CADVCBerechnungListKindBaseType>enum</VC_CADVCBerechnungListKindBaseType>]
[<VC_CADVCBerechnungListKindType>text</VC_CADVCBerechnungListKindType>]
[<VC_CADVCBerechnungListCounterNr>ganzzahl</VC_CADVCBerechnungListCounterNr>]
[<VC_CADVCBerechnungListKindName>text</VC_CADVCBerechnungListKindName>]
[<VC_CADVCBerechnungListDeactivated>bool</VC_CADVCBerechnungListDeactivated>]
[<VC_CADVCBerechnungListSysID>ganzzahl</VC_CADVCBerechnungListSysID>]
[<MemberGroup>
{<Member GUID="guid" [RefGUID="guid"] [Counter="ganzzahl"]/>}*
</MemberGroup>]
</VC_CADVCBerechnungList>}*
</VC_CADVCBerechnung> | </VC_CADVCMessung>
</pre>
Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]], [[CAD XML Syntax-Basiselemente|Basiselemente]] und die <code>MemberGroup</code> von [[CAD XML Syntax-Objekt VC CADKompo|Kompo]]; Werteformate: [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

== Zwingende Element-Reihenfolge ==
Der Leser wertet die fünf Kernelemente '''in Dokumentreihenfolge''' aus — ein Erzeuger MUSS schreiben:

<code>MakroIDType</code> → <code>MakroIDNr</code> → <code>MakroIDName</code> → <code>VC_CADVCBerCalcKind</code> → <code>VC_CADVCBerechnungSettings</code>

Gründe (im Code mehrfach als „### ACHTUNG ###" dokumentiert):
# <code>MakroIDNr</code> holt die <code>TVCMakroID</code> vom IDServer '''mit dem zuvor gelesenen Typ''' — steht der Typ noch nicht, entsteht die falsche Makro-Verknüpfung.
# <code>MakroIDName</code> setzt den Namen '''an der bereits erzeugten''' MakroID.
# Der Setter von <code>VC_CADVCBerCalcKind</code> erzeugt das <code>CalcMessViewObjekt</code> (Settings-Träger).
# <code>VC_CADVCBerechnungSettings</code> vor <code>CalcKind</code> → das Settings-Objekt existiert noch nicht; der Leser loggt „Einstellungen … konnten nicht korrekt eingelesen werden" und '''verwirft die Settings'''.

== Elemente ==
Nur die eigenen Elemente von <code>T3DVCCalcMess</code> (zusätzlich zu Kompo/Basis):

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>MakroIDType</code> || enum:TMakroType || praktisch ja (geschrieben, wenn MakroID existiert) || — || Makrotyp: <code>mt_Calc</code> (Berechnung), <code>mt_Mess</code> (Tachymeter-Messung), <code>mt_NetzMess</code>, <code>mt_GNSSMess</code>
|-
| <code>MakroIDNr</code> || ganzzahl || praktisch ja || — || Makronummer; eindeutig je Makrotyp (und KS) — verknüpft das CAD-Objekt mit der Berechnung/Messung im IDServer des Projekts
|-
| <code>MakroIDName</code> || text || praktisch ja (darf leer sein: <code><MakroIDName /></code>) || '' || Makroname; bei Messungen z. B. der Standpunktname
|-
| <code>VC_CADVCBerCalcKind</code> || enum:TCalcKind || '''ja''' (wird immer geschrieben) || — || Berechnungs-/Messungsart, siehe Enum-Tabelle unten; der Setter erzeugt das Settings-Objekt
|-
| <code>CalcItemActive</code> || bool (-1/0) || nein (wird immer geschrieben) || — || Berechnungs-Item aktiv
|-
| <code>VC_CADVCBerechnungSettings</code> || Container || nein || — || Darstellungs-Einstellungen, RTTI-basiert (siehe unten)
|-
| <code>VC_CADVCBerechnungList</code> || Container, 0..n || nein || — || Untergliederung in Einzel-Listen (z. B. je Messblock, je Transformations-System); '''keine eigenständigen CAD-Objekte''' — kein VermCadID, keine GUID
|}

=== Enum TCalcKind (alle 43 Werte, in Deklarationsreihenfolge) ===
Quelle: <code>VERMCAD\GlobalTypes.pas:397-441</code>. Geschrieben wird immer der GetEnumName-String:

{| class="wikitable"
! Wert !! Bedeutung
|-
| <code>ca_Entfernung</code> || Entfernungsberechnung
|-
| <code>ca_KoordinatenVergleich</code> || Koordinatenvergleich
|-
| <code>ca_Fassade</code> || Fassade (neu ab Version 5.0)
|-
| <code>ca_LinienElement</code> || Linienelement
|-
| <code>ca_KleinPunkt</code> || Kleinpunktberechnung
|-
| <code>ca_MessLinie</code> || Messungslinie
|-
| <code>ca_PolygonPunkt</code> || Polygonpunkt
|-
| <code>ca_BogenElement</code> || Bogenelement
|-
| <code>ca_BogenPunkt</code> || Bogenpunkt
|-
| <code>ca_AusgleichGeraden</code> || Ausgleichsgerade
|-
| <code>ca_Kreis</code> || Kreisberechnung
|-
| <code>ca_Klotoide</code> || Klotoide
|-
| <code>ca_LotFussPunkt</code> || Lotfußpunkt
|-
| <code>ca_RichtungFussPunkt</code> || Richtungsfußpunkt
|-
| <code>ca_GeradenSchnitt</code> || Geradenschnitt
|-
| <code>ca_KreisGeradeSchnitt</code> || Schnitt Kreis–Gerade
|-
| <code>ca_BogenSchnitt</code> || Bogenschnitt
|-
| <code>ca_MultiBogenSchnitt</code> || Mehrfach-Bogenschnitt
|-
| <code>ca_VorwaertsSchnitt</code> || Vorwärtsschnitt
|-
| <code>ca_Flaeche</code> || Flächenberechnung
|-
| <code>ca_Winkel</code> || Winkelberechnung
|-
| <code>ca_PolarElement</code> || Polarelement
|-
| <code>ca_PolarPunkt</code> || Polarpunkt
|-
| <code>ca_Mittelwert</code> || Mittelwertbildung
|-
| <code>ca_Transformation</code> || Transformation
|-
| <code>ca_KsTransformation</code> || Koordinatensystem-Transformation
|-
| <code>ca_MaschenweiseTransformation</code> || maschenweise Transformation (neu ab Version 5.0)
|-
| <code>ca_MaschenweiseKsTransformation</code> || maschenweise KS-Transformation (neu ab Version 5.0)
|-
| <code>ca_Grenzpruefung</code> || Grenzprüfung
|-
| <code>ca_Punktidentitaet</code> || Punktidentitätsnachweis
|-
| <code>ca_PolygonZug</code> || Polygonzug
|-
| <code>ca_NetzAusgleichYX</code> || Netzausgleichung Lage (Y/X)
|-
| <code>ca_NetzAusgleichZ</code> || Netzausgleichung Höhe (Z)
|-
| <code>ca_Nivellement</code> || Nivellement
|-
| <code>ca_VkTransformation</code> || VK-Transformation
|-
| <code>ca_GebaeudeUmringAusgleichung</code> || Gebäudeumring-Ausgleichung
|-
| <code>ca_Ebenheit</code> || Ebenheitsprüfung
|-
| <code>ca_Trasse</code> || Trasse
|-
| <code>ca_EinfluchtenGerade</code> || Einfluchten in Gerade (neu 07/2026)
|-
| <code>ca_EinfluchtenBogen</code> || Einfluchten in Bogen (neu 07/2026)
|-
| <code>ca_GNSSMess</code> || GNSS-Messung (typisch bei <code>VC_CADVCMessung</code>)
|-
| <code>ca_TachyMess</code> || Tachymeter-Messung (typisch bei <code>VC_CADVCMessung</code>)
|-
| <code>ca_Calculations</code> || Sammelliste aller Berechnungen (außer Netz)
|}
Real belegt in den Beispielprojekten: <code>ca_AusgleichGeraden</code>, <code>ca_Entfernung</code>, <code>ca_GNSSMess</code>, <code>ca_GeradenSchnitt</code>, <code>ca_KleinPunkt</code>, <code>ca_KreisGeradeSchnitt</code>, <code>ca_LinienElement</code>, <code>ca_LotFussPunkt</code>, <code>ca_MessLinie</code>, <code>ca_TachyMess</code>, <code>ca_VkTransformation</code>.

=== Settings-Container (RTTI-Prinzip) ===
<code>VC_CADVCBerechnungSettings</code> wird '''per RTTI''' geschrieben: Alle PUBLISHED Properties des jeweiligen <code>TCalcView…Objekt</code> (Klassen je CalcKind in <code>CAD\GLCalcViewManager.pas</code>) der Typen Integer, Enum und String werden als Kindelemente <code><PropertyName>Wert</PropertyName></code> ausgegeben — '''Elementname = exakter Delphi-Property-Name'''. Gelesen wird spiegelbildlich über <code>CalcMessViewObjekt.ReadFromXML</code>; die konkreten Element-Namen variieren daher je nach CalcKind und Programmversion und sind hier nicht abschließend aufzählbar.

Regeln für Erzeuger/Reparierer:
* Immer vorhanden (Basisklasse <code>TCalcViewBaseObjekt</code>): <code>Active</code> und <code>TextLayerID</code>.
* '''Ausnahme vom Bool-Format:''' <code>Active</code> wird über RTTI als String <code>True</code>/<code>False</code> geschrieben — nicht als -1/0 wie alle anderen Bool-Elemente!
* Alle weiteren Properties sind fast durchweg Layer-IDs (Integer, -1 = nicht gesetzt), z. B. bei <code>ca_MessLinie</code>: <code>NachweisLayerID</code>, <code>BemerkungLayerID</code>, <code>BaseLinienObjLayerID</code>, <code>AnfangsmassLayerID</code>, <code>ZwischenmassLayerID</code>, <code>EndmassLayerID</code>, <code>PunkteLinienObjLayerID</code>, <code>ElementeLinienObjLayerID</code> u. a.; bei <code>ca_GNSSMess</code> nur <code>Active</code> + <code>TextLayerID</code>.
* Unbekannte/überzählige Kindelemente sind unkritisch (werden ignoriert); minimal genügt <code><Active>True</Active></code> + <code><TextLayerID>-1</TextLayerID></code>.
* Der Container darf ganz fehlen; er wird nur geschrieben/gelesen, wenn ein CalcMessViewObjekt existiert (d. h. CalcKind wurde vorher gesetzt).

=== Kindelemente von VC_CADVCBerechnungList ===
Ein <code>VC_CADVCBerechnungList</code>-Block (Klasse <code>T3DVCBerechnungsItemListContainer</code>) ist reine Untergliederung — kein CAD-Objekt.

{| class="wikitable"
! Kind-Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>VC_CADVCBerechnungListName</code> || text || '''ja''' || — || Listenname; der Block wird beim Lesen NUR übernommen, wenn Name UND NR gesetzt sind
|-
| <code>VC_CADVCBerechnungListNR</code> || ganzzahl ≥ 0 || '''ja''' || — || Listen-/Makronummer
|-
| <code>VC_CADVCBerechnungListKind</code> || ganzzahl || nein — '''Legacy''' (wird seit 28.01.2026 nicht mehr geschrieben) || -1 || alte numerische Kind-Kodierung; wird beim Lesen in KindBaseType/KindType migriert (siehe Besonderheiten)
|-
| <code>VC_CADVCBerechnungListKindBaseType</code> || enum || nein || <code>kbt_None</code> (nicht geschrieben) || Basistyp des Listen-Kinds: <code>kbt_None</code>, <code>kbt_VkTransformation</code>, <code>kbt_Punktidentitaet</code>, <code>kbt_MaschenTrafo</code>
|-
| <code>VC_CADVCBerechnungListKindType</code> || text (Enum-Name) || nein || '' || konkreter Kind-Typ als Enum-Name der Zieltypen, z. B. <code>vaYX</code>/<code>vaUnknown</code> (TVAObservationKind) oder ein TPIdKind-Name
|-
| <code>VC_CADVCBerechnungListCounterNr</code> || ganzzahl ≥ 0 || nein || 0 || laufende Nummer
|-
| <code>VC_CADVCBerechnungListKindName</code> || text || nein || '' || Anzeigename des Kinds (z. B. Systemname einer VK-Transformation)
|-
| <code>VC_CADVCBerechnungListDeactivated</code> || bool || nein (nur geschrieben, wenn True) || False || Liste deaktiviert
|-
| <code>VC_CADVCBerechnungListSysID</code> || ganzzahl > 0 || nein || 0 || Unter-System-ID
|-
| <code>MemberGroup</code> || Container || nein || — || Listen-Mitglieder; hier tragen die <code>Member</code>-Elemente die Daten als '''Attribute''': <code>GUID</code> (CAD-Objekt), optional <code>RefGUID</code> (Quell-Referenzpunkt), optional <code>Counter</code> (Zähler ≥ 0)
|}

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>MemberGroup/Member</code> (äußere, geerbt) || beliebige CAD-Objekte des Makros (Punkte, Linien, Texte …) || '''ja''' (≥ 1) || wie beim [[CAD XML Syntax-Objekt VC CADKompo|Kompo]]: nicht auflösbare Referenzen führen nach dem „LastTry" zur Zerstörung des Objekts; anders als beim reinen Kompo genügt hier bereits '''1''' Member
|-
| <code>Member@GUID</code> (in Listen-MemberGroup) || dieselben CAD-Objekte wie in der äußeren MemberGroup || praktisch ja || fehlt das Attribut, wird die GUID als Workaround aus der Kompo-Kinderliste positionsbasiert rekonstruiert; ungültige Werte → Logeintrag, Eintrag übersprungen (weiche Referenz)
|-
| <code>Member@RefGUID</code> || Quell-Referenzobjekt des Members — bei Messungen der gemessene Original-Punkt, dessen Darstellungs-Objekt der Member ist || nein || weiche Referenz (nur Verzahnungs-Info)
|}
'''Verzahnung Berechnung ↔ Messung:''' Über <code>RefGUID</code> zeigt ein Listen-Member (z. B. der von einer GNSS-Messung erzeugte CAD-Punkt) auf sein Quellobjekt. So bleibt nachvollziehbar, welches Messungs-Objekt welches Zielobjekt erzeugt hat; Paare mit gleichem <code>Counter</code> gehören zusammen (z. B. Punkt + Punktnummerntext derselben Messung Nr. n).

== Minimalform ==
<pre>
<VC_CADVCBerechnung>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-5200</Layer>
<MemberGroup>
<Member GUID="{XXXX…}"/>
</MemberGroup>
<MakroIDType>mt_Calc</MakroIDType>
<MakroIDNr>1</MakroIDNr>
<MakroIDName>1</MakroIDName>
<VC_CADVCBerCalcKind>ca_KleinPunkt</VC_CADVCBerCalcKind>
<CalcItemActive>-1</CalcItemActive>
<VC_CADVCBerechnungSettings>
<Active>True</Active>
<TextLayerID>-1</TextLayerID>
</VC_CADVCBerechnungSettings>
</VC_CADVCBerechnung>
</pre>
Für <code>VC_CADVCMessung</code> identisch mit <code>MakroIDType</code> <code>mt_Mess</code>/<code>mt_GNSSMess</code>/<code>mt_NetzMess</code> und passendem CalcKind (<code>ca_TachyMess</code>/<code>ca_GNSSMess</code>). Die 5-Elemente-Reihenfolge ist zwingend; die MakroIDNr sollte zu einer existierenden Berechnung/Messung des Projekts passen.

== Beispiele ==
=== Beispiel VC_CADVCBerechnung (Baden-Württemberg 5.0.0, echt, gekürzt — MessLinie mit Settings und Ergebnisliste) ===
<pre>
<VC_CADVCBerechnung>
<VermCadID>
<GUID>{2D8D9A8D-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-5200</Layer>
<MemberGroup>
<Member GUID="{EC2B0EAF-…}" />
<Member GUID="{F4914B8E-…}" />
… (im Original 15 Member) …
</MemberGroup>
<MakroIDType>mt_Calc</MakroIDType>
<MakroIDNr>7</MakroIDNr>
<MakroIDName>7</MakroIDName>
<VC_CADVCBerCalcKind>ca_MessLinie</VC_CADVCBerCalcKind>
<CalcItemActive>-1</CalcItemActive>
<VC_CADVCBerechnungSettings>
<NachweisLayerID>-5201</NachweisLayerID>
<BemerkungLayerID>-5202</BemerkungLayerID>
<BaseLinienObjLayerID>-5205</BaseLinienObjLayerID>
<AnfangsmassLayerID>-5203</AnfangsmassLayerID>
<ZwischenmassLayerID>-5206</ZwischenmassLayerID>
<EndmassLayerID>-5207</EndmassLayerID>
<PunkteLinienObjLayerID>-5209</PunkteLinienObjLayerID>
<ElementeLinienObjLayerID>-5212</ElementeLinienObjLayerID>
… (weitere Layer-IDs gekürzt) …
<Active>True</Active>
<TextLayerID>-1</TextLayerID>
</VC_CADVCBerechnungSettings>
<VC_CADVCBerechnungList>
<VC_CADVCBerechnungListName>7</VC_CADVCBerechnungListName>
<VC_CADVCBerechnungListNR>7</VC_CADVCBerechnungListNR>
<VC_CADVCBerechnungListCounterNr>0</VC_CADVCBerechnungListCounterNr>
<MemberGroup>
<Member GUID="{F4914B8E-…}" Counter="1" />
<Member GUID="{23E14A92-…}" RefGUID="{5E840B97-…}" Counter="1" />
<Member GUID="{FA2BB7DC-…}" Counter="2" />
… (im Original 15 Member) …
</MemberGroup>
</VC_CADVCBerechnungList>
</VC_CADVCBerechnung>
</pre>

=== Beispiel VC_CADVCMessung (echt, gekürzt — GNSS-Messung mit RefGUID-Verzahnung) ===
<pre>
<VC_CADVCMessung>
<VermCadID>
<GUID>{7457ECCD-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-3002</Layer>
<MemberGroup>
<Member GUID="{03C581E4-…}" />
<Member GUID="{0A236819-…}" />
… (im Original 14 Member) …
</MemberGroup>
<MakroIDType>mt_Mess</MakroIDType>
<MakroIDNr>5</MakroIDNr>
<MakroIDName />
<VC_CADVCBerCalcKind>ca_GNSSMess</VC_CADVCBerCalcKind>
<CalcItemActive>-1</CalcItemActive>
<VC_CADVCBerechnungSettings>
<Active>True</Active>
<TextLayerID>554</TextLayerID>
</VC_CADVCBerechnungSettings>
<VC_CADVCBerechnungList>
<VC_CADVCBerechnungListName>Block 8 GNSS - Messung LS 489</VC_CADVCBerechnungListName>
<VC_CADVCBerechnungListNR>5</VC_CADVCBerechnungListNR>
<VC_CADVCBerechnungListCounterNr>0</VC_CADVCBerechnungListCounterNr>
<MemberGroup>
<Member GUID="{03C581E4-…}" RefGUID="{64104C29-…}" Counter="1" />
<Member GUID="{0A236819-…}" Counter="1" />
<Member GUID="{1C4F8839-…}" RefGUID="{A14432B9-…}" Counter="2" />
<Member GUID="{4E7730EC-…}" Counter="2" />
… (weitere Paare gekürzt) …
</MemberGroup>
</VC_CADVCBerechnungList>
</VC_CADVCMessung>
</pre>
Je gemessenem Punkt entstehen hier zwei Member mit gleichem <code>Counter</code>: der CAD-Punkt (mit <code>RefGUID</code> auf den Quellpunkt) und sein Punktnummerntext.

=== Die drei real belegten Versions-Schemata der Listenstruktur ===
Die <code>VC_CADVCBerechnungList</code>-Struktur hat sich über die Programmversionen entwickelt; alle drei Formen werden gelesen:

{| class="wikitable"
! Schema !! belegt in !! Kind-Felder
|-
| '''5.0.0''' (BW) || BW-Beispielprojekt || nur <code>ListName</code>/<code>ListNR</code>/<code>ListCounterNr</code> + MemberGroup — keine Kind-Typ-Felder
|-
| '''5.0.35''' (THR) || THR-Beispielprojekt || zusätzlich <code>VC_CADVCBerechnungListKind</code> als '''Zahl''' (Legacy) + <code>ListKindName</code>, ggf. <code>ListSysID</code>
|-
| '''5.0.57''' (Sachsen) || Sachsen-Beispielprojekt || <code>ListKindBaseType</code>/<code>ListKindType</code> als '''Enum-Strings''' (aktuelles Schreibformat) + <code>ListKindName</code>/<code>ListSysID</code>
|}

THR 5.0.35 (echt — <code>ListKind</code> noch als Zahl):
<pre>
<VC_CADVCBerechnungList>
<VC_CADVCBerechnungListName>1</VC_CADVCBerechnungListName>
<VC_CADVCBerechnungListNR>1</VC_CADVCBerechnungListNR>
<VC_CADVCBerechnungListKind>11</VC_CADVCBerechnungListKind>
<VC_CADVCBerechnungListCounterNr>0</VC_CADVCBerechnungListCounterNr>
<VC_CADVCBerechnungListKindName>1</VC_CADVCBerechnungListKindName>
<MemberGroup>
<Member GUID="{C0406EBC-…}" Counter="1" />
… (gekürzt) …
</MemberGroup>
</VC_CADVCBerechnungList>
</pre>

Sachsen 5.0.57 (echt — Enum-Strings; das zugehörige VK-Transformations-Objekt umfasst im Original 17.499 Zeilen mit 447 Listen-Blöcken):
<pre>
<VC_CADVCBerechnungList>
<VC_CADVCBerechnungListName>1</VC_CADVCBerechnungListName>
<VC_CADVCBerechnungListNR>1</VC_CADVCBerechnungListNR>
<VC_CADVCBerechnungListKindBaseType>kbt_VkTransformation</VC_CADVCBerechnungListKindBaseType>
<VC_CADVCBerechnungListKindType>vaYX</VC_CADVCBerechnungListKindType>
<VC_CADVCBerechnungListCounterNr>0</VC_CADVCBerechnungListCounterNr>
<VC_CADVCBerechnungListKindName>D4244-DT5-L1</VC_CADVCBerechnungListKindName>
<VC_CADVCBerechnungListSysID>35</VC_CADVCBerechnungListSysID>
<MemberGroup>
<Member GUID="{21920A80-…}" RefGUID="{2E8AA095-…}" Counter="2" />
<Member GUID="{94994B3F-…}" Counter="1" />
… (gekürzt) …
</MemberGroup>
</VC_CADVCBerechnungList>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen; Bestandsbelege in allen drei Beispielprojekten.
* <code>ObjektArt</code> ist beim Berechnungs-/Messungs-Objekt selbst <code>oaVC</code>; die von Berechnungen erzeugten Member-Objekte tragen häufig <code>oaVCBer</code>. <code>CADObjektArt</code> ist <code>cadKompo</code>.
* '''Legacy-Migration <code>VC_CADVCBerechnungListKind</code>:''' Die alte Zahl wird beim Lesen für <code>ca_VkTransformation</code> und <code>ca_Punktidentitaet</code> in <code>KindBaseType</code>/<code>KindType</code> umgesetzt. Bei VK-Transformationen aus '''älteren''' Dateiversionen (<code>fvcOlder</code>) wird dabei der TVAObservationKind-Ordinalwert um +1 verschoben (Enum-Erweiterung); neuere Dateien 1:1. Für andere CalcKinds bleibt die Zahl nur im internen <code>Kind</code>-Feld erhalten.
* Die Elementnamen im <code>VC_CADVCBerechnungSettings</code>-Container sind versions- und CalcKind-abhängig (RTTI) — beim Reparieren fremde/unbekannte Property-Namen nicht „korrigieren", sie sind harmlos.
* <code>MakroIDNr</code> ohne passende Berechnung/Messung im Projekt: Das CAD-Objekt lädt trotzdem (die MakroID wird über den IDServer angelegt), verweist dann aber ins Leere — verwaiste Darstellungs-Kompo.
* Schreibreihenfolge im Manager: Berechnungen/Messungen werden mit den Kompos geschrieben.
* Layer sind typischerweise negative System-Layer der Berechnungs-/Messungsdarstellung (z. B. -3xxx, -45xx, -5xxx, -6xxx).

== Quellen im Code ==
* <code>CAD\GLVCCalcMessBase.pas:2988-3085</code> — <code>T3DVCCalcMess.DataToXMLLite</code> (Schreibreihenfolge mit „### ACHTUNG ###", RTTI-Settings 3040-3049)
* <code>CAD\GLVCCalcMessBase.pas:2935-2985</code> — <code>InternalCreateFromXML</code> (MakroIDType/Nr/Name, CalcKind-Setter, CalcItemActive)
* <code>CAD\GLVCCalcMessBase.pas:2681-2933</code> — <code>InternalCreateComplexStructsFromXML</code> (Settings-Lesen, Listen-Blöcke, Name+NR-Pflicht 2873, Kind-Migration 2897-2918, GUID-Workaround 2760-2765)
* <code>CAD\GLVCCalcMessBase.pas:568-652</code> — <code>T3DVCBerechnungsItemListContainer.DataToXMLLite</code> (Kind-Elemente + Schreibbedingungen)
* <code>CAD\GLVCCalcMessBase.pas:445-483</code> — <code>T3DVCCalcMessItem.DataToXMLLite</code> (Member-Attribute GUID/RefGUID/Counter)
* <code>CAD\GLVCCalcMessBase.pas:44-49</code> — Enum <code>T3DVCBerechnungsItemListContainerKindBaseType</code>
* <code>CAD\GLCalcViewManager.pas:262-448</code> — <code>TCalcViewBaseObjekt</code> (published <code>Active</code>/<code>TextLayerID</code>) und CalcKind-spezifische <code>TCalcView…</code>-Klassen
* <code>VERMCAD\GlobalTypes.pas:397-441</code> — Enum <code>TCalcKind</code> (43 Werte)
* <code>VERMCAD\VCObjID.pas:11</code> — Enum <code>TMakroType</code>
* <code>VERMCAD\GlobalConsts.pas</code> — Tag-Konstanten <code>xn_CADVCCM*</code> (write_xn_CADVCCMListKind=False seit 28.01.2026)

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

CAD XML Syntax-Objekt VC CADText

2026-07-20T12:50:31Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADText}}
Der CAD-Text ist das allgemeine Textobjekt der CAD-Daten (Beschriftungen, Maßtexte, Berechnungs- und ALKIS-Präsentationstexte). Delphi-Klasse ist <code>T2DText</code> (<code>CAD\GLGeometrics.pas</code>), gespeichert unter dem XML-Tag <code>VC_CADText</code> innerhalb einer <code>VCCADDaten</code>-Sektion. Die Punktnummerntext-Varianten ([[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|VC_CADVCPNRText und Varianten]]) erben alle hier beschriebenen Elemente.

'''ACHTUNG — der Tag <code>VC_CADText</code> ist doppelt belegt:'''
# als '''Objekt-Wurzeltag''' des Textobjekts (Factory-Eintrag → <code>T2DText</code>), UND
# als '''Kind-Element für den Textinhalt''' INNERHALB des Objekts: <code><VC_CADText>mein Text</VC_CADText></code> (Reader-ID <code>xn_CADText_ID</code>).
Beim Zählen/Parsen von Objekten darf das innere Element nicht als eigenes Objekt gewertet werden (es steht als Kind unterhalb des Wurzelelements und enthält einen Textknoten statt eines <code>VermCadID</code>-Blocks). Das innere Element kommt in ALLEN Text-Objekttypen vor, auch in den PNRText-Varianten.

== Strukturregel ==
<pre>
<VC_CADText>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt = cadText)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[<Text_Referenzobjekt GUID="guid"/>] (praktisch Pflicht — Texte haben KEIN Position-Element)
[<Text_RefPktMoveX>zahl</Text_RefPktMoveX>]
[<Text_RefPktMoveY>zahl</Text_RefPktMoveY>]
[<Text_RefObjPkt>zahl zahl</Text_RefObjPkt>]
[<Text_VCBerTextKind>enum:TVCBerTextKind</Text_VCBerTextKind>]
<VC_CADText>text</VC_CADText> (der TEXTINHALT — gleicher Tag-Name wie das Wurzelelement!)
[<Text_Schriftart>text</Text_Schriftart>]
[<Text_Schriftschnitt>enum:TRotTextSchnitt</Text_Schriftschnitt>]
[<Text_Groesse>zahl</Text_Groesse>]
[<Text_Zeilenabstand>zahl</Text_Zeilenabstand>]
[<Text_Durchgestrichen>enum:TRotTextDurchgestrichen</Text_Durchgestrichen>]
[<Text_Rotation>ganzzahl</Text_Rotation>]
[<Text_Skalierung>ganzzahl</Text_Skalierung>]
[<Text_Unterstrichfarbe>ganzzahl</Text_Unterstrichfarbe>]
[<Text_Durchstrichfarbe>ganzzahl</Text_Durchstrichfarbe>]
[<Text_TextBuendigkeit>enum:TRotTextBuendigkeit</Text_TextBuendigkeit>]
[<Text_Unterstrichen>enum:TRotTextUnterstreichung</Text_Unterstrichen>]
[<Text_BezugsStrichGUID GUID="guid"/>]
[<Text_Drehwinkel>zahl</Text_Drehwinkel>]
[<Text_NieAufDemKopf>ganzzahl</Text_NieAufDemKopf>]
[<Text_AusrichtungRefLinieGUID GUID="guid"/>]
[<Text_AmRefObjAusrichten>ganzzahl</Text_AmRefObjAusrichten>]
[<Text_StrStauHor>zahl</Text_StrStauHor>]
[<Text_StrStauVert>zahl</Text_StrStauVert>]
[<Text_Rahmenform>enum:TRotTextRahmenForm</Text_Rahmenform>]
[<Text_RahmenDoppelt>ganzzahl</Text_RahmenDoppelt>]
[<Text_RahmenTransparent>ganzzahl</Text_RahmenTransparent>]
[<Text_RahmenHor>zahl</Text_RahmenHor>]
[<Text_RahmenVert>zahl</Text_RahmenVert>]
[<Text_Rahmenfarbe>ganzzahl</Text_Rahmenfarbe>]
[<Text_AusrichtungZumRefPkt>enum:TRotTextAusrichtungZumRefPkt</Text_AusrichtungZumRefPkt>]
[<Text_VersatzXZumRefPkt>zahl</Text_VersatzXZumRefPkt>]
[<Text_VersatzYZumRefPkt>zahl</Text_VersatzYZumRefPkt>]
[<Text_AusrichtungStil>enum:TRotTextAusrichtungStil</Text_AusrichtungStil>]
<Text_RissDaten> {<RissEintrag_ID> … </RissEintrag_ID>}* </Text_RissDaten>
</VC_CADText>
</pre>
Die Reihenfolge entspricht der Schreibreihenfolge in <code>T2DText.DataToXMLLite</code>. Der Container <code>Text_RissDaten</code> wird beim Speichern IMMER geschrieben — meist leer als <code><Text_RissDaten /></code> (Struktur: [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]]). Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]] und [[CAD XML Syntax-Basiselemente|Basiselemente]]; Werteformate (Float mit Dezimalpunkt, Bool = -1/0, GUID-Format): [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

== Elemente ==
Nur die eigenen Elemente von <code>T2DText</code>. Alle Defaults kommen aus dem Record <code>TTextData.Init</code> — geschrieben wird ein Element nur, wenn der Wert vom Initialwert abweicht; fehlt ein Element, gilt also der Initialwert (bei Darstellungsfeldern in der Regel „inherit/vom Textstil erben“). Floats mit dem Wert <code>NAN</code> werden beim Lesen ignoriert.

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>Text_Referenzobjekt</code> || GUID-Attribut-Element || praktisch ja || — || Referenz auf das Objekt, an dem der Text hängt (meist ein [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]], auch Linien). '''Texte haben kein eigenes <code>Position</code>-Element''' — die Position kommt immer vom Referenzobjekt (in den drei untersuchten Beispielprojekten existiert kein einziges Textobjekt ohne <code>Text_Referenzobjekt</code>)
|-
| <code>Text_RefPktMoveX</code> / <code>Text_RefPktMoveY</code> || zahl || nein || Init || Verschiebung des Texts relativ zum Referenzpunkt
|-
| <code>Text_RefObjPkt</code> || Pos-String 2D (<code>X Y</code>) || nein || Init-Punkt || fester Referenz-Objekt-Punkt
|-
| <code>Text_VCBerTextKind</code> || enum:TVCBerTextKind || nein || <code>TKBer_Ohne</code> || Kennzeichnung als Berechnungstext; Lesen über <code>StrToVCBerTextKind</code>, akzeptiert auch Legacy-Strings <code>ohne</code>/<code>gerechnet</code>/<code>gemessen</code>
|-
| <code>VC_CADText</code> (inneres Element) || text (auch mehrzeilig) || ja || '''' || '''der Textinhalt selbst''' — gleicher Tag-Name wie das Wurzelelement! Nur geschrieben, wenn <code>Trim ≠ ''</code>; Objekte mit leerem Text werden beim Speichern komplett verworfen
|-
| <code>Text_Schriftart</code> || text || nein || Init || Fontname
|-
| <code>Text_Schriftschnitt</code> || enum:TRotTextSchnitt || nein || Init || Schriftschnitt
|-
| <code>Text_Groesse</code> || zahl || nein || Init || Schriftgröße
|-
| <code>Text_Zeilenabstand</code> || zahl || nein || Init || Zeilenabstand
|-
| <code>Text_Durchgestrichen</code> || enum:TRotTextDurchgestrichen || nein || Init || Durchstreichung
|-
| <code>Text_Rotation</code> || ganzzahl || nein || Init || Rotation
|-
| <code>Text_Skalierung</code> || ganzzahl || nein || Init || Skalierung
|-
| <code>Text_Unterstrichfarbe</code> / <code>Text_Durchstrichfarbe</code> || ganzzahl (TColor) || nein || Init || Farben von Unter-/Durchstrich; Legacy-Lesen: <code>Text_UnterDurchstrichfarbe</code> (frühere gemeinsame Farbe) setzt BEIDE
|-
| <code>Text_TextBuendigkeit</code> || enum:TRotTextBuendigkeit || nein || Init || Textausrichtung (Bündigkeit)
|-
| <code>Text_Unterstrichen</code> || enum:TRotTextUnterstreichung || nein || Init || Unterstreichung/Oberstrich
|-
| <code>Text_BezugsStrichGUID</code> || GUID-Attribut-Element || nein || — || Bezugsstrich (Linie zum Text); nur geschrieben, wenn die Linie existiert und nicht gelöscht ist
|-
| <code>Text_Drehwinkel</code> || zahl || nein || Init || Drehwinkel des Texts
|-
| <code>Text_NieAufDemKopf</code> || ganzzahl (Bool/Inherit-kodiert) || nein || Init || Text nie kopfüber darstellen
|-
| <code>Text_AusrichtungRefLinieGUID</code> || GUID-Attribut-Element || nein || — || Ausrichtungs-Referenzlinie (T2DStartEndPunktLine); komplexe Schreibbedingung, siehe „Verfügbarkeit und Besonderheiten“
|-
| <code>Text_AmRefObjAusrichten</code> || ganzzahl (Bool/Inherit-kodiert) || nein || Init || am Referenzobjekt ausrichten
|-
| <code>Text_StrStauHor</code> / <code>Text_StrStauVert</code> || zahl || nein || Init || Streckung/Stauchung horizontal/vertikal; beim Lesen wird ein Fehlwert auf <code>PROPERTY_VALUE_INHERIT</code> gesetzt (Bugfix)
|-
| <code>Text_Rahmenform</code> || enum:TRotTextRahmenForm || nein || Init || Rahmen um den Text
|-
| <code>Text_RahmenDoppelt</code> / <code>Text_RahmenTransparent</code> || ganzzahl || nein || Init || Rahmenoptionen
|-
| <code>Text_RahmenHor</code> / <code>Text_RahmenVert</code> || zahl || nein || Init || Rahmengrößen horizontal/vertikal
|-
| <code>Text_Rahmenfarbe</code> || ganzzahl (TColor) || nein || Init || Rahmenfarbe
|-
| <code>Text_AusrichtungZumRefPkt</code> || enum:TRotTextAusrichtungZumRefPkt || nein || Init || Ankerpunkt des Texts relativ zum Referenzpunkt
|-
| <code>Text_VersatzXZumRefPkt</code> / <code>Text_VersatzYZumRefPkt</code> || zahl || nein || Init || Versatz in mm zum Referenzpunkt
|-
| <code>Text_AusrichtungStil</code> || enum:TRotTextAusrichtungStil || nein || Init || Ausrichtungsstil (VermCad- oder AutoCAD-Logik)
|-
| <code>Text_RissDaten</code> || Container || nein (wird aber immer geschrieben) || leer || rissabhängige Textwerte je Riss — Details: [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]]
|}

=== Die 8 Text-Enums (alle Werte, GetEnumName-Strings) ===
Alle Text-Enums werden per <code>GetEnumName</code>/<code>GetEnumValue</code> serialisiert; laut Quellcode-Kommentar dürfen die Namen nie geändert werden (<code>CAD\GLTypes.pas:1016-1018</code>).

{| class="wikitable"
! Enum !! Werte
|-
| <code>TVCBerTextKind</code> || <code>TKBer_Ohne</code>, <code>TKBer_Gerechnet</code>, <code>TKBer_Gemessen</code>
|-
| <code>TRotTextSchnitt</code> || <code>TS_inherit</code>, <code>TS_Standard</code>, <code>TS_Kursiv</code>, <code>TS_Fett</code>, <code>TS_FettKursiv</code>
|-
| <code>TRotTextDurchgestrichen</code> || <code>TD_inherit</code>, <code>TD_ohne</code>, <code>TD_einfach</code>, <code>TD_doppelt</code>
|-
| <code>TRotTextBuendigkeit</code> || <code>TB_inherit</code>, <code>TB_linksbuendig</code>, <code>TB_zentriert</code>, <code>TB_rechtsbuendig</code>
|-
| <code>TRotTextUnterstreichung</code> || <code>TU_inherit</code>, <code>TU_ohne</code>, <code>TU_einfach</code>, <code>TU_doppelt</code>, <code>TU_Oberstrich</code>
|-
| <code>TRotTextRahmenForm</code> || <code>TRF_inherit</code>, <code>TRF_Ohne</code>, <code>TRF_Rechteck</code>, <code>TRF_Kreis</code>, <code>TRF_Ellipse</code>
|-
| <code>TRotTextAusrichtungZumRefPkt</code> || <code>TARP_inherit</code>, <code>TARP_TopLeft</code>, <code>TARP_TopCenter</code>, <code>TARP_TopRight</code>, <code>TARP_CenterLeft</code>, <code>TARP_CenterCenter</code>, <code>TARP_CenterRight</code>, <code>TARP_BottomLeft</code>, <code>TARP_BottomCenter</code>, <code>TARP_BottomRight</code>
|-
| <code>TRotTextAusrichtungStil</code> || <code>TAS_inherit</code>, <code>TAS_VC</code>, <code>TAS_ACAD</code>
|}

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>Text_Referenzobjekt</code> || beliebiges CAD-Objekt (meist VC_CADPunkt, auch Linien) || praktisch ja (Texte haben nie eine eigene Position; alle Bestandsbeispiele besitzen die Referenz) || harte Referenz: fehlt das Zielobjekt endgültig, wird der Text beim Referenzen-Update als fehlerhaft markiert und '''zerstört''' (siehe [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]])
|-
| <code>Text_BezugsStrichGUID</code> || [[CAD XML Syntax-Objekt VC CADSimpleLine|VC_CADSimpleLine]] || nein || weiche Referenz: fehlendes Ziel wird ignoriert/geloggt, der Text bleibt bestehen
|-
| <code>Text_AusrichtungRefLinieGUID</code> || Linie mit Start-/Endpunkt (T2DStartEndPunktLine-Ableitung) || nein || weiche Referenz, wie oben
|}
Legacy: Beim Lesen wird zusätzlich der alte Tag <code>Text_Referenzpunkt</code> akzeptiert und wie <code>Text_Referenzobjekt</code> behandelt.

== Minimalform ==
<pre>
<VC_CADText>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Text_Referenzobjekt GUID="{XXXX…}" />
<VC_CADText>Mein Beschriftungstext</VC_CADText>
<Text_RissDaten />
</VC_CADText>
</pre>
<code>VermCadID</code> mit GUID, <code>Layer</code>, ein gültiges <code>Text_Referenzobjekt</code> und ein nicht-leerer Textinhalt sind das Minimum: leere Texte werden beim Speichern verworfen, Texte mit fehlendem Referenzobjekt beim Referenzen-Update zerstört (siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Beispiele ==
=== Beispiel (Baden-Württemberg) — Berechnungstext mit vollem Darstellungsblock ===
<pre>
<VC_CADText>
<VermCadID>
<GUID>{8D393017-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Sichtbar>0</Sichtbar>
<Farbe>2147483644</Farbe>
<Fuellfarbe>2147483644</Fuellfarbe>
<Alpha>2147483644</Alpha>
<Fuellalpha>2147483644</Fuellalpha>
<VCBerLayerID>-4500</VCBerLayerID>
<Layer>-4500</Layer>
<Linienstaerke>2147483644</Linienstaerke>
<LinienendenFreistellen>2147483644</LinienendenFreistellen>
<Liniensymbol>2147483644</Liniensymbol>
<Linienmuster>2147483644</Linienmuster>
<LineCloseType>2147483644</LineCloseType>
<TextStil>2147483644</TextStil>
<Textur>2147483644</Textur>
<SchraffurStil>2147483644</SchraffurStil>
<BoeschungsSchraffurStil>2147483644</BoeschungsSchraffurStil>
<Text_Referenzobjekt GUID="{2D4C3021-…}" />
<VC_CADText>Entfernung 1 (1)</VC_CADText>
<Text_Durchstrichfarbe>2147483644</Text_Durchstrichfarbe>
<Text_AusrichtungRefLinieGUID GUID="{B5605FBD-…}" />
<Text_AusrichtungZumRefPkt>TARP_TopRight</Text_AusrichtungZumRefPkt>
<Text_RissDaten />
</VC_CADText>
</pre>
Der Magic-Wert <code>2147483644</code> bedeutet „nicht gesetzt / vom Layer bzw. Stil erben“ (siehe [[CAD XML Syntax-Basiselemente|Basiselemente]]).

=== Beispiel (Baden-Württemberg) — ALKIS-Präsentationstext mit Drehwinkel und Stauchung ===
<pre>
<VC_CADText>
<VermCadID>
<GUID>{A6635B64-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<AlkisID>DEBWL00100087A03</AlkisID>
<Layer>-100900</Layer>
<Text_Referenzobjekt GUID="{E53D059B-…}" />
<VC_CADText>$PTO_PRAESO_TEXT$</VC_CADText>
<Text_Drehwinkel>349.000001697572</Text_Drehwinkel>
<Text_StrStauHor>1</Text_StrStauHor>
<Text_StrStauVert>1</Text_StrStauVert>
<Text_AusrichtungZumRefPkt>TARP_CenterCenter</Text_AusrichtungZumRefPkt>
<Text_RissDaten />
</VC_CADText>
</pre>

=== Beispiel (Sachsen) — Maßtext mit Durchstreichung und Referenzlinien-Ausrichtung ===
<pre>
<VC_CADText>
<VermCadID>
<GUID>{5293E2D7-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadText</CADObjektArt>
</VermCadID>
<Farbe>2147483644</Farbe>
<Fuellfarbe>2147483644</Fuellfarbe>
<Alpha>2147483644</Alpha>
<Fuellalpha>2147483644</Fuellalpha>
<VCBerLayerID>-6205</VCBerLayerID>
<Layer>-6205</Layer>
<Linienstaerke>2147483644</Linienstaerke>
<LinienendenFreistellen>2147483644</LinienendenFreistellen>
<Liniensymbol>2147483644</Liniensymbol>
<Linienmuster>2147483644</Linienmuster>
<LineCloseType>2147483644</LineCloseType>
<TextStil>2147483644</TextStil>
<Textur>2147483644</Textur>
<SchraffurStil>2147483644</SchraffurStil>
<BoeschungsSchraffurStil>2147483644</BoeschungsSchraffurStil>
<Text_Referenzobjekt GUID="{CBA75FC8-…}" />
<VC_CADText>$4.470$</VC_CADText>
<Text_Durchgestrichen>TD_ohne</Text_Durchgestrichen>
<Text_Drehwinkel>100</Text_Drehwinkel>
<Text_AusrichtungRefLinieGUID GUID="{F633B31F-…}" />
<Text_AusrichtungZumRefPkt>TARP_CenterLeft</Text_AusrichtungZumRefPkt>
<Text_RissDaten />
</VC_CADText>
</pre>
Reale Textinhalte in den Beispielprojekten: Platzhalter <code>#TEXTVONTEXTSTIL</code>, Maßtexte in <code>$…$</code>-Form (<code>$36.33$</code>, <code>$4.470$</code>), <code>$PTO_PRAESO_TEXT$</code>, Klartext (<code>Entfernung 1 (1)</code>).

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen.
* '''Doppelter Tag''': <code>VC_CADText</code> ist Wurzeltag UND inneres Textinhalts-Element (siehe Einleitung). Beim Zählen mit Werkzeugen (z. B. grep) liefert der Tag daher deutlich mehr Treffer als es Textobjekte gibt.
* '''Leere Texte''' werden beim Speichern nicht geschrieben (Manager-Filter) — ein Erzeuger muss immer einen nicht-leeren Textinhalt setzen.
* '''Legacy-Aliase (nur Lesen)''': <code>Text_Referenzpunkt</code> → wie <code>Text_Referenzobjekt</code>; <code>Text_UnterDurchstrichfarbe</code> (alte gemeinsame Farbe) → setzt <code>Text_Unterstrichfarbe</code> UND <code>Text_Durchstrichfarbe</code>.
* '''Schreibbedingung <code>Text_AusrichtungRefLinieGUID</code>''' (Bugfix 01/2022, „Ausrichtung Referenzlinie ging in Rissen verloren“): geschrieben wird die GUID, wenn (a) die Referenz noch nicht aufgelöst wurde (DoCheck aktiv), oder (b) die Ausrichtung aktiv „ENTFERNT“ wurde — dann wird die spezielle NOTHING-GUID <code>{AD59FD8E-A1B2-40E8-B2E3-199A7F3E7F89}</code> (<code>MisGUIDString</code>/<code>PROPERTY_GUID_VALUE_NOTHING</code>) geschrieben, oder (c) eine gültige, nicht gelöschte Referenzlinie existiert.
* <code>Text_StrStauHor</code>/<code>Text_StrStauVert</code>: Fehlwert beim Lesen → <code>PROPERTY_VALUE_INHERIT</code> (Bugfix).
* Floats mit Wert <code>NAN</code> werden beim Lesen ignoriert.
* In den Beispielprojekten zusätzlich real belegt: <code>Text_AmRefObjAusrichten</code>, <code>Text_BezugsStrichGUID</code>, <code>Text_TextBuendigkeit</code>, <code>Text_VCBerTextKind</code>, <code>Text_RefPktMoveX/Y</code> (nur Sachsen).

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:49221-49514</code> — <code>T2DText.DataToXMLLite</code> (Schreibreihenfolge, Init-Vergleich gegen <code>TTextData.Init</code>)
* <code>CAD\GLGeometrics.pas:49068-49218</code> — <code>InternalCreateFromXML</code> (einfache Werte, Legacy <code>Text_UnterDurchstrichfarbe</code>, NAN-Behandlung, StrStau-Bugfix)
* <code>CAD\GLGeometrics.pas:49017-49066</code> — <code>InternalCreateComplexStructsFromXML</code> (Referenzobjekt inkl. Legacy <code>Text_Referenzpunkt</code>, BezugsStrich, AusrichtungRefLinie, RissDaten)
* <code>CAD\GLGeometrics.pas:49369-49418</code> — Schreibbedingung <code>Text_AusrichtungRefLinieGUID</code> inkl. NOTHING-GUID
* <code>CAD\GLGeometrics.pas:47496-47628</code> — <code>T2DTextRissValueList.DataToXMLLite</code> (Text_RissDaten)
* <code>CAD\GLTypes.pas:1014-1097</code> — die 8 Text-Enums (TRotText*/TVCBerTextKind)
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten (<code>xn_Txt*</code>, <code>xn_CADText</code>); <code>GlobalConsts.pas:1965</code> — <code>MisGUIDString</code>
* <code>CAD\GLConsts.pas:454</code> — <code>PROPERTY_GUID_VALUE_NOTHING</code>
* <code>VERMCAD\GlobalStaticMethods.pas:3122-3141</code> (<code>GLStaticMethods</code>) — <code>StrToVCBerTextKind</code> (Legacy-Strings)
* <code>CAD\GLGeometrics.pas:79982</code> — leere Texte werden nicht gespeichert

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

CAD XML Syntax-Objekt VC CADSimpleLine

2026-07-20T12:50:30Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADSimpleLine}}
Die einfache Linie (Gerade zwischen zwei Punkten) ist das häufigste Linienobjekt der CAD-Daten. Delphi-Klasse ist <code>T2DSimpleLine</code> (<code>CAD\GLGeometrics.pas</code>), gespeichert unter dem XML-Tag <code>VC_CADSimpleLine</code>. Die Klasse selbst hat '''keine eigenen XML-Elemente''' — sie erbt alles von den abstrakten Zwischenklassen <code>T2DLine</code> und <code>T2DStartEndPunktLine</code>, die kein eigenes Wurzeltag besitzen. Deren Elemente sind deshalb '''auf dieser Seite''' dokumentiert; die übrigen Linienseiten ([[CAD XML Syntax-Objekt VC CADMeteredSimpleLine|VC_CADMeteredSimpleLine]], [[CAD XML Syntax-Objekt VC CADArcLine|VC_CADArcLine]], [[CAD XML Syntax-Objekt VC CADKlotoide|Klotoiden]]) verweisen hierauf.

== Strukturregel ==
<pre>
<VC_CADSimpleLine>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadLinie)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[<RichtungInvertiert>bool</RichtungInvertiert>] (T2DLine)
[<VerbundIdentischerLinien>bool</VerbundIdentischerLinien>] (T2DLine)
<Startpunkt GUID="guid"/> (T2DStartEndPunktLine — Pflicht)
<Endpunkt GUID="guid"/> (T2DStartEndPunktLine — Pflicht)
[<LaengeGemessen>zahl</LaengeGemessen>]
[<VerlaengerungAmStartpunkt>zahl</VerlaengerungAmStartpunkt>]
[<VerlaengerungAmEndpunkt>zahl</VerlaengerungAmEndpunkt>]
</VC_CADSimpleLine>
</pre>
Die Reihenfolge entspricht der Schreibkette <code>T3DBaseObject → T2DLine → T2DStartEndPunktLine</code>: die beiden <code>T2DLine</code>-Elemente stehen vor <code>Startpunkt</code>/<code>Endpunkt</code>. Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]] und [[CAD XML Syntax-Basiselemente|Basiselemente]]; Zahlen-/GUID-Formate: [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

== Elemente ==
Elemente der Zwischenklassen <code>T2DLine</code> und <code>T2DStartEndPunktLine</code> (gelten für alle davon abgeleiteten Linien):

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>RichtungInvertiert</code> || bool || nein || False || Linienrichtung invertiert (T2DLine)
|-
| <code>VerbundIdentischerLinien</code> || bool || nein || '''True''' || Darstellung im Verbund trotz identischer Linien; wird nur geschrieben, wenn der Wert False ist (T2DLine)
|-
| <code>Startpunkt</code> || GUID-Attribut-Element || '''ja''' || — || Referenz auf den Start-[[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]]
|-
| <code>Endpunkt</code> || GUID-Attribut-Element || '''ja''' || — || Referenz auf den End-[[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]]
|-
| <code>LaengeGemessen</code> || Float || nein || 0.0 || manuell gemessene Länge
|-
| <code>VerlaengerungAmStartpunkt</code> || Float || nein || 0.0 || optische Verlängerung über den Startpunkt hinaus
|-
| <code>VerlaengerungAmEndpunkt</code> || Float || nein || 0.0 || optische Verlängerung über den Endpunkt hinaus
|}

<code>T2DSimpleLine</code> selbst fügt keine weiteren Elemente hinzu — die Objektart ergibt sich allein aus dem Wurzeltag.

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>Startpunkt</code> || VC_CADPunkt || ja || harte Referenz: fehlt die GUID oder ist das Ziel nach dem LastTry des Referenzen-Updates nicht auffindbar, wird die Linie mit Logeintrag „Objekt wird nicht eingelesen" '''zerstört'''
|-
| <code>Endpunkt</code> || VC_CADPunkt || ja || wie Startpunkt
|}
Beim Lesen landen die GUIDs zunächst in Merk-Feldern (<code>FSPGUID</code>/<code>FEPGUID</code>); die Auflösung zu Objektzeigern geschieht erst nach dem Einlesen ALLER Objekte im Referenzen-Update des Managers (Wiederholungsschleife mit LastTry, siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Minimalform ==
<pre>
<VC_CADSimpleLine>
<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_CADSimpleLine>
</pre>
Beide Punkt-GUIDs müssen auf existierende <code>VC_CADPunkt</code>-Objekte in derselben Datei zeigen — sonst wird die Linie nach dem LastTry zerstört.

== Beispiele ==
=== Minimalfall (echtes Beispiel — reine Topologie) ===
<pre>
<VC_CADSimpleLine>
<VermCadID>
<GUID>{FB786524-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Startpunkt GUID="{5E840B97-…}" />
<Endpunkt GUID="{4B8E94CA-…}" />
</VC_CADSimpleLine>
</pre>

=== Reiches Exemplar (echtes Beispiel — voller Linien-Darstellungsblock) ===
<pre>
<VC_CADSimpleLine>
<VermCadID>
<GUID>{E7EF1789-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Farbe>2147483644</Farbe>
<Alpha>2147483644</Alpha>
<VCBerLayerID>-5704</VCBerLayerID>
<Layer>-5704</Layer>
<LayerErben>-1</LayerErben>
<Linienstaerke>2147483644</Linienstaerke>
<LinienendenFreistellen>2147483644</LinienendenFreistellen>
<Liniensymbol>2147483644</Liniensymbol>
<Linienmuster>2147483644</Linienmuster>
<LineCloseType>2147483644</LineCloseType>
<Startpunkt GUID="{7ADD6286-…}" />
<Endpunkt GUID="{99443D76-…}" />
</VC_CADSimpleLine>
</pre>
Alle Stil-Elemente sind [[CAD XML Syntax-Basiselemente|Basiselemente]]; <code>2147483644</code> = „vom Layer erben". In den Beispielprojekten kommt <code>LineCloseType</code> nur mit den Werten <code>1</code> oder <code>2147483644</code> vor, <code>Linienmuster</code>/<code>Liniensymbol</code> ausschließlich mit <code>2147483644</code>.

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen (Factory-Eintrag ohne IFDEF).
* Belegt in allen drei Beispielprojekten: BW 5.050, Sachsen 53.743, Thüringen 9.069 Exemplare — das mit Abstand häufigste Linienobjekt.
* Keine Legacy-Aliase an dieser Klasse.
* Die Enden der Linie sind eigenständige <code>VC_CADPunkt</code>-Objekte (meist <code>PunktQualitaet=pqHelp</code>) — eine Linie ohne ihre beiden Punkte ist nicht ladbar.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:1735, 1813, 1929</code> — Klassendeklarationen <code>T2DLine</code>, <code>T2DStartEndPunktLine</code>, <code>T2DSimpleLine</code>
* <code>CAD\GLGeometrics.pas:32670-32702</code> — <code>T2DLine.DataToXMLLite</code> (RichtungInvertiert, VerbundIdentischerLinien)
* <code>CAD\GLGeometrics.pas:34503-34564</code> — <code>T2DStartEndPunktLine.DataToXMLLite</code> (Startpunkt, Endpunkt, LaengeGemessen, Verlängerungen)
* <code>CAD\GLGeometrics.pas:34473-34500</code> — <code>InternalCreateComplexStructsFromXML</code> (GUID-Attribute → FSPGUID/FEPGUID)
* <code>CAD\GLGeometrics.pas:36651-36710</code> — <code>SetReferencesAndUpdate</code> („Objekt wird nicht eingelesen" bei fehlender SP/EP-Referenz)
* <code>CAD\GLGeometrics.pas:96996-97034</code> — Factory-Registrierung des Wurzeltags
* <code>CAD\GLConsts.pas:513-583</code> — Init-Werte (<code>INIT_T2DLINE_*</code>)

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

CAD XML Syntax-Objekt VC CADPunktsymbol

2026-07-20T12:50:29Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADPunktsymbol}}
Das Punktsymbol ist die Darstellungs-Instanz eines Symbols an einem CAD-Punkt (Symbolzuordnung, Drehwinkel, Skalierung). Delphi-Klasse ist <code>T3DPointSymbol</code> (<code>CAD\GLGeometrics.pas</code>), gespeichert unter dem XML-Tag <code>VC_CADPunktsymbol</code>. Es hat keine eigene Position — es hängt immer an einem [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]], der es über <code>PointSymbolGUID</code> bzw. <code>WeitereSymbole</code> referenziert.

'''Achtung Tag-Namen:''' Vier Elemente tragen im XML wörtlich das Präfix <code>xn_</code> (<code>xn_SymbolDrehwinkel</code>, <code>xn_SymbolSkalierung</code>, <code>xn_SymbolMitCADRotieren</code>, <code>xn_HilfsPunktSymbol</code>) — der Konstanten-Präfix wurde bei nachträglich ergänzten Feldern versehentlich Teil des Tag-Strings und ist persistent. Ein Erzeuger muss diese Namen exakt so schreiben.

== Strukturregel ==
<pre>
<VC_CADPunktsymbol>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt = cadPunktsymbol)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[<SymbolID>guid</SymbolID>] (GUID als ELEMENTTEXT, kein Attribut!)
[<SymbolName>text</SymbolName>] (nur zusammen mit SymbolID)
[<xn_SymbolDrehwinkel>ganzzahl</xn_SymbolDrehwinkel>]
[<xn_SymbolSkalierung>zahl</xn_SymbolSkalierung>]
[<xn_SymbolMitCADRotieren>ganzzahl</xn_SymbolMitCADRotieren>]
[<xn_HilfsPunktSymbol>bool</xn_HilfsPunktSymbol>]
[<PunktSymbolRefLinieGUID GUID="guid"/>]
</VC_CADPunktsymbol>
</pre>
Werteformate: [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]] (Bool = -1/0, Float mit Dezimalpunkt, GUID mit geschweiften Klammern).

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

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>SymbolID</code> || guid als '''Elementtext''' || nein || „Inherited" (kein individuelles Symbol) || ID der Symbol-Definition im Symbolmanager (<code>GUIDToString</code>). Nur geschrieben, wenn dem Punktsymbol ein individuelles Symbol zugeordnet ist (<code>FPunktSymbolIDType ≠ psgtInherited</code>, Enum <code>TPunktSymbolGUIDType</code>: <code>psgtInherited</code>, <code>psgtFromLayer</code>, <code>psgtFromNothing</code>, <code>psgtFromInvisible</code>, <code>psgtOther</code>); fehlt das Element, wird das Symbol aus Layer/Punktzuordnung geerbt.
|-
| <code>SymbolName</code> || Text || nein || — || Symbolname als Lese-Fallback; wird nur zusammen mit <code>SymbolID</code> geschrieben, wenn das Symbol im Symbolmanager gefunden wurde
|-
| <code>xn_SymbolDrehwinkel</code> || ganzzahl || nein || 0 || Drehwinkel des Symbols (Beispieldaten in gon, z. B. <code>300</code>)
|-
| <code>xn_SymbolSkalierung</code> || zahl (Float) || nein || <code>PROPERTY_VALUE_INHERIT</code> (2147483645 = erben) || Skalierungsfaktor; Plausibilitäts-Check beim Lesen: Werte > 1E6 oder < CADZero werden auf 1 gesetzt
|-
| <code>xn_SymbolMitCADRotieren</code> || ganzzahl (Int-kodiertes Bool/Inherit) || nein || <code>PROPERTY_VALUE_INHERIT</code> || Symbol rotiert mit der CAD-Ansicht mit (-1/0/Inherit-Magic-Wert)
|-
| <code>xn_HilfsPunktSymbol</code> || bool || nein || False || Kennzeichen Hilfssymbol (nur geschrieben, wenn True = <code>-1</code>)
|-
| <code>PunktSymbolRefLinieGUID</code> || GUID-Attribut-Element || nein || — || Referenzlinie zur Symbolausrichtung; nur geschrieben, wenn die Linie existiert und nicht gelöscht ist
|}

Magic-Werte (<code>2147483645</code> = erben u. a.): siehe [[CAD XML Syntax-Basiselemente|Basiselemente]].

=== Symboldatei (Root VCSymbol) ===
<code>SymbolID</code> verweist NICHT auf ein CAD-Objekt der Projekt-XML, sondern auf eine Symbol-Definition des Symbolmanagers. Symbol-Definitionen liegen in separaten Symbol-Dateien mit dem Wurzelelement <code>VCSymbol</code> (Konstante <code>xn_SymbolRoot</code>, <code>VERMCAD\GlobalConsts.pas</code>). Der Aufbau dieser Symboldateien ist nicht Teil der Projekt-XML-Syntax und wird hier nicht dokumentiert.

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>SymbolID</code> || Symbol-Definition im Symbolmanager (keine Projekt-GUID) || nein || '''Selbstheilung''': Ist die SymbolID im Symbolmanager unbekannt, wird das Symbol im PostProcessing über <code>SymbolName</code> gesucht; sonst nur Log-Meldung
|-
| <code>PunktSymbolRefLinieGUID</code> || Linienobjekt (z. B. [[CAD XML Syntax-Objekt VC CADSimpleLine|VC_CADSimpleLine]]) || nein || weiche Referenz: fehlendes Ziel wird geloggt/ignoriert
|}
'''Rückverweis-Pflicht:''' Die Verknüpfung Symbol → Punkt läuft ausschließlich rückwärts über den Punkt (<code>PointSymbolGUID</code>/<code>WeitereSymbole</code> am [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]]). Ein Punktsymbol '''ohne referenzierenden Punkt wird beim Speichern übersprungen''' — ein Erzeuger muss also immer das Paar Punkt + Symbol mit passender GUID-Referenz schreiben (Schreibreihenfolge Punkte → Symbole, siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Minimalform ==
<pre>
<VC_CADPunktsymbol>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunktsymbol</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
</VC_CADPunktsymbol>
</pre>
Dazu MUSS ein <code>VC_CADPunkt</code> existieren, dessen <code><PointSymbolGUID GUID="{XXXXXXXX-…}"/></code> auf diese GUID zeigt (sonst geht das Symbol beim nächsten Speichern verloren). Ohne <code>SymbolID</code> gilt das Symbol als „geerbt" aus Layer/Punktzuordnung.

== Beispiele ==
=== Minimalfall (Baden-Württemberg, geerbtes Symbol) ===
<pre>
<VC_CADPunktsymbol>
<VermCadID>
<GUID>{A8653A46-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunktsymbol</CADObjektArt>
</VermCadID>
<Layer>-100900</Layer>
</VC_CADPunktsymbol>
</pre>

=== Reiches Beispiel (Baden-Württemberg) — individuelles Symbol mit Drehwinkel und Referenzlinie ===
<pre>
<VC_CADPunktsymbol>
<VermCadID>
<GUID>{95BBC564-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunktsymbol</CADObjektArt>
</VermCadID>
<Layer>-5212</Layer>
<SymbolID>{8CF9FB44-…}</SymbolID>
<xn_SymbolDrehwinkel>300</xn_SymbolDrehwinkel>
<PunktSymbolRefLinieGUID GUID="{FA2BB7DC-…}" />
</VC_CADPunktsymbol>
</pre>
Beachte: <code>SymbolID</code> trägt die GUID als Elementtext, <code>PunktSymbolRefLinieGUID</code> dagegen als <code>GUID</code>-Attribut.

=== Beispiel (Sachsen) — Hilfssymbol ===
In der Sachsen-Beispieldatei ist <code>xn_HilfsPunktSymbol</code> 7.051-mal belegt (immer <code>-1</code> = True), z. B.:
<pre>
<VC_CADPunktsymbol>
<VermCadID>
<GUID>{XXXXXXXX-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunktsymbol</CADObjektArt>
</VermCadID>
<Layer>-100850</Layer>
<xn_HilfsPunktSymbol>-1</xn_HilfsPunktSymbol>
</VC_CADPunktsymbol>
</pre>
(GUIDs gekürzt; Feldkombination gemäß belegten Vorkommen konstruiert, auch <code>xn_SymbolSkalierung</code> ist in Sachsen belegt.)

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen; in den Beispielprojekten existiert praktisch zu jedem Punkt (mindestens) ein Punktsymbol.
* '''Legacy-Tag <code>xn_SymbolNummer</code>''' (Tag-String ebenfalls wörtlich mit <code>xn_</code>-Präfix): alte Integer-Symbolnummer aus der Zeit vor der GUID-Umstellung; wird nur noch gelesen und über <code>GetSymbolIDByOldSymbolnummer</code> in eine Symbol-GUID gewandelt (Werte ≤ 0/Fehlwert → „Inherited").
* '''PostProcessing''': Unbekannte <code>SymbolID</code> → Suche über <code>SymbolName</code> (Selbstheilung); schlägt auch das fehl, bleibt das Objekt mit Log-Meldung bestehen.
* In sehr alten Projekten lagen die Symbolfelder direkt am Punkt; <code>T3DPoint</code> reicht unbekannte Tags deshalb beim Lesen an sein PointSymbol weiter (Migration, siehe [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]]).
* Symbole werden im Manager direkt nach den Punkten geschrieben (Objektgruppen-Reihenfolge, siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:30535-30602</code> — <code>T3DPointSymbol.DataToXMLLite</code> (Bedingungen, Elementtext vs. Attribut)
* <code>CAD\GLGeometrics.pas:31059-31110</code> — <code>InternalCreateFromXML</code> (inkl. Legacy <code>xn_SymbolNummer</code>, Skalierungs-Plausi)
* <code>CAD\GLGeometrics.pas:31147-31174</code> — <code>InternalCreateComplexStructsFromXML</code> (PunktSymbolRefLinieGUID)
* <code>CAD\GLGeometrics.pas:31112-31145</code> — PostProcessing (Selbstheilung über SymbolName)
* <code>CAD\GLGeometrics.pas:26344-26394</code> — <code>SetReferencesAndUpdate</code> (Rückverknüpfung Punkt → Symbol)
* <code>CAD\GLGeometrics.pas:79712</code> — Symbole ohne ReferenzPoint werden beim Speichern übersprungen
* <code>CAD\GLTypes.pas:990</code> — <code>TPunktSymbolGUIDType</code>; <code>CAD\GLConsts.pas:500-503</code> — Init-Werte der Symbolfelder
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten (inkl. wörtlicher <code>xn_</code>-Präfixe und <code>xn_SymbolRoot</code> = <code>VCSymbol</code>)

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

CAD XML Syntax-Objekt VC CADPunkt

2026-07-20T12:50:28Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADPunkt}}
Der CAD-Punkt ist das Grundobjekt der CAD-Daten: Träger von Koordinaten, Punktqualität und (bei VC-Punkten) der Punktnummer. Delphi-Klasse ist <code>T3DPoint</code> (<code>CAD\GLGeometrics.pas</code>), gespeichert unter dem XML-Tag <code>VC_CADPunkt</code> innerhalb einer <code>VCCADDaten</code>-Sektion. Fast alle anderen Objekte (Linien, Texte, Symbole, Flächen) referenzieren Punkte über deren GUID.

== Strukturregel ==
<pre>
<VC_CADPunkt>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; bei VC-Punktnummer
zusätzlich VCPktID_NV + VCPktID_NR)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[<Verankert>bool</Verankert>]
[<PunktQualitaet>enum:TPointQualType</PunktQualitaet>]
[<VCPktArtTransferActivated>bool</VCPktArtTransferActivated>]
[<VCPktArtTransferForce>bool</VCPktArtTransferForce>]
[<VCPktArtTransfer>enum:TAZ_Punktobjekt | leer</VCPktArtTransfer>]
[<PktNrTextType>enum:TPktNrTextType</PktNrTextType>]
[<VCPktSiblTransferedConnected>enum:TVCPktSiblTransferedConnected</VCPktSiblTransferedConnected>]
[<VerwendungsStatus>enum:TPktBenutzPart</VerwendungsStatus>]
<Position>
<gml:Point>
<gml:pos>zahl zahl [zahl]</gml:pos> (X Y [Z]; ECHTE Koordinaten, keine Riss-Deltas)
</gml:Point>
[<OriginalCADPos>zahl zahl [zahl]</OriginalCADPos>]
</Position>
[<PointSymbolGUID GUID="guid"/>]
[<WeitereSymbole>
{<WeitereSymboleMember GUID="guid"/>}* </WeitereSymbole>]
<RissKoordinaten> {<RissEintrag_ID>zahl zahl zahl</RissEintrag_ID>}* </RissKoordinaten>
<RissPktNrTextType> {<RissEintrag_ID>enum:TPktNrTextType</RissEintrag_ID>}* </RissPktNrTextType>
</VC_CADPunkt>
</pre>
Die Reihenfolge entspricht der Schreibreihenfolge in <code>T3DPoint.DataToXMLLite</code>. Die Container <code>RissKoordinaten</code>/<code>RissPktNrTextType</code> werden beim Speichern IMMER geschrieben — meist leer als <code><RissKoordinaten /></code> — dürfen beim Erzeugen aber auch fehlen. Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]] und [[CAD XML Syntax-Basiselemente|Basiselemente]]; Werteformate (Float mit Dezimalpunkt, Bool = -1/0, gml:pos): [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

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

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>Verankert</code> || bool || nein || False || Punkt ist verankert (nicht verschiebbar)
|-
| <code>PunktQualitaet</code> || enum:TPointQualType || praktisch ja || <code>pqConst</code> (Init) || Punktqualität; da der Init-Wert die Konstruktionsphase bezeichnet, steht das Element an praktisch jedem realen Punkt
|-
| <code>VCPktArtTransferActivated</code> || bool || nein || False || Punktart-Transfer aktiv
|-
| <code>VCPktArtTransferForce</code> || bool || nein || False || Punktart-Transfer erzwingen
|-
| <code>VCPktArtTransfer</code> || Enum-Name aus TAZ_Punktobjekt ODER leer || nein || <code>cVCPktArtTransferNone</code> (nicht geschrieben) || Ziel-Punktart des Transfers. Sonderfall: „Inherited" wird als '''leeres Element''' <code><VCPktArtTransfer /></code> gespeichert; beim Lesen wird der Name über <code>GetAlkisObjektByName</code> aufgelöst, leer/unbekannt → Inherited. Wertebereich = ALKIS-Punktobjekt-Typen (Teilbereich <code>ZAX_Grenzpunkt</code> … <code>ZSD_Erhebungspunkt</code> der Enum <code>TAZ_AlkisObjekte</code>, <code>Alkis\AlkisTypes.pas:467</code>)
|-
| <code>PktNrTextType</code> || enum:TPktNrTextType || nein || <code>TT_INHERITED</code> || Art des Punktnummern-Texts; beim Schreiben wird <code>TT_NVNR</code> → <code>TT_NR</code> gewandelt, wenn die Bundesland-Version keine NV/GV-Nummern nutzt (<code>USE_NV_OR_GV</code> aus)
|-
| <code>VCPktSiblTransferedConnected</code> || enum:TVCPktSiblTransferedConnected || nein || <code>vcpstc_None</code> || Zwillings-Übertragungsstatus
|-
| <code>VerwendungsStatus</code> || enum:TPktBenutzPart || nein || <code>pb_None</code> || Verwendungsstatus des VC-Punkts; nur geschrieben, wenn der Punkt eine VCPktID hat und der Status ≠ <code>pb_None</code> ist (Feld seit 09/2023 am CAD-Punkt)
|-
| <code>Position</code> || Container || ja || — || enthält <code>gml:Point/gml:pos</code>; ohne gültige Position bleiben die Koordinaten Fehlwert und der Punkt wird beim '''nächsten Speichern verworfen'''
|-
| <code>gml:pos</code> || <code>X Y [Z]</code> (Floats, leerzeichengetrennt) || ja || — || echte Koordinaten (<code>FCoords</code>, keine Riss-Deltas); Z nur, wenn kein Fehlwert; Fehlwert-Koordinaten werden als Fehlwert-Zahl geschrieben
|-
| <code>OriginalCADPos</code> || <code>X Y [Z]</code> || nein || — || ursprüngliche CAD-Position vor dem Punktart-Transfer; steht INNERHALB von <code>Position</code> (nach <code></gml:Point></code>); nur wenn Transfer aktiv und Original ≠ aktuelle 2D-Koordinate
|-
| <code>PointSymbolGUID</code> || GUID-Attribut-Element || nein || — || Referenz auf das Haupt-[[CAD XML Syntax-Objekt VC CADPunktsymbol|VC_CADPunktsymbol]] des Punkts
|-
| <code>WeitereSymbole</code> || Container mit <code><WeitereSymboleMember GUID="{…}"/></code> (0..n) || nein || leer || weitere Punktsymbol-Objekte desselben Punkts
|-
| <code>RissKoordinaten</code> || Container, je Riss <code><RissEintrag_ID>dX dY dZ</RissEintrag_ID></code> || nein (wird aber immer geschrieben) || leer || rissabhängige Koordinaten-'''Deltas''' zur Standardposition; Eintrag nur, wenn mind. ein Delta ≠ 0/Fehlwert
|-
| <code>RissPktNrTextType</code> || Container, je Riss <code><RissEintrag_ID>enum:TPktNrTextType</RissEintrag_ID></code> || nein (wird aber immer geschrieben) || leer || rissabhängiger PNR-Text-Typ; Eintrag nur ≠ <code>TT_UNDEFINED</code>
|}

Die Punktnummer selbst (<code>VCPktID_NV</code>/<code>VCPktID_NR</code>) steht im [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]]; eine gültige VC-Punktnummer verlangt NV ≠ '' UND NR ≠ ''.

=== Enum TPointQualType (alle Werte) ===
{| class="wikitable"
! Wert !! Bedeutung
|-
| <code>pqExtern</code> || externes Objekt: VermCad-Punkt, ALKIS-Punkt, Messgerät
|-
| <code>pqCAD</code> || als Punkt gezeichnetes CAD-Objekt
|-
| <code>pqHelp</code> || Nicht-Punkte (z. B. Linienenden, ALKIS-Repräsentanten)
|-
| <code>pqOnlyFang</code> || reine Fangpunkte
|-
| <code>pqConst</code> || Konstruktionsphase (Init-Wert — wird nicht geschrieben)
|-
| <code>pqTemp</code> || temporär
|}

=== 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>.

=== Enum TVCPktSiblTransferedConnected (alle Werte) ===
<code>vcpstc_None</code>, <code>vcpstc_AutoToNP</code>, <code>vcpstc_ToGoDown</code>, <code>vcpstc_ToNotGoDown</code>.

=== Enum TPktBenutzPart (alle Werte) ===
<code>pb_None</code>, <code>pb_SollUnused</code>, <code>pb_SollUsed</code>, <code>pb_ChangedKoord</code>, <code>pb_Changed</code>, <code>pb_New</code>, <code>pb_Deleted</code>, <code>pb_DeletedZwilling</code>.

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>PointSymbolGUID</code> || [[CAD XML Syntax-Objekt VC CADPunktsymbol|VC_CADPunktsymbol]] || nein || weiche Referenz: fehlendes Ziel wird nur geloggt/ignoriert, der Punkt bleibt bestehen
|-
| <code>WeitereSymboleMember</code> || VC_CADPunktsymbol (0..n) || nein || weiche Referenz, wie oben
|}
Umgekehrt ist der Punkt selbst Ziel harter Referenzen (Startpunkt/Endpunkt von Linien, Member von Kompos, Text_Referenzobjekt …) — fehlt der Punkt, wird das '''referenzierende''' Objekt beim Referenzen-Update zerstört (siehe [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]]).

== Minimalform ==
<pre>
<VC_CADPunkt>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<PunktQualitaet>pqCAD</PunktQualitaet>
<Position>
<gml:Point>
<gml:pos>545123.456 5721456.789</gml:pos>
</gml:Point>
</Position>
</VC_CADPunkt>
</pre>
<code>VermCadID</code> mit GUID, <code>Layer</code> und eine gültige <code>Position</code> sind das Minimum fürs korrekte Laden; Punkte mit Fehlwert-Koordinaten werden beim nächsten Speichern verworfen (siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Beispiele ==
=== Minimalfall (Baden-Württemberg, häufigster Fall — ALKIS-Repräsentant) ===
<pre>
<VC_CADPunkt>
<VermCadID>
<GUID>{AEFE2E5B-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>
<Layer>-100780</Layer>
<PunktQualitaet>pqHelp</PunktQualitaet>
<Position>
<gml:Point>
<gml:pos>32519146.78 5308557.85</gml:pos>
</gml:Point>
</Position>
<PointSymbolGUID GUID="{9AB3B261-…}" />
<RissKoordinaten />
<RissPktNrTextType />
</VC_CADPunkt>
</pre>

=== Beispiel (Sachsen) — VC-Punkt mit Punktnummer, VerwendungsStatus und WeitereSymbole ===
<pre>
<VC_CADPunkt>
<VermCadID>
<GUID>{6083B9B4-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
<VCPktID_NV>10</VCPktID_NV>
<VCPktID_NR>56</VCPktID_NR>
</VermCadID>
<Layer>804</Layer>
<UseLayerAusSymboldefinition>-1</UseLayerAusSymboldefinition>
<PunktQualitaet>pqExtern</PunktQualitaet>
<VerwendungsStatus>pb_SollUnused</VerwendungsStatus>
<Position>
<gml:Point>
<gml:pos>3331817.374 5682842.57</gml:pos>
</gml:Point>
</Position>
<PointSymbolGUID GUID="{4263AD83-…}" />
<WeitereSymbole>
<WeitereSymboleMember GUID="{27D026D3-…}" />
</WeitereSymbole>
<RissKoordinaten />
<RissPktNrTextType />
</VC_CADPunkt>
</pre>

=== Beispiel (Sachsen) — gefüllte RissKoordinaten (Deltas je Riss) ===
<pre>
<VC_CADPunkt>
<VermCadID>
<GUID>{A45C4265-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>
<Layer>-100850</Layer>
<PunktQualitaet>pqHelp</PunktQualitaet>
<Position>
<gml:Point>
<gml:pos>3332413.7 5683111.729</gml:pos>
</gml:Point>
</Position>
<PointSymbolGUID GUID="{49A895D7-…}" />
<RissKoordinaten>
<RissEintrag_0>-0.000279225409030914 0.000412030145525932 0</RissEintrag_0>
</RissKoordinaten>
<RissPktNrTextType />
</VC_CADPunkt>
</pre>
Details zur RissEintrag-Struktur: [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]].

=== Beispiel (Thüringen) — ALKIS-Repräsentant mit AlkisID und leerem VCPktArtTransfer ===
<pre>
<VC_CADPunkt>
<VermCadID>
<GUID>{XXXXXXXX-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>
<AlkisID>DETHL53P0000GTXJ</AlkisID>
<Layer>-100360</Layer>
<PunktQualitaet>pqExtern</PunktQualitaet>
<VCPktArtTransfer />
<Position>
<gml:Point>
<gml:pos>2581116.89 5624174.596</gml:pos>
</gml:Point>
</Position>
<PointSymbolGUID GUID="{80A4225D-…}" />
<RissKoordinaten />
<RissPktNrTextType />
</VC_CADPunkt>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen.
* '''PostProcessing''': Nach dem Einlesen des Objekts läuft <code>CheckPktQuality(True)</code> und repariert inkonsistente Kombinationen aus Punktqualität und ObjektArt (es gab z. B. Punkte mit gültiger VCPktID, die <code>pqHelp</code>/<code>oaCAD</code> waren). Dieselbe Prüfung läuft auch vor jedem Speichern.
* '''UTM-Y-Korrektur''': Beim Lesen von <code>gml:pos</code>/<code>OriginalCADPos</code> alter Projekte greift ggf. <code>VKS489YKorrektur</code> (Erkennung UTM-Hochwerte, setzt ggf. Lagestatus 489). Ein leerer pos-String lässt die Koordinaten unverändert.
* '''Migrations-Weiche''': Unbekannte Reader-IDs und Komplexstrukturen werden an das PointSymbol weitergereicht — in sehr alten Projekten lagen die Symboldaten (SymbolID, Drehwinkel …) direkt am Punkt; solche Tags werden also beim Lesen des Punkts akzeptiert.
* <code>VCPktID_KSID</code> wird von CAD-Punkten nicht mehr geschrieben; fehlt sie, gilt die KSID des Projekts. In lokalen Systemen kann <code>VCPktID_NV</code> ein beliebiger String sein (z. B. <code>xx</code>) und Koordinaten können klein oder negativ sein.
* <code>VerwendungsStatus</code> wird erst seit 09/2023 am CAD-Punkt gespeichert — ältere Dateien enthalten es nie.
* Punkte '''ohne gültige X/Y-Koordinaten werden beim Speichern übersprungen''' (Fehlwert-Filter im Manager).

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:26063-26262</code> — <code>T3DPoint.DataToXMLLite</code> (Schreibreihenfolge, Bedingungen)
* <code>CAD\GLGeometrics.pas:26496-26618</code> — <code>InternalCreateFromXML</code> (einfache Werte, UTM-Korrektur, Migrations-Weiche)
* <code>CAD\GLGeometrics.pas:26406-26494</code> — <code>InternalCreateComplexStructsFromXML</code> (Position, PointSymbolGUID, WeitereSymbole, Rissdaten)
* <code>CAD\GLGeometrics.pas:26396-26404</code> — PostProcessing <code>CheckPktQuality(True)</code>
* <code>CAD\GLGeometrics.pas:26620-26636</code> — <code>SetVCPktIDFromXML</code> (NV/NR-Pflicht der Punktnummer)
* <code>CAD\GLGeometrics.pas:21178-21278</code> — <code>T3DPointRissValueList.DataToXMLLite</code> (RissKoordinaten/RissPktNrTextType)
* <code>CAD\GLTypes.pas:952-957</code> — TPointQualType; <code>GLTypes.pas:58, 60-64</code> — TPktNrTextType, TVCPktSiblTransferedConnected
* <code>VERMCAD\GlobalTypes.pas:809</code> — TPktBenutzPart; <code>Alkis\AlkisTypes.pas:467</code> — TAZ_Punktobjekt
* <code>CAD\GLConsts.pas:513-583</code> — Init-Werte (<code>INIT_T3DPOINT_*</code>); <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten
* <code>CAD\GLGeometrics.pas:79669-79670</code> — Fehlwert-Punkte werden nicht gespeichert

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

CAD XML Syntax-Objekt VC CADMeteredSimpleLine

2026-07-20T12:50:27Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADMeteredSimpleLine}}
Die Messlinie (Maßlinie einer Messung, „gemessene Linie") ist eine einfache Linie mit zusätzlicher Pfeildarstellung. Delphi-Klasse ist <code>T2DMeteredSimpleLine</code> (<code>CAD\GLGeometrics.pas</code>), abgeleitet von <code>T2DSimpleLine</code>, gespeichert unter dem XML-Tag <code>VC_CADMeteredSimpleLine</code>. Messlinien entstehen typischerweise aus Messungs-Berechnungen (<code>ObjektArt=oaVCBer</code>, Berechnungs-Systemlayer).

== Strukturregel ==
<pre>
<VC_CADMeteredSimpleLine>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadLinie)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
[geerbte Linien-Elemente] (siehe VC_CADSimpleLine: RichtungInvertiert,
VerbundIdentischerLinien, LaengeGemessen,
VerlaengerungAmStart-/Endpunkt)
<Startpunkt GUID="guid"/> (Pflicht)
<Endpunkt GUID="guid"/> (Pflicht)
[<MeasuredLineKind>enum:TMeasuredLineKind</MeasuredLineKind>]
[<AmBildschirmrandAusrichten>bool</AmBildschirmrandAusrichten>]
</VC_CADMeteredSimpleLine>
</pre>
Die eigenen Elemente stehen NACH allen geerbten Elementen. 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 ==
Nur die eigenen Elemente von <code>T2DMeteredSimpleLine</code>:

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>MeasuredLineKind</code> || enum:TMeasuredLineKind || nein || <code>mlk_</code> (ohne Pfeil, wird nicht geschrieben) || Pfeildarstellung der Messlinie
|-
| <code>AmBildschirmrandAusrichten</code> || bool || nein || False || Beschriftung/Darstellung am Bildschirmrand ausrichten
|}

=== Enum TMeasuredLineKind (alle Werte) ===
{| class="wikitable"
! Wert !! Bedeutung
|-
| <code>mlk_</code> || ohne Pfeil (Default — wird nicht geschrieben)
|-
| <code>mlk_Hz</code> || Richtung
|-
| <code>mlk_Hz_HD</code> || Richtung und Strecke
|-
| <code>mlk_Hz_Hz</code> || Richtung hin und zurück
|-
| <code>mlk_Hz_HD_Hz</code> || Richtung hin und zurück und Strecke
|-
| <code>mlk_Hz_HD_Hz_HD</code> || Richtung hin und zurück und Strecke hin und zurück
|}

== Referenzen ==
Wie bei jeder Start-/Endpunkt-Linie: <code>Startpunkt</code>- und <code>Endpunkt</code>-GUID sind Pflicht; bei fehlendem Ziel wird das Objekt nach dem LastTry des Referenzen-Updates zerstört (Details auf [[CAD XML Syntax-Objekt VC CADSimpleLine|VC_CADSimpleLine]]).

== Minimalform ==
<pre>
<VC_CADMeteredSimpleLine>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaVCBer</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Layer>-3002</Layer>
<Startpunkt GUID="{XXXX…}" />
<Endpunkt GUID="{XXXX…}" />
</VC_CADMeteredSimpleLine>
</pre>

== Beispiele ==
=== Echtes Beispiel (Messlinie mit Pfeil-Basiselementen) ===
<pre>
<VC_CADMeteredSimpleLine>
<VermCadID>
<GUID>{4704C67E-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadLinie</CADObjektArt>
</VermCadID>
<Farbe>2147483644</Farbe>
<Alpha>2147483644</Alpha>
<VCBerLayerID>-3002</VCBerLayerID>
<Layer>-3002</Layer>
<LayerErben>-1</LayerErben>
<Linienstaerke>2147483644</Linienstaerke>
<LinienendenFreistellen>2147483644</LinienendenFreistellen>
<Linienmuster>2147483644</Linienmuster>
<LineDarstellungMessung>3</LineDarstellungMessung>
<Startpunkt GUID="{3FB56072-…}" />
<Endpunkt GUID="{4CE2222B-…}" />
<AmBildschirmrandAusrichten>-1</AmBildschirmrandAusrichten>
</VC_CADMeteredSimpleLine>
</pre>
<code>LineDarstellungMessung</code> ist ein [[CAD XML Syntax-Basiselemente|Basiselement]] (in den Beispielprojekten mit den Werten <code>2</code> oder <code>3</code>), das gerade bei Messlinien regelmäßig gesetzt ist.

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen (Factory-Eintrag ohne IFDEF).
* Belegt in den Beispielprojekten: BW 23, Sachsen 797, Thüringen 0 Exemplare.
* In der Objekteigenschaften-GUI sind <code>Liniensymbol</code>, <code>Linienmuster</code> und <code>LineCloseType</code> für Messlinien ausgeblendet (<code>PropValid</code>) — in der XML können die Basiselemente dennoch vorkommen und werden gelesen.
* Historisch wurden gemessene Linien in der Kataster-Darstellung farblich hervorgehoben; heute gilt: Farbe immer von der Folie (auskommentierter Code, BUG #646).
* Keine Legacy-Aliase an dieser Klasse.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:2024-2056</code> — Klassendeklaration <code>T2DMeteredSimpleLine</code>
* <code>CAD\GLGeometrics.pas:39136-39168</code> — <code>DataToXMLLite</code> (MeasuredLineKind, AmBildschirmrandAusrichten)
* <code>CAD\GLGeometrics.pas:39049-39073</code> — <code>InternalCreateFromXML</code>
* <code>CAD\GLGeometrics.pas:39128-39134</code> — <code>PropValid</code> (ausgeblendete Stil-Eigenschaften)
* <code>VERMCAD\GlobalTypes.pas:446-452</code> — Enum <code>TMeasuredLineKind</code>
* <code>CAD\GLConsts.pas:513-583</code> — Init-Werte (<code>INIT_T2DMETEREDSIMPLELINE_*</code>)

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

CAD XML Syntax-Objekt VC CADKompo

2026-07-20T12:50:26Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADKompo}}
Der Kompo ist das Verbund-/Gruppenobjekt des CAD: eine geordnete Komposition beliebiger CAD-Objekte (meist Linien, auch Punkte, Texte, andere Kompos). Delphi-Klasse ist <code>T3DKompo</code> (<code>CAD\GLGeometrics.pas</code>), XML-Tag <code>VC_CADKompo</code>. Ein geschlossener Linien-Kompo dient außerdem als Ring-Objekt für Flächenränder ([[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|VC_CADFlaeche]], [[CAD XML Syntax-Objekt VC Plotrahmen|VC_Plotrahmen]]). <code>T3DKompo</code> ist Basisklasse der [[CAD XML Syntax-Objekt VC CADBemassung|Bemaßung]] und (über <code>T3DVCCalcMess</code>) von [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|VC_CADVCBerechnung/VC_CADVCMessung]].

== Strukturregel ==
<pre>
<VC_CADKompo>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadKompo)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
<MemberGroup>
{<Member GUID="guid"/>}* (2..n — geordnete Kind-Referenzen)
</MemberGroup>
</VC_CADKompo>
</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 ==
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>MemberGroup</code> || Container || '''ja''' || — || Liste der Kind-Objekte
|-
| <code>Member</code> || GUID-Attribut-Element (0..n) || '''ja''' (mindestens 2 fürs Laden) || — || Referenz auf ein Kind-Objekt. Die '''Reihenfolge der Member-Elemente = Kompositionsreihenfolge''' (bei Ring-Kompos die Umlaufreihenfolge der Randlinien)
|}
Hinweis: Beim reinen <code>VC_CADKompo</code> tragen die <code>Member</code>-Elemente nur das Attribut <code>GUID</code>. Die Variante mit zusätzlichen Attributen <code>RefGUID</code>/<code>Counter</code> kommt nur in den <code>MemberGroup</code>-Containern INNERHALB von <code>VC_CADVCBerechnungList</code>-Einträgen vor (siehe [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|VC_CADVCBerechnung]]).

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>Member</code> || beliebiges CAD-Objekt (meist [[CAD XML Syntax-Objekt VC CADSimpleLine|Linien]], auch Punkte, Texte, Kompos) || '''ja''' || siehe unten
|}
Auflösungsverhalten von <code>T3DKompo.SetReferencesAndUpdate</code> (Referenzen-Update nach dem Laden aller Objekte):
* '''Weniger als 2 Verweis-GUIDs''' → „Objekt wird nicht eingelesen": der Kompo wird verworfen (gilt nicht für die <code>T3DVCCalcMess</code>-Ableitungen Berechnung/Messung, die auch 1 Kind haben dürfen).
* '''Syntaktisch ungültige Member-GUID''' → Kompo wird verworfen.
* '''Member-Ziel selbst fehlerhaft''' (konnte nicht eingelesen werden) → dieser Member wird aus der Liste entfernt, der Kompo überlebt — sinkt die Zahl dabei unter 2, wird er doch verworfen.
* '''Member-Ziel (noch) nicht verarbeitet''' → Kompo kommt in die Wiedervorlage-Liste; bleibt das Ziel bis zum „LastTry" unauffindbar, wird der Kompo als fehlerhaft '''zerstört''' (Logeintrag „n von m Unter-Objekten nicht gefunden", siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]). Kinder eines verworfenen Kompos können einzeln überleben.
Nach erfolgreicher Auflösung wird jedes Kind-Objekt mit <code>Parent</code> auf den Kompo verlinkt.

== Minimalform ==
<pre>
<VC_CADKompo>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<MemberGroup>
<Member GUID="{XXXX…}"/>
<Member GUID="{XXXX…}"/>
</MemberGroup>
</VC_CADKompo>
</pre>
Mindestens 2 Member-GUIDs auf existierende Objekte sind Pflicht — mit weniger wird der Kompo beim Laden verworfen.

== Beispiele ==
=== Beispiel (Baden-Württemberg, echt — ALKIS-Repräsentant mit 2 Membern) ===
<pre>
<VC_CADKompo>
<VermCadID>
<GUID>{9EEC7079-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-101510</Layer>
<LayerErben>-1</LayerErben>
<MemberGroup>
<Member GUID="{CC3C9309-…}" />
<Member GUID="{32FA3AF1-…}" />
</MemberGroup>
</VC_CADKompo>
</pre>

=== Beispiel (Baden-Württemberg, echt — großer Ring-Kompo, gekürzt) ===
<pre>
<VC_CADKompo>
<VermCadID>
<GUID>{A7E2273A-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-100720</Layer>
<LayerErben>-1</LayerErben>
<MemberGroup>
<Member GUID="{97702235-…}" />
<Member GUID="{5879B99F-…}" />
<Member GUID="{78D742D2-…}" />
… (im Original 280 Member) …
</MemberGroup>
</VC_CADKompo>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen; Bestandsbelege in allen drei Beispielprojekten (BW: 370, Sachsen: 7.868, THR: 765).
* '''Leerer Kompo wird nicht gespeichert''': <code>DataToXMLLite</code> bricht bei 0 Kindern VOR dem Schreiben der VermCadID ab — es entsteht nur ein leeres Wurzelelement ohne Inhalt, das beim Lesen mangels <code>VermCadID</code> kein Objekt erzeugt. Bei genau 1 Kind wird nur eine Log-Warnung („Sinnlose Komposition") ausgegeben, geschrieben wird trotzdem.
* Als Ring einer Fläche muss der Kompo eine '''geschlossene Kurve''' bilden (<code>IsCurve</code> + <code>IsClosed</code>) — sonst verwirft die referenzierende Fläche sich selbst beim Laden.
* Ableitungen mit eigenen Wurzeltags: <code>VC_CADBemassung</code> (T3DBemassung), <code>VC_CADVCBerechnung</code>/<code>VC_CADVCMessung</code> (T3DVCCalcMess). Der Manager schreibt beim Speichern je nach Klasse das passende Tag; nur „echte" Kompos erhalten <code>VC_CADKompo</code>.
* Schreibreihenfolge im Manager: Kompos als Gruppe 9 (nach den Flächen!) — Flächen referenzieren ihre Rand-Kompos also vorwärts; der Leser löst das über die Wiedervorlage-Schleife auf.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:56202-56278</code> — <code>T3DKompo.DataToXMLLite</code> (Leer-Check vor VermCadID, MemberGroup/Member)
* <code>CAD\GLGeometrics.pas:56130-56194</code> — <code>InternalCreateComplexStructsFromXML</code> (Member-GUIDs → FChildrenGUIDS)
* <code>CAD\GLGeometrics.pas:57251-57347</code> — <code>SetReferencesAndUpdate</code> (Mindestanzahl 2, Fehlerverhalten, Parent-Verlinkung)
* <code>CAD\GLGeometrics.pas:56196-56200</code> — <code>GetXMLLinkError</code> (Fehlermeldung über fehlende Kind-GUIDs)
* <code>CAD\GLGeometrics.pas:9011-9021</code> — <code>IsClosedCurve</code> (Kompo als Flächenring)
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten <code>xn_Kompo</code>=<code>VC_CADKompo</code>, <code>xn_Members</code>=<code>MemberGroup</code>, <code>xn_Member</code>=<code>Member</code>

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

CAD XML Syntax-Objekt VC CADKlotoide

2026-07-20T12:50:25Z

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

{{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 CADFlaeche und VCFlaeche

2026-07-20T12:50:24Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADFlaeche und VC_CADVCFlaeche}}
Flächenobjekte des CAD. Delphi-Klassen sind <code>T2DArea</code> (XML-Tag <code>VC_CADFlaeche</code>) und die davon abgeleitete <code>T2DVCArea</code> (XML-Tag <code>VC_CADVCFlaeche</code>, VC-generierte Fläche mit Makro-Verknüpfung), beide in <code>CAD\GLGeometrics.pas</code>. Gemeinsame Basis ist die abstrakte <code>T2DAreaBase</code> (ohne eigenes Wurzeltag), die den Flächenrand als GUID-Referenzen auf Ring-Objekte speichert: genau ein äußerer Umring (<code>Exterior</code>) plus beliebig viele Löcher (<code>Interior</code>).

== Strukturregel ==
<pre>
<VC_CADFlaeche> (bzw. <VC_CADVCFlaeche>)
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadFlaeche)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht;
Schraffur-Felder SchraffurStil,
SchraffurHauptkanteGUID, … siehe dort)
<Rand>
<Exterior GUID="guid"/> (genau 1 — äußerer Umring)
{<Interior GUID="guid"/>}* (0..n — Löcher)
</Rand>
[<BoeschungsInfos> (nur T2DArea, nur bei Böschungsschraffur)
[<BoeschungOKUKVertauschen>bool</BoeschungOKUKVertauschen>] (nur wenn True)
[<BoeschungOKUKAutomatisch>bool</BoeschungOKUKAutomatisch>] (nur wenn False)
[<BoeschungOKStart_GUID>guid</BoeschungOKStart_GUID> (GUID als Elementtext!
<BoeschungOKEnd_GUID>guid</BoeschungOKEnd_GUID> alle 4 zusammen
<BoeschungUKStart_GUID>guid</BoeschungUKStart_GUID> oder keine)
<BoeschungUKEnd_GUID>guid</BoeschungUKEnd_GUID>]
</BoeschungsInfos>]
</VC_CADFlaeche>

Zusätzlich NUR bei <VC_CADVCFlaeche> (Reihenfolge Type→Nr→Name):
[<MakroIDType>enum:TMakroType</MakroIDType>] (praktisch immer mt_Calc)
[<MakroIDNr>ganzzahl</MakroIDNr>] (Verknüpfung zur Berechnungs-Fläche)
[<MakroIDName>text</MakroIDName>] (informativ)
</pre>
Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]] und [[CAD XML Syntax-Basiselemente|Basiselemente]]; Werteformate (Float, Bool = -1/0, GUID): [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]]. Die Schraffur einer Fläche wird komplett über die Basiselemente gesteuert (<code>SchraffurStil</code>, <code>SchraffurHauptkanteGUID</code>, <code>SchraffurHauptkanteAutomatisch</code>, <code>BoeschungsSchraffurStil</code>, <code>Textur</code>) — die Fläche selbst hat dafür keine eigenen Elemente.

== Elemente ==
{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>Rand</code> || Container || '''ja''' || — || Flächenrand; enthält Exterior + Interiors
|-
| <code>Exterior</code> || GUID-Attribut-Element || '''ja''' (genau 1) || — || äußerer Umring. Mehrfache <code>Exterior</code>-Knoten: nur der '''erste''' zählt, weitere werden mit Fehlerlog ignoriert
|-
| <code>Interior</code> || GUID-Attribut-Element (0..n) || nein || keine || Löcher der Fläche; '''doppelte GUIDs werden beim Lesen ignoriert''' (Schutz vor Aufsummierung bei wiederholtem Öffnen)
|-
| <code>BoeschungsInfos</code> || Container || nein || — || Böschungskanten-Zuordnung (nur <code>T2DArea</code>); geschrieben nur, wenn ein Böschungs-Info-Container existiert (Fläche mit Böschungsschraffur). Die 4 Kanten-Punkt-GUIDs stehen als '''Elementtext''' (nicht als Attribut) und werden nur geschrieben, wenn nicht automatisch und alle 4 Punkte existieren
|-
| <code>MakroIDType</code> || enum:TMakroType || nein || — || nur <code>VC_CADVCFlaeche</code>; Werte: <code>mt_Calc</code>, <code>mt_Mess</code>, <code>mt_NetzMess</code>, <code>mt_GNSSMess</code> — bei Flächen praktisch immer <code>mt_Calc</code>. '''Beim Lesen ignoriert''' (siehe unten)
|-
| <code>MakroIDNr</code> || Int || ja (für die VC-Verknüpfung) || — || nur <code>VC_CADVCFlaeche</code>; Nummer der VC-Fläche. Beim Lesen wird '''nur dieses Element''' ausgewertet: die MakroID wird mit <code>mt_Calc</code> und der Projekt-KSID neu über den IDServer geholt
|-
| <code>MakroIDName</code> || String || nein || — || nur <code>VC_CADVCFlaeche</code>; Name (informativ, beim Lesen ignoriert)
|}

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>Exterior</code> || geschlossene Kurve: [[CAD XML Syntax-Objekt VC CADKompo|VC_CADKompo]] (geschlossener Linienring) oder [[CAD XML Syntax-Objekt VC CADCircleLine und EllipseLine|VC_CADCircleLine/VC_CADEllipseLine]] || '''ja''' || '''harte Referenz''': fehlende/ungültige GUID, nicht gefundenes Ziel oder ein Ziel, das keine geschlossene Kurve ist → „Objekt wird nicht eingelesen" — die Fläche wird beim Referenzen-Update verworfen und zerstört. Ist das Exterior-Objekt selbst fehlerhaft, wird auch die Fläche verworfen
|-
| <code>Interior</code> || geschlossene Kurve (wie Exterior), je Loch eine || nein || überwiegend '''weich''': nicht gefundene oder fehlerhafte Interior-Ziele und ungeschlossene Ringe werden mit Logeintrag ignoriert, die Fläche bleibt bestehen. Ausnahme: eine syntaktisch '''ungültige''' Interior-GUID (nicht parsebar) verwirft die ganze Fläche
|-
| <code>BoeschungOK/UK…_GUID</code> || [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]] (4 Kanten-Punkte) || nein || weich (nur Darstellung der Böschungsschraffur)
|}
Prüfkriterium „geschlossene Kurve" (<code>T3DBaseObject.IsClosedCurve</code>): Kreis, Ellipse oder ein <code>T3DKompo</code>, dessen Member eine geschlossene Kurve bilden.

'''Wichtig für Erzeuger:''' In der Schreibreihenfolge des Managers stehen die Flächen VOR den Kompos — das referenzierte Rand-Kompo steht in echten Dateien also typischerweise NACH der Fläche. Der Leser löst das über die Wiedervorlage-Schleife des Referenzen-Updates auf (siehe [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Minimalform ==
<pre>
<VC_CADFlaeche>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Rand>
<Exterior GUID="{XXXX…}"/>
</Rand>
</VC_CADFlaeche>
</pre>
Die <code>Exterior</code>-GUID muss auf ein existierendes, geschlossenes Ring-Objekt zeigen (in der Regel ein <code>VC_CADKompo</code>, dessen <code>MemberGroup</code> die Randlinien enthält) — sonst wird die Fläche beim Laden verworfen.

== Beispiele ==
=== Minimalfall (Baden-Württemberg, echt) ===
<pre>
<VC_CADFlaeche>
<VermCadID>
<GUID>{E91D72F2-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Rand>
<Exterior GUID="{E25CC64B-…}" />
</Rand>
</VC_CADFlaeche>
</pre>

=== Fläche mit Löchern (Baden-Württemberg, echt — ALKIS-Repräsentant mit 6 Interiors) ===
<pre>
<VC_CADFlaeche>
<VermCadID>
<GUID>{5F2F5D3E-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<AlkisID>DEBWL001000h42SS</AlkisID>
<Layer>-100360</Layer>
<Rand>
<Exterior GUID="{93AD309C-…}" />
<Interior GUID="{58E5F5D0-…}" />
<Interior GUID="{ECC12FEE-…}" />
<Interior GUID="{9D2A3BF2-…}" />
<Interior GUID="{44CED532-…}" />
<Interior GUID="{E22A2480-…}" />
<Interior GUID="{504A1A3A-…}" />
</Rand>
</VC_CADFlaeche>
</pre>

=== VC_CADVCFlaeche (KONSTRUIERT nach den Code-Regeln — kein Bestandsbeleg in den Beispielprojekten) ===
<pre>
<VC_CADVCFlaeche>
<VermCadID>
<GUID>{XXXXXXXX-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Rand>
<Exterior GUID="{XXXX…}"/>
</Rand>
<MakroIDType>mt_Calc</MakroIDType>
<MakroIDNr>7</MakroIDNr>
<MakroIDName>Flurstück 123</MakroIDName>
</VC_CADVCFlaeche>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen; Bestandsbelege für <code>VC_CADFlaeche</code> in allen drei Beispielprojekten (BW/Sachsen/THR), für <code>VC_CADVCFlaeche</code> keiner.
* '''Sichtbar-Sonderfall''' bei <code>VC_CADVCFlaeche</code>: Das Basiselement <code>Sichtbar</code> wird beim Schreiben aus dem Koordinatensystem der verknüpften VC-Fläche abgeleitet (Basisklasse GLGeometrics.pas:6630-6633), nicht direkt aus dem Objektzustand.
* Beim Lesen von <code>VC_CADVCFlaeche</code> zählt nur <code>MakroIDNr</code> — Typ und Name werden verworfen und die Makro-ID mit <code>mt_Calc</code> neu vom IDServer geholt. Ein Reparierer darf <code>MakroIDType</code>/<code>MakroIDName</code> also gefahrlos ergänzen/korrigieren.
* Anhalt-Ableitungen der Fläche: siehe [[CAD XML Syntax-Objekt VC AreaCADLTK und AlkisDE|VC_AreaCADLTK und VC_AreaCADAlkisDE]]; der [[CAD XML Syntax-Objekt VC Plotrahmen|VC_Plotrahmen]] erbt ebenfalls den <code>Rand</code>-Mechanismus.
* Schreibreihenfolge im Manager: Flächen als Gruppe 7 (nach Linien, vor Kompos); <code>T2DVCArea</code> → Tag <code>VC_CADVCFlaeche</code>, sonst <code>VC_CADFlaeche</code>.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:61035-61096</code> — <code>T2DAreaBase.DataToXMLLite</code> (Rand/Exterior/Interior schreiben)
* <code>CAD\GLGeometrics.pas:60860-60949</code> — <code>T2DAreaBase.InternalCreateComplexStructsFromXML</code> (Exterior nur erster, Interior-Duplikatfilter)
* <code>CAD\GLGeometrics.pas:62342-62470</code> — <code>T2DAreaBase.SetReferencesAndUpdate</code> (harte Exterior-/weiche Interior-Referenz, IsClosedCurve-Prüfung)
* <code>CAD\GLGeometrics.pas:9011-9021</code> — <code>T3DBaseObject.IsClosedCurve</code>
* <code>CAD\GLGeometrics.pas:64261-64283</code> — <code>T2DArea.DataToXMLLite</code> (BoeschungsInfos); <code>64229-64258</code> — Lesen
* <code>CAD\GLBoeschungsSchraffuren.pas:3387-3438</code> — <code>TBoeschungInfoContainer.DataToXMLLite</code>; <code>3341-3385</code> — Lesen
* <code>CAD\GLGeometrics.pas:64482-64516</code> — <code>T2DVCArea.DataToXMLLite</code> (MakroID-Elemente); <code>64518-64549</code> — Lesen (nur MakroIDNr, IDServer)
* <code>VERMCAD\VCObjID.pas:11</code> — Enum <code>TMakroType</code>
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten (<code>xn_Rand</code>, <code>xn_Exterior</code>, <code>xn_Interior</code>, <code>xn_MakroID*</code>, <code>xn_Boeschung*</code>)

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

CAD XML Syntax-Objekt VC CADCircleLine und EllipseLine

2026-07-20T12:50:23Z

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

{{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 CADBoeschung

2026-07-20T12:50:22Z

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

{{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 CADBMPunkt

2026-07-20T12:50:21Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADBMPunkt}}
Der Bogenmittenpunkt markiert die Mitte eines Kreisbogens auf dem Bogen. Delphi-Klasse ist <code>T3DBMPoint</code> (<code>CAD\GLGeometrics.pas</code>), gespeichert unter dem XML-Tag <code>VC_CADBMPunkt</code>. Die Klasse erbt vollständig von <code>T3DPoint</code> — Struktur und Elemente sind identisch zu [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]], ergänzt um zwei eigene Bool-Felder.

== Strukturregel ==
<pre>
<VC_CADBMPunkt>
<VermCadID> … </VermCadID> (siehe VermCadID-Block)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
… alle Elemente von VC_CADPunkt … (PunktQualitaet, Position/gml:pos,
PointSymbolGUID, RissKoordinaten, …)
[<ImmerAufBogen>bool</ImmerAufBogen>] (nur geschrieben, wenn False!)
[<IstEntstandenDurchBearbeitung>bool</IstEntstandenDurchBearbeitung>]
</VC_CADBMPunkt>
</pre>
Die beiden eigenen Elemente stehen NACH allen geerbten Punkt-Elementen (das <code>inherited</code>-Schreiben läuft zuerst). CADObjektArt ist wie beim normalen Punkt <code>cadPunkt</code> — die Unterscheidung liegt allein im Wurzeltag.

== Elemente ==
Nur die eigenen Elemente von <code>T3DBMPoint</code> (alles andere: [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]]):

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>ImmerAufBogen</code> || bool || nein || '''True''' || Bogenmittenpunkt bleibt beim Verschieben immer auf dem Bogen. Achtung: Da der Default True ist, wird das Element '''nur geschrieben, wenn der Wert False ist''' (<code><ImmerAufBogen>0</ImmerAufBogen></code>); ein fehlendes Element bedeutet True.
|-
| <code>IstEntstandenDurchBearbeitung</code> || bool || nein || False || Kennzeichen „durch Bearbeitung entstanden" (nur geschrieben, wenn True)
|}

== Referenzen ==
Der BM-Punkt selbst trägt '''keine''' Referenz auf seinen Bogen. Die Zuordnung läuft umgekehrt: Das Bogen-Objekt [[CAD XML Syntax-Objekt VC CADArcLine|VC_CADArcLine]] referenziert den BM-Punkt über sein Element <code><BogenMittePoint GUID="{…}"/></code> (und meist zusätzlich <code>BogenZwischenPunkt</code>). Beim Erzeugen gehört zu jedem VC_CADBMPunkt also ein VC_CADArcLine, dessen <code>BogenMittePoint</code>-GUID auf ihn zeigt. Die weichen Symbol-Referenzen (<code>PointSymbolGUID</code>, <code>WeitereSymbole</code>) verhalten sich wie beim [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]].

== Minimalform ==
<pre>
<VC_CADBMPunkt>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<PunktQualitaet>pqHelp</PunktQualitaet>
<Position>
<gml:Point>
<gml:pos>545123.456 5721456.789</gml:pos>
</gml:Point>
</Position>
</VC_CADBMPunkt>
</pre>

== Beispiele ==
=== Beispiel (Baden-Württemberg) — typischer ALKIS-Bogenmittenpunkt ===
Alle 175 BM-Punkte der BW-Beispieldatei haben exakt diese Form (17 Zeilen, keine eigenen Elemente, da beide Defaults gelten):
<pre>
<VC_CADBMPunkt>
<VermCadID>
<GUID>{26A2B7A6-…}</GUID>
<ObjektArt>oaAlkisCADRepr</ObjektArt>
<CADObjektArt>cadPunkt</CADObjektArt>
</VermCadID>
<Layer>-100890</Layer>
<PunktQualitaet>pqHelp</PunktQualitaet>
<Position>
<gml:Point>
<gml:pos>32518902.215 5308847.597</gml:pos>
</gml:Point>
</Position>
<PointSymbolGUID GUID="{F4A81545-…}" />
<RissKoordinaten />
<RissPktNrTextType />
</VC_CADBMPunkt>
</pre>
Der zugehörige Bogen referenziert diesen Punkt: <code><BogenMittePoint GUID="{26A2B7A6-…}"/></code> im [[CAD XML Syntax-Objekt VC CADArcLine|VC_CADArcLine]].

== Verfügbarkeit und Besonderheiten ==
* Verfügbar in '''allen''' Bundesland-Versionen; kommt nur in Projekten mit Kreisbögen vor (BW/Sachsen-Beispieldateien: ja, THR-Beispieldatei: keiner).
* Umgekehrte Default-Logik bei <code>ImmerAufBogen</code> (Init True → nur False wird geschrieben) — in den drei Beispielprojekten kommt keines der beiden eigenen Elemente vor.
* PostProcessing, UTM-Y-Korrektur, Fehlwert-Filter beim Speichern: identisch zu [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]].

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:30319-30350</code> — <code>T3DBMPoint.DataToXMLLite</code>
* <code>CAD\GLGeometrics.pas:30241-30265</code> — <code>T3DBMPoint.InternalCreateFromXML</code>
* <code>CAD\GLConsts.pas</code> — <code>INIT_T3DBMPOINT_IMMERAUFBOGEN = True</code>, <code>INIT_T3DBMPOINT_ISTENTSTANDENDURCHBEARBEITUNG = False</code>
* <code>VERMCAD\GlobalConsts.pas:4566-4567</code> — Tag-Konstanten <code>xn_ImmerAufBogen</code>, <code>xn_IstEntstandenDurchBearbeitung</code>
* <code>CAD\GLGeometrics.pas:96996-97034</code> — Factory-Registrierung <code>VC_CADBMPunkt</code> → T3DBMPoint

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

CAD XML Syntax-Objekt VC CADBemassung

2026-07-20T12:50:19Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_CADBemassung}}
Die Bemaßung stellt den Abstand zwischen zwei Basispunkten mit Maßlinie und Maßtext dar. Delphi-Klasse ist <code>T3DBemassung</code> (<code>CAD\GLGeometrics.pas</code>), XML-Tag <code>VC_CADBemassung</code>. Sie erbt von [[CAD XML Syntax-Objekt VC CADKompo|T3DKompo (VC_CADKompo)]]: die Darstellungs-Hilfsobjekte der Bemaßung (Punkte, Linien, Texte) stehen als Member in der geerbten <code>MemberGroup</code>, die beiden vermessenen Basispunkte zusätzlich als eigene Referenzen.

== Strukturregel ==
<pre>
<VC_CADBemassung>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadKompo)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
<MemberGroup>
{<Member GUID="guid"/>}* (geerbt von VC_CADKompo; min. 2)
</MemberGroup>
<BasePoint1 GUID="guid"/> (Pflicht)
<BasePoint2 GUID="guid"/> (Pflicht)
[<BemassungDistToBase>zahl</BemassungDistToBase>]
[<Bemassung_RissDaten>
{<RissEintrag_ID>
<Bemassung_RissDistToBase>zahl</Bemassung_RissDistToBase>
</RissEintrag_ID>}* </Bemassung_RissDaten>]
</VC_CADBemassung>
</pre>
Geerbte Elemente: [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]], [[CAD XML Syntax-Basiselemente|Basiselemente]], <code>MemberGroup</code> siehe [[CAD XML Syntax-Objekt VC CADKompo|VC_CADKompo]]; Werteformate: [[CAD XML Syntax-Werte- und Koordinatenformate|Werteformate]].

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

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>BasePoint1</code> || GUID-Attribut-Element || '''ja''' || — || erster Basispunkt der Bemaßung
|-
| <code>BasePoint2</code> || GUID-Attribut-Element || '''ja''' || — || zweiter Basispunkt der Bemaßung
|-
| <code>BemassungDistToBase</code> || Float || nein || Fehlwert (nicht geschrieben) || Abstand der Maßlinie zur Basislinie (durch die beiden Basispunkte)
|-
| <code>Bemassung_RissDaten</code> || Container || nein || leer || rissabhängiger Maßlinien-Abstand: je Riss ein <code>RissEintrag_<RissID></code>-Container mit <code>Bemassung_RissDistToBase</code> (Float, nur wenn ≠ Fehlwert) — Details: [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]]
|}
Das zugehörige Rück-Referenz-Element <code>ReferenzPunkteInBemassungen</code> steht nicht hier, sondern an den referenzierten Punkten (Basiselement, siehe [[CAD XML Syntax-Basiselemente|Basiselemente]]).

== Referenzen ==
{| class="wikitable"
! Referenz !! Ziel !! Pflicht !! Verhalten bei fehlendem Ziel
|-
| <code>BasePoint1</code> / <code>BasePoint2</code> || [[CAD XML Syntax-Objekt VC CADPunkt|VC_CADPunkt]] || '''ja''' || '''harte Referenz''': fehlende/ungültige GUID oder nicht auffindbarer Punkt → „Objekt wird nicht eingelesen" — die Bemaßung wird beim Referenzen-Update verworfen und zerstört
|-
| <code>Member</code> (geerbt) || Hilfsobjekte der Maßdarstellung (Punkte/Linien/Texte) || '''ja''' (min. 2) || wie beim [[CAD XML Syntax-Objekt VC CADKompo|VC_CADKompo]]: unauflösbare Member führen zum Verwerfen, als fehlerhaft bekannte Member werden übersprungen
|}
Zur Laufzeit gilt eine Bemaßung außerdem als gelöscht, sobald einer ihrer Basispunkte gelöscht ist.

== Minimalform ==
<pre>
<VC_CADBemassung>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<MemberGroup>
<Member GUID="{XXXX…}"/>
<Member GUID="{XXXX…}"/>
</MemberGroup>
<BasePoint1 GUID="{XXXX…}"/>
<BasePoint2 GUID="{XXXX…}"/>
</VC_CADBemassung>
</pre>
Beide BasePoint-GUIDs müssen auf existierende <code>VC_CADPunkt</code>-Objekte zeigen und die <code>MemberGroup</code> mindestens 2 auflösbare Member enthalten — sonst wird die Bemaßung beim Laden verworfen.

== Beispiele ==
=== Beispiel (KONSTRUIERT nach den Code-Regeln — in keinem der drei Beispielprojekte BW/Sachsen/THR kommt eine Bemaßung vor) ===
<pre>
<VC_CADBemassung>
<VermCadID>
<GUID>{0AB1C2D3-…}</GUID>
<ObjektArt>oaCAD</ObjektArt>
<CADObjektArt>cadKompo</CADObjektArt>
</VermCadID>
<Layer>346</Layer>
<MemberGroup>
<Member GUID="{11A2B3C4-…}"/>
<Member GUID="{22B3C4D5-…}"/>
<Member GUID="{33C4D5E6-…}"/>
</MemberGroup>
<BasePoint1 GUID="{44D5E6F7-…}"/>
<BasePoint2 GUID="{55E6F7A8-…}"/>
<BemassungDistToBase>2.5</BemassungDistToBase>
<Bemassung_RissDaten>
<RissEintrag_0>
<Bemassung_RissDistToBase>3.1</Bemassung_RissDistToBase>
</RissEintrag_0>
</Bemassung_RissDaten>
</VC_CADBemassung>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Code-Verfügbarkeit: '''alle''' Bundesland-Versionen (Factory-Eintrag ohne IFDEF). '''Kein Bestandsbeleg''' in den drei Beispielprojekten — das Format ist ausschließlich aus dem Code abgeleitet.
* <code>CADObjektArt</code>: Als Kompo-Ableitung nutzt die Bemaßung <code>cadKompo</code> — die Enum <code>TCADObjArt</code> kennt keinen eigenen Bemaßungs-Wert; die Objektklasse ergibt sich allein aus dem Wurzeltag <code>VC_CADBemassung</code>.
* Die referenzierten Basispunkte erhalten beim Speichern die Rückreferenz <code>ReferenzPunkteInBemassungen</code>/<code>ReferenzPunkteInBemassungenMember</code> (Basiselement am Punkt) — beim Erzeugen einer Bemaßung sollte diese Rückreferenz an beiden Punkten mit angelegt werden.
* Die Kompo-Regel „leer wird nicht gespeichert" gilt auch hier: eine Bemaßung ohne Member-Kinder schreibt keine VermCadID und geht damit beim nächsten Speichern verloren.
* Verknüpfungen einer Bemaßung werden beim Bearbeiten nie gelöst (<code>VerknuepfungenLoesen</code> ist leer überschrieben) — die Geometrie folgt immer den Basispunkten.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:59810-59871</code> — <code>T3DBemassung.DataToXMLLite</code> (BasePoint1/2, DistToBase, Rissdaten)
* <code>CAD\GLGeometrics.pas:59335-59368</code> — <code>InternalCreateComplexStructsFromXML</code> (BPkt-GUIDs, Bemassung_RissDaten)
* <code>CAD\GLGeometrics.pas:59370-59393</code> — <code>InternalCreateFromXML</code> (BemassungDistToBase)
* <code>CAD\GLGeometrics.pas:59268-59333</code> — <code>SetReferencesAndUpdate</code> (harte BasePoint-Referenzen, „Objekt wird nicht eingelesen")
* <code>CAD\GLGeometrics.pas:59255-59266</code> — <code>GetDeleted_Notice_BaseObjectsDeleted</code> (gelöschte Basispunkte)
* <code>CAD\GLGeometrics.pas:59037-59079</code> — <code>T3DBemassungRissValueList</code> (Riss-Struktur)
* <code>CAD\GLGeometrics.pas:57251-57347</code> — geerbtes Member-Verhalten (<code>T3DKompo.SetReferencesAndUpdate</code>)
* <code>VERMCAD\GlobalConsts.pas</code> ca. 4372-5004 — Tag-Konstanten <code>xn_CADBemassung</code>, <code>xn_BPkt1</code>=<code>BasePoint1</code>, <code>xn_BPkt2</code>=<code>BasePoint2</code>, <code>xn_BemassungDistToBase</code>, <code>xn_BemassungRissDaten</code>=<code>Bemassung_RissDaten</code>

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

CAD XML Syntax-Objekt VC CADArcLine

2026-07-20T12:50:18Z

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

{{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 AreaCADLTK und AlkisDE

2026-07-20T12:50:17Z

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

{{DISPLAYTITLE:CAD XML Syntax-Objekt VC_AreaCADLTK und VC_AreaCADAlkisDE}}
Spezial-Flächen der Sachsen-Anhalt-Version (LTK = Linien-Teilungs-Kennzeichnung/„Zitronenschalen", DE = ALKIS-Dateneinheiten). Delphi-Klassen sind <code>T2DAreaLTK</code> (XML-Tag <code>VC_AreaCADLTK</code>) und <code>T2DAreaAlkisDE</code> (XML-Tag <code>VC_AreaCADAlkisDE</code>), beide in <code>CAD\GLGeometrics.pas</code> und '''nur unter <code>{$IFDEF Anhalt}</code>''' übersetzt. Beide erben über die Zwischenklasse <code>T2DAreaLTKDE</code> von <code>T2DArea</code> — die gesamte Rand-Mechanik entspricht [[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|VC_CADFlaeche]].

== VC_AreaCADLTK ==

=== Strukturregel ===
<pre>
<VC_AreaCADLTK>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadFlaeche)
[Basiselemente] (siehe Basiselemente; Layer ist Pflicht)
<Rand>
<Exterior GUID="guid"/>
{<Interior GUID="guid"/>}*
</Rand>
</VC_AreaCADLTK>
</pre>
<code>T2DAreaLTK</code> hat '''keine eigenen XML-Elemente''' — es wird exakt die <code>T2DArea</code>-Serialisierung geerbt (Rand + optional BoeschungsInfos + Basiselemente). Das einzige Unterscheidungsmerkmal in der Datei ist das Wurzeltag.

=== Referenzen ===
Wie bei [[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|VC_CADFlaeche]]: <code>Exterior</code> ist harte Pflicht-Referenz auf eine geschlossene Kurve, <code>Interior</code> weich. Die Verknüpfung zu den beiden LTK-Bezugspunkten (<code>BezugspunkteItem</code>) wird '''nicht im Objekt gespeichert''' — sie wird nach dem Laden von der ALKIS-Seite (LTK-Daten in der <code>VC_AlkisDaten</code>-Sektion) wiederhergestellt.

== VC_AreaCADAlkisDE ==

=== Strukturregel ===
<pre>
<VC_AreaCADAlkisDE>
<VermCadID> … </VermCadID> (siehe VermCadID-Block; CADObjektArt=cadFlaeche)
[Basiselemente]
<Rand>
<Exterior GUID="guid"/>
{<Interior GUID="guid"/>}*
</Rand>
<AlkisDEShowPermanent>bool</AlkisDEShowPermanent> (wird immer geschrieben)
<AlkisDEItemName>text</AlkisDEItemName> (wird immer geschrieben)
</VC_AreaCADAlkisDE>
</pre>

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

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>AlkisDEShowPermanent</code> || bool (-1/0) || nein (wird aber immer geschrieben) || False || DE-Fläche permanent anzeigen (sonst nur, wenn das DE-Item die aktuelle CAD-Repräsentation ist)
|-
| <code>AlkisDEItemName</code> || String || ja (für die DE-Verknüpfung) || '' || Name der ALKIS-Dateneinheit — '''namensbasierte Verknüpfung''': die ALKIS-Seite (<code>TAlkisDE</code>) sucht nach dem Laden die CAD-Fläche, deren <code>AlkisDEItemName</code> ihrem Namen entspricht. Fehlt der Name oder gibt es die DE nicht mehr, bleibt die Fläche unverknüpft (weich, kein Objektverlust)
|}

== Minimalform ==
<pre>
<VC_AreaCADAlkisDE>
<VermCadID>
<GUID>{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Rand>
<Exterior GUID="{XXXX…}"/>
</Rand>
<AlkisDEShowPermanent>0</AlkisDEShowPermanent>
<AlkisDEItemName>DE 10-56 / 10-57</AlkisDEItemName>
</VC_AreaCADAlkisDE>
</pre>
Für <code>VC_AreaCADLTK</code> gilt dieselbe Minimalform ohne die beiden DE-Elemente. Die <code>Exterior</code>-GUID muss auf ein existierendes geschlossenes Ring-Objekt zeigen, sonst wird die Fläche beim Laden verworfen.

== Beispiele ==
=== Beispiel (KONSTRUIERT — die drei Beispielprojekte sind BW/Sachsen/THR, kein Anhalt-Beleg vorhanden) ===
<pre>
<VC_AreaCADLTK>
<VermCadID>
<GUID>{1A2B3C4D-…}</GUID>
<ObjektArt>oaVC</ObjektArt>
<CADObjektArt>cadFlaeche</CADObjektArt>
</VermCadID>
<Layer>-102</Layer>
<Rand>
<Exterior GUID="{5E6F7A8B-…}"/>
</Rand>
</VC_AreaCADLTK>
</pre>

== Verfügbarkeit und Besonderheiten ==
* '''Nur Sachsen-Anhalt''' (<code>{$IFDEF Anhalt}</code>): In allen anderen Bundesland-Versionen sind die Tags nicht in der Objekt-Factory registriert — die Elemente würden beim Laden '''stillschweigend ignoriert'''.
* Kein Bestandsbeleg: In den drei untersuchten Beispielprojekten (BW/Sachsen/THR) kommen beide Tags nicht vor; alle Beispiele auf dieser Seite sind nach den Code-Regeln konstruiert.
* '''KS-0-Bindung''': Beim Referenzen-Update setzen beide Klassen <code>Deleted := True</code>, wenn die umgebende <code>VCCADDaten</code>-Sektion nicht KSID 0 ist — LTK-/DE-Flächen leben nur im Koordinatensystem 0 und werden in anderen KS-Sektionen beim Laden entsorgt (und nicht erneut gespeichert).
* Beide Objekte sind im CAD '''nie verschiebbar''' — sie folgen ihren Bezugspunkten (Geometrie wird von der ALKIS-Seite aktualisiert).
* Schreibreihenfolge im Manager: <code>T2DAreaLTK</code> wird in der Objektgruppe „Flächen" geschrieben, <code>T2DAreaAlkisDE</code> als eigene Gruppe direkt danach (beide nur Anhalt).
* Sichtbarkeit der DE-Fläche zur Laufzeit: nur wenn <code>AlkisDEShowPermanent</code> gesetzt ist oder das DE-Item gerade als CAD-Repräsentation aktiv ist.

== Quellen im Code ==
* <code>CAD\GLGeometrics.pas:3601-3651</code> — Klassendeklarationen <code>T2DAreaLTKDE</code>/<code>T2DAreaLTK</code> (keine eigenen XML-Methoden bei LTK)
* <code>CAD\GLGeometrics.pas:3653-3702</code> — Klassendeklaration <code>T2DAreaAlkisDE</code>
* <code>CAD\GLGeometrics.pas:65419-65454</code> — <code>T2DAreaAlkisDE.DataToXMLLite</code> (beide Elemente bedingungslos)
* <code>CAD\GLGeometrics.pas:65528-65554</code> — <code>T2DAreaAlkisDE.InternalCreateFromXML</code>
* <code>CAD\GLGeometrics.pas:65115-65125</code> und <code>65380-65389</code> — <code>SetReferencesAndUpdate</code> (Deleted bei KSID ≠ 0)
* <code>Alkis\TAlkisDEUnit.pas:334</code> — namensbasierte Suche der CAD-Fläche über <code>AlkisDEItemName</code>
* <code>CAD\GLGeometrics.pas:97015, 97016ff</code> — Factory-Registrierung (nur Anhalt)
* <code>VERMCAD\GlobalConsts.pas:4702</code> — Tag-Konstanten <code>xn_AlkisDEItemName</code>/<code>xn_AlkisDEShowPermanent</code>

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

CAD XML Syntax-Lesemechanik und Pflichtfelder

2026-07-20T12:50:16Z

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

{{DISPLAYTITLE:CAD XML Syntax-Lesemechanik und Pflichtfelder}}
Diese Seite beschreibt, wie VermCad die CAD-Objekte der Projekt-XML einliest (Factory, Element-Dispatch, Referenzen-Update), in welcher Reihenfolge die Objektgruppen geschrieben werden und welche Minimalanforderungen ein Objekt erfüllen muss, damit es korrekt geladen wird. Sie ist damit die zentrale Regelseite für das ERZEUGEN und REPARIEREN von Projekt-XMLs.

== Strukturregel ==
<pre>
<VCCADDaten KSID="…">
… Rissdaten, CurrRissID, ObjektAuswahlen, Bearbeitungsgebiet … (siehe Sektion VCCADDaten)
{ <objekt-wurzeltag> (muss in der Factory-Tabelle stehen,
<VermCadID> … </VermCadID> sonst wird das Element ignoriert)
[Basiselemente]
… klassenspezifische Elemente …
</objekt-wurzeltag> }*
</VCCADDaten>
</pre>

== Factory: Objekt-Wurzeltag → Delphi-Klasse ==
Beim Lesen wird jedes Kind-Element von <code>VCCADDaten</code> über die Hash-Tabelle <code>CreateCADObj_HashTable</code> auf eine Erzeugerfunktion abgebildet. '''Nur die folgenden 29 Tags erzeugen Objekte; alle anderen Tags werden still ignoriert.'''

{| class="wikitable"
! XML-Tag !! Delphi-Klasse !! Detailseite !! Bundesland
|-
| <code>VC_CADPunkt</code> || T3DPoint || [[CAD XML Syntax-Objekt VC CADPunkt|Objekt VC_CADPunkt]] || alle
|-
| <code>VC_CADBMPunkt</code> || T3DBMPoint (Bogenmittenpunkt) || [[CAD XML Syntax-Objekt VC CADBMPunkt|Objekt VC_CADBMPunkt]] || alle
|-
| <code>VC_CADPunktsymbol</code> || T3DPointSymbol || [[CAD XML Syntax-Objekt VC CADPunktsymbol|Objekt VC_CADPunktsymbol]] || alle
|-
| <code>VC_CADSimpleLine</code> || T2DSimpleLine || [[CAD XML Syntax-Objekt VC CADSimpleLine|Objekt VC_CADSimpleLine]] || alle
|-
| <code>VC_CADMeteredSimpleLine</code> || T2DMeteredSimpleLine || [[CAD XML Syntax-Objekt VC CADMeteredSimpleLine|Objekt VC_CADMeteredSimpleLine]] || alle
|-
| <code>VC_CADArcLine</code> || T2DArcLine || [[CAD XML Syntax-Objekt VC CADArcLine|Objekt VC_CADArcLine]] || alle
|-
| <code>VC_CADCircleLine</code> || T2DCircleLine || [[CAD XML Syntax-Objekt VC CADCircleLine und EllipseLine|Objekt VC_CADCircleLine/EllipseLine]] || alle
|-
| <code>VC_CADEllipseLine</code> || T2DEllipseLine || [[CAD XML Syntax-Objekt VC CADCircleLine und EllipseLine|Objekt VC_CADCircleLine/EllipseLine]] || alle
|-
| <code>VC_CADKlotoideLine</code> || T2DKlotoideLine || [[CAD XML Syntax-Objekt VC CADKlotoide|Objekt VC_CADKlotoide]] || alle
|-
| <code>VC_CAD_Klothoide</code> || T2DKlothoide || [[CAD XML Syntax-Objekt VC CADKlotoide|Objekt VC_CADKlotoide]] || alle
|-
| <code>VC_CADFlaeche</code> || T2DArea || [[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|Objekt VC_CADFlaeche/VCFlaeche]] || alle
|-
| <code>VC_CADVCFlaeche</code> || T2DVCArea || [[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|Objekt VC_CADFlaeche/VCFlaeche]] || alle
|-
| <code>VC_Plotrahmen</code> || T2DPlotFrame || [[CAD XML Syntax-Objekt VC Plotrahmen|Objekt VC_Plotrahmen]] || alle
|-
| <code>VC_AreaCADLTK</code> || T2DAreaLTK || [[CAD XML Syntax-Objekt VC AreaCADLTK und AlkisDE|Objekt VC_AreaCADLTK/AlkisDE]] || nur Sachsen-Anhalt (Anhalt)
|-
| <code>VC_AreaCADAlkisDE</code> || T2DAreaAlkisDE || [[CAD XML Syntax-Objekt VC AreaCADLTK und AlkisDE|Objekt VC_AreaCADLTK/AlkisDE]] || nur Sachsen-Anhalt (Anhalt)
|-
| <code>VC_CADVCBerechnung</code> || T3DVCBerechnung || [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|Objekt VC_CADVCBerechnung/VCMessung]] || alle
|-
| <code>VC_CADVCMessung</code> || T3DVCMessung || [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|Objekt VC_CADVCBerechnung/VCMessung]] || alle
|-
| <code>VC_CADBemassung</code> || T3DBemassung || [[CAD XML Syntax-Objekt VC CADBemassung|Objekt VC_CADBemassung]] || alle
|-
| <code>VC_CADKompo</code> || T3DKompo || [[CAD XML Syntax-Objekt VC CADKompo|Objekt VC_CADKompo]] || alle
|-
| <code>VC_CADText</code> || T2DText || [[CAD XML Syntax-Objekt VC CADText|Objekt VC_CADText]] || alle
|-
| <code>VC_CADVCPNRText</code> || T2DVCPNRText || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || alle
|-
| <code>VC_CADVCPNRParVMAKuerzelText</code> || T2DVCPNRParameterVMAKuerzelText || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || alle
|-
| <code>VC_CADVCPNRParVMAKuerzelOriginalText</code> || T2DVCPNRParameterVMAKuerzelText (mit <code>IsOriginal</code>-Flag) || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || alle
|-
| <code>VC_CADVCPNRParInGeradeText</code> || T2DVCPNRParameterInGeradeText || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || nur BW
|-
| <code>VC_CADVCPNRParInGeradeOriginalText</code> || T2DVCPNRParameterInGeradeText (mit <code>IsOriginal</code>-Flag) || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || nur BW
|-
| <code>VC_CADVCPNRParAufKreisbogenText</code> || T2DVCPNRParameterAufKreisbogenText || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || nur BW
|-
| <code>VC_CADVCPNRParAufKreisbogenOriginalText</code> || T2DVCPNRParameterAufKreisbogenText (mit <code>IsOriginal</code>-Flag) || [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] || nur BW
|-
| <code>VC_CADBoeschung</code> || T2DBoeschung || [[CAD XML Syntax-Objekt VC CADBoeschung|Objekt VC_CADBoeschung]] || alle
|-
| <code>VC_Hintergrundbild</code> || T2DBackgroundPicture || [[CAD XML Syntax-Objekt VC Hintergrundbild|Objekt VC_Hintergrundbild]] || alle
|}

Hinweise:
* Nicht alle Objekte heißen <code>VC_CAD*</code>: Plotrahmen und Hintergrundbild werden als <code>VC_Plotrahmen</code>/<code>VC_Hintergrundbild</code> (ohne „CAD") serialisiert.
* <code>T2DLine</code>, <code>T2DStartEndPunktLine</code>, <code>T2DAreaBase</code> sind abstrakte Zwischenklassen ohne eigenes Wurzeltag.
* Die PNRText-„Original"-Varianten sind KEINE eigenen Klassen: Die Factory erzeugt dieselbe Klasse wie die Normal-Variante und setzt zusätzlich das Flag <code>IsOriginal := True</code> (GLGeometrics.pas:83807/83819/83830). Die Unterscheidung steckt allein im Wurzeltag.

== Lesemechanik (drei Stufen) ==
# '''Factory''': Wurzeltag → Erzeugerfunktion (<code>Init_CreateCADObj_HashTable</code> → <code>NewObjectFromXML</code>). Die Objekt-Erzeugung wird erst beim Fund des <code>VermCadID</code>-Kindes ausgelöst.
# '''Element-Dispatch''' (<code>T3DBaseObject.CreateFromXML</code>, XmlLite-SAX-Reader): Elementknoten werden über die <code>CAD_XML_Reader_ComplexStructures_HashTable</code> (Struktur-/GUID-Referenz-Elemente, Attribute werden mitgegeben), Text-/CDATA-Knoten über die <code>CAD_XML_Reader_HashTable</code> (einfache Werte) auf Reader-IDs (<code>TCAD_XML_Reader_ID</code>) abgebildet. Das Ende eines Objekts wird über die Element-TIEFE erkannt (Tiefenzähler), nicht über End-Tag-Namen.
# '''PostProcessing''': nach dem Einlesen des Objekts (<code>InternalCreateFromXMLPostProcessing</code>, z. B. Qualitäts-Reparatur beim Punkt, Symbol-Selbstheilung); die GUID→Objekt-Auflösung erfolgt erst nach dem Laden ALLER Objekte über den GUID-Suchbaum ([[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID und GUID-Referenzen]]).

Fehlertoleranz:
* '''Unbekannte Tags werden stillschweigend übersprungen''' (nur im VCDEBUG-Build geloggt) — zusätzliche/fremde Elemente machen eine Datei nicht ungültig.
* Defekte Einzelwerte: Exception wird gefangen und geloggt, die restlichen Elemente des Objekts werden weitergelesen. Ein defektes Objekt bricht das Projektladen nicht ab.
* Objekte mit <code>Deleted=-1</code> werden nach dem Laden entfernt.

== Schreibreihenfolge der Objektgruppen ==
Innerhalb jeder <code>VCCADDaten</code>-Sektion schreibt VermCad in dieser festen Reihenfolge (referenzierte Objekte stehen dadurch VOR ihren Referenzierern — ein Erzeuger sollte sie einhalten, der Leser ist dank nachgelagerter Referenz-Auflösung aber tolerant):

# Rissdaten + <code>CurrRissID</code> ([[CAD XML Syntax-Sektion Rissdaten und Auswahlen|Sektion Rissdaten und Auswahlen]])
# Bearbeitungsgebiet (<code>BearbeitungsgebietAutomatisch</code>, <code>BearbeitungsgebietAutoMitFlaechen</code>, <code>Bearbeitungsgebiet</code>)
# <code>ObjektAuswahlen</code>
# '''Punkte''' (<code>VC_CADPunkt</code>, <code>VC_CADBMPunkt</code>) — nur mit gültigen X/Y-Koordinaten
# '''Punktsymbole''' — nur mit vorhandenem Referenz-Punkt
# '''Linien''' (SimpleLine, MeteredSimpleLine, Arc, Circle, Ellipse, Klotoide, Klothoide)
# '''Flächen''' (VCFlaeche, LTK [Anhalt], Flaeche)
# AlkisDE-Flächen (nur Anhalt)
# '''Kompos''' (VCBerechnung, VCMessung, Bemassung, Kompo)
# '''Texte''' (PNR-Text-Varianten, Text) — leere Texte werden nicht gespeichert
# '''Hintergrundbilder''' — nur wenn Textur geladen und Bilddatei existiert
# '''Plotrahmen'''
# '''Spezialobjekte''' (Böschung)

Speicherfilter: keine temporären Objekte; VC-generierte Objekte (<code>oaVC</code>/<code>oaVCDeleted</code>) nur, wenn Default-Eigenschaften geändert wurden oder ein verbundenes Objekt gespeichert werden muss.

== Minimalanforderungen je Objekt (Pflichtfelder) ==
{| class="wikitable"
! Regel !! Bedeutung
|-
| Registrierter Wurzeltag || sonst wird das gesamte Element ignoriert (Tabelle oben)
|-
| <code>VermCadID</code>-Block || '''zwingend''' — ohne ihn entsteht KEIN Objekt; <code>GUID</code> faktisch Pflicht, Duplikat-GUID → Objekt übersprungen; <code>ObjektArt</code> VOR <code>CADObjektArt</code> ([[CAD XML Syntax-VermCadID und GUID-Referenzen|Details]])
|-
| <code>Layer</code> || wird immer geschrieben; beim Lesen über den LayerManager aufgelöst ([[CAD XML Syntax-Basiselemente|Basiselemente]])
|}

Klassen-Minimum (Details auf den Objektseiten):
* '''Punkt''': <code>Position/gml:pos</code> — Punkte mit Fehlwert-Koordinaten werden beim nächsten Speichern verworfen.
* '''Linien''' (Start/End-Typen): <code>Startpunkt</code>- und <code>Endpunkt</code>-GUID; '''Kreis/Ellipse''': <code>Mittelpunkt</code>-GUID + Radius/Radien; '''Bogen''': zusätzlich <code>RatioDistRad</code> + <code>Spiegeln</code> (werden immer geschrieben), sinnvollerweise <code>BogenMittePoint</code>.
* '''Flächen''': <code>Rand/Exterior</code>-GUID auf ein Kompo, dessen <code>MemberGroup</code> die Randlinien enthält.
* '''Kompo''': <code>MemberGroup</code> mit ≥ 1 (sinnvoll ≥ 2) <code>Member</code>-GUIDs; ein leerer Kompo wird nicht gespeichert.
* '''Bemaßung''': <code>BasePoint1</code> + <code>BasePoint2</code> — sonst wird das Objekt beim Referenzen-Update verworfen.
* '''Texte''': Textinhalt im Kind-Element <code>VC_CADText</code> (leere Texte werden verworfen); für positionsgebundene Texte <code>Text_Referenzobjekt</code>.
* '''Punktsymbol''': Rückverweis nötig — der zugehörige Punkt braucht <code>PointSymbolGUID</code>/<code>WeitereSymbole</code> auf das Symbol; Symbole ohne Referenz-Punkt werden beim Speichern übersprungen.
* '''VCBerechnung/VCMessung''': strikte Element-Reihenfolge <code>MakroIDType</code> → <code>MakroIDNr</code> → <code>MakroIDName</code> → <code>VC_CADVCBerCalcKind</code> → <code>VC_CADVCBerechnungSettings</code> zwingend.

== Regeln fürs Erzeugen einer Projekt-XML ==
# Dateirahmen nach [[CAD XML Syntax-Uebersicht|Übersicht]] aufbauen (Prolog, Kommentar, <code>VCDaten</code> mit Namespaces, Metadaten inkl. <code>ObjectFileVersion</code>/<code>ObjectFileVCVersion</code> — nie höher als die Zielinstallation, siehe [[CAD XML Syntax-Versionierung und Kompatibilitaet|Versionierung]]).
# Je Koordinatensystem eine <code>VCCADDaten</code>-Sektion mit <code>KSID</code>-Attribut; darin zuerst <code>Rissdaten</code> (mindestens <code>RissEintrag_0</code> mit <code>RissName</code>+<code>RissID</code>) und <code>CurrRissID</code>.
# Objekte in der Schreibreihenfolge oben ausgeben; jedes Objekt: Wurzeltag → <code>VermCadID</code> (eindeutige GUID!) → benötigte [[CAD XML Syntax-Basiselemente|Basiselemente]] (mindestens <code>Layer</code>) → Klassen-Elemente.
# Nur Nicht-Default-Werte schreiben (fehlendes Element = Default); Formate strikt nach [[CAD XML Syntax-Werte- und Koordinatenformate|Werte- und Koordinatenformate]].
# Alle GUID-Referenzen müssen auf existierende Objekte derselben Datei zeigen — fehlende harte Referenzen führen zur Zerstörung des referenzierenden Objekts beim Laden.
# Keine Legacy-Tags schreiben ([[CAD XML Syntax-Versionierung und Kompatibilitaet|Alias-Tabelle]]).

== Verfügbarkeit und Besonderheiten ==
* Factory-Einträge <code>VC_AreaCADLTK</code>/<code>VC_AreaCADAlkisDE</code> existieren nur in der Sachsen-Anhalt-Version (IFDEF <code>Anhalt</code>); die vier <code>InGerade</code>/<code>AufKreisbogen</code>-PNR-Varianten nur in BW. Eine Datei mit solchen Tags wird in anderen Bundesland-Versionen trotzdem geladen — die unbekannten Tags werden dann still ignoriert (Datenverlust beim erneuten Speichern!).
* In den drei Referenz-Beispielprojekten (BW/Sachsen/THR) kommen <code>VC_CADBemassung</code>, <code>VC_CADBoeschung</code> und die beiden Anhalt-Flächentypen nicht vor — die Tags sind gleichwohl in der Factory registriert.
* Die Reader-IDs sind der Enum <code>TCAD_XML_Reader_ID</code>; Registrierung der einfachen Tags in <code>CAD_XML_Reader_HashTable</code>, der Struktur-Tags in <code>CAD_XML_Reader_ComplexStructures_HashTable</code>.

== Quellen im Code ==
* CAD\GLGeometrics.pas:96996-97034 — <code>Init_CreateCADObj_HashTable</code>: Factory-Tabelle (29 Tags)
* CAD\GLGeometrics.pas:83845-83952 — <code>TCADObjectManager.NewObjectFromXML</code>: VermCadID-Pflicht, Duplikat-GUID-Skip
* CAD\GLGeometrics.pas:6189-6261 — <code>T3DBaseObject.CreateFromXML</code>: Element-Dispatch, unbekannte Tags (6242-6246)
* CAD\GLGeometrics.pas:96747-96992 — Reader-Hash-Tabellen (einfach + komplex)
* CAD\GLTypes.pas:1782-2017 — <code>TCAD_XML_Reader_ID</code>
* CAD\GLGeometrics.pas:79499-80190 — <code>SaveXMLLite</code>: Schreibreihenfolge, Speicherfilter (79516/79524), Punkt-/Symbol-/Text-Filter (79669, 79712, 79982)
* CAD\GLGeometrics.pas:86090-86325 — <code>UpdateReferencesOrClean</code>: Referenz-Auflösung, Zerstörung fehlerhafter Objekte, <code>ClearAll(True)</code> für Deleted (86312)
* CAD\GLGeometrics.pas:5969-5975 — <code>IsCADObjectName</code> (= Factory-ContainsKey)

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

CAD XML Syntax-Basiselemente

2026-07-20T12:50:15Z

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

{{DISPLAYTITLE:CAD XML Syntax-Basiselemente}}
Alle CAD-Objekte erben von der Delphi-Klasse <code>T3DBaseObject</code> einen gemeinsamen Satz von Darstellungs- und Verwaltungselementen (Layer, Farben, Linienstile, Sichtbarkeit …). Diese Basiselemente stehen in jedem Objekt direkt nach dem [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID-Block]] und vor den klassenspezifischen Elementen. Diese Seite listet ALLE Basiselemente in Schreibreihenfolge; die Objektseiten verweisen hierher, statt sie zu wiederholen.

== Strukturregel ==
<pre>
<VC_CADxxx>
<VermCadID> … </VermCadID> (siehe VermCadID und GUID-Referenzen)
[<AlkisID>text</AlkisID>]
[<AlkisCanRender>bool</AlkisCanRender>] (nur wenn False)
[<Deleted>bool</Deleted>]
[<ImPapierkorb>bool</ImPapierkorb>]
[<Sichtbar>bool</Sichtbar>] (nur wenn False)
[<Name>text</Name>]
[<Bemerkung>text</Bemerkung>]
[<Oben>bool</Oben>]
[<Farbe>ganzzahl</Farbe>]
[<Fuellfarbe>ganzzahl</Fuellfarbe>]
[<Alpha>zahl</Alpha>]
[<Fuellalpha>zahl</Fuellalpha>]
[<Signaturnummer>text</Signaturnummer>]
[<VCBerLayerID>ganzzahl</VCBerLayerID>]
<Layer>ganzzahl</Layer> (einziges Pflicht-Basiselement — wird IMMER geschrieben)
[<LayerErben>bool</LayerErben>]
[<UseLayerAusSymboldefinition>bool</...>]
[<Linienstaerke>zahl</Linienstaerke>]
[<LinienendenFreistellen>ganzzahl</...>]
[<Liniensymbol>ganzzahl</Liniensymbol>]
[<Linienmuster>ganzzahl</Linienmuster>]
[<LineCloseType>ganzzahl</LineCloseType>]
[<LineDarstellungMessung>ganzzahl</...>]
[<LineDarstellungMessungMan>bool</...>]
[<TextStil>ganzzahl</TextStil>]
[<Textur>ganzzahl</Textur>]
[<SchraffurStil>ganzzahl</SchraffurStil>]
[<RissSichtbarkeit> {<RissEintrag_ID>0</RissEintrag_ID>}* </RissSichtbarkeit>]
[<SchraffurHauptkanteGUID GUID="guid"/>]
[<SchraffurHauptkanteAutomatisch>bool</...>] (nur wenn False)
[<BoeschungsSchraffurStil>ganzzahl</...>]
[<ReferenzPunkteInBemassungen>
{<ReferenzPunkteInBemassungenMember GUID="guid"/>}* </...>]
[<AlkisInitialDataErrors>
{<AlkisInitialDataError ErrorType="text"><Diff>zahl zahl</Diff></AlkisInitialDataError>}* </...>]
… klassenspezifische Elemente …
</VC_CADxxx>
</pre>

=== Schreibprinzip (write_xn_ + Init-Wert-Unterdrückung) ===
Ein Element wird nur geschrieben, wenn (1) sein Compile-Time-Schalter <code>write_xn_*</code> (Konstante neben der Tag-Konstante in <code>GlobalConsts.pas</code>) True ist UND (2) der Wert vom Initialwert abweicht (bei Strings zusätzlich <code>Trim ≠ ''</code>, bei Floats <code>not SameValue</code>). Konsequenzen:
* '''Fehlende Elemente bedeuten immer: Defaultwert.''' Ein Erzeuger schreibt nur Nicht-Default-Werte; ein Reparierer darf fehlende Elemente nicht als Fehler werten.
* Einzige Ausnahme: <code>Layer</code> wird IMMER geschrieben („Layer muss immer gespeichert werden!").
* Die Basiselemente werden nur bei CAD-artiger ObjektArt geschrieben (<code>oaCAD</code>, <code>oaAlkisCADRepr</code>, <code>oaVC</code>, <code>oaVCBer</code>, <code>oaVCDeleted</code>).

== Elemente ==
Reihenfolge der Tabelle = Schreibreihenfolge im Code. Werteformate siehe [[CAD XML Syntax-Werte- und Koordinatenformate|Werte- und Koordinatenformate]] (Bool = <code>-1</code>/<code>0</code>; Farben = TColor-Integer).

{| class="wikitable"
! Element !! Typ/Format !! Pflicht !! Default !! Bedeutung
|-
| <code>AlkisID</code> || Text (16-stellige GML-ID) || nein || '' || ALKIS-Objekt-ID der Quelle (bei <code>oaAlkisCADRepr</code>); Legacy-Tag <code>ALKIS_GMLID</code> wird gelesen
|-
| <code>AlkisCanRender</code> || bool || nein || True || ALKIS-Renderfreigabe (nur geschrieben, wenn False)
|-
| <code>Deleted</code> || bool || nein || False || als gelöscht markiert; solche Objekte werden nach dem Laden entfernt
|-
| <code>ImPapierkorb</code> || bool || nein || False || Objekt liegt im Papierkorb
|-
| <code>Sichtbar</code> || bool || nein || True || Sichtbarkeit (nur geschrieben, wenn False; bei <code>VC_CADVCFlaeche</code> aus dem KoordSystem der Fläche abgeleitet)
|-
| <code>Name</code> || Text || nein || '' || Objektname
|-
| <code>Bemerkung</code> || Text || nein || '' || Bemerkung
|-
| <code>Oben</code> || bool || nein || False || „OnTop" rendern
|-
| <code>Farbe</code> || ganzzahl (TColor) || nein || INHERIT || Linien-/Objektfarbe
|-
| <code>Fuellfarbe</code> || ganzzahl (TColor) || nein || INHERIT || Füllfarbe
|-
| <code>Alpha</code> || zahl || nein || INHERIT || Transparenz (<code>NAN</code> wird beim Lesen ignoriert)
|-
| <code>Fuellalpha</code> || zahl || nein || INHERIT || Füll-Transparenz
|-
| <code>Signaturnummer</code> || Text || nein || '' || Signaturnummer
|-
| <code>VCBerLayerID</code> || ganzzahl || nein || −1 || Layer für Berechnungsobjekte (nur bei gültiger Layer-ID geschrieben)
|-
| <code>Layer</code> || ganzzahl || '''ja''' || — || Layer-ID: Systemlayer negativ (System-ID ≤ −10), Nutzerlayer positiv. Siehe [[CAD-Folienverwaltung]]
|-
| <code>LayerErben</code> || bool || nein || False || Layer vom Parent-Objekt erben
|-
| <code>UseLayerAusSymboldefinition</code> || bool || nein || False || Layer aus der Punktzuordnung/Symboldefinition (Achtung: Tag-String weicht vom Konstantennamen <code>xn_UseLayerAusPunktzuordnung</code> ab)
|-
| <code>Linienstaerke</code> || zahl || nein || INHERIT || Linienstärke
|-
| <code>LinienendenFreistellen</code> || ganzzahl || nein || INHERIT || Freistellung der Linienenden
|-
| <code>Liniensymbol</code> || ganzzahl (Konfig-ID) || nein || INHERIT || Liniensymbol — [[CAD-Konfiguration-Liniensymbole|CAD-Konfiguration Liniensymbole]]; Lesen: −1 → NOTHING
|-
| <code>Linienmuster</code> || ganzzahl (Konfig-ID) || nein || INHERIT || Linienmuster — [[CAD-Konfiguration-Linienmuster|CAD-Konfiguration Linienmuster]]
|-
| <code>LineCloseType</code> || ganzzahl || nein || INHERIT || Linienabschluss-Typ-ID
|-
| <code>LineDarstellungMessung</code> || ganzzahl || nein || FROMLAYER || Messungs-Darstellungs-ID
|-
| <code>LineDarstellungMessungMan</code> || bool || nein || False || Messungs-Darstellung manuell gesetzt
|-
| <code>TextStil</code> || ganzzahl (Konfig-ID) || nein || INHERIT || Textstil — [[CAD-Konfiguration-Textstile|CAD-Konfiguration Textstile]]; Lesen: −1 → INDIVIDUAL
|-
| <code>Textur</code> || ganzzahl (Konfig-ID) || nein || INHERIT || Textur — [[CAD-Konfiguration-Texturen|CAD-Konfiguration Texturen]]
|-
| <code>SchraffurStil</code> || ganzzahl (Konfig-ID) || nein || INHERIT || Schraffurstil — [[CAD-Konfiguration-Schraffurstile|CAD-Konfiguration Schraffurstile]]
|-
| <code>RissSichtbarkeit</code> || Container || nein || leer || je Riss, in dem das Objekt UNSICHTBAR ist, ein Kind <code>RissEintrag_<RissID></code> mit Wert <code>0</code> — siehe [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]]
|-
| <code>SchraffurHauptkanteGUID</code> || GUID-Attribut-Element || nein || — || Referenz auf die Kanten-Linie der Schraffur (nur wenn nicht automatisch, GUID gesetzt und Kante existiert)
|-
| <code>SchraffurHauptkanteAutomatisch</code> || bool || nein || True || Hauptkante automatisch bestimmen (nur geschrieben, wenn False)
|-
| <code>BoeschungsSchraffurStil</code> || ganzzahl (Konfig-ID) || nein || INHERIT || Böschungsschraffurstil — [[CAD-Konfiguration-Boeschungsschraffurstile|CAD-Konfiguration Böschungsschraffurstile]]
|-
| <code>ReferenzPunkteInBemassungen</code> || Container || nein || leer || je Eintrag <code><ReferenzPunkteInBemassungenMember GUID="{…}"/></code>; Rückreferenz Punkt → Bemaßungen ([[CAD XML Syntax-Objekt VC CADBemassung|Objekt VC_CADBemassung]])
|-
| <code>AlkisInitialDataErrors</code> || Container || nein || leer || ALKIS-Initialdaten-Fehler: Kinder <code>AlkisInitialDataError</code> mit Attribut <code>ErrorType</code> (belegt: <code>aideBogenMitte</code>) und Kind <code>Diff</code> (Zahlenpaar)
|}

<code>Verankert</code> (bool, Default False) gehört historisch zu den Basis-Tags, wird heute aber von <code>VC_CADPunkt</code> und <code>VC_Hintergrundbild</code> geschrieben — siehe dortige Objektseiten.

== Magic-Werte (Markerwerte statt echter Werte) ==
Stil- und Farbfelder tragen sehr oft keinen echten Wert, sondern einen Markerwert (<code>IntFehlwert</code> = MaxInt−1 = 2147483646):

{| class="wikitable"
! Konstante !! Wert !! Bedeutung
|-
| <code>PROPERTY_VALUE_INHERIT</code> || 2147483645 || Eigenschaft wird vom Layer/Parent geerbt (Init-Default fast aller Stilfelder)
|-
| <code>PROPERTY_VALUE_FROMLAYER</code> || 2147483644 || explizit „vom Layer" — der in echten Dateien dominierende Wert
|-
| <code>PROPERTY_VALUE_NOTHING</code> || 2147483643 || „keins" (z. B. kein Liniensymbol)
|-
| <code>PROPERTY_VALUE_INDIVIDUAL</code> || 2147483642 || individueller Wert (= <code>PROPERTY_VALUE_BG_COLOR</code>)
|}

* Beobachtete Realwerte: <code><Farbe>2147483644</Farbe></code> in praktisch allen Fällen; bei <code>LinienendenFreistellen</code> zusätzlich <code>2147483641</code>.
* Legacy-Lesen: alte negative Kodierungen (−1 = „von Layer") werden beim Einlesen über WORKAROUND-Blöcke in diese Konstanten umgesetzt; System-Konfig-IDs (≤ −101, <code>SYSTEM_MIN_CONFIG_ID</code>) bleiben erhalten. Alte Hintergrundfarben werden auf <code>PROPERTY_VALUE_BG_COLOR</code> gemappt.
* Layer-Sonderfall: der alte Gelöscht-Dummy-Layer (<code>OLD_LID_DELETEDLAYER_OLD_DUMMY</code>) wird beim Lesen auf den aktuellen Gelöscht-Layer umgesetzt.

== Beispiele ==
=== Beispiel (BW, echt — kompletter Darstellungsblock eines Berechnungs-Hilfspunkts) ===
<pre>
<Sichtbar>0</Sichtbar>
<Farbe>2147483644</Farbe>
<Fuellfarbe>2147483644</Fuellfarbe>
<Alpha>2147483644</Alpha>
<Fuellalpha>2147483644</Fuellalpha>
<VCBerLayerID>-3002</VCBerLayerID>
<Layer>-102</Layer>
<LayerErben>-1</LayerErben>
<Linienstaerke>2147483644</Linienstaerke>
<LinienendenFreistellen>2147483644</LinienendenFreistellen>
<Liniensymbol>2147483644</Liniensymbol>
<Linienmuster>2147483644</Linienmuster>
<LineCloseType>2147483644</LineCloseType>
<TextStil>2147483644</TextStil>
<Textur>2147483644</Textur>
<SchraffurStil>2147483644</SchraffurStil>
<BoeschungsSchraffurStil>2147483644</BoeschungsSchraffurStil>
</pre>

=== Beispiel (THR, echt — AlkisInitialDataErrors an einem Bogen) ===
<pre>
<AlkisInitialDataErrors>
<AlkisInitialDataError ErrorType="aideBogenMitte">
<Diff>0 -0.001</Diff>
</AlkisInitialDataError>
</AlkisInitialDataErrors>
</pre>

== Verfügbarkeit und Besonderheiten ==
* Alle Basiselemente sind in allen Bundesland-Versionen identisch.
* Minimalfall in echten Dateien: nur <code><Layer></code> zwischen <code>VermCadID</code> und den Klassen-Elementen (z. B. ALKIS-Repräsentanten).
* Beobachtete Layer-ID-Bereiche: <code>-100xxx</code> ALKIS-Layer, <code>-1xxx</code> Punktnummern-Layer, <code>-3xxx</code>/<code>-45xx</code>/<code>-5xxx</code>/<code>-6xxx</code> Berechnungs-/Messungslayer, <code>-11</code> Plotrahmen; positive IDs = Benutzerlayer.
* Fehlerhafte Einzelwerte beim Lesen werden geloggt, das restliche Objekt wird weitergelesen ([[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik]]).

== Quellen im Code ==
* CAD\GLGeometrics.pas:6584-6839 — <code>T3DBaseObject.DataToXMLLite</code>: Schreibreihenfolge und -bedingungen (Layer immer: 6677)
* CAD\GLGeometrics.pas:6350-6524 — <code>InternalCreateFromXML</code>: Lesen, NAN-Behandlung, Farb-/Layer-Workarounds (6377-6515, 6420-6428)
* CAD\GLGeometrics.pas:6271-6348 — <code>InternalCreateComplexStructsFromXML</code>: RissSichtbarkeit, SchraffurHauptkanteGUID, ReferenzPunkteInBemassungen, AlkisInitialDataErrors
* CAD\GLGeometrics.pas:6738-6775, 6802-6823 — RissSichtbarkeit-/ReferenzPunkte-Container
* CAD\GLConsts.pas:435-444, 473-503 — <code>PROPERTY_VALUE_*</code>, <code>INIT_T3DBASEOBJECT_*</code>
* VERMCAD\GlobalConsts.pas:156, 357 — <code>SYSTEM_MIN_CONFIG_ID</code>, <code>IntFehlwert</code>
* VERMCAD\GlobalTypConsts.pas:522-523 — <code>INIT_TOBJBASE_*</code>

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

CAD XML Syntax

2026-07-20T12:50:14Z

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

{{DISPLAYTITLE:CAD XML Syntax}}
Regelbasierte Referenz der VermCad-Projekt-XML-Datei (Endung <code>.xml</code>, Wurzelelement <code>VCDaten</code>). Die Projekt-XML bildet zusammen mit der Messwertdatei (<code>.mwt</code>, siehe [[MWT Syntax]]) und der ALKIS-Fachdatendatei (<code>.nas</code>) ein VermCad-Projekt. Sie enthält alle CAD-Objekte (Punkte, Linien, Texte, Flächen …) mit ihrer Darstellung und Topologie. Diese Referenz ist maschinenlesbar aufbereitet, so dass auch eine KI eine Projekt-XML lesen, reparieren und erzeugen kann.

Dokumentiert ist die CAD-Sektion (<code>VCCADDaten</code>) vollständig; die ALKIS- und Plot-Sektionen sind im [[CAD XML Syntax-Sektion AlkisDaten und PlotDaten|Überblick]] beschrieben.

== Grundlagen ==

* [[CAD XML Syntax-Uebersicht|Übersicht]] — Dateiaufbau, Sektionen, Metadaten, Encoding
* [[CAD XML Syntax-Versionierung und Kompatibilitaet|Versionierung und Kompatibilität]] — ObjectFileVersion, Versionsprüfung, Legacy-Aliase
* [[CAD XML Syntax-VermCadID und GUID-Referenzen|VermCadID und GUID-Referenzen]] — Objektidentität, Referenzmechanik, Fehlerverhalten
* [[CAD XML Syntax-Basiselemente|Basiselemente]] — gemeinsame Elemente aller CAD-Objekte (Layer, Farben, Linienstile …)
* [[CAD XML Syntax-Werte- und Koordinatenformate|Werte- und Koordinatenformate]] — Float/Bool/Enum/GUID/gml:pos
* [[CAD XML Syntax-Lesemechanik und Pflichtfelder|Lesemechanik und Pflichtfelder]] — Factory, Schreibreihenfolge, Minimalanforderungen

== Sektionen ==

* [[CAD XML Syntax-Sektion VCCADDaten|Sektion VCCADDaten]] — CAD-Container je Koordinatensystem (KSID/LSID/Zone)
* [[CAD XML Syntax-Sektion Rissdaten und Auswahlen|Sektion Rissdaten und Auswahlen]] — Riss-Verwaltung, Objektauswahlen, Bearbeitungsgebiet
* [[CAD XML Syntax-Sektion AlkisDaten und PlotDaten|Sektion AlkisDaten und PlotDaten]] — Überblick VC_AlkisDaten und VC_PlotDaten
* [[CAD XML Syntax-Rissdaten an Objekten|Rissdaten an Objekten]] — RissEintrag-Strukturen an Punkten, Texten und Bemaßungen

== CAD-Objekte ==

Alle in der Objekt-Factory registrierten Wurzeltags. „Bundesland" = Einschränkung durch bedingte Kompilierung; ohne Angabe = alle Editionen.

{| class="wikitable"
! XML-Tag !! Delphi-Klasse !! Seite !! Bundesland
|-
| <code>VC_CADPunkt</code> || T3DPoint || [[CAD XML Syntax-Objekt VC CADPunkt|Objekt VC_CADPunkt]] ||
|-
| <code>VC_CADBMPunkt</code> || T3DBMPoint || [[CAD XML Syntax-Objekt VC CADBMPunkt|Objekt VC_CADBMPunkt]] ||
|-
| <code>VC_CADPunktsymbol</code> || T3DPointSymbol || [[CAD XML Syntax-Objekt VC CADPunktsymbol|Objekt VC_CADPunktsymbol]] ||
|-
| <code>VC_CADSimpleLine</code> || T2DSimpleLine || [[CAD XML Syntax-Objekt VC CADSimpleLine|Objekt VC_CADSimpleLine]] ||
|-
| <code>VC_CADMeteredSimpleLine</code> || T2DMeteredSimpleLine || [[CAD XML Syntax-Objekt VC CADMeteredSimpleLine|Objekt VC_CADMeteredSimpleLine]] ||
|-
| <code>VC_CADArcLine</code> || T2DArcLine || [[CAD XML Syntax-Objekt VC CADArcLine|Objekt VC_CADArcLine]] ||
|-
| <code>VC_CADCircleLine</code> || T2DCircleLine || rowspan="2" | [[CAD XML Syntax-Objekt VC CADCircleLine und EllipseLine|Objekt VC_CADCircleLine und EllipseLine]] ||
|-
| <code>VC_CADEllipseLine</code> || T2DEllipseLine ||
|-
| <code>VC_CADKlotoideLine</code> || T2DKlotoideLine || rowspan="2" | [[CAD XML Syntax-Objekt VC CADKlotoide|Objekt VC_CADKlotoide]] ||
|-
| <code>VC_CAD_Klothoide</code> || T2DKlothoide ||
|-
| <code>VC_CADText</code> || T2DText || [[CAD XML Syntax-Objekt VC CADText|Objekt VC_CADText]] ||
|-
| <code>VC_CADVCPNRText</code> || T2DVCPNRText || rowspan="7" | [[CAD XML Syntax-Objekt VC CADVCPNRText und Varianten|Objekt VC_CADVCPNRText und Varianten]] ||
|-
| <code>VC_CADVCPNRParVMAKuerzelText</code> || T2DVCPNRParameterVMAKuerzelText ||
|-
| <code>VC_CADVCPNRParVMAKuerzelOriginalText</code> || T2DVCPNRParameterVMAKuerzelText (IsOriginal) ||
|-
| <code>VC_CADVCPNRParInGeradeText</code> || T2DVCPNRParameterInGeradeText || nur BW
|-
| <code>VC_CADVCPNRParInGeradeOriginalText</code> || T2DVCPNRParameterInGeradeText (IsOriginal) || nur BW
|-
| <code>VC_CADVCPNRParAufKreisbogenText</code> || T2DVCPNRParameterAufKreisbogenText || nur BW
|-
| <code>VC_CADVCPNRParAufKreisbogenOriginalText</code> || T2DVCPNRParameterAufKreisbogenText (IsOriginal) || nur BW
|-
| <code>VC_CADFlaeche</code> || T2DArea || rowspan="2" | [[CAD XML Syntax-Objekt VC CADFlaeche und VCFlaeche|Objekt VC_CADFlaeche und VCFlaeche]] ||
|-
| <code>VC_CADVCFlaeche</code> || T2DVCArea ||
|-
| <code>VC_AreaCADLTK</code> || T2DAreaLTK || rowspan="2" | [[CAD XML Syntax-Objekt VC AreaCADLTK und AlkisDE|Objekt VC_AreaCADLTK und AlkisDE]] || nur Sachsen-Anhalt
|-
| <code>VC_AreaCADAlkisDE</code> || T2DAreaAlkisDE || nur Sachsen-Anhalt
|-
| <code>VC_Plotrahmen</code> || T2DPlotFrame || [[CAD XML Syntax-Objekt VC Plotrahmen|Objekt VC_Plotrahmen]] ||
|-
| <code>VC_CADKompo</code> || T3DKompo || [[CAD XML Syntax-Objekt VC CADKompo|Objekt VC_CADKompo]] ||
|-
| <code>VC_CADBemassung</code> || T3DBemassung || [[CAD XML Syntax-Objekt VC CADBemassung|Objekt VC_CADBemassung]] ||
|-
| <code>VC_CADVCBerechnung</code> || T3DVCBerechnung || rowspan="2" | [[CAD XML Syntax-Objekt VC CADVCBerechnung und VCMessung|Objekt VC_CADVCBerechnung und VCMessung]] ||
|-
| <code>VC_CADVCMessung</code> || T3DVCMessung ||
|-
| <code>VC_CADBoeschung</code> || T2DBoeschung || [[CAD XML Syntax-Objekt VC CADBoeschung|Objekt VC_CADBoeschung]] ||
|-
| <code>VC_Hintergrundbild</code> || T2DBackgroundPicture || [[CAD XML Syntax-Objekt VC Hintergrundbild|Objekt VC_Hintergrundbild]] ||
|}

Hinweis: Die Tags <code>VC_Plotrahmen</code> und <code>VC_Hintergrundbild</code> tragen kein „CAD" im Namen; <code>VC_CAD_Klothoide</code> hat einen zusätzlichen Unterstrich. Die „Original"-Varianten der Punktnummerntexte sind keine eigenen Klassen, sondern dieselbe Klasse mit gesetztem <code>IsOriginal</code>-Flag.

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

CAD-Funktionen-Texteingabe

2025-05-11T19:53:19Z

Hahn: /* Besonderheit: Linientexte */

{{Hilfe:Navigation|[[Hauptseite]] > [[CAD]] > '''[[CAD-Symbolleiste, Funktionen & Werkzeuge|Symbolleiste, Funktionen & Werkzeuge]]'''|{{Hilfe:Artikel:CAD:Symbolleiste}}}}

{{Hilfe:Artikeltitel|Texteingabe}}

Sowohl in den [[CAD-Objektinformationen|Objektinformationen]] als auch im [[CAD-Konfiguration-Textstile|Textstil]] können Texte mit Inhalt gefüllt werden. Dazu können auch Platzhalter verwendet werden, die man über das Kontextmenü der Texteingabe aufrufen kann.

==Texteingabe==

[[Datei:Texteingabe.png]]

Für den Platzhalter können verschiedenste Einträge über Auftrags-, Projekt-, Büro- und objektspezifische Daten gewählt werden.

[[Datei:Texteingabe_Menu.png]]

==Besonderheit: Nummerierungsbezirk {NBZ}==

Eine Besonderheit stellt der Nummerierungsbezirk {NBZ} dar. Hier können per "$" und ":" Zwischenzeichen an vorgegebenen Positionen gesetzt werden.

<pre>
Beispiel:

Die Eingabe von {NBZ$|:2:6} setzt das Zeichen "|" nach der 2. und 6. Stelle im resultierenden NBZ-Text, z.B. "33|5627|84".
</pre>

Das gleiche gilt für die Gauß-Krüger-Nummerierungsbezirke {NBZ_GK111} und {NBZ_GK112}. Zur Anzeige dieser NBZ ist eine gültige NTv2-Rasterdatei nötig, die die Auftrags-UTM-Koordinaten in Gauß-Krüger überführen kann.

==Besonderheit: Einkürzen von Wörtern==

Eine weitere Besonderheit bildet das Einkürzen einzelner Wörter ab. 
Das kann hilfreich sein, um z.B. bei Schlüsselworten nur eine bestimmte Anzahl an Buchstaben zu erhalten.

<pre>
per {>+N} VOR einem Wort bleiben nur so viele Buchstaben des Wortes am Anfang stehen (z.B. "{>+3}VermCad" wird zu "Ver" im Ergebnistext)
per {>-N} VOR einem Wort werden so viele Buchstaben des Wortes am Anfang entfernt (z.B. "{>-3}VermCad" wird zu "mCad" im Ergebnistext)
per {<+N} NACH einem Wort bleiben nur so viele Buchstaben des Wortes am Ende stehen (z.B. "VermCad{<+3}" wird zu "Cad" im Ergebnistext)
per {<-N} NACH einem Wort werden so viele Buchstaben des Wortes am Ende entfernt (z.B. "VermCad{<-3}" wird zu "Verm" im Ergebnistext)
</pre>

==Besonderheit: Linientexte / Flächentexte (Objekttexte)==

{|
|-
||$L$
||
||
||Länge aus Koordinaten
|-
||$LO$
||
||
||Länge in Örtlichkeit
|-
||$LG$
||
||
||Länge gemessen
|-
||...
||
||
||...
|}

Die ganze Liste an Vorgabe-Platzhaltern finden Sie unter [[CAD-Konfiguration-Textstile|'''Textstile''']]

{{Hilfe:NachOben}}

{{Hilfe:NachOben}}

CAD-Funktionen-Texteingabe

2025-05-11T19:51:52Z

Hahn: /* Besonderheit: Linientexte */

{{Hilfe:Navigation|[[Hauptseite]] > [[CAD]] > '''[[CAD-Symbolleiste, Funktionen & Werkzeuge|Symbolleiste, Funktionen & Werkzeuge]]'''|{{Hilfe:Artikel:CAD:Symbolleiste}}}}

{{Hilfe:Artikeltitel|Texteingabe}}

Sowohl in den [[CAD-Objektinformationen|Objektinformationen]] als auch im [[CAD-Konfiguration-Textstile|Textstil]] können Texte mit Inhalt gefüllt werden. Dazu können auch Platzhalter verwendet werden, die man über das Kontextmenü der Texteingabe aufrufen kann.

==Texteingabe==

[[Datei:Texteingabe.png]]

Für den Platzhalter können verschiedenste Einträge über Auftrags-, Projekt-, Büro- und objektspezifische Daten gewählt werden.

[[Datei:Texteingabe_Menu.png]]

==Besonderheit: Nummerierungsbezirk {NBZ}==

Eine Besonderheit stellt der Nummerierungsbezirk {NBZ} dar. Hier können per "$" und ":" Zwischenzeichen an vorgegebenen Positionen gesetzt werden.

<pre>
Beispiel:

Die Eingabe von {NBZ$|:2:6} setzt das Zeichen "|" nach der 2. und 6. Stelle im resultierenden NBZ-Text, z.B. "33|5627|84".
</pre>

Das gleiche gilt für die Gauß-Krüger-Nummerierungsbezirke {NBZ_GK111} und {NBZ_GK112}. Zur Anzeige dieser NBZ ist eine gültige NTv2-Rasterdatei nötig, die die Auftrags-UTM-Koordinaten in Gauß-Krüger überführen kann.

==Besonderheit: Einkürzen von Wörtern==

Eine weitere Besonderheit bildet das Einkürzen einzelner Wörter ab. 
Das kann hilfreich sein, um z.B. bei Schlüsselworten nur eine bestimmte Anzahl an Buchstaben zu erhalten.

<pre>
per {>+N} VOR einem Wort bleiben nur so viele Buchstaben des Wortes am Anfang stehen (z.B. "{>+3}VermCad" wird zu "Ver" im Ergebnistext)
per {>-N} VOR einem Wort werden so viele Buchstaben des Wortes am Anfang entfernt (z.B. "{>-3}VermCad" wird zu "mCad" im Ergebnistext)
per {<+N} NACH einem Wort bleiben nur so viele Buchstaben des Wortes am Ende stehen (z.B. "VermCad{<+3}" wird zu "Cad" im Ergebnistext)
per {<-N} NACH einem Wort werden so viele Buchstaben des Wortes am Ende entfernt (z.B. "VermCad{<-3}" wird zu "Verm" im Ergebnistext)
</pre>

==Besonderheit: Linientexte==

{|
|-
||$L$
||
||
||Länge aus Koordinaten
|-
||$LO$
||
||
||Länge in Örtlichkeit
|-
||$LG$
||
||
||Länge gemessen
|-
||...
||
||
||...
|}

Die ganze Liste an Linien-Parametern finden Sie unter [[CAD-Konfiguration-Textstile|'''Textstile''']]

{{Hilfe:NachOben}}

{{Hilfe:NachOben}}

CAD-Funktionen-Texteingabe

2025-05-11T19:51:29Z

Hahn:

{{Hilfe:Navigation|[[Hauptseite]] > [[CAD]] > '''[[CAD-Symbolleiste, Funktionen & Werkzeuge|Symbolleiste, Funktionen & Werkzeuge]]'''|{{Hilfe:Artikel:CAD:Symbolleiste}}}}

{{Hilfe:Artikeltitel|Texteingabe}}

Sowohl in den [[CAD-Objektinformationen|Objektinformationen]] als auch im [[CAD-Konfiguration-Textstile|Textstil]] können Texte mit Inhalt gefüllt werden. Dazu können auch Platzhalter verwendet werden, die man über das Kontextmenü der Texteingabe aufrufen kann.

==Texteingabe==

[[Datei:Texteingabe.png]]

Für den Platzhalter können verschiedenste Einträge über Auftrags-, Projekt-, Büro- und objektspezifische Daten gewählt werden.

[[Datei:Texteingabe_Menu.png]]

==Besonderheit: Nummerierungsbezirk {NBZ}==

Eine Besonderheit stellt der Nummerierungsbezirk {NBZ} dar. Hier können per "$" und ":" Zwischenzeichen an vorgegebenen Positionen gesetzt werden.

<pre>
Beispiel:

Die Eingabe von {NBZ$|:2:6} setzt das Zeichen "|" nach der 2. und 6. Stelle im resultierenden NBZ-Text, z.B. "33|5627|84".
</pre>

Das gleiche gilt für die Gauß-Krüger-Nummerierungsbezirke {NBZ_GK111} und {NBZ_GK112}. Zur Anzeige dieser NBZ ist eine gültige NTv2-Rasterdatei nötig, die die Auftrags-UTM-Koordinaten in Gauß-Krüger überführen kann.

==Besonderheit: Einkürzen von Wörtern==

Eine weitere Besonderheit bildet das Einkürzen einzelner Wörter ab. 
Das kann hilfreich sein, um z.B. bei Schlüsselworten nur eine bestimmte Anzahl an Buchstaben zu erhalten.

<pre>
per {>+N} VOR einem Wort bleiben nur so viele Buchstaben des Wortes am Anfang stehen (z.B. "{>+3}VermCad" wird zu "Ver" im Ergebnistext)
per {>-N} VOR einem Wort werden so viele Buchstaben des Wortes am Anfang entfernt (z.B. "{>-3}VermCad" wird zu "mCad" im Ergebnistext)
per {<+N} NACH einem Wort bleiben nur so viele Buchstaben des Wortes am Ende stehen (z.B. "VermCad{<+3}" wird zu "Cad" im Ergebnistext)
per {<-N} NACH einem Wort werden so viele Buchstaben des Wortes am Ende entfernt (z.B. "VermCad{<-3}" wird zu "Verm" im Ergebnistext)
</pre>

==Besonderheit: Linientexte==

{|
|-
||$L$
||
||
||Länge aus Koordinaten
|-
||$LO$
||
||
||Länge in Örtlichkeit
|-
||$LG$
||
||
||Länge gemessen
|-
||...
||
||
||...
|}

Die ganze Liste an Linien-Parametern finden Sie unter [[''Textstile''|CAD-Konfiguration-Textstile]]

{{Hilfe:NachOben}}

{{Hilfe:NachOben}}

Optionen Menü-Das Dialogfenster Speichern-Einstellungen

2024-12-17T07:33:01Z

Hahn: /* Informationen zum Ring-Logging */

{{Hilfe:Navigation|[[Hauptseite]] > '''[[Das Optionen Menü]]'''|{{Hilfe:Artikel:OptionenMenu}}}}

{{Hilfe:Artikeltitel|Das Dialogfenster Speichern-Einstellungen}}

Dieses Dialogfenster dient der Einstellung des Speicherns ihrer Projekt-Daten. Es bietet die Möglichkeit, VermCad automatisch speichern zu lassen, Sicherheitskopien ihrer Projekte anzulegen und das Speichern zu beschleunigen bzw. nach ihren Ansprüchen zu optimieren. Denn vor allem die Projekt-Objekt-Datei (XML) und Projekt-ALKIS-Datei (NAS) muss viele Daten halten und kann entsprechend groß werden.

Mit dem Experten-Modus können sie detaillierte Einstellungen vornehmen. Ohne den Experten-Modus werden nur die grundsätzlichen Einstellungen angeboten, um auch den Überblick besser wahren zu können. Alle mit dem kleinen grünen Punkt versehenen Einstellungen gehören zum Experten-Modus.

[[File:Optionen Fenster Speichern-Einstellungen.PNG|800px]]

{| class="wikitable"
|-
||''Automatisches Speichern (AutoSave)''
||aktiviert das autom. Speichern, also das Speichern ihrer Dateien/Projekt nach einem eingestellten Zeitraster
|-
||''Ziel: Wohin soll autom. gespeichert werden?''
||es kann direkt '''ins Projekt-Verzeichnis''' gespeichert und damit die Original Dateien überschrieben werden; oder man speichert in ein selbst gewähltes '''Verzeichnis''' [...] ( es können hier auch relative Pfade verwendet werden: z.B. "save" speichert parallel zum Projekt in den Ordner "\save\")
|-
||''Intervall: Wann soll gespeichern werden?''
||legt fest, in welchem Abstand (Minuten) ein automatisches Speichern durchgeführt werden soll
|-
||''dynamisch''
||hier kann eingestellt werden, dass nach Ablaufen des Intervalls das Speichern erst dann durchgeführt werden soll, wenn eine Zeit lang keine Aktion in Vermcad ausgeführt wurde; damit aber dadurch das autom. Speichern nicht ganz abgeschaltet wird, kann man angeben, nach welcher Zeit dann spätestens doch gespeichert werden soll ("dynamisch" lohnt sich, wenn Sie in Ihrer Arbeit in VermCad durch das autom. Speichern nicht gestört/aufgehalten werden wollen)
|-
||''CAD-Daten (XML/NAS) mit speichern''
||das Speichern der Objekt-Daten kann je nach Projekt-Größe unterschiedlich groß sein - dazu kann hier angegeben werden, beim wie vielten Zyklus des autom. Speicherns auch die CAD-XML bzw. -NAS mit gespeichert werden soll
|-
||''Sicherheitskopien ([[Optionen_Menü-Das_Dialogfenster_Speichern-Einstellungen#Informationen_zum_Ring-Logging|Ring-Logging]])''
||legt zusätzlich die angegebene Anzahl an Sicherheitskopien an; wird ins Projekt-Verzeichnis gespeichert, so wird dort autom. ein ("RingLog"-)Ordner mit dem Projekt-Namen angelegt, in dem die Sicherheitskopien landen
{{Hilfe:Hinweis|Siehe auch Zusatz-Informationen unten zum [[Optionen_Menü-Das_Dialogfenster_Speichern-Einstellungen#Informationen_zum_Ring-Logging|Ring-Logging]].}}
|-
||''[[Optionen_Menü-Das_Dialogfenster_Speichern-Einstellungen#Informationen_zum_Ring-Logging|Ring-Logging]]-Kopien beim Schließen des Projektes erhalten''
||behält die Sicherheitskopien des [[Optionen_Menü-Das_Dialogfenster_Speichern-Einstellungen#Informationen_zum_Ring-Logging|Ring-Loggings]] auch nach Beenden von VermCad bzw. dem Schließen von Projekt/Datei
|-
||''Immer alles speichern (Editor-Datei + XML + NAS)''
||Es wird auch dann zyklisch zum Intervall gespeichert, wenn in der Zeit zwischen 2 autom. Speicher-Vorgängen keine Änderungen (an Editor-Datei/XML/NAS) gemacht wurden
|-
||''Auch vom Anwender gespeicherte Änderungen automatisch speichern''
||Werden Änderungen an Dateien/CAD vorgenommen und gespeichert und dann kommt irgendwann das autom. Speichern dran, dann kann man mit diesem Schalter sagen, dass das autom. Speichern trotzdem noch durchgeführt wird (das ist nicht der Fall, wenn dieser Schalter AUS gestellt wird)
|-
||''BACKUP - Speicherung bei Versions-Änderung''
||Wird das Projekt mit einer neuen VermCad-Version gestartet, wird ein Backup der Datei(en) im AutoSave-Verzeichnis\Backup_Version angelegt
|-
||
|-
||''Lokales Verzeichnis zum Zwischenspeichern''
||Beschleunigt das Speichern, da das Projekt zunächst nur lokal gespeichert und dann in das Ziel-Verzeichnis kopiert wird, während man in VermCad bereits weiter arbeiten kann (das wird allerdings nicht für das automatische Speichern (AutoSave) verwendet; ein AutoSave sollte immer lokal stattfinden, um so die Performance zu sichern)
|-
||''Beschleunigung des Kopiervorgangs Zwischen-Verzeichnis -> Ziel-Verzeichnis''
||Zeigt einen Dialog, während des Kopierens der zwischengespeicherten Datei ins Zielverzeichnis. Dieser Dialog bschleunigt auch das Kopieren, da andere Prozesse im Hintergrund unterbunden werden.
|-
||
|-
||''CAD-Projekt-XML/NAS-Speicherung in VermCad deaktivieren''
||Schaltet das Speichern der CAD-Objekt-Daten (XML/NAS) komplett ab - es wird nur die Projekt-Datei (MWT) gespeichert
|-
||''Im Anschluss an das Speichern einer CAD-Projekt-XML-/NAS-Datei prüfen, ob die Datei ein gültiges Format besitzt''
||Dabei wird (intern) das Einlesen der Datei getestet und so gesichert, dass die Datei korrekt gespeichert wurde (benötigt 20-30% der Speichern-Zeit)
|-
||''Bei automatischen Änderungen das Speichern direkt aktivieren''
||damit wird das Speichern nach automatischen Änderungen (Einlesekorrekturen, F8/F9, ...) immer gleich mit aktiviert
|-
||
|-
||''Standard''
||Stellt die Standard-Speichern-Einstellungen wieder her
|-
||''Daten vom Hauptnutzer''
||ermittelt die Speichern-Einstellungen des Hauptnutzers und stellt diese ein
|}

== Informationen zum Ring-Logging ==

Das Ring-Logging speichert im angegebenen Ziel-Verzeichnis die veränderten Projekt-Dateien unter <projektname>.mwt, *.xml und *.nas und zusätzlich je Speichervorgang eine <projektname>_RingLog_<NR>.mwt, *.xml und *.nas. <NR> fängt bei 1 an und geht bis zur angegebenen Anzahl an Sicherheitskopien und fängt dann wieder bei 1 an.

Dabei passen je die Dateien mit gleicher <NR> zusammen. Ist ein Dateityp einmal nicht vorhanden, dann ist die entsprechende Original-Projekt-Datei aktuell (und unterlag zum Zeitpunkt der autom. Speicherung keiner Änderung, so dass keine RingLog-Kopie nötig war)

Ist die weitere Einstellung "Immer alles speichern" aktiv, werden bei jedem autom. Speichervorgang auch immer alle Projekt-Dateien (*.mwt, *.xml und *.nas) pro RingLog-<NR> gesichert.

Abschließend ist noch einmal wichtig zu betonen, dass im Zielverzeichnis des autom. Speicherns die Projekt-Dateien mit <projektname>.mwt, *.xml und *.nas (ohne RingLog-Zusatz) die aktuellste Sicherung sind, entweder im dafür definierten Ziel-Verzeichnis oder die Projekt-Dateien selbst, wenn direkt "ins Projekt-Verzeichnis (Original-Dateien überschreiben)" gespeichert wird.

{{Hilfe:NachOben}}

Optionen Menü-Das Dialogfenster Speichern-Einstellungen

2024-12-17T07:32:11Z

Hahn:

{{Hilfe:Navigation|[[Hauptseite]] > '''[[Das Optionen Menü]]'''|{{Hilfe:Artikel:OptionenMenu}}}}

{{Hilfe:Artikeltitel|Das Dialogfenster Speichern-Einstellungen}}

Dieses Dialogfenster dient der Einstellung des Speicherns ihrer Projekt-Daten. Es bietet die Möglichkeit, VermCad automatisch speichern zu lassen, Sicherheitskopien ihrer Projekte anzulegen und das Speichern zu beschleunigen bzw. nach ihren Ansprüchen zu optimieren. Denn vor allem die Projekt-Objekt-Datei (XML) und Projekt-ALKIS-Datei (NAS) muss viele Daten halten und kann entsprechend groß werden.

Mit dem Experten-Modus können sie detaillierte Einstellungen vornehmen. Ohne den Experten-Modus werden nur die grundsätzlichen Einstellungen angeboten, um auch den Überblick besser wahren zu können. Alle mit dem kleinen grünen Punkt versehenen Einstellungen gehören zum Experten-Modus.

[[File:Optionen Fenster Speichern-Einstellungen.PNG|800px]]

{| class="wikitable"
|-
||''Automatisches Speichern (AutoSave)''
||aktiviert das autom. Speichern, also das Speichern ihrer Dateien/Projekt nach einem eingestellten Zeitraster
|-
||''Ziel: Wohin soll autom. gespeichert werden?''
||es kann direkt '''ins Projekt-Verzeichnis''' gespeichert und damit die Original Dateien überschrieben werden; oder man speichert in ein selbst gewähltes '''Verzeichnis''' [...] ( es können hier auch relative Pfade verwendet werden: z.B. "save" speichert parallel zum Projekt in den Ordner "\save\")
|-
||''Intervall: Wann soll gespeichern werden?''
||legt fest, in welchem Abstand (Minuten) ein automatisches Speichern durchgeführt werden soll
|-
||''dynamisch''
||hier kann eingestellt werden, dass nach Ablaufen des Intervalls das Speichern erst dann durchgeführt werden soll, wenn eine Zeit lang keine Aktion in Vermcad ausgeführt wurde; damit aber dadurch das autom. Speichern nicht ganz abgeschaltet wird, kann man angeben, nach welcher Zeit dann spätestens doch gespeichert werden soll ("dynamisch" lohnt sich, wenn Sie in Ihrer Arbeit in VermCad durch das autom. Speichern nicht gestört/aufgehalten werden wollen)
|-
||''CAD-Daten (XML/NAS) mit speichern''
||das Speichern der Objekt-Daten kann je nach Projekt-Größe unterschiedlich groß sein - dazu kann hier angegeben werden, beim wie vielten Zyklus des autom. Speicherns auch die CAD-XML bzw. -NAS mit gespeichert werden soll
|-
||''Sicherheitskopien ([[Optionen_Menü-Das_Dialogfenster_Speichern-Einstellungen#Informationen_zum_Ring-Logging|Ring-Logging]])''
||legt zusätzlich die angegebene Anzahl an Sicherheitskopien an; wird ins Projekt-Verzeichnis gespeichert, so wird dort autom. ein ("RingLog"-)Ordner mit dem Projekt-Namen angelegt, in dem die Sicherheitskopien landen
{{Hilfe:Hinweis|Siehe auch Zusatz-Informationen unten zum [[Optionen_Menü-Das_Dialogfenster_Speichern-Einstellungen#Informationen_zum_Ring-Logging|Ring-Logging]].}}
|-
||''[[Optionen_Menü-Das_Dialogfenster_Speichern-Einstellungen#Informationen_zum_Ring-Logging|Ring-Logging]]-Kopien beim Schließen des Projektes erhalten''
||behält die Sicherheitskopien des [[Optionen_Menü-Das_Dialogfenster_Speichern-Einstellungen#Informationen_zum_Ring-Logging|Ring-Loggings]] auch nach Beenden von VermCad bzw. dem Schließen von Projekt/Datei
|-
||''Immer alles speichern (Editor-Datei + XML + NAS)''
||Es wird auch dann zyklisch zum Intervall gespeichert, wenn in der Zeit zwischen 2 autom. Speicher-Vorgängen keine Änderungen (an Editor-Datei/XML/NAS) gemacht wurden
|-
||''Auch vom Anwender gespeicherte Änderungen automatisch speichern''
||Werden Änderungen an Dateien/CAD vorgenommen und gespeichert und dann kommt irgendwann das autom. Speichern dran, dann kann man mit diesem Schalter sagen, dass das autom. Speichern trotzdem noch durchgeführt wird (das ist nicht der Fall, wenn dieser Schalter AUS gestellt wird)
|-
||''BACKUP - Speicherung bei Versions-Änderung''
||Wird das Projekt mit einer neuen VermCad-Version gestartet, wird ein Backup der Datei(en) im AutoSave-Verzeichnis\Backup_Version angelegt
|-
||
|-
||''Lokales Verzeichnis zum Zwischenspeichern''
||Beschleunigt das Speichern, da das Projekt zunächst nur lokal gespeichert und dann in das Ziel-Verzeichnis kopiert wird, während man in VermCad bereits weiter arbeiten kann (das wird allerdings nicht für das automatische Speichern (AutoSave) verwendet; ein AutoSave sollte immer lokal stattfinden, um so die Performance zu sichern)
|-
||''Beschleunigung des Kopiervorgangs Zwischen-Verzeichnis -> Ziel-Verzeichnis''
||Zeigt einen Dialog, während des Kopierens der zwischengespeicherten Datei ins Zielverzeichnis. Dieser Dialog bschleunigt auch das Kopieren, da andere Prozesse im Hintergrund unterbunden werden.
|-
||
|-
||''CAD-Projekt-XML/NAS-Speicherung in VermCad deaktivieren''
||Schaltet das Speichern der CAD-Objekt-Daten (XML/NAS) komplett ab - es wird nur die Projekt-Datei (MWT) gespeichert
|-
||''Im Anschluss an das Speichern einer CAD-Projekt-XML-/NAS-Datei prüfen, ob die Datei ein gültiges Format besitzt''
||Dabei wird (intern) das Einlesen der Datei getestet und so gesichert, dass die Datei korrekt gespeichert wurde (benötigt 20-30% der Speichern-Zeit)
|-
||''Bei automatischen Änderungen das Speichern direkt aktivieren''
||damit wird das Speichern nach automatischen Änderungen (Einlesekorrekturen, F8/F9, ...) immer gleich mit aktiviert
|-
||
|-
||''Standard''
||Stellt die Standard-Speichern-Einstellungen wieder her
|-
||''Daten vom Hauptnutzer''
||ermittelt die Speichern-Einstellungen des Hauptnutzers und stellt diese ein
|}

== Informationen zum Ring-Logging ==

Das Ring-Logging speichert im angegebenen Ziel-Verzeichnis die veränderten Projekt-Dateien unter <projektname>.mwt, *.xml und *.nas und zusätzlich je Speichervorgang eine <projektname>_RingLog_<NR>.mwt, *.xml und *.nas. <NR> fängt bei 1 an und geht bis zur angegebenen Anzahl und fängt dann wieder bei 1 an.

Dabei passen je die Dateien mit gleicher <NR> zusammen. Ist ein Dateityp einmal nicht vorhanden, dann ist die entsprechende Original-Projekt-Datei aktuell (und unterlag zum Zeitpunkt der autom. Speicherung keiner Änderung, so dass keine RingLog-Kopie nötig war)

Ist die weitere Einstellung "Immer alles speichern" aktiv, werden bei jedem autom. Speichervorgang auch immer alle Projekt-Dateien (*.mwt, *.xml und *.nas) pro RingLog-<NR> gesichert.

Abschließend ist noch einmal wichtig zu betonen, dass im Zielverzeichnis des autom. Speicherns die Projekt-Dateien mit <projektname>.mwt, *.xml und *.nas (ohne RingLog-Zusatz) die aktuellste Sicherung sind, entweder im dafür definierten Ziel-Verzeichnis oder die Projekt-Dateien selbst, wenn direkt "ins Projekt-Verzeichnis (Original-Dateien überschreiben)" gespeichert wird.

{{Hilfe:NachOben}}

Optionen Menü-Das Dialogfenster Speichern-Einstellungen

2024-12-17T07:29:40Z

Hahn:

{{Hilfe:Navigation|[[Hauptseite]] > '''[[Das Optionen Menü]]'''|{{Hilfe:Artikel:OptionenMenu}}}}

{{Hilfe:Artikeltitel|Das Dialogfenster Speichern-Einstellungen}}

Dieses Dialogfenster dient der Einstellung des Speicherns ihrer Projekt-Daten. Es bietet die Möglichkeit, VermCad automatisch speichern zu lassen, Sicherheitskopien ihrer Projekte anzulegen und das Speichern zu beschleunigen bzw. nach ihren Ansprüchen zu optimieren. Denn vor allem die Projekt-Objekt-Datei (XML) und Projekt-ALKIS-Datei (NAS) muss viele Daten halten und kann entsprechend groß werden.

Mit dem Experten-Modus können sie detaillierte Einstellungen vornehmen. Ohne den Experten-Modus werden nur die grundsätzlichen Einstellungen angeboten, um auch den Überblick besser wahren zu können. Alle mit dem kleinen grünen Punkt versehenen Einstellungen gehören zum Experten-Modus.

[[File:Optionen Fenster Speichern-Einstellungen.PNG|800px]]

{| class="wikitable"
|-
||''Automatisches Speichern (AutoSave)''
||aktiviert das autom. Speichern, also das Speichern ihrer Dateien/Projekt nach einem eingestellten Zeitraster
|-
||''Ziel: Wohin soll autom. gespeichert werden?''
||es kann direkt '''ins Projekt-Verzeichnis''' gespeichert und damit die Original Dateien überschrieben werden; oder man speichert in ein selbst gewähltes '''Verzeichnis''' [...] ( es können hier auch relative Pfade verwendet werden: z.B. "save" speichert parallel zum Projekt in den Ordner "\save\")
|-
||''Intervall: Wann soll gespeichern werden?''
||legt fest, in welchem Abstand (Minuten) ein automatisches Speichern durchgeführt werden soll
|-
||''dynamisch''
||hier kann eingestellt werden, dass nach Ablaufen des Intervalls das Speichern erst dann durchgeführt werden soll, wenn eine Zeit lang keine Aktion in Vermcad ausgeführt wurde; damit aber dadurch das autom. Speichern nicht ganz abgeschaltet wird, kann man angeben, nach welcher Zeit dann spätestens doch gespeichert werden soll ("dynamisch" lohnt sich, wenn Sie in Ihrer Arbeit in VermCad durch das autom. Speichern nicht gestört/aufgehalten werden wollen)
|-
||''CAD-Daten (XML/NAS) mit speichern''
||das Speichern der Objekt-Daten kann je nach Projekt-Größe unterschiedlich groß sein - dazu kann hier angegeben werden, beim wie vielten Zyklus des autom. Speicherns auch die CAD-XML bzw. -NAS mit gespeichert werden soll
|-
||''Sicherheitskopien (Ring-Logging)''
||legt zusätzlich die angegebene Anzahl an Sicherheitskopien an; wird ins Projekt-Verzeichnis gespeichert, so wird dort autom. ein ("RingLog"-)Ordner mit dem Projekt-Namen angelegt, in dem die Sicherheitskopien landen
|-
||''[[Ring-Logging|Optionen_Menü-Das_Dialogfenster_Speichern-Einstellungen#Informationen_zum_Ring-Logging]]-Kopien beim Schließen des Projektes erhalten''
||behält die Sicherheitskopien des [[Ring-Loggings|Optionen_Menü-Das_Dialogfenster_Speichern-Einstellungen#Informationen_zum_Ring-Logging]] auch nach Beenden von VermCad bzw. dem Schließen von Projekt/Datei
|-
||''Immer alles speichern (Editor-Datei + XML + NAS)''
||Es wird auch dann zyklisch zum Intervall gespeichert, wenn in der Zeit zwischen 2 autom. Speicher-Vorgängen keine Änderungen (an Editor-Datei/XML/NAS) gemacht wurden
|-
||''Auch vom Anwender gespeicherte Änderungen automatisch speichern''
||Werden Änderungen an Dateien/CAD vorgenommen und gespeichert und dann kommt irgendwann das autom. Speichern dran, dann kann man mit diesem Schalter sagen, dass das autom. Speichern trotzdem noch durchgeführt wird (das ist nicht der Fall, wenn dieser Schalter AUS gestellt wird)
|-
||''BACKUP - Speicherung bei Versions-Änderung''
||Wird das Projekt mit einer neuen VermCad-Version gestartet, wird ein Backup der Datei(en) im AutoSave-Verzeichnis\Backup_Version angelegt
|-
||
|-
||''Lokales Verzeichnis zum Zwischenspeichern''
||Beschleunigt das Speichern, da das Projekt zunächst nur lokal gespeichert und dann in das Ziel-Verzeichnis kopiert wird, während man in VermCad bereits weiter arbeiten kann (das wird allerdings nicht für das automatische Speichern (AutoSave) verwendet; ein AutoSave sollte immer lokal stattfinden, um so die Performance zu sichern)
|-
||''Beschleunigung des Kopiervorgangs Zwischen-Verzeichnis -> Ziel-Verzeichnis''
||Zeigt einen Dialog, während des Kopierens der zwischengespeicherten Datei ins Zielverzeichnis. Dieser Dialog bschleunigt auch das Kopieren, da andere Prozesse im Hintergrund unterbunden werden.
|-
||
|-
||''CAD-Projekt-XML/NAS-Speicherung in VermCad deaktivieren''
||Schaltet das Speichern der CAD-Objekt-Daten (XML/NAS) komplett ab - es wird nur die Projekt-Datei (MWT) gespeichert
|-
||''Im Anschluss an das Speichern einer CAD-Projekt-XML-/NAS-Datei prüfen, ob die Datei ein gültiges Format besitzt''
||Dabei wird (intern) das Einlesen der Datei getestet und so gesichert, dass die Datei korrekt gespeichert wurde (benötigt 20-30% der Speichern-Zeit)
|-
||''Bei automatischen Änderungen das Speichern direkt aktivieren''
||damit wird das Speichern nach automatischen Änderungen (Einlesekorrekturen, F8/F9, ...) immer gleich mit aktiviert
|-
||
|-
||''Standard''
||Stellt die Standard-Speichern-Einstellungen wieder her
|-
||''Daten vom Hauptnutzer''
||ermittelt die Speichern-Einstellungen des Hauptnutzers und stellt diese ein
|}

== Informationen zum Ring-Logging ==

Das Ring-Logging speichert im angegebenen Ziel-Verzeichnis die veränderten Projekt-Dateien unter <projektname>.mwt, *.xml und *.nas und zusätzlich je Speichervorgang eine <projektname>_RingLog_<NR>.mwt, *.xml und *.nas. <NR> fängt bei 1 an und geht bis zur angegebenen Anzahl und fängt dann wieder bei 1 an.

Dabei passen je die Dateien mit gleicher <NR> zusammen. Ist ein Dateityp einmal nicht vorhanden, dann ist die entsprechende Original-Projekt-Datei aktuell (und unterlag zum Zeitpunkt der autom. Speicherung keiner Änderung, so dass keine RingLog-Kopie nötig war)

Ist die weitere Einstellung "Immer alles speichern" aktiv, werden bei jedem autom. Speichervorgang auch immer alle Projekt-Dateien (*.mwt, *.xml und *.nas) pro RingLog-<NR> gesichert.

Abschließend ist noch einmal wichtig zu betonen, dass im Zielverzeichnis des autom. Speicherns die Projekt-Dateien mit <projektname>.mwt, *.xml und *.nas (ohne RingLog-Zusatz) die aktuellste Sicherung sind, entweder im dafür definierten Ziel-Verzeichnis oder die Projekt-Dateien selbst, wenn direkt "ins Projekt-Verzeichnis (Original-Dateien überschreiben)" gespeichert wird.

{{Hilfe:NachOben}}

Optionen Menü-Das Dialogfenster Speichern-Einstellungen

2024-12-17T07:28:22Z

Hahn:

{{Hilfe:Navigation|[[Hauptseite]] > '''[[Das Optionen Menü]]'''|{{Hilfe:Artikel:OptionenMenu}}}}

{{Hilfe:Artikeltitel|Das Dialogfenster Speichern-Einstellungen}}

Dieses Dialogfenster dient der Einstellung des Speicherns ihrer Projekt-Daten. Es bietet die Möglichkeit, VermCad automatisch speichern zu lassen, Sicherheitskopien ihrer Projekte anzulegen und das Speichern zu beschleunigen bzw. nach ihren Ansprüchen zu optimieren. Denn vor allem die Projekt-Objekt-Datei (XML) und Projekt-ALKIS-Datei (NAS) muss viele Daten halten und kann entsprechend groß werden.

Mit dem Experten-Modus können sie detaillierte Einstellungen vornehmen. Ohne den Experten-Modus werden nur die grundsätzlichen Einstellungen angeboten, um auch den Überblick besser wahren zu können. Alle mit dem kleinen grünen Punkt versehenen Einstellungen gehören zum Experten-Modus.

[[File:Optionen Fenster Speichern-Einstellungen.PNG|800px]]

{| class="wikitable"
|-
||''Automatisches Speichern (AutoSave)''
||aktiviert das autom. Speichern, also das Speichern ihrer Dateien/Projekt nach einem eingestellten Zeitraster
|-
||''Ziel: Wohin soll autom. gespeichert werden?''
||es kann direkt '''ins Projekt-Verzeichnis''' gespeichert und damit die Original Dateien überschrieben werden; oder man speichert in ein selbst gewähltes '''Verzeichnis''' [...] ( es können hier auch relative Pfade verwendet werden: z.B. "save" speichert parallel zum Projekt in den Ordner "\save\")
|-
||''Intervall: Wann soll gespeichern werden?''
||legt fest, in welchem Abstand (Minuten) ein automatisches Speichern durchgeführt werden soll
|-
||''dynamisch''
||hier kann eingestellt werden, dass nach Ablaufen des Intervalls das Speichern erst dann durchgeführt werden soll, wenn eine Zeit lang keine Aktion in Vermcad ausgeführt wurde; damit aber dadurch das autom. Speichern nicht ganz abgeschaltet wird, kann man angeben, nach welcher Zeit dann spätestens doch gespeichert werden soll ("dynamisch" lohnt sich, wenn Sie in Ihrer Arbeit in VermCad durch das autom. Speichern nicht gestört/aufgehalten werden wollen)
|-
||''CAD-Daten (XML/NAS) mit speichern''
||das Speichern der Objekt-Daten kann je nach Projekt-Größe unterschiedlich groß sein - dazu kann hier angegeben werden, beim wie vielten Zyklus des autom. Speicherns auch die CAD-XML bzw. -NAS mit gespeichert werden soll
|-
||''Sicherheitskopien (Ring-Logging)''
||legt zusätzlich die angegebene Anzahl an Sicherheitskopien an; wird ins Projekt-Verzeichnis gespeichert, so wird dort autom. ein ("RingLog"-)Ordner mit dem Projekt-Namen angelegt, in dem die Sicherheitskopien landen
|-
||''Ring-Logging-Kopien beim Schließen des Projektes erhalten''
||behält die Sicherheitskopien des Ring-Loggings auch nach Beenden von VermCad bzw. dem Schließen von Projekt/Datei
|-
||''Immer alles speichern (Editor-Datei + XML + NAS)''
||Es wird auch dann zyklisch zum Intervall gespeichert, wenn in der Zeit zwischen 2 autom. Speicher-Vorgängen keine Änderungen (an Editor-Datei/XML/NAS) gemacht wurden
|-
||''Auch vom Anwender gespeicherte Änderungen automatisch speichern''
||Werden Änderungen an Dateien/CAD vorgenommen und gespeichert und dann kommt irgendwann das autom. Speichern dran, dann kann man mit diesem Schalter sagen, dass das autom. Speichern trotzdem noch durchgeführt wird (das ist nicht der Fall, wenn dieser Schalter AUS gestellt wird)
|-
||''BACKUP - Speicherung bei Versions-Änderung''
||Wird das Projekt mit einer neuen VermCad-Version gestartet, wird ein Backup der Datei(en) im AutoSave-Verzeichnis\Backup_Version angelegt
|-
||
|-
||''Lokales Verzeichnis zum Zwischenspeichern''
||Beschleunigt das Speichern, da das Projekt zunächst nur lokal gespeichert und dann in das Ziel-Verzeichnis kopiert wird, während man in VermCad bereits weiter arbeiten kann (das wird allerdings nicht für das automatische Speichern (AutoSave) verwendet; ein AutoSave sollte immer lokal stattfinden, um so die Performance zu sichern)
|-
||''Beschleunigung des Kopiervorgangs Zwischen-Verzeichnis -> Ziel-Verzeichnis''
||Zeigt einen Dialog, während des Kopierens der zwischengespeicherten Datei ins Zielverzeichnis. Dieser Dialog bschleunigt auch das Kopieren, da andere Prozesse im Hintergrund unterbunden werden.
|-
||
|-
||''CAD-Projekt-XML/NAS-Speicherung in VermCad deaktivieren''
||Schaltet das Speichern der CAD-Objekt-Daten (XML/NAS) komplett ab - es wird nur die Projekt-Datei (MWT) gespeichert
|-
||''Im Anschluss an das Speichern einer CAD-Projekt-XML-/NAS-Datei prüfen, ob die Datei ein gültiges Format besitzt''
||Dabei wird (intern) das Einlesen der Datei getestet und so gesichert, dass die Datei korrekt gespeichert wurde (benötigt 20-30% der Speichern-Zeit)
|-
||''Bei automatischen Änderungen das Speichern direkt aktivieren''
||damit wird das Speichern nach automatischen Änderungen (Einlesekorrekturen, F8/F9, ...) immer gleich mit aktiviert
|-
||
|-
||''Standard''
||Stellt die Standard-Speichern-Einstellungen wieder her
|-
||''Daten vom Hauptnutzer''
||ermittelt die Speichern-Einstellungen des Hauptnutzers und stellt diese ein
|}

== Informationen zum Ring-Logging ==

Das Ring-Logging speichert im angegebenen Ziel-Verzeichnis die veränderten Projekt-Dateien unter <projektname>.mwt, *.xml und *.nas und zusätzlich je Speichervorgang eine <projektname>_RingLog_<NR>.mwt, *.xml und *.nas. <NR> fängt bei 1 an und geht bis zur angegebenen Anzahl und fängt dann wieder bei 1 an.

Dabei passen je die Dateien mit gleicher <NR> zusammen. Ist ein Dateityp einmal nicht vorhanden, dann ist die entsprechende Original-Projekt-Datei aktuell (und unterlag zum Zeitpunkt der autom. Speicherung keiner Änderung, so dass keine RingLog-Kopie nötig war)

Ist die weitere Einstellung "Immer alles speichern" aktiv, werden bei jedem autom. Speichervorgang auch immer alle Projekt-Dateien (*.mwt, *.xml und *.nas) pro RingLog-<NR> gesichert.

Abschließend ist noch einmal wichtig zu betonen, dass im Zielverzeichnis des autom. Speicherns die Projekt-Dateien mit <projektname>.mwt, *.xml und *.nas (ohne RingLog-Zusatz) die aktuellste Sicherung sind, entweder im dafür definierten Ziel-Verzeichnis oder die Projekt-Dateien selbst, wenn direkt "ins Projekt-Verzeichnis (Original-Dateien überschreiben)" gespeichert wird.

{{Hilfe:NachOben}}

CAD-Funktionen-Texteingabe

2024-08-08T09:49:55Z

Hahn: /* Texteingabe */

CAD-Funktionen-Texteingabe

2024-08-08T09:49:45Z

Hahn:

CAD-Funktionen-Texteingabe

2024-08-08T09:49:24Z

Hahn:

{{Hilfe:Navigation|[[Hauptseite]] > [[CAD]] > '''[[CAD-Symbolleiste, Funktionen & Werkzeuge|Symbolleiste, Funktionen & Werkzeuge]]'''|{{Hilfe:Artikel:CAD:Symbolleiste}}}}

{{Hilfe:Artikeltitel|Texteingabe}}

Sowohl in den [[CAD-Objektinformationen|Objektinformationen]] als auch im [[CAD-Konfiguration-Textstile|Textstil]] können Texte mit Inhalt gefüllt werden. Dazu können auch Platzhalter verwendet werden, die man über das Kontextmenü der Texteingabe aufrufen kann.

[[Datei:Texteingabe.png]]

Für den Platzhalter können verschiedenste Einträge über Auftrags-, Projekt-, Büro- und objektspezifische Daten gewählt werden.

[[Datei:Texteingabe_Menu.png]]

==Besonderheit: Nummerierungsbezirk {NBZ}==

Eine Besonderheit stellt der Nummerierungsbezirk {NBZ} dar. Hier können per "$" und ":" Zwischenzeichen an vorgegebenen Positionen gesetzt werden.

<pre>
Beispiel:

Die Eingabe von {NBZ$|:2:6} setzt das Zeichen "|" nach der 2. und 6. Stelle im resultierenden NBZ-Text, z.B. "33|5627|84".
</pre>

Das gleiche gilt für die Gauß-Krüger-Nummerierungsbezirke {NBZ_GK111} und {NBZ_GK112}. Zur Anzeige dieser NBZ ist eine gültige NTv2-Rasterdatei nötig, die die Auftrags-UTM-Koordinaten in Gauß-Krüger überführen kann.

==Besonderheit: Einkürzen von Wörtern==

Eine weitere Besonderheit bildet das Einkürzen einzelner Wörter ab. 
Das kann hilfreich sein, um z.B. bei Schlüsselworten nur eine bestimmte Anzahl an Buchstaben zu erhalten.

<pre>
per {>+N} VOR einem Wort bleiben nur so viele Buchstaben des Wortes am Anfang stehen (z.B. "{>+3}VermCad" wird zu "Ver" im Ergebnistext)
per {>-N} VOR einem Wort werden so viele Buchstaben des Wortes am Anfang entfernt (z.B. "{>-3}VermCad" wird zu "mCad" im Ergebnistext)
per {<+N} NACH einem Wort bleiben nur so viele Buchstaben des Wortes am Ende stehen (z.B. "VermCad{<+3}" wird zu "Cad" im Ergebnistext)
per {<-N} NACH einem Wort werden so viele Buchstaben des Wortes am Ende entfernt (z.B. "VermCad{<-3}" wird zu "Verm" im Ergebnistext)
</pre>

{{Hilfe:NachOben}}

Datei:CAD Objektinformationen Details.PNG

2024-06-28T15:46:46Z

Hahn: Hahn lud eine neue Version von Datei:CAD Objektinformationen Details.PNG hoch

CAD-Objektinformationen

2024-06-28T15:44:55Z

Hahn: /* Das Kontextmenü */

{{Hilfe:Navigation|[[Hauptseite]] > '''[[CAD]]'''|{{Hilfe:Artikel:CAD}}}}

{{Hilfe:Artikeltitel|Objektinformationen}}

Die Objektinformationen dienen der Darstellung und Änderung von Eigenschaften der Zeichen-Objekte, mit denen Sie in ihrem CAD arbeiten.

[[File:CAD Objektinformationen.PNG]]

Das Fenster der Objektinformationen ist in 3 Hauptbereiche aufgeteilt:

* Im oberen Bereich befindet sich die Button-Leiste für die wichtigsten schnellen Funktionen und die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]]
* In der Mitte befinden sich die Objekt-Eigenschaften, die verändert werden können. Zudem eine Spalte [[CAD-Objektinformationen#Herkunft|"Herkunft"]].
* Im unteren Bereich sind [[CAD-Die Objektinformationen#Die Details|Details]] wie Verbindungen zu anderen Objekten zu finden. Per Klick auf die 5 Punkte "....." können die Details zu- und abgeschaltet werden (weitere Infos: siehe [[CAD-Die Objektinformationen#Die Details|Details]])

== Button-Leiste mit Funktionen und [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]] ==
{| class="wikitable"
|-
||
[[File:CAD Steuerleiste Auswahl Fange AlkisVC.png]]

||Gibt an, ob beim Fangen eines CAD-Objektes initial die CAD- oder Alkis-Eigenschaften angezeigt werden sollen.
|-
||[[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]]
||Öffnet die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]], mit denen Sie festlegen können, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen.
|-
||[[File:CAD Objektinformationen Icon ObjektZurueck.PNG]] [[File:CAD Objektinformationen Icon ObjektVor.PNG]]
||Navigiert zum vorherigen oder nachfolgenden Objekt in der Historie der angezeigten Objekte
|-
||[[File:CAD Objektinformationen Icon PositionHighlight.PNG]]
||Objekt zur Bildschirmmitte "anfliegen" (per Rechtsklick wird das Objekt direkt angesprungen, ohne Anfliegen)
|-
||[[File:CAD Objektinformationen Parameter.png]]
||Öffnet zum aktuellen Objekt den Parameter-Dialog (auch für mehrere Objekte)
|-
||[[File:CAD Objektinformationen Hinweis mehrere Objekte betroffen.PNG]]
||Weist Sie darauf hin, dass beim Ändern von Eigenschaften mehrere Objekte betroffen sind. (gilt auch für verschiedenartigen Objekte - z.B.: Ändern Sie die Farbe einer Linie, während ebenfalls ein Punkt im CAD ausgewählt ist, so wird die Farbe auch an dem gewählten Punkt gesetzt, ändern Sie allerdings die Linienstärke, ändert sich für den gewählten Punkt nichts, da der Punkt diese Eigenschaft nicht besitzt)
|}

===Die Anzeige-Einstellungen===
In einem Anzeige-Eintrag können Sie festlegen, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen. Außerdem ist es möglich, einzelne Eigenschaften oben oder unten anzupinnen, so dass diese fixiert sind und nicht mit scrollen.

[[File:CAD Objektinformationen Anzeige Aendern.PNG]]

Sie können sich beliebig viele Anzeigen für ihre Objektinformationen erzeugen.

Über das Anzeige-Kontextmenü, dass beim Klicken der Schaltfläche [[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]] erscheint, können Sie einen Anzeige-Eintrag bearbeiten, löschen, umbenennen oder einen neuen Eintrag hinzufügen:

[[File:CAD Objektinformationen Anzeige Kontextmenu.PNG]]

Sobald Sie in der Bearbeitung [[File:CAD Objektinformationen Icon AnzeigeEinstellungen Aendern.PNG]] eines Anzeige-Eintrages sind, können Sie für die Art (z.B. Punkt, einfache Linie, Kreisbogen, Fläche, Text, ...) des aktuellen Objektes die Anzeige der Eigenschaften folgendermaßen ändern:

{| class="wikitable"
|-
||[[File:CAD Objektinformationen Anzeige Icon NachOben.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach oben verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon NachUnten.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach unten verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon Sichtbarkeit.PNG]]
||Eigenschaft für die Anzeige ein- oder ausblenden
|-
||[[File:CAD Objektinformationen Anzeige Icon PinTop.PNG]]
||Eigenschaft oben anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon PinBottom.PNG]]
||Eigenschaft unten anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon Unpin.PNG]]
||Fixierung (Pin) der Eigenschaft oben/unten lösen (ab Version 4.5)
|}

==Herkunft==

[[Datei:CAD Objektinformationen Icon Herkunft.PNG]] Die Herkunft zeigt die Quelle für den Wert einer Eigenschaft an.

Das Symbol (Hand) deutet mit dem enthaltenen Zeichen an, dass der Wert z.B. von einer [[CAD-Folienverwaltung|Folie]] oder [[CAD-Darstellungsvarianten|Darstellungsvariante]] oder aus einem [[CAD-Symbole-Symbol_erstellen|Symbol]] stammt.

Per Klick auf das Herkunft-Symbol gelangt man genau zu diesem Herkunftsort. Also stammt bspw. die Farbe eines Objektes von einer Folie und man klickt auf das Symbol, landet man in der [[CAD-Folienverwaltung|Folienverwaltung]] bei genau dieser Folie und dieser Eigenschaft (Spalte).

==Das Kontextmenü==

Das Kontextmenü im Eigenschaften-Werte-Bereich bietet verschiedene Möglichkeiten:

{| class="wikitable"
|-
||''[[CAD-Objektinformationen#Herkunft|Herkunft ...]]''
||Beschreibt und navigiert bei Klick die Herkunft eines Wertes einer Eigenschaft des Objektes (siehe [[CAD-Objektinformationen#Herkunft|Herkunft]])
|-
||''Folien-Optionen''
||Über der Eigenschaft "Folie" geöffnet, können Sie im Kontextmenü hier im [[CAD-Folienverwaltung|Folienmanager]] zu dieser Folie navigieren oder die Folie als [[CAD-Allgemeines#Zeichenfolie|aktive Zeichenfolie]] auswählen
|-
||''Warum ... ? - Fragen''
||Zeigt auf, warum ein Objekt/Eigenschaft bspw. nicht editierbar, sichtbar, verschiebbar, fangbar, ... ist. Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil die Folie des Objektes ausgeblendet ist.")
|-
||''Wert <erben> setzen'' (Alle Werte <erben> setzen)
||Ist ein Objekt einem anderen Objekt untergeordnet (z.B. Linie eines Rechtecks), so erbt dieses Objekt Eigenschaften von seinem übergeordeten Objekt. Stellen Sie ein, um immer den Wert des übergeordneten Objektes zu verwenden. Existiert kein übergeordnetes Objekt, so wird immer der Wert der Folie verwendet.
|-
||''Wert <von Folie> setzen'' (Alle Werte <von Folie> setzen)
||Der Wert der Eigenschaft des Objektes entspricht immer dem zugehörigen [[CAD-Der Folieneigenschaften Manager|Folien]]-Wert (Kann nur an den Eigenschaften gesetzt werden, die auch in den [[CAD-Der Folieneigenschaften Manager|Folien]] verfügbar sind)
|-
||''Wert <von Textstil> setzen'' (Alle Werte <von Textstil> setzen)
||Der Wert der Text-Eigenschaft des Text-Objektes entspricht immer dem zugehörigen [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstil]]-Wert (Gilt nur für Text-Eigenschaften (Schriftart, Textgröße, Unterstreichung, ...) für Text-Objekte)
|-
||''[[CAD-Risse|Riss]]-Optionen''
||Hier können Riss-Verschiebungen zurückgesetzt oder Riss-Eigenschaften an andere Risse übertragen oder von ihnen geholt werden ([[CAD-Risse#Risse_erstellen/Riss-Funktionen_(das_Riss-Kontextmenü)|siehe auch Riss-Menü]])
|-
||''[[CAD-Symbolleiste,_Funktionen_%26_Werkzeuge#ALKIS|Alkis]]-Optionen''
||Hier können zum CAD-Objekt zugehörige Alkis-Objekte erstellt bzw. gelöscht werden. Auch eine Anzeige einer Geometrieänderung zum originalen Alkis-CAD-Objekt ist möglich.
|-
||''Stile bearbeiten''
||Zu versch. Eigenschaften wie Textstil, Linienmuster, Liniensymbol, Schraffurstile u.Ä. kann man über "... bearbeiten" direkt zu dieser [[CAD-Konfiguration|Konfiguration]] springen und sie anpassen
|-
||''Einstellungen''
||Hier gibt es verschiedene Einstellungen zur Darstellung des OI, wie z.B. Zeilenhöhe, Zeilen ohne Wert ausblenden oder den OI rechts oder links andocken oder "frei fliegen" lassen
|-
||''Kopieren''
||Kopiert den Wert der Eigenschaft in die Zwischenablage
|}

Daneben bietet das Kontextmenü noch weitere selbsterklärende Funktionen rund um die Objekte und deren Eigenschaften.

==Die Details==
Die Details enthalten weiter Informationen zu dem Objekt.

[[File:CAD Objektinformationen Details.PNG]]

===Untergeordnete Objekte===
Zeigt das Objekt in seiner Hierarchie zu verwandten Objekten. Das blau markierte Objekt ist das Objekt selbst.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie zu den Objektinformationen dieses Objektes.}}

===Verbindungen===
Zeigt die Verbindung zu weiteren Objekten, die nicht zu den untergeordneten Objekten gehören. Das sind für eine Flurstücksgrenzlinie bspw. Grenzpunkte (Start- und Endpunkt der Linie) und weitere angrenzende Flurstücksgrenzlinien.

Auf '''identische Linien''' wird mit [ident. Linie] hingewiesen. Linien sind dann identisch, wenn sie genau übereinander liegen und demnach die exakt gleichen Endpunkt-Koordinaten besitzen. Bei verbundenen identlischen Linien wird standardmäßig immer nur die Linie mit der höchsten Priorität dargestellt. Das ist entweder das durch die [[CAD-Der Folieneigenschaften Manager|Tiefe der Folie]] höher liegende Objekt oder - bei gleicher Folie - das zuletzt gezeichnete Objekt.

Möchte man weitere identische Linien dennoch darstellen, so kann man das an der Objektinformations-Eigenschaft "Identische Linien" der Linie mittels "[ ] darstellen" tun.

Hinweis: Die Einstellungen wirken sich auch auf den Druck aus, sprich CAD-Ansicht und Druck-Ausgabe sind hier gleich.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie auch hier zu den Objektinformationen dieses Objektes.}}

CAD-Objektinformationen

2024-06-28T10:02:18Z

Hahn: /* Das Kontextmenü */

{{Hilfe:Navigation|[[Hauptseite]] > '''[[CAD]]'''|{{Hilfe:Artikel:CAD}}}}

{{Hilfe:Artikeltitel|Objektinformationen}}

Die Objektinformationen dienen der Darstellung und Änderung von Eigenschaften der Zeichen-Objekte, mit denen Sie in ihrem CAD arbeiten.

[[File:CAD Objektinformationen.PNG]]

Das Fenster der Objektinformationen ist in 3 Hauptbereiche aufgeteilt:

* Im oberen Bereich befindet sich die Button-Leiste für die wichtigsten schnellen Funktionen und die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]]
* In der Mitte befinden sich die Objekt-Eigenschaften, die verändert werden können. Zudem eine Spalte [[CAD-Objektinformationen#Herkunft|"Herkunft"]].
* Im unteren Bereich sind [[CAD-Die Objektinformationen#Die Details|Details]] wie Verbindungen zu anderen Objekten zu finden. Per Klick auf die 5 Punkte "....." können die Details zu- und abgeschaltet werden (weitere Infos: siehe [[CAD-Die Objektinformationen#Die Details|Details]])

== Button-Leiste mit Funktionen und [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]] ==
{| class="wikitable"
|-
||
[[File:CAD Steuerleiste Auswahl Fange AlkisVC.png]]

||Gibt an, ob beim Fangen eines CAD-Objektes initial die CAD- oder Alkis-Eigenschaften angezeigt werden sollen.
|-
||[[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]]
||Öffnet die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]], mit denen Sie festlegen können, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen.
|-
||[[File:CAD Objektinformationen Icon ObjektZurueck.PNG]] [[File:CAD Objektinformationen Icon ObjektVor.PNG]]
||Navigiert zum vorherigen oder nachfolgenden Objekt in der Historie der angezeigten Objekte
|-
||[[File:CAD Objektinformationen Icon PositionHighlight.PNG]]
||Objekt zur Bildschirmmitte "anfliegen" (per Rechtsklick wird das Objekt direkt angesprungen, ohne Anfliegen)
|-
||[[File:CAD Objektinformationen Parameter.png]]
||Öffnet zum aktuellen Objekt den Parameter-Dialog (auch für mehrere Objekte)
|-
||[[File:CAD Objektinformationen Hinweis mehrere Objekte betroffen.PNG]]
||Weist Sie darauf hin, dass beim Ändern von Eigenschaften mehrere Objekte betroffen sind. (gilt auch für verschiedenartigen Objekte - z.B.: Ändern Sie die Farbe einer Linie, während ebenfalls ein Punkt im CAD ausgewählt ist, so wird die Farbe auch an dem gewählten Punkt gesetzt, ändern Sie allerdings die Linienstärke, ändert sich für den gewählten Punkt nichts, da der Punkt diese Eigenschaft nicht besitzt)
|}

===Die Anzeige-Einstellungen===
In einem Anzeige-Eintrag können Sie festlegen, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen. Außerdem ist es möglich, einzelne Eigenschaften oben oder unten anzupinnen, so dass diese fixiert sind und nicht mit scrollen.

[[File:CAD Objektinformationen Anzeige Aendern.PNG]]

Sie können sich beliebig viele Anzeigen für ihre Objektinformationen erzeugen.

Über das Anzeige-Kontextmenü, dass beim Klicken der Schaltfläche [[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]] erscheint, können Sie einen Anzeige-Eintrag bearbeiten, löschen, umbenennen oder einen neuen Eintrag hinzufügen:

[[File:CAD Objektinformationen Anzeige Kontextmenu.PNG]]

Sobald Sie in der Bearbeitung [[File:CAD Objektinformationen Icon AnzeigeEinstellungen Aendern.PNG]] eines Anzeige-Eintrages sind, können Sie für die Art (z.B. Punkt, einfache Linie, Kreisbogen, Fläche, Text, ...) des aktuellen Objektes die Anzeige der Eigenschaften folgendermaßen ändern:

{| class="wikitable"
|-
||[[File:CAD Objektinformationen Anzeige Icon NachOben.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach oben verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon NachUnten.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach unten verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon Sichtbarkeit.PNG]]
||Eigenschaft für die Anzeige ein- oder ausblenden
|-
||[[File:CAD Objektinformationen Anzeige Icon PinTop.PNG]]
||Eigenschaft oben anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon PinBottom.PNG]]
||Eigenschaft unten anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon Unpin.PNG]]
||Fixierung (Pin) der Eigenschaft oben/unten lösen (ab Version 4.5)
|}

==Herkunft==

[[Datei:CAD Objektinformationen Icon Herkunft.PNG]] Die Herkunft zeigt die Quelle für den Wert einer Eigenschaft an.

Das Symbol (Hand) deutet mit dem enthaltenen Zeichen an, dass der Wert z.B. von einer [[CAD-Folienverwaltung|Folie]] oder [[CAD-Darstellungsvarianten|Darstellungsvariante]] oder aus einem [[CAD-Symbole-Symbol_erstellen|Symbol]] stammt.

Per Klick auf das Herkunft-Symbol gelangt man genau zu diesem Herkunftsort. Also stammt bspw. die Farbe eines Objektes von einer Folie und man klickt auf das Symbol, landet man in der [[CAD-Folienverwaltung|Folienverwaltung]] bei genau dieser Folie und dieser Eigenschaft (Spalte).

==Das Kontextmenü==

Das Kontextmenü im Eigenschaften-Werte-Bereich bietet verschiedene Möglichkeiten:

{| class="wikitable"
|-
||''[[CAD-Objektinformationen#Herkunft|Herkunft ...]]''
||Beschreibt und navigiert bei Klick die Herkunft eines Wertes einer Eigenschaft des Objektes (siehe [[CAD-Objektinformationen#Herkunft|Herkunft]])
|-
||''Folien-Optionen''
||Über der Eigenschaft "Folie" geöffnet, können Sie im Kontextmenü hier im [[CAD-Folienverwaltung|Folienmanager]] zu dieser Folie navigieren oder die Folie als [[CAD-Allgemeines#Zeichenfolie|aktive Zeichenfolie]] auswählen
|-
||''Warum ... ? - Fragen''
||Zeigt auf, warum ein Objekt/Eigenschaft bspw. nicht editierbar, sichtbar, verschiebbar, fangbar, ... ist. Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil die Folie des Objektes ausgeblendet ist.")
|-
||''Wert <erben> setzen'' (Alle Werte <erben> setzen)
||Ist ein Objekt einem anderen Objekt untergeordnet (z.B. Linie eines Rechtecks), so erbt dieses Objekt Eigenschaften von seinem übergeordeten Objekt. Stellen Sie ein, um immer den Wert des übergeordneten Objektes zu verwenden. Existiert kein übergeordnetes Objekt, so wird immer der Wert der Folie verwendet.
|-
||''Wert <von Folie> setzen'' (Alle Werte <von Folie> setzen)
||Der Wert der Eigenschaft des Objektes entspricht immer dem zugehörigen [[CAD-Der Folieneigenschaften Manager|Folien]]-Wert (Kann nur an den Eigenschaften gesetzt werden, die auch in den [[CAD-Der Folieneigenschaften Manager|Folien]] verfügbar sind)
|-
||''Wert <von Textstil> setzen'' (Alle Werte <von Textstil> setzen)
||Der Wert der Text-Eigenschaft des Text-Objektes entspricht immer dem zugehörigen [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstil]]-Wert (Gilt nur für Text-Eigenschaften (Schriftart, Textgröße, Unterstreichung, ...) für Text-Objekte)
|-
||''[[CAD-Risse|Riss]]-Optionen''
||Hier können Riss-Verschiebungen zurückgesetzt oder Riss-Eigenschaften an andere Risse übertragen oder von ihnen geholt werden ([[CAD-Risse#Risse_erstellen/Riss-Funktionen_(das_Riss-Kontextmenü)|siehe auch Riss-Menü]])
|-
||''[[CAD-Symbolleiste,_Funktionen_%26_Werkzeuge#ALKIS|Alkis]]-Optionen''
||Hier können zum CAD-Objekt zugehörige Alkis-Objekte erstellt bzw. gelöscht werden. Auch eine Anzeige einer Geometrieänderung zum originalen Alkis-CAD-Objekt ist möglich.
|-
||
||
|-
||''Liniensymbole ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Liniensymbole|Liniensymbolen]] (Gilt nur für die Eigenschaft 'Liniensymbol')
|-
||''Linienmuster ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Linienmuster|Linienmustern]] (Gilt nur für die Eigenschaft 'Linienmuster')
|-
||''Textstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstilen]] (Gilt nur für die Eigenschaft 'Textstil')
|-
||''Texturen ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Texturen|Texturen]] (Gilt nur für die Eigenschaft 'Textur')
|-
||''Schraffurstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Schraffurstile|Schraffurstilen]] (Gilt nur für die Eigenschaft 'Schraffurstil')
|-
||
||
|-
||''Kopieren''
||Kopiert den Wert der Eigenschaft in die Zwischenablage
|-
||''Objekt "anfliegen" (Highlight)''
||Springt ("fährt") das Objekt, dass sich hinter dem Wert der Eigenschaft verbirgt, an (Gilt nur für Eigenschaften, die andere Objekte repräsentieren)
|}

==Die Details==
Die Details enthalten weiter Informationen zu dem Objekt.

[[File:CAD Objektinformationen Details.PNG]]

===Untergeordnete Objekte===
Zeigt das Objekt in seiner Hierarchie zu verwandten Objekten. Das blau markierte Objekt ist das Objekt selbst.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie zu den Objektinformationen dieses Objektes.}}

===Verbindungen===
Zeigt die Verbindung zu weiteren Objekten, die nicht zu den untergeordneten Objekten gehören. Das sind für eine Flurstücksgrenzlinie bspw. Grenzpunkte (Start- und Endpunkt der Linie) und weitere angrenzende Flurstücksgrenzlinien.

Auf '''identische Linien''' wird mit [ident. Linie] hingewiesen. Linien sind dann identisch, wenn sie genau übereinander liegen und demnach die exakt gleichen Endpunkt-Koordinaten besitzen. Bei verbundenen identlischen Linien wird standardmäßig immer nur die Linie mit der höchsten Priorität dargestellt. Das ist entweder das durch die [[CAD-Der Folieneigenschaften Manager|Tiefe der Folie]] höher liegende Objekt oder - bei gleicher Folie - das zuletzt gezeichnete Objekt.

Möchte man weitere identische Linien dennoch darstellen, so kann man das an der Objektinformations-Eigenschaft "Identische Linien" der Linie mittels "[ ] darstellen" tun.

Hinweis: Die Einstellungen wirken sich auch auf den Druck aus, sprich CAD-Ansicht und Druck-Ausgabe sind hier gleich.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie auch hier zu den Objektinformationen dieses Objektes.}}

CAD-Objektinformationen

2024-06-28T09:59:24Z

Hahn: /* Das Kontextmenü */

{{Hilfe:Navigation|[[Hauptseite]] > '''[[CAD]]'''|{{Hilfe:Artikel:CAD}}}}

{{Hilfe:Artikeltitel|Objektinformationen}}

Die Objektinformationen dienen der Darstellung und Änderung von Eigenschaften der Zeichen-Objekte, mit denen Sie in ihrem CAD arbeiten.

[[File:CAD Objektinformationen.PNG]]

Das Fenster der Objektinformationen ist in 3 Hauptbereiche aufgeteilt:

* Im oberen Bereich befindet sich die Button-Leiste für die wichtigsten schnellen Funktionen und die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]]
* In der Mitte befinden sich die Objekt-Eigenschaften, die verändert werden können. Zudem eine Spalte [[CAD-Objektinformationen#Herkunft|"Herkunft"]].
* Im unteren Bereich sind [[CAD-Die Objektinformationen#Die Details|Details]] wie Verbindungen zu anderen Objekten zu finden. Per Klick auf die 5 Punkte "....." können die Details zu- und abgeschaltet werden (weitere Infos: siehe [[CAD-Die Objektinformationen#Die Details|Details]])

== Button-Leiste mit Funktionen und [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]] ==
{| class="wikitable"
|-
||
[[File:CAD Steuerleiste Auswahl Fange AlkisVC.png]]

||Gibt an, ob beim Fangen eines CAD-Objektes initial die CAD- oder Alkis-Eigenschaften angezeigt werden sollen.
|-
||[[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]]
||Öffnet die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]], mit denen Sie festlegen können, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen.
|-
||[[File:CAD Objektinformationen Icon ObjektZurueck.PNG]] [[File:CAD Objektinformationen Icon ObjektVor.PNG]]
||Navigiert zum vorherigen oder nachfolgenden Objekt in der Historie der angezeigten Objekte
|-
||[[File:CAD Objektinformationen Icon PositionHighlight.PNG]]
||Objekt zur Bildschirmmitte "anfliegen" (per Rechtsklick wird das Objekt direkt angesprungen, ohne Anfliegen)
|-
||[[File:CAD Objektinformationen Parameter.png]]
||Öffnet zum aktuellen Objekt den Parameter-Dialog (auch für mehrere Objekte)
|-
||[[File:CAD Objektinformationen Hinweis mehrere Objekte betroffen.PNG]]
||Weist Sie darauf hin, dass beim Ändern von Eigenschaften mehrere Objekte betroffen sind. (gilt auch für verschiedenartigen Objekte - z.B.: Ändern Sie die Farbe einer Linie, während ebenfalls ein Punkt im CAD ausgewählt ist, so wird die Farbe auch an dem gewählten Punkt gesetzt, ändern Sie allerdings die Linienstärke, ändert sich für den gewählten Punkt nichts, da der Punkt diese Eigenschaft nicht besitzt)
|}

===Die Anzeige-Einstellungen===
In einem Anzeige-Eintrag können Sie festlegen, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen. Außerdem ist es möglich, einzelne Eigenschaften oben oder unten anzupinnen, so dass diese fixiert sind und nicht mit scrollen.

[[File:CAD Objektinformationen Anzeige Aendern.PNG]]

Sie können sich beliebig viele Anzeigen für ihre Objektinformationen erzeugen.

Über das Anzeige-Kontextmenü, dass beim Klicken der Schaltfläche [[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]] erscheint, können Sie einen Anzeige-Eintrag bearbeiten, löschen, umbenennen oder einen neuen Eintrag hinzufügen:

[[File:CAD Objektinformationen Anzeige Kontextmenu.PNG]]

Sobald Sie in der Bearbeitung [[File:CAD Objektinformationen Icon AnzeigeEinstellungen Aendern.PNG]] eines Anzeige-Eintrages sind, können Sie für die Art (z.B. Punkt, einfache Linie, Kreisbogen, Fläche, Text, ...) des aktuellen Objektes die Anzeige der Eigenschaften folgendermaßen ändern:

{| class="wikitable"
|-
||[[File:CAD Objektinformationen Anzeige Icon NachOben.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach oben verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon NachUnten.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach unten verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon Sichtbarkeit.PNG]]
||Eigenschaft für die Anzeige ein- oder ausblenden
|-
||[[File:CAD Objektinformationen Anzeige Icon PinTop.PNG]]
||Eigenschaft oben anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon PinBottom.PNG]]
||Eigenschaft unten anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon Unpin.PNG]]
||Fixierung (Pin) der Eigenschaft oben/unten lösen (ab Version 4.5)
|}

==Herkunft==

[[Datei:CAD Objektinformationen Icon Herkunft.PNG]] Die Herkunft zeigt die Quelle für den Wert einer Eigenschaft an.

Das Symbol (Hand) deutet mit dem enthaltenen Zeichen an, dass der Wert z.B. von einer [[CAD-Folienverwaltung|Folie]] oder [[CAD-Darstellungsvarianten|Darstellungsvariante]] oder aus einem [[CAD-Symbole-Symbol_erstellen|Symbol]] stammt.

Per Klick auf das Herkunft-Symbol gelangt man genau zu diesem Herkunftsort. Also stammt bspw. die Farbe eines Objektes von einer Folie und man klickt auf das Symbol, landet man in der [[CAD-Folienverwaltung|Folienverwaltung]] bei genau dieser Folie und dieser Eigenschaft (Spalte).

==Das Kontextmenü==

Das Kontextmenü im Eigenschaften-Werte-Bereich bietet verschiedene Möglichkeiten:

{| class="wikitable"
|-
||''[[CAD-Objektinformationen#Herkunft|Herkunft ...]]''
||Beschreibt und navigiert bei Klick die Herkunft eines Wertes einer Eigenschaft des Objektes (siehe [[CAD-Objektinformationen#Herkunft|Herkunft]])
|-
||''Folien-Optionen''
||Über der Eigenschaft "Folie" geöffnet, können Sie im Kontextmenü hier im [[CAD-Folienverwaltung|Folienmanager]] zu dieser Folie navigieren oder die Folie als [[CAD-Allgemeines#Zeichenfolie|aktive Zeichenfolie]] auswählen
|-
||''Warum ... ? - Fragen''
||Zeigt auf, warum ein Objekt/Eigenschaft bspw. nicht editierbar, sichtbar, verschiebbar, fangbar, ... ist. Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil die Folie des Objektes ausgeblendet ist.")
|-
||''Wert <erben> setzen'' (Alle Werte <erben> setzen)
||Ist ein Objekt einem anderen Objekt untergeordnet (z.B. Linie eines Rechtecks), so erbt dieses Objekt Eigenschaften von seinem übergeordeten Objekt. Stellen Sie ein, um immer den Wert des übergeordneten Objektes zu verwenden. Existiert kein übergeordnetes Objekt, so wird immer der Wert der Folie verwendet.
|-
||''Wert <von Folie> setzen'' (Alle Werte <von Folie> setzen)
||Der Wert der Eigenschaft des Objektes entspricht immer dem zugehörigen [[CAD-Der Folieneigenschaften Manager|Folien]]-Wert (Kann nur an den Eigenschaften gesetzt werden, die auch in den [[CAD-Der Folieneigenschaften Manager|Folien]] verfügbar sind)
|-
||''Wert <von Textstil> setzen'' (Alle Werte <von Textstil> setzen)
||Der Wert der Text-Eigenschaft des Text-Objektes entspricht immer dem zugehörigen [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstil]]-Wert (Gilt nur für Text-Eigenschaften (Schriftart, Textgröße, Unterstreichung, ...) für Text-Objekte)
|-
||''[[CAD-Risse|Riss]]-Optionen''
||Hier können Riss-Verschiebungen zurückgesetzt oder Riss-Eigenschaften an andere Risse übertragen oder von ihnen geholt werden ([[CAD-Risse#Risse_erstellen/Riss-Funktionen_(das_Riss-Kontextmenü)|siehe auch >> hier <<]])
|-
||
||
|-
||''Liniensymbole ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Liniensymbole|Liniensymbolen]] (Gilt nur für die Eigenschaft 'Liniensymbol')
|-
||''Linienmuster ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Linienmuster|Linienmustern]] (Gilt nur für die Eigenschaft 'Linienmuster')
|-
||''Textstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstilen]] (Gilt nur für die Eigenschaft 'Textstil')
|-
||''Texturen ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Texturen|Texturen]] (Gilt nur für die Eigenschaft 'Textur')
|-
||''Schraffurstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Schraffurstile|Schraffurstilen]] (Gilt nur für die Eigenschaft 'Schraffurstil')
|-
||
||
|-
||''Kopieren''
||Kopiert den Wert der Eigenschaft in die Zwischenablage
|-
||''Objekt "anfliegen" (Highlight)''
||Springt ("fährt") das Objekt, dass sich hinter dem Wert der Eigenschaft verbirgt, an (Gilt nur für Eigenschaften, die andere Objekte repräsentieren)
|}

==Die Details==
Die Details enthalten weiter Informationen zu dem Objekt.

[[File:CAD Objektinformationen Details.PNG]]

===Untergeordnete Objekte===
Zeigt das Objekt in seiner Hierarchie zu verwandten Objekten. Das blau markierte Objekt ist das Objekt selbst.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie zu den Objektinformationen dieses Objektes.}}

===Verbindungen===
Zeigt die Verbindung zu weiteren Objekten, die nicht zu den untergeordneten Objekten gehören. Das sind für eine Flurstücksgrenzlinie bspw. Grenzpunkte (Start- und Endpunkt der Linie) und weitere angrenzende Flurstücksgrenzlinien.

Auf '''identische Linien''' wird mit [ident. Linie] hingewiesen. Linien sind dann identisch, wenn sie genau übereinander liegen und demnach die exakt gleichen Endpunkt-Koordinaten besitzen. Bei verbundenen identlischen Linien wird standardmäßig immer nur die Linie mit der höchsten Priorität dargestellt. Das ist entweder das durch die [[CAD-Der Folieneigenschaften Manager|Tiefe der Folie]] höher liegende Objekt oder - bei gleicher Folie - das zuletzt gezeichnete Objekt.

Möchte man weitere identische Linien dennoch darstellen, so kann man das an der Objektinformations-Eigenschaft "Identische Linien" der Linie mittels "[ ] darstellen" tun.

Hinweis: Die Einstellungen wirken sich auch auf den Druck aus, sprich CAD-Ansicht und Druck-Ausgabe sind hier gleich.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie auch hier zu den Objektinformationen dieses Objektes.}}

CAD-Objektinformationen

2024-06-28T09:56:16Z

Hahn: /* Das Kontextmenü */

{{Hilfe:Navigation|[[Hauptseite]] > '''[[CAD]]'''|{{Hilfe:Artikel:CAD}}}}

{{Hilfe:Artikeltitel|Objektinformationen}}

Die Objektinformationen dienen der Darstellung und Änderung von Eigenschaften der Zeichen-Objekte, mit denen Sie in ihrem CAD arbeiten.

[[File:CAD Objektinformationen.PNG]]

Das Fenster der Objektinformationen ist in 3 Hauptbereiche aufgeteilt:

* Im oberen Bereich befindet sich die Button-Leiste für die wichtigsten schnellen Funktionen und die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]]
* In der Mitte befinden sich die Objekt-Eigenschaften, die verändert werden können. Zudem eine Spalte [[CAD-Objektinformationen#Herkunft|"Herkunft"]].
* Im unteren Bereich sind [[CAD-Die Objektinformationen#Die Details|Details]] wie Verbindungen zu anderen Objekten zu finden. Per Klick auf die 5 Punkte "....." können die Details zu- und abgeschaltet werden (weitere Infos: siehe [[CAD-Die Objektinformationen#Die Details|Details]])

== Button-Leiste mit Funktionen und [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]] ==
{| class="wikitable"
|-
||
[[File:CAD Steuerleiste Auswahl Fange AlkisVC.png]]

||Gibt an, ob beim Fangen eines CAD-Objektes initial die CAD- oder Alkis-Eigenschaften angezeigt werden sollen.
|-
||[[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]]
||Öffnet die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]], mit denen Sie festlegen können, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen.
|-
||[[File:CAD Objektinformationen Icon ObjektZurueck.PNG]] [[File:CAD Objektinformationen Icon ObjektVor.PNG]]
||Navigiert zum vorherigen oder nachfolgenden Objekt in der Historie der angezeigten Objekte
|-
||[[File:CAD Objektinformationen Icon PositionHighlight.PNG]]
||Objekt zur Bildschirmmitte "anfliegen" (per Rechtsklick wird das Objekt direkt angesprungen, ohne Anfliegen)
|-
||[[File:CAD Objektinformationen Parameter.png]]
||Öffnet zum aktuellen Objekt den Parameter-Dialog (auch für mehrere Objekte)
|-
||[[File:CAD Objektinformationen Hinweis mehrere Objekte betroffen.PNG]]
||Weist Sie darauf hin, dass beim Ändern von Eigenschaften mehrere Objekte betroffen sind. (gilt auch für verschiedenartigen Objekte - z.B.: Ändern Sie die Farbe einer Linie, während ebenfalls ein Punkt im CAD ausgewählt ist, so wird die Farbe auch an dem gewählten Punkt gesetzt, ändern Sie allerdings die Linienstärke, ändert sich für den gewählten Punkt nichts, da der Punkt diese Eigenschaft nicht besitzt)
|}

===Die Anzeige-Einstellungen===
In einem Anzeige-Eintrag können Sie festlegen, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen. Außerdem ist es möglich, einzelne Eigenschaften oben oder unten anzupinnen, so dass diese fixiert sind und nicht mit scrollen.

[[File:CAD Objektinformationen Anzeige Aendern.PNG]]

Sie können sich beliebig viele Anzeigen für ihre Objektinformationen erzeugen.

Über das Anzeige-Kontextmenü, dass beim Klicken der Schaltfläche [[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]] erscheint, können Sie einen Anzeige-Eintrag bearbeiten, löschen, umbenennen oder einen neuen Eintrag hinzufügen:

[[File:CAD Objektinformationen Anzeige Kontextmenu.PNG]]

Sobald Sie in der Bearbeitung [[File:CAD Objektinformationen Icon AnzeigeEinstellungen Aendern.PNG]] eines Anzeige-Eintrages sind, können Sie für die Art (z.B. Punkt, einfache Linie, Kreisbogen, Fläche, Text, ...) des aktuellen Objektes die Anzeige der Eigenschaften folgendermaßen ändern:

{| class="wikitable"
|-
||[[File:CAD Objektinformationen Anzeige Icon NachOben.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach oben verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon NachUnten.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach unten verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon Sichtbarkeit.PNG]]
||Eigenschaft für die Anzeige ein- oder ausblenden
|-
||[[File:CAD Objektinformationen Anzeige Icon PinTop.PNG]]
||Eigenschaft oben anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon PinBottom.PNG]]
||Eigenschaft unten anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon Unpin.PNG]]
||Fixierung (Pin) der Eigenschaft oben/unten lösen (ab Version 4.5)
|}

==Herkunft==

[[Datei:CAD Objektinformationen Icon Herkunft.PNG]] Die Herkunft zeigt die Quelle für den Wert einer Eigenschaft an.

Das Symbol (Hand) deutet mit dem enthaltenen Zeichen an, dass der Wert z.B. von einer [[CAD-Folienverwaltung|Folie]] oder [[CAD-Darstellungsvarianten|Darstellungsvariante]] oder aus einem [[CAD-Symbole-Symbol_erstellen|Symbol]] stammt.

Per Klick auf das Herkunft-Symbol gelangt man genau zu diesem Herkunftsort. Also stammt bspw. die Farbe eines Objektes von einer Folie und man klickt auf das Symbol, landet man in der [[CAD-Folienverwaltung|Folienverwaltung]] bei genau dieser Folie und dieser Eigenschaft (Spalte).

==Das Kontextmenü==

Das Kontextmenü im Eigenschaften-Werte-Bereich bietet verschiedene Möglichkeiten:

{| class="wikitable"
|-
||''[[CAD-Objektinformationen#Herkunft|Herkunft ...]]''
||Beschreibt und navigiert bei Klick die Herkunft eines Wertes einer Eigenschaft des Objektes (siehe [[CAD-Objektinformationen#Herkunft|Herkunft]])
|-
||''Folien-Optionen''
||Über der Eigenschaft "Folie" geöffnet, können Sie im Kontextmenü hier im [[CAD-Folienverwaltung|Folienmanager]] zu dieser Folie navigieren oder die Folie als [[CAD-Allgemeines#Zeichenfolie|aktive Zeichenfolie]] auswählen
|-
||''Warum ... ? - Fragen''
||Zeigt auf, warum ein Objekt/Eigenschaft bspw. nicht editierbar, sichtbar, verschiebbar, fangbar, ... ist. Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil die Folie des Objektes ausgeblendet ist.")
|-
||''Wert <erben> setzen'' (Alle Werte <erben> setzen)
||Ist ein Objekt einem anderen Objekt untergeordnet (z.B. Linie eines Rechtecks), so erbt dieses Objekt Eigenschaften von seinem übergeordeten Objekt. Stellen Sie ein, um immer den Wert des übergeordneten Objektes zu verwenden. Existiert kein übergeordnetes Objekt, so wird immer der Wert der Folie verwendet.
|-
||''Wert <von Folie> setzen'' (Alle Werte <von Folie> setzen)
||Der Wert der Eigenschaft des Objektes entspricht immer dem zugehörigen [[CAD-Der Folieneigenschaften Manager|Folien]]-Wert (Kann nur an den Eigenschaften gesetzt werden, die auch in den [[CAD-Der Folieneigenschaften Manager|Folien]] verfügbar sind)
|-
||''Wert <von Textstil> setzen'' (Alle Werte <von Textstil> setzen)
||Der Wert der Text-Eigenschaft des Text-Objektes entspricht immer dem zugehörigen [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstil]]-Wert (Gilt nur für Text-Eigenschaften (Schriftart, Textgröße, Unterstreichung, ...) für Text-Objekte)
|-
||
||
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten Eigenschaften für das/die ausgewählte(n) Objekt(e)
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten Eigenschaften für das/die ausgewählte(n) Objekt(e)
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten (Text-)Eigenschaften für das/die ausgewählte(n) (Text-)Objekt(e)
|-
||
||
|-
||''Folie "aus Symboldefinition" als feste Folie einstellen''
||Ist die Eigenschaft 'Folie' auf den Wert '"" ' gestellt, dann wird der dieser [[Optionen Menü-Symbol - Definitionen-Die Symbol - Definitionen Freie Symbole|Symboldefinition-Folie]] für die Eigenschaft 'Folie' fest eingestellt
|-
||''Punktsymbol "aus Symboldefinition" als festes Punktsymbol einstellen''
||Ist die Eigenschaft 'Punktsymbol' auf den Wert ' (aus Symboldefinition)' gestellt, dann wird der -Wert dieses [[Optionen Menü-Symbol - Definitionen-Die Symbol - Definitionen Freie Symbole|Symboldefinition-Punktsymbols]] für die Eigenschaft 'Punktsymbols' fest eingestellt
|-
||
||
|-
||''Als aktive Folie einstellen''
||Stellt die [[CAD-Der Folieneigenschaften Manager|Folie]], die als Wert der Eigenschaft 'Folie' eingestellt ist als aktive Folie im CAD ein. (Gilt nur für die Eigenschaft 'Folie')
|-
||''Im Folienmanager öffnen''
||Öffnet die ausgewählte Folie des Objektes im [[CAD-Der Folieneigenschaften Manager|Folieneigenschaften Manager]] (Gilt nur für die Eigenschaft 'Folie')
|-
||''Liniensymbole ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Liniensymbole|Liniensymbolen]] (Gilt nur für die Eigenschaft 'Liniensymbol')
|-
||''Linienmuster ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Linienmuster|Linienmustern]] (Gilt nur für die Eigenschaft 'Linienmuster')
|-
||''Textstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstilen]] (Gilt nur für die Eigenschaft 'Textstil')
|-
||''Texturen ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Texturen|Texturen]] (Gilt nur für die Eigenschaft 'Textur')
|-
||''Schraffurstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Schraffurstile|Schraffurstilen]] (Gilt nur für die Eigenschaft 'Schraffurstil')
|-
||
||
|-
||''Kopieren''
||Kopiert den Wert der Eigenschaft in die Zwischenablage
|-
||''Objekt "anfliegen" (Highlight)''
||Springt ("fährt") das Objekt, dass sich hinter dem Wert der Eigenschaft verbirgt, an (Gilt nur für Eigenschaften, die andere Objekte repräsentieren)
|}

==Die Details==
Die Details enthalten weiter Informationen zu dem Objekt.

[[File:CAD Objektinformationen Details.PNG]]

===Untergeordnete Objekte===
Zeigt das Objekt in seiner Hierarchie zu verwandten Objekten. Das blau markierte Objekt ist das Objekt selbst.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie zu den Objektinformationen dieses Objektes.}}

===Verbindungen===
Zeigt die Verbindung zu weiteren Objekten, die nicht zu den untergeordneten Objekten gehören. Das sind für eine Flurstücksgrenzlinie bspw. Grenzpunkte (Start- und Endpunkt der Linie) und weitere angrenzende Flurstücksgrenzlinien.

Auf '''identische Linien''' wird mit [ident. Linie] hingewiesen. Linien sind dann identisch, wenn sie genau übereinander liegen und demnach die exakt gleichen Endpunkt-Koordinaten besitzen. Bei verbundenen identlischen Linien wird standardmäßig immer nur die Linie mit der höchsten Priorität dargestellt. Das ist entweder das durch die [[CAD-Der Folieneigenschaften Manager|Tiefe der Folie]] höher liegende Objekt oder - bei gleicher Folie - das zuletzt gezeichnete Objekt.

Möchte man weitere identische Linien dennoch darstellen, so kann man das an der Objektinformations-Eigenschaft "Identische Linien" der Linie mittels "[ ] darstellen" tun.

Hinweis: Die Einstellungen wirken sich auch auf den Druck aus, sprich CAD-Ansicht und Druck-Ausgabe sind hier gleich.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie auch hier zu den Objektinformationen dieses Objektes.}}

CAD-Objektinformationen

2024-06-28T09:48:08Z

Hahn: /* Das Kontextmenü */

{{Hilfe:Navigation|[[Hauptseite]] > '''[[CAD]]'''|{{Hilfe:Artikel:CAD}}}}

{{Hilfe:Artikeltitel|Objektinformationen}}

Die Objektinformationen dienen der Darstellung und Änderung von Eigenschaften der Zeichen-Objekte, mit denen Sie in ihrem CAD arbeiten.

[[File:CAD Objektinformationen.PNG]]

Das Fenster der Objektinformationen ist in 3 Hauptbereiche aufgeteilt:

* Im oberen Bereich befindet sich die Button-Leiste für die wichtigsten schnellen Funktionen und die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]]
* In der Mitte befinden sich die Objekt-Eigenschaften, die verändert werden können. Zudem eine Spalte [[CAD-Objektinformationen#Herkunft|"Herkunft"]].
* Im unteren Bereich sind [[CAD-Die Objektinformationen#Die Details|Details]] wie Verbindungen zu anderen Objekten zu finden. Per Klick auf die 5 Punkte "....." können die Details zu- und abgeschaltet werden (weitere Infos: siehe [[CAD-Die Objektinformationen#Die Details|Details]])

== Button-Leiste mit Funktionen und [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]] ==
{| class="wikitable"
|-
||
[[File:CAD Steuerleiste Auswahl Fange AlkisVC.png]]

||Gibt an, ob beim Fangen eines CAD-Objektes initial die CAD- oder Alkis-Eigenschaften angezeigt werden sollen.
|-
||[[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]]
||Öffnet die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]], mit denen Sie festlegen können, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen.
|-
||[[File:CAD Objektinformationen Icon ObjektZurueck.PNG]] [[File:CAD Objektinformationen Icon ObjektVor.PNG]]
||Navigiert zum vorherigen oder nachfolgenden Objekt in der Historie der angezeigten Objekte
|-
||[[File:CAD Objektinformationen Icon PositionHighlight.PNG]]
||Objekt zur Bildschirmmitte "anfliegen" (per Rechtsklick wird das Objekt direkt angesprungen, ohne Anfliegen)
|-
||[[File:CAD Objektinformationen Parameter.png]]
||Öffnet zum aktuellen Objekt den Parameter-Dialog (auch für mehrere Objekte)
|-
||[[File:CAD Objektinformationen Hinweis mehrere Objekte betroffen.PNG]]
||Weist Sie darauf hin, dass beim Ändern von Eigenschaften mehrere Objekte betroffen sind. (gilt auch für verschiedenartigen Objekte - z.B.: Ändern Sie die Farbe einer Linie, während ebenfalls ein Punkt im CAD ausgewählt ist, so wird die Farbe auch an dem gewählten Punkt gesetzt, ändern Sie allerdings die Linienstärke, ändert sich für den gewählten Punkt nichts, da der Punkt diese Eigenschaft nicht besitzt)
|}

===Die Anzeige-Einstellungen===
In einem Anzeige-Eintrag können Sie festlegen, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen. Außerdem ist es möglich, einzelne Eigenschaften oben oder unten anzupinnen, so dass diese fixiert sind und nicht mit scrollen.

[[File:CAD Objektinformationen Anzeige Aendern.PNG]]

Sie können sich beliebig viele Anzeigen für ihre Objektinformationen erzeugen.

Über das Anzeige-Kontextmenü, dass beim Klicken der Schaltfläche [[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]] erscheint, können Sie einen Anzeige-Eintrag bearbeiten, löschen, umbenennen oder einen neuen Eintrag hinzufügen:

[[File:CAD Objektinformationen Anzeige Kontextmenu.PNG]]

Sobald Sie in der Bearbeitung [[File:CAD Objektinformationen Icon AnzeigeEinstellungen Aendern.PNG]] eines Anzeige-Eintrages sind, können Sie für die Art (z.B. Punkt, einfache Linie, Kreisbogen, Fläche, Text, ...) des aktuellen Objektes die Anzeige der Eigenschaften folgendermaßen ändern:

{| class="wikitable"
|-
||[[File:CAD Objektinformationen Anzeige Icon NachOben.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach oben verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon NachUnten.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach unten verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon Sichtbarkeit.PNG]]
||Eigenschaft für die Anzeige ein- oder ausblenden
|-
||[[File:CAD Objektinformationen Anzeige Icon PinTop.PNG]]
||Eigenschaft oben anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon PinBottom.PNG]]
||Eigenschaft unten anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon Unpin.PNG]]
||Fixierung (Pin) der Eigenschaft oben/unten lösen (ab Version 4.5)
|}

==Herkunft==

[[Datei:CAD Objektinformationen Icon Herkunft.PNG]] Die Herkunft zeigt die Quelle für den Wert einer Eigenschaft an.

Das Symbol (Hand) deutet mit dem enthaltenen Zeichen an, dass der Wert z.B. von einer [[CAD-Folienverwaltung|Folie]] oder [[CAD-Darstellungsvarianten|Darstellungsvariante]] oder aus einem [[CAD-Symbole-Symbol_erstellen|Symbol]] stammt.

Per Klick auf das Herkunft-Symbol gelangt man genau zu diesem Herkunftsort. Also stammt bspw. die Farbe eines Objektes von einer Folie und man klickt auf das Symbol, landet man in der [[CAD-Folienverwaltung|Folienverwaltung]] bei genau dieser Folie und dieser Eigenschaft (Spalte).

==Das Kontextmenü==

Das Kontextmenü im Eigenschaften-Werte-Bereich bietet verschiedene Möglichkeiten:

{| class="wikitable"
|-
||''Herkunft ...''
||Beschreibt, wo der Wert der markierten Eigenschaft (Zelle) unter dem Kontextmenü her kommt (z.B. von einer Folie, Darstellungsvariante, Elternobjekt, Nutzeränderung ...) Per Klick wird zum entsprechenden '''Herkunfts-Ort navigiert'''
|-
||''Warum ist dieses Objekt nicht sichtbar/editierbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil die Folie des Objektes ausgeblendet ist.")
|-
||''Warum ist diese Objekt-Eigenschaft nicht editierbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Die Eigenschaft "Füll-Farbe" kann nicht editiert werden, weil das "Füllen" an der zugehörigen Folie deaktiviert ist.")
|-
||''Warum ist dieses Objekt nicht löschbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil noch Abhängigkeiten zu anderen Objekten bestehen.")
|-
||
||
|-
||''Wert <erben> setzen''
||Ist ein Objekt einem anderen Objekt untergeordnet (z.B. Linie eines Rechtecks), so erbt dieses Objekt Eigenschaften von seinem übergeordeten Objekt. Stellen Sie ein, um immer den Wert des übergeordneten Objektes zu verwenden. Existiert kein übergeordnetes Objekt, so wird immer der Wert der Folie verwendet.
|-
||''Wert <von Folie> setzen''
||Der Wert der Eigenschaft des Objektes entspricht immer dem zugehörigen [[CAD-Der Folieneigenschaften Manager|Folien]]-Wert (Kann nur an den Eigenschaften gesetzt werden, die auch in den [[CAD-Der Folieneigenschaften Manager|Folien]] verfügbar sind)
|-
||''Wert <von Textstil> setzen''
||Der Wert der Text-Eigenschaft des Text-Objektes entspricht immer dem zugehörigen [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstil]]-Wert (Gilt nur für Text-Eigenschaften (Schriftart, Textgröße, Unterstreichung, ...) für Text-Objekte)
|-
||
||
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten Eigenschaften für das/die ausgewählte(n) Objekt(e)
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten Eigenschaften für das/die ausgewählte(n) Objekt(e)
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten (Text-)Eigenschaften für das/die ausgewählte(n) (Text-)Objekt(e)
|-
||
||
|-
||''Folie "aus Symboldefinition" als feste Folie einstellen''
||Ist die Eigenschaft 'Folie' auf den Wert '"" ' gestellt, dann wird der dieser [[Optionen Menü-Symbol - Definitionen-Die Symbol - Definitionen Freie Symbole|Symboldefinition-Folie]] für die Eigenschaft 'Folie' fest eingestellt
|-
||''Punktsymbol "aus Symboldefinition" als festes Punktsymbol einstellen''
||Ist die Eigenschaft 'Punktsymbol' auf den Wert ' (aus Symboldefinition)' gestellt, dann wird der -Wert dieses [[Optionen Menü-Symbol - Definitionen-Die Symbol - Definitionen Freie Symbole|Symboldefinition-Punktsymbols]] für die Eigenschaft 'Punktsymbols' fest eingestellt
|-
||
||
|-
||''Als aktive Folie einstellen''
||Stellt die [[CAD-Der Folieneigenschaften Manager|Folie]], die als Wert der Eigenschaft 'Folie' eingestellt ist als aktive Folie im CAD ein. (Gilt nur für die Eigenschaft 'Folie')
|-
||''Im Folienmanager öffnen''
||Öffnet die ausgewählte Folie des Objektes im [[CAD-Der Folieneigenschaften Manager|Folieneigenschaften Manager]] (Gilt nur für die Eigenschaft 'Folie')
|-
||''Liniensymbole ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Liniensymbole|Liniensymbolen]] (Gilt nur für die Eigenschaft 'Liniensymbol')
|-
||''Linienmuster ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Linienmuster|Linienmustern]] (Gilt nur für die Eigenschaft 'Linienmuster')
|-
||''Textstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstilen]] (Gilt nur für die Eigenschaft 'Textstil')
|-
||''Texturen ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Texturen|Texturen]] (Gilt nur für die Eigenschaft 'Textur')
|-
||''Schraffurstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Schraffurstile|Schraffurstilen]] (Gilt nur für die Eigenschaft 'Schraffurstil')
|-
||
||
|-
||''Kopieren''
||Kopiert den Wert der Eigenschaft in die Zwischenablage
|-
||''Objekt "anfliegen" (Highlight)''
||Springt ("fährt") das Objekt, dass sich hinter dem Wert der Eigenschaft verbirgt, an (Gilt nur für Eigenschaften, die andere Objekte repräsentieren)
|}

==Die Details==
Die Details enthalten weiter Informationen zu dem Objekt.

[[File:CAD Objektinformationen Details.PNG]]

===Untergeordnete Objekte===
Zeigt das Objekt in seiner Hierarchie zu verwandten Objekten. Das blau markierte Objekt ist das Objekt selbst.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie zu den Objektinformationen dieses Objektes.}}

===Verbindungen===
Zeigt die Verbindung zu weiteren Objekten, die nicht zu den untergeordneten Objekten gehören. Das sind für eine Flurstücksgrenzlinie bspw. Grenzpunkte (Start- und Endpunkt der Linie) und weitere angrenzende Flurstücksgrenzlinien.

Auf '''identische Linien''' wird mit [ident. Linie] hingewiesen. Linien sind dann identisch, wenn sie genau übereinander liegen und demnach die exakt gleichen Endpunkt-Koordinaten besitzen. Bei verbundenen identlischen Linien wird standardmäßig immer nur die Linie mit der höchsten Priorität dargestellt. Das ist entweder das durch die [[CAD-Der Folieneigenschaften Manager|Tiefe der Folie]] höher liegende Objekt oder - bei gleicher Folie - das zuletzt gezeichnete Objekt.

Möchte man weitere identische Linien dennoch darstellen, so kann man das an der Objektinformations-Eigenschaft "Identische Linien" der Linie mittels "[ ] darstellen" tun.

Hinweis: Die Einstellungen wirken sich auch auf den Druck aus, sprich CAD-Ansicht und Druck-Ausgabe sind hier gleich.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie auch hier zu den Objektinformationen dieses Objektes.}}

CAD-Objektinformationen

2024-06-28T09:41:42Z

Hahn: /* Herkunft */

{{Hilfe:Navigation|[[Hauptseite]] > '''[[CAD]]'''|{{Hilfe:Artikel:CAD}}}}

{{Hilfe:Artikeltitel|Objektinformationen}}

Die Objektinformationen dienen der Darstellung und Änderung von Eigenschaften der Zeichen-Objekte, mit denen Sie in ihrem CAD arbeiten.

[[File:CAD Objektinformationen.PNG]]

Das Fenster der Objektinformationen ist in 3 Hauptbereiche aufgeteilt:

* Im oberen Bereich befindet sich die Button-Leiste für die wichtigsten schnellen Funktionen und die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]]
* In der Mitte befinden sich die Objekt-Eigenschaften, die verändert werden können. Zudem eine Spalte [[CAD-Objektinformationen#Herkunft|"Herkunft"]].
* Im unteren Bereich sind [[CAD-Die Objektinformationen#Die Details|Details]] wie Verbindungen zu anderen Objekten zu finden. Per Klick auf die 5 Punkte "....." können die Details zu- und abgeschaltet werden (weitere Infos: siehe [[CAD-Die Objektinformationen#Die Details|Details]])

== Button-Leiste mit Funktionen und [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]] ==
{| class="wikitable"
|-
||
[[File:CAD Steuerleiste Auswahl Fange AlkisVC.png]]

||Gibt an, ob beim Fangen eines CAD-Objektes initial die CAD- oder Alkis-Eigenschaften angezeigt werden sollen.
|-
||[[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]]
||Öffnet die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]], mit denen Sie festlegen können, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen.
|-
||[[File:CAD Objektinformationen Icon ObjektZurueck.PNG]] [[File:CAD Objektinformationen Icon ObjektVor.PNG]]
||Navigiert zum vorherigen oder nachfolgenden Objekt in der Historie der angezeigten Objekte
|-
||[[File:CAD Objektinformationen Icon PositionHighlight.PNG]]
||Objekt zur Bildschirmmitte "anfliegen" (per Rechtsklick wird das Objekt direkt angesprungen, ohne Anfliegen)
|-
||[[File:CAD Objektinformationen Parameter.png]]
||Öffnet zum aktuellen Objekt den Parameter-Dialog (auch für mehrere Objekte)
|-
||[[File:CAD Objektinformationen Hinweis mehrere Objekte betroffen.PNG]]
||Weist Sie darauf hin, dass beim Ändern von Eigenschaften mehrere Objekte betroffen sind. (gilt auch für verschiedenartigen Objekte - z.B.: Ändern Sie die Farbe einer Linie, während ebenfalls ein Punkt im CAD ausgewählt ist, so wird die Farbe auch an dem gewählten Punkt gesetzt, ändern Sie allerdings die Linienstärke, ändert sich für den gewählten Punkt nichts, da der Punkt diese Eigenschaft nicht besitzt)
|}

===Die Anzeige-Einstellungen===
In einem Anzeige-Eintrag können Sie festlegen, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen. Außerdem ist es möglich, einzelne Eigenschaften oben oder unten anzupinnen, so dass diese fixiert sind und nicht mit scrollen.

[[File:CAD Objektinformationen Anzeige Aendern.PNG]]

Sie können sich beliebig viele Anzeigen für ihre Objektinformationen erzeugen.

Über das Anzeige-Kontextmenü, dass beim Klicken der Schaltfläche [[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]] erscheint, können Sie einen Anzeige-Eintrag bearbeiten, löschen, umbenennen oder einen neuen Eintrag hinzufügen:

[[File:CAD Objektinformationen Anzeige Kontextmenu.PNG]]

Sobald Sie in der Bearbeitung [[File:CAD Objektinformationen Icon AnzeigeEinstellungen Aendern.PNG]] eines Anzeige-Eintrages sind, können Sie für die Art (z.B. Punkt, einfache Linie, Kreisbogen, Fläche, Text, ...) des aktuellen Objektes die Anzeige der Eigenschaften folgendermaßen ändern:

{| class="wikitable"
|-
||[[File:CAD Objektinformationen Anzeige Icon NachOben.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach oben verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon NachUnten.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach unten verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon Sichtbarkeit.PNG]]
||Eigenschaft für die Anzeige ein- oder ausblenden
|-
||[[File:CAD Objektinformationen Anzeige Icon PinTop.PNG]]
||Eigenschaft oben anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon PinBottom.PNG]]
||Eigenschaft unten anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon Unpin.PNG]]
||Fixierung (Pin) der Eigenschaft oben/unten lösen (ab Version 4.5)
|}

==Herkunft==

[[Datei:CAD Objektinformationen Icon Herkunft.PNG]] Die Herkunft zeigt die Quelle für den Wert einer Eigenschaft an.

Das Symbol (Hand) deutet mit dem enthaltenen Zeichen an, dass der Wert z.B. von einer [[CAD-Folienverwaltung|Folie]] oder [[CAD-Darstellungsvarianten|Darstellungsvariante]] oder aus einem [[CAD-Symbole-Symbol_erstellen|Symbol]] stammt.

Per Klick auf das Herkunft-Symbol gelangt man genau zu diesem Herkunftsort. Also stammt bspw. die Farbe eines Objektes von einer Folie und man klickt auf das Symbol, landet man in der [[CAD-Folienverwaltung|Folienverwaltung]] bei genau dieser Folie und dieser Eigenschaft (Spalte).

==Das Kontextmenü==

Das Kontextmenü bietet folgende Möglichkeiten:

{| class="wikitable"
|-
||''Herkunft ...''
||Beschreibt, wo der Wert der markierten Eigenschaft (Zelle) unter dem Kontextmenü her kommt (z.B. von einer Folie, Darstellungsvariante, Elternobjekt, Nutzeränderung ...) Per Klick wird zum entsprechenden '''Herkunfts-Ort navigiert'''
|-
||''Warum ist dieses Objekt nicht sichtbar/editierbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil die Folie des Objektes ausgeblendet ist.")
|-
||''Warum ist diese Objekt-Eigenschaft nicht editierbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Die Eigenschaft "Füll-Farbe" kann nicht editiert werden, weil das "Füllen" an der zugehörigen Folie deaktiviert ist.")
|-
||''Warum ist dieses Objekt nicht löschbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil noch Abhängigkeiten zu anderen Objekten bestehen.")
|-
||
||
|-
||''Wert <erben> setzen''
||Ist ein Objekt einem anderen Objekt untergeordnet (z.B. Linie eines Rechtecks), so erbt dieses Objekt Eigenschaften von seinem übergeordeten Objekt. Stellen Sie ein, um immer den Wert des übergeordneten Objektes zu verwenden. Existiert kein übergeordnetes Objekt, so wird immer der Wert der Folie verwendet.
|-
||''Wert <von Folie> setzen''
||Der Wert der Eigenschaft des Objektes entspricht immer dem zugehörigen [[CAD-Der Folieneigenschaften Manager|Folien]]-Wert (Kann nur an den Eigenschaften gesetzt werden, die auch in den [[CAD-Der Folieneigenschaften Manager|Folien]] verfügbar sind)
|-
||''Wert <von Textstil> setzen''
||Der Wert der Text-Eigenschaft des Text-Objektes entspricht immer dem zugehörigen [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstil]]-Wert (Gilt nur für Text-Eigenschaften (Schriftart, Textgröße, Unterstreichung, ...) für Text-Objekte)
|-
||
||
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten Eigenschaften für das/die ausgewählte(n) Objekt(e)
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten Eigenschaften für das/die ausgewählte(n) Objekt(e)
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten (Text-)Eigenschaften für das/die ausgewählte(n) (Text-)Objekt(e)
|-
||
||
|-
||''Folie "aus Symboldefinition" als feste Folie einstellen''
||Ist die Eigenschaft 'Folie' auf den Wert '"" ' gestellt, dann wird der dieser [[Optionen Menü-Symbol - Definitionen-Die Symbol - Definitionen Freie Symbole|Symboldefinition-Folie]] für die Eigenschaft 'Folie' fest eingestellt
|-
||''Punktsymbol "aus Symboldefinition" als festes Punktsymbol einstellen''
||Ist die Eigenschaft 'Punktsymbol' auf den Wert ' (aus Symboldefinition)' gestellt, dann wird der -Wert dieses [[Optionen Menü-Symbol - Definitionen-Die Symbol - Definitionen Freie Symbole|Symboldefinition-Punktsymbols]] für die Eigenschaft 'Punktsymbols' fest eingestellt
|-
||
||
|-
||''Als aktive Folie einstellen''
||Stellt die [[CAD-Der Folieneigenschaften Manager|Folie]], die als Wert der Eigenschaft 'Folie' eingestellt ist als aktive Folie im CAD ein. (Gilt nur für die Eigenschaft 'Folie')
|-
||''Im Folienmanager öffnen''
||Öffnet die ausgewählte Folie des Objektes im [[CAD-Der Folieneigenschaften Manager|Folieneigenschaften Manager]] (Gilt nur für die Eigenschaft 'Folie')
|-
||''Liniensymbole ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Liniensymbole|Liniensymbolen]] (Gilt nur für die Eigenschaft 'Liniensymbol')
|-
||''Linienmuster ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Linienmuster|Linienmustern]] (Gilt nur für die Eigenschaft 'Linienmuster')
|-
||''Textstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstilen]] (Gilt nur für die Eigenschaft 'Textstil')
|-
||''Texturen ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Texturen|Texturen]] (Gilt nur für die Eigenschaft 'Textur')
|-
||''Schraffurstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Schraffurstile|Schraffurstilen]] (Gilt nur für die Eigenschaft 'Schraffurstil')
|-
||
||
|-
||''Kopieren''
||Kopiert den Wert der Eigenschaft in die Zwischenablage
|-
||''Objekt "anfliegen" (Highlight)''
||Springt ("fährt") das Objekt, dass sich hinter dem Wert der Eigenschaft verbirgt, an (Gilt nur für Eigenschaften, die andere Objekte repräsentieren)
|}

==Die Details==
Die Details enthalten weiter Informationen zu dem Objekt.

[[File:CAD Objektinformationen Details.PNG]]

===Untergeordnete Objekte===
Zeigt das Objekt in seiner Hierarchie zu verwandten Objekten. Das blau markierte Objekt ist das Objekt selbst.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie zu den Objektinformationen dieses Objektes.}}

===Verbindungen===
Zeigt die Verbindung zu weiteren Objekten, die nicht zu den untergeordneten Objekten gehören. Das sind für eine Flurstücksgrenzlinie bspw. Grenzpunkte (Start- und Endpunkt der Linie) und weitere angrenzende Flurstücksgrenzlinien.

Auf '''identische Linien''' wird mit [ident. Linie] hingewiesen. Linien sind dann identisch, wenn sie genau übereinander liegen und demnach die exakt gleichen Endpunkt-Koordinaten besitzen. Bei verbundenen identlischen Linien wird standardmäßig immer nur die Linie mit der höchsten Priorität dargestellt. Das ist entweder das durch die [[CAD-Der Folieneigenschaften Manager|Tiefe der Folie]] höher liegende Objekt oder - bei gleicher Folie - das zuletzt gezeichnete Objekt.

Möchte man weitere identische Linien dennoch darstellen, so kann man das an der Objektinformations-Eigenschaft "Identische Linien" der Linie mittels "[ ] darstellen" tun.

Hinweis: Die Einstellungen wirken sich auch auf den Druck aus, sprich CAD-Ansicht und Druck-Ausgabe sind hier gleich.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie auch hier zu den Objektinformationen dieses Objektes.}}

CAD-Objektinformationen

2024-06-28T09:39:22Z

Hahn:

{{Hilfe:Navigation|[[Hauptseite]] > '''[[CAD]]'''|{{Hilfe:Artikel:CAD}}}}

{{Hilfe:Artikeltitel|Objektinformationen}}

Die Objektinformationen dienen der Darstellung und Änderung von Eigenschaften der Zeichen-Objekte, mit denen Sie in ihrem CAD arbeiten.

[[File:CAD Objektinformationen.PNG]]

Das Fenster der Objektinformationen ist in 3 Hauptbereiche aufgeteilt:

* Im oberen Bereich befindet sich die Button-Leiste für die wichtigsten schnellen Funktionen und die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]]
* In der Mitte befinden sich die Objekt-Eigenschaften, die verändert werden können. Zudem eine Spalte [[CAD-Objektinformationen#Herkunft|"Herkunft"]].
* Im unteren Bereich sind [[CAD-Die Objektinformationen#Die Details|Details]] wie Verbindungen zu anderen Objekten zu finden. Per Klick auf die 5 Punkte "....." können die Details zu- und abgeschaltet werden (weitere Infos: siehe [[CAD-Die Objektinformationen#Die Details|Details]])

== Button-Leiste mit Funktionen und [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]] ==
{| class="wikitable"
|-
||
[[File:CAD Steuerleiste Auswahl Fange AlkisVC.png]]

||Gibt an, ob beim Fangen eines CAD-Objektes initial die CAD- oder Alkis-Eigenschaften angezeigt werden sollen.
|-
||[[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]]
||Öffnet die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]], mit denen Sie festlegen können, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen.
|-
||[[File:CAD Objektinformationen Icon ObjektZurueck.PNG]] [[File:CAD Objektinformationen Icon ObjektVor.PNG]]
||Navigiert zum vorherigen oder nachfolgenden Objekt in der Historie der angezeigten Objekte
|-
||[[File:CAD Objektinformationen Icon PositionHighlight.PNG]]
||Objekt zur Bildschirmmitte "anfliegen" (per Rechtsklick wird das Objekt direkt angesprungen, ohne Anfliegen)
|-
||[[File:CAD Objektinformationen Parameter.png]]
||Öffnet zum aktuellen Objekt den Parameter-Dialog (auch für mehrere Objekte)
|-
||[[File:CAD Objektinformationen Hinweis mehrere Objekte betroffen.PNG]]
||Weist Sie darauf hin, dass beim Ändern von Eigenschaften mehrere Objekte betroffen sind. (gilt auch für verschiedenartigen Objekte - z.B.: Ändern Sie die Farbe einer Linie, während ebenfalls ein Punkt im CAD ausgewählt ist, so wird die Farbe auch an dem gewählten Punkt gesetzt, ändern Sie allerdings die Linienstärke, ändert sich für den gewählten Punkt nichts, da der Punkt diese Eigenschaft nicht besitzt)
|}

===Die Anzeige-Einstellungen===
In einem Anzeige-Eintrag können Sie festlegen, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen. Außerdem ist es möglich, einzelne Eigenschaften oben oder unten anzupinnen, so dass diese fixiert sind und nicht mit scrollen.

[[File:CAD Objektinformationen Anzeige Aendern.PNG]]

Sie können sich beliebig viele Anzeigen für ihre Objektinformationen erzeugen.

Über das Anzeige-Kontextmenü, dass beim Klicken der Schaltfläche [[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]] erscheint, können Sie einen Anzeige-Eintrag bearbeiten, löschen, umbenennen oder einen neuen Eintrag hinzufügen:

[[File:CAD Objektinformationen Anzeige Kontextmenu.PNG]]

Sobald Sie in der Bearbeitung [[File:CAD Objektinformationen Icon AnzeigeEinstellungen Aendern.PNG]] eines Anzeige-Eintrages sind, können Sie für die Art (z.B. Punkt, einfache Linie, Kreisbogen, Fläche, Text, ...) des aktuellen Objektes die Anzeige der Eigenschaften folgendermaßen ändern:

{| class="wikitable"
|-
||[[File:CAD Objektinformationen Anzeige Icon NachOben.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach oben verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon NachUnten.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach unten verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon Sichtbarkeit.PNG]]
||Eigenschaft für die Anzeige ein- oder ausblenden
|-
||[[File:CAD Objektinformationen Anzeige Icon PinTop.PNG]]
||Eigenschaft oben anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon PinBottom.PNG]]
||Eigenschaft unten anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon Unpin.PNG]]
||Fixierung (Pin) der Eigenschaft oben/unten lösen (ab Version 4.5)
|}

==Herkunft==

[[Datei:CAD Objektinformationen Icon Herkunft.PNG]] Die Herkunft zeigt die Quelle für den Wert einer Eigenschaft an.

Das Symbol (Hand) deutet mit dem enthaltenen Zeichen an, dass der Wert z.B. von einer Folie oder Darstellungsvariante oder aus einem Symbol stammt.

Per Klick auf das Herkunft-Symbol gelangt man genau zu diesem Herkunftsort. Also stammt bspw. die Farbe eines Objektes von einer Folie und man klickt auf das Symbol, landet man im Folienmanager bei genau dieser Folie und dieser Eigenschaft (Spalte).

==Das Kontextmenü==

Das Kontextmenü bietet folgende Möglichkeiten:

{| class="wikitable"
|-
||''Herkunft ...''
||Beschreibt, wo der Wert der markierten Eigenschaft (Zelle) unter dem Kontextmenü her kommt (z.B. von einer Folie, Darstellungsvariante, Elternobjekt, Nutzeränderung ...) Per Klick wird zum entsprechenden '''Herkunfts-Ort navigiert'''
|-
||''Warum ist dieses Objekt nicht sichtbar/editierbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil die Folie des Objektes ausgeblendet ist.")
|-
||''Warum ist diese Objekt-Eigenschaft nicht editierbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Die Eigenschaft "Füll-Farbe" kann nicht editiert werden, weil das "Füllen" an der zugehörigen Folie deaktiviert ist.")
|-
||''Warum ist dieses Objekt nicht löschbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil noch Abhängigkeiten zu anderen Objekten bestehen.")
|-
||
||
|-
||''Wert <erben> setzen''
||Ist ein Objekt einem anderen Objekt untergeordnet (z.B. Linie eines Rechtecks), so erbt dieses Objekt Eigenschaften von seinem übergeordeten Objekt. Stellen Sie ein, um immer den Wert des übergeordneten Objektes zu verwenden. Existiert kein übergeordnetes Objekt, so wird immer der Wert der Folie verwendet.
|-
||''Wert <von Folie> setzen''
||Der Wert der Eigenschaft des Objektes entspricht immer dem zugehörigen [[CAD-Der Folieneigenschaften Manager|Folien]]-Wert (Kann nur an den Eigenschaften gesetzt werden, die auch in den [[CAD-Der Folieneigenschaften Manager|Folien]] verfügbar sind)
|-
||''Wert <von Textstil> setzen''
||Der Wert der Text-Eigenschaft des Text-Objektes entspricht immer dem zugehörigen [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstil]]-Wert (Gilt nur für Text-Eigenschaften (Schriftart, Textgröße, Unterstreichung, ...) für Text-Objekte)
|-
||
||
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten Eigenschaften für das/die ausgewählte(n) Objekt(e)
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten Eigenschaften für das/die ausgewählte(n) Objekt(e)
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten (Text-)Eigenschaften für das/die ausgewählte(n) (Text-)Objekt(e)
|-
||
||
|-
||''Folie "aus Symboldefinition" als feste Folie einstellen''
||Ist die Eigenschaft 'Folie' auf den Wert '"" ' gestellt, dann wird der dieser [[Optionen Menü-Symbol - Definitionen-Die Symbol - Definitionen Freie Symbole|Symboldefinition-Folie]] für die Eigenschaft 'Folie' fest eingestellt
|-
||''Punktsymbol "aus Symboldefinition" als festes Punktsymbol einstellen''
||Ist die Eigenschaft 'Punktsymbol' auf den Wert ' (aus Symboldefinition)' gestellt, dann wird der -Wert dieses [[Optionen Menü-Symbol - Definitionen-Die Symbol - Definitionen Freie Symbole|Symboldefinition-Punktsymbols]] für die Eigenschaft 'Punktsymbols' fest eingestellt
|-
||
||
|-
||''Als aktive Folie einstellen''
||Stellt die [[CAD-Der Folieneigenschaften Manager|Folie]], die als Wert der Eigenschaft 'Folie' eingestellt ist als aktive Folie im CAD ein. (Gilt nur für die Eigenschaft 'Folie')
|-
||''Im Folienmanager öffnen''
||Öffnet die ausgewählte Folie des Objektes im [[CAD-Der Folieneigenschaften Manager|Folieneigenschaften Manager]] (Gilt nur für die Eigenschaft 'Folie')
|-
||''Liniensymbole ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Liniensymbole|Liniensymbolen]] (Gilt nur für die Eigenschaft 'Liniensymbol')
|-
||''Linienmuster ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Linienmuster|Linienmustern]] (Gilt nur für die Eigenschaft 'Linienmuster')
|-
||''Textstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstilen]] (Gilt nur für die Eigenschaft 'Textstil')
|-
||''Texturen ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Texturen|Texturen]] (Gilt nur für die Eigenschaft 'Textur')
|-
||''Schraffurstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Schraffurstile|Schraffurstilen]] (Gilt nur für die Eigenschaft 'Schraffurstil')
|-
||
||
|-
||''Kopieren''
||Kopiert den Wert der Eigenschaft in die Zwischenablage
|-
||''Objekt "anfliegen" (Highlight)''
||Springt ("fährt") das Objekt, dass sich hinter dem Wert der Eigenschaft verbirgt, an (Gilt nur für Eigenschaften, die andere Objekte repräsentieren)
|}

==Die Details==
Die Details enthalten weiter Informationen zu dem Objekt.

[[File:CAD Objektinformationen Details.PNG]]

===Untergeordnete Objekte===
Zeigt das Objekt in seiner Hierarchie zu verwandten Objekten. Das blau markierte Objekt ist das Objekt selbst.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie zu den Objektinformationen dieses Objektes.}}

===Verbindungen===
Zeigt die Verbindung zu weiteren Objekten, die nicht zu den untergeordneten Objekten gehören. Das sind für eine Flurstücksgrenzlinie bspw. Grenzpunkte (Start- und Endpunkt der Linie) und weitere angrenzende Flurstücksgrenzlinien.

Auf '''identische Linien''' wird mit [ident. Linie] hingewiesen. Linien sind dann identisch, wenn sie genau übereinander liegen und demnach die exakt gleichen Endpunkt-Koordinaten besitzen. Bei verbundenen identlischen Linien wird standardmäßig immer nur die Linie mit der höchsten Priorität dargestellt. Das ist entweder das durch die [[CAD-Der Folieneigenschaften Manager|Tiefe der Folie]] höher liegende Objekt oder - bei gleicher Folie - das zuletzt gezeichnete Objekt.

Möchte man weitere identische Linien dennoch darstellen, so kann man das an der Objektinformations-Eigenschaft "Identische Linien" der Linie mittels "[ ] darstellen" tun.

Hinweis: Die Einstellungen wirken sich auch auf den Druck aus, sprich CAD-Ansicht und Druck-Ausgabe sind hier gleich.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie auch hier zu den Objektinformationen dieses Objektes.}}

CAD-Objektinformationen

2024-06-28T09:38:56Z

Hahn: /* Das Kontextmenü */

{{Hilfe:Navigation|[[Hauptseite]] > '''[[CAD]]'''|{{Hilfe:Artikel:CAD}}}}

{{Hilfe:Artikeltitel|Objektinformationen}}

Die Objektinformationen dienen der Darstellung und Änderung von Eigenschaften der Zeichen-Objekte, mit denen Sie in ihrem CAD arbeiten.

[[File:CAD Objektinformationen.PNG]]

Das Fenster der Objektinformationen ist in 3 Hauptbereiche aufgeteilt:

* Im oberen Bereich befindet sich die Button-Leiste für die wichtigsten schnellen Funktionen und die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]]
* In der Mitte befinden sich die Objekt-Eigenschaften, die verändert werden können. Zudem eine Spalte "Herkunft".
* Im unteren Bereich sind [[CAD-Die Objektinformationen#Die Details|Details]] wie Verbindungen zu anderen Objekten zu finden. Per Klick auf die 5 Punkte "....." können die Details zu- und abgeschaltet werden (weitere Infos: siehe [[CAD-Die Objektinformationen#Die Details|Details]])

== Button-Leiste mit Funktionen und [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]] ==
{| class="wikitable"
|-
||
[[File:CAD Steuerleiste Auswahl Fange AlkisVC.png]]

||Gibt an, ob beim Fangen eines CAD-Objektes initial die CAD- oder Alkis-Eigenschaften angezeigt werden sollen.
|-
||[[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]]
||Öffnet die [[CAD-Die Objektinformationen#Die Anzeige-Einstellungen|Anzeige-Einstellungen]], mit denen Sie festlegen können, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen.
|-
||[[File:CAD Objektinformationen Icon ObjektZurueck.PNG]] [[File:CAD Objektinformationen Icon ObjektVor.PNG]]
||Navigiert zum vorherigen oder nachfolgenden Objekt in der Historie der angezeigten Objekte
|-
||[[File:CAD Objektinformationen Icon PositionHighlight.PNG]]
||Objekt zur Bildschirmmitte "anfliegen" (per Rechtsklick wird das Objekt direkt angesprungen, ohne Anfliegen)
|-
||[[File:CAD Objektinformationen Parameter.png]]
||Öffnet zum aktuellen Objekt den Parameter-Dialog (auch für mehrere Objekte)
|-
||[[File:CAD Objektinformationen Hinweis mehrere Objekte betroffen.PNG]]
||Weist Sie darauf hin, dass beim Ändern von Eigenschaften mehrere Objekte betroffen sind. (gilt auch für verschiedenartigen Objekte - z.B.: Ändern Sie die Farbe einer Linie, während ebenfalls ein Punkt im CAD ausgewählt ist, so wird die Farbe auch an dem gewählten Punkt gesetzt, ändern Sie allerdings die Linienstärke, ändert sich für den gewählten Punkt nichts, da der Punkt diese Eigenschaft nicht besitzt)
|}

===Die Anzeige-Einstellungen===
In einem Anzeige-Eintrag können Sie festlegen, für welche Arten von Objekten Sie welche Eigenschaften sehen möchten und in welcher Reihenfolge diese in ihrer Anzeige dargestellt werden sollen. Außerdem ist es möglich, einzelne Eigenschaften oben oder unten anzupinnen, so dass diese fixiert sind und nicht mit scrollen.

[[File:CAD Objektinformationen Anzeige Aendern.PNG]]

Sie können sich beliebig viele Anzeigen für ihre Objektinformationen erzeugen.

Über das Anzeige-Kontextmenü, dass beim Klicken der Schaltfläche [[File:CAD Objektinformationen Icon AnzeigeEinstellungen.PNG]] erscheint, können Sie einen Anzeige-Eintrag bearbeiten, löschen, umbenennen oder einen neuen Eintrag hinzufügen:

[[File:CAD Objektinformationen Anzeige Kontextmenu.PNG]]

Sobald Sie in der Bearbeitung [[File:CAD Objektinformationen Icon AnzeigeEinstellungen Aendern.PNG]] eines Anzeige-Eintrages sind, können Sie für die Art (z.B. Punkt, einfache Linie, Kreisbogen, Fläche, Text, ...) des aktuellen Objektes die Anzeige der Eigenschaften folgendermaßen ändern:

{| class="wikitable"
|-
||[[File:CAD Objektinformationen Anzeige Icon NachOben.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach oben verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon NachUnten.PNG]]
||Eigenschaft in der Anzeige um eine Stelle nach unten verschieben
|-
||[[File:CAD Objektinformationen Anzeige Icon Sichtbarkeit.PNG]]
||Eigenschaft für die Anzeige ein- oder ausblenden
|-
||[[File:CAD Objektinformationen Anzeige Icon PinTop.PNG]]
||Eigenschaft oben anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon PinBottom.PNG]]
||Eigenschaft unten anpinnen (fixieren) (ab Version 4.5)
|-
||[[File:CAD Objektinformationen Anzeige Icon Unpin.PNG]]
||Fixierung (Pin) der Eigenschaft oben/unten lösen (ab Version 4.5)
|}

==Herkunft==

[[Datei:CAD Objektinformationen Icon Herkunft.PNG]] Die Herkunft zeigt die Quelle für den Wert einer Eigenschaft an.

Das Symbol (Hand) deutet mit dem enthaltenen Zeichen an, dass der Wert z.B. von einer Folie oder Darstellungsvariante oder aus einem Symbol stammt.

Per Klick auf das Herkunft-Symbol gelangt man genau zu diesem Herkunftsort. Also stammt bspw. die Farbe eines Objektes von einer Folie und man klickt auf das Symbol, landet man im Folienmanager bei genau dieser Folie und dieser Eigenschaft (Spalte).

==Das Kontextmenü==

Das Kontextmenü bietet folgende Möglichkeiten:

{| class="wikitable"
|-
||''Herkunft ...''
||Beschreibt, wo der Wert der markierten Eigenschaft (Zelle) unter dem Kontextmenü her kommt (z.B. von einer Folie, Darstellungsvariante, Elternobjekt, Nutzeränderung ...) Per Klick wird zum entsprechenden '''Herkunfts-Ort navigiert'''
|-
||''Warum ist dieses Objekt nicht sichtbar/editierbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil die Folie des Objektes ausgeblendet ist.")
|-
||''Warum ist diese Objekt-Eigenschaft nicht editierbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Die Eigenschaft "Füll-Farbe" kann nicht editiert werden, weil das "Füllen" an der zugehörigen Folie deaktiviert ist.")
|-
||''Warum ist dieses Objekt nicht löschbar? ...''
||Per Klick auf diesen Menü-Eintrag wird die Antwort in einem kleinen Fenster angezeigt (z.B.: "Weil noch Abhängigkeiten zu anderen Objekten bestehen.")
|-
||
||
|-
||''Wert <erben> setzen''
||Ist ein Objekt einem anderen Objekt untergeordnet (z.B. Linie eines Rechtecks), so erbt dieses Objekt Eigenschaften von seinem übergeordeten Objekt. Stellen Sie ein, um immer den Wert des übergeordneten Objektes zu verwenden. Existiert kein übergeordnetes Objekt, so wird immer der Wert der Folie verwendet.
|-
||''Wert <von Folie> setzen''
||Der Wert der Eigenschaft des Objektes entspricht immer dem zugehörigen [[CAD-Der Folieneigenschaften Manager|Folien]]-Wert (Kann nur an den Eigenschaften gesetzt werden, die auch in den [[CAD-Der Folieneigenschaften Manager|Folien]] verfügbar sind)
|-
||''Wert <von Textstil> setzen''
||Der Wert der Text-Eigenschaft des Text-Objektes entspricht immer dem zugehörigen [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstil]]-Wert (Gilt nur für Text-Eigenschaften (Schriftart, Textgröße, Unterstreichung, ...) für Text-Objekte)
|-
||
||
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten Eigenschaften für das/die ausgewählte(n) Objekt(e)
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten Eigenschaften für das/die ausgewählte(n) Objekt(e)
|-
||''Alle Werte setzen (für relevante Eigenschaften)''
||ruft ''"Wert setzen"'' an allen verfügbaren und relevanten (Text-)Eigenschaften für das/die ausgewählte(n) (Text-)Objekt(e)
|-
||
||
|-
||''Folie "aus Symboldefinition" als feste Folie einstellen''
||Ist die Eigenschaft 'Folie' auf den Wert '"" ' gestellt, dann wird der dieser [[Optionen Menü-Symbol - Definitionen-Die Symbol - Definitionen Freie Symbole|Symboldefinition-Folie]] für die Eigenschaft 'Folie' fest eingestellt
|-
||''Punktsymbol "aus Symboldefinition" als festes Punktsymbol einstellen''
||Ist die Eigenschaft 'Punktsymbol' auf den Wert ' (aus Symboldefinition)' gestellt, dann wird der -Wert dieses [[Optionen Menü-Symbol - Definitionen-Die Symbol - Definitionen Freie Symbole|Symboldefinition-Punktsymbols]] für die Eigenschaft 'Punktsymbols' fest eingestellt
|-
||
||
|-
||''Als aktive Folie einstellen''
||Stellt die [[CAD-Der Folieneigenschaften Manager|Folie]], die als Wert der Eigenschaft 'Folie' eingestellt ist als aktive Folie im CAD ein. (Gilt nur für die Eigenschaft 'Folie')
|-
||''Im Folienmanager öffnen''
||Öffnet die ausgewählte Folie des Objektes im [[CAD-Der Folieneigenschaften Manager|Folieneigenschaften Manager]] (Gilt nur für die Eigenschaft 'Folie')
|-
||''Liniensymbole ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Liniensymbole|Liniensymbolen]] (Gilt nur für die Eigenschaft 'Liniensymbol')
|-
||''Linienmuster ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Linienmuster|Linienmustern]] (Gilt nur für die Eigenschaft 'Linienmuster')
|-
||''Textstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Textstile|Textstilen]] (Gilt nur für die Eigenschaft 'Textstil')
|-
||''Texturen ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Texturen|Texturen]] (Gilt nur für die Eigenschaft 'Textur')
|-
||''Schraffurstile ändern/erstellen''
||Öffnet den Dialog zum Bearbeiten und Erstellen von [[CAD-Einstellungen-CAD Konfiguration-Die Schraffurstile|Schraffurstilen]] (Gilt nur für die Eigenschaft 'Schraffurstil')
|-
||
||
|-
||''Kopieren''
||Kopiert den Wert der Eigenschaft in die Zwischenablage
|-
||''Objekt "anfliegen" (Highlight)''
||Springt ("fährt") das Objekt, dass sich hinter dem Wert der Eigenschaft verbirgt, an (Gilt nur für Eigenschaften, die andere Objekte repräsentieren)
|}

==Die Details==
Die Details enthalten weiter Informationen zu dem Objekt.

[[File:CAD Objektinformationen Details.PNG]]

===Untergeordnete Objekte===
Zeigt das Objekt in seiner Hierarchie zu verwandten Objekten. Das blau markierte Objekt ist das Objekt selbst.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie zu den Objektinformationen dieses Objektes.}}

===Verbindungen===
Zeigt die Verbindung zu weiteren Objekten, die nicht zu den untergeordneten Objekten gehören. Das sind für eine Flurstücksgrenzlinie bspw. Grenzpunkte (Start- und Endpunkt der Linie) und weitere angrenzende Flurstücksgrenzlinien.

Auf '''identische Linien''' wird mit [ident. Linie] hingewiesen. Linien sind dann identisch, wenn sie genau übereinander liegen und demnach die exakt gleichen Endpunkt-Koordinaten besitzen. Bei verbundenen identlischen Linien wird standardmäßig immer nur die Linie mit der höchsten Priorität dargestellt. Das ist entweder das durch die [[CAD-Der Folieneigenschaften Manager|Tiefe der Folie]] höher liegende Objekt oder - bei gleicher Folie - das zuletzt gezeichnete Objekt.

Möchte man weitere identische Linien dennoch darstellen, so kann man das an der Objektinformations-Eigenschaft "Identische Linien" der Linie mittels "[ ] darstellen" tun.

Hinweis: Die Einstellungen wirken sich auch auf den Druck aus, sprich CAD-Ansicht und Druck-Ausgabe sind hier gleich.

{{Hilfe:Hinweis|Per Doppelklick auf eines der aufgeführten Objekte gelangen sie auch hier zu den Objektinformationen dieses Objektes.}}

Datei:CAD Objektinformationen Icon Herkunft.PNG

2024-06-28T09:34:50Z

Hahn: