MWT Syntax-Block 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.

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]