MWT Syntax-Block HINTERGRUNDGRAFIK: Unterschied zwischen den Versionen

Aktuelle Version vom 18. September 2026, 10:38 Uhr

Der Block HINTERGRUNDGRAFIK speichert die Georeferenzierung einer Rasterhintergrund-Grafik (z. B. gescannte Flurkarte oder Riss): Dateiname, Darstellung (Halbton, Drehung, Spiegelung …) und die Passpunkt-/Transformationsparameter. Es können mehrere Blöcke im Projekt hinterlegt werden, aber nur eine Grafik darf aktiv sein.

Syntaxregel

HINTERGRUNDGRAFIK
    { <Bezeichner> = <Wert> ; }*
END [;]

Regelelement	Bedeutung
`<Bezeichner>`	einer der Bezeichner aus der Tabelle unten; unbekannte Bezeichner erzeugen Fehler 601 „unbekanntes Schlüsselwort“.
`<Wert>`	Wert je nach Bezeichner: Dateiname, Boolean (`0` = aus, `-1` = ein), ganze Zahl oder Realzahl (auch in E-Notation, z. B. `4.376838517677306E+0`).

Parameter

Der Blockkopf hat keine Parameter. Bezeichner der Datenzeilen:

Bezeichner	Syntax	Pflicht	Bedeutung	Bundesland
`DATEI`	`DATEI = <Pfad\Dateiname>;`	ja	Grafikdatei (relativer Pfad zulässig, z. B. `VCD-Grafiken\1315US1N8-AUSS.jpg`)	alle
`AKTIV`	`AKTIV = 0\|-1;`	nein	diese Grafik anzeigen/benutzen; nur eine Grafik im Projekt darf aktiv sein	alle
`HALBTON`	`HALBTON = 0\|-1;`	nein	Halbton-Darstellung (abgeschwächt)	alle
`DREH_R`	`DREH_R = 0..3;`	nein	Drehung in 90°-Schritten (ganze Zahl 0–3, sonst Fehler 464)	alle
`SPIEGEL`	`SPIEGEL = 0\|-1;`	nein	Spiegelung	alle
`INVERT`	`INVERT = 0\|-1;`	nein	Farben invertieren	alle
`AUFHELL`	`AUFHELL = 0..15;`	nein	Aufhellungsstufe (ganze Zahl 0–15, sonst Fehler 465)	alle
`PASS_A`, `PASS_O`	`PASS_A = <w>;`	nein	Transformationsparameter der Georeferenzierung (Maßstab/Drehanteile)	alle
`PASS_X`, `PASS_Y`	`PASS_X = <w>;`	nein	Translationsanteile der Georeferenzierung	alle
`PASS_TL_X`, `PASS_TL_Y`	`PASS_TL_X = <w>;`	nein	Passkoordinate der linken oberen Bildecke (top left)	alle
`PASS_BR_X`, `PASS_BR_Y`	`PASS_BR_X = <w>;`	nein	Passkoordinate der rechten unteren Bildecke (bottom right)	alle

Datenzeilen

Je Datensatz genau ein Paar Bezeichner = Wert;; die Reihenfolge ist beliebig, üblich ist die oben gezeigte.
Boolesche Werte werden als 0 (aus) bzw. -1 (ein) geschrieben.
Die PASS_*-Realzahlen schreibt VermCad in Exponentialnotation; beim manuellen Erstellen genügt normale Dezimalschreibweise.
Die Scan-Auflösung (DPI) und der Kartenmaßstab (KMS) gehören nicht in diesen Block: Sie sind Blockkopf-Parameter des zugehörigen VORGABEN KOORDINATENSYSTEM-Blocks (nur in Nicht-Auftrags-Koordinatensystemen zulässig).

Beispiele

Beispiel (Sachsen)

HINTERGRUNDGRAFIK
  DATEI = VCD-Grafiken\1315US1N8-AUSS.jpg;
  AKTIV = -1;
  HALBTON = -1;
  DREH_R = 0;
  SPIEGEL = 0;
  INVERT = 0;
  PASS_A = 4.376838517677306E+0;
END

Beispiel mit vollständigen Passparametern (alle Bundesländer)

