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

2026-07-20T12:50:36Z

CAD-XML-Syntax-Dokumentation (automatischer Import)

Neue Seite

{{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 Plotrahmen - Versionsgeschichte

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