HINTERGRUNDGRAFIK

  DATEI = 20.jpg;                { Dateiname                        }
  AKTIV = -1;                    { diese Grafik benutzen; 0 oder -1 }
  HALBTON = 0;
  DREH_R = 0;
  SPIEGEL = 0;
  INVERT = 0;
  PASS_A = 1.000000000000000E+0; { Transformationsparameter         }
  PASS_O =   0.0000000000000E+0;
  PASS_X =   0.0000000000000E+0;
  PASS_Y =   0.0000000000000E+0;
END

Verfügbarkeit und Besonderheiten

Verfügbar in allen Bundesländern; in der Praxis vor allem in Sachsen (Digitalisierung gescannter Risse/Karten) und Thüringen verbreitet.
Mehrere HINTERGRUNDGRAFIK-Blöcke pro Projekt sind zulässig; nur einer sollte AKTIV = -1 haben.
Der Block wird üblicherweise vom Georeferenzierungs-Dialog geschrieben; die PASS_*-Parameter von Hand zu setzen ist fehleranfällig.
Fehlerquellen: Fehler 601 (unbekannter Bezeichner), 602 (Boolean erwartet), 603 (Realzahl erwartet), 464/465 (Wertebereiche DREH_R/AUFHELL).

Entwicklerhinweise

Diese Angaben richten sich an Entwickler bzw. eine KI mit Zugriff auf den VermCad-Quellcode; für die reine Nutzung der MWT-Syntax sind sie nicht nötig. Unit-Namen und besonders Zeilennummern können sich durch die laufende Weiterentwicklung verschieben - sie dienen als Einstieg, nicht als exakte Fundstelle.

Quellen im Code:

VERMCAD\VCSCHMWT.PAS:4956-5086 — Datensatz-Verarbeitung aller Bezeichner (inkl. Wertebereiche DREH_R 0–3, AUFHELL 0–15)
VERMCAD\GlobalConsts.pas:1654 — kwGrafikGeoRef = 'HINTERGRUNDGRAFIK'
VERMCAD\VCSCHMWT.PAS:2426-2861 — ReadBlockHeaderInfos: DPI/KMS nur im VORGABEN-Koordinatensystem-Kopf

[Nach oben]

@@ Zeile 1: / Zeile 1: @@
-{{DISPLAYTITLE:Block HINTERGRUNDGRAFIK}}
+{{DISPLAYTITLE:HINTERGRUNDGRAFIK}}
 Der Block HINTERGRUNDGRAFIK speichert die Georeferenzierung einer Rasterhintergrund-Grafik (z. B. gescannte Flurkarte oder Riss): Dateiname, Darstellung (Halbton, Drehung, Spiegelung …) und die Passpunkt-/Transformationsparameter. Es können mehrere Blöcke im Projekt hinterlegt werden, aber '''nur eine Grafik darf aktiv sein'''.
@@ Zeile 94: / Zeile 94: @@
 '''Quellen im Code:'''
-* <code>VERMCAD\VCSCHMWT.PAS:4940-5070</code> — Datensatz-Verarbeitung aller Bezeichner (inkl. Wertebereiche DREH_R 0–3, AUFHELL 0–15)
+* <code>VERMCAD\VCSCHMWT.PAS:4956-5086</code> — Datensatz-Verarbeitung aller Bezeichner (inkl. Wertebereiche DREH_R 0–3, AUFHELL 0–15)
-* <code>VERMCAD\GlobalConsts.pas:1576</code> — <code>kwGrafikGeoRef = 'HINTERGRUNDGRAFIK'</code>
+* <code>VERMCAD\GlobalConsts.pas:1654</code> — <code>kwGrafikGeoRef = 'HINTERGRUNDGRAFIK'</code>
-* <code>VERMCAD\VCSCHMWT.PAS:2418-2845</code> — <code>ReadBlockHeaderInfos</code>: <code>DPI</code>/<code>KMS</code> nur im VORGABEN-Koordinatensystem-Kopf
+* <code>VERMCAD\VCSCHMWT.PAS:2426-2861</code> — <code>ReadBlockHeaderInfos</code>: <code>DPI</code>/<code>KMS</code> nur im VORGABEN-Koordinatensystem-Kopf
 {{Hilfe:NachOben}}
-[[Kategorie:MWT Syntax|Block HINTERGRUNDGRAFIK]]
+[[Kategorie:Blöcke mit Anweisungen (Makros)|HINTERGRUNDGRAFIK]]