CreateTheImageErzeugt das Kartenbild mit den aktuellen Einstellung und hält es in einem Sitzungspuffer bereit. SyntaxHinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional CreateTheImage(
theResolution:value, ImgLib:value, collectDrawStat:value); theResolution Auflösung des Bildes, angegeben als Breite bzw. Höhe in Pixeln (die jeweils längere Seite wird verwendet).
ImgLib gibt die für die Bildkomprimierung zu verwendende Routine an. Mögliche Werte sind "PNGLIB" (Standard) und "GDIPLUS".
collectDrawStat Boolscher Wert in der Form "true" oder "false". Legt fest, ob die Informationen der letzten Zeichenanforderung einer Sitzung aufgezeichnet werden sollen. Diese können mit der Methode LastDrawedLayers des Session-Objekt abgefragt werden. Ab Version 3.3.1.430 verfügbar.
HinweiseDer Aufruf dieser Funktion generiert die Karte mit den in der Sitzung vorgenommenen Einstellungen. Ein wiederholter Aufruf dieser Funktion verwirft das zuletzt erstellte Kartenbild. BeispieleGo; |
Setzt den Extent für diese Sitzung auf die gesamte Ausdehung aller als sichtbar markierten Ebenen. Standardmäßig wird ein Kartenbild mit den aktuellen Einstellung für diesen Extent generiert.
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
CreateIt
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Beispiel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("ExtendToActiveLayers");
End;
CreateTheImage, SetTheImageParameters
Setzt den Extent der Karte auf die Ausdehnung der im Parameter theLayerList angegebenen Ebenen, so dass diese im zurückgelieferten Kartenbild vollständig enthalten sind.
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
theLayerList
CreateIt
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Beispiel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("ExtendToLayer", theLayerList:"STRASSEN|FLUESSE", CreateIt:false); ret=ExecOld("CreateTheImage"); ret=ExecOld("GetTheImage");
End;
ExtentToActiveLayers, GetTheImage, CreateTheImage, SetTheImageParameters
Holt das zuletzt erstellte Kartenbild aus dem Sitzungspuffer und sendet dies direkt an den Aufrufer.
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
Direkt aufeinanderfolgende GetTheImage-Anweisungen ohne erneute Bildgenerierung (also CreateTheImage oder ähnliches) führen zu einem Fehler.
Die Anweisung in einem Skript führt zum sofortigen Abbruch der Abarbeitung des Programmcodes und sendet unmittelbar das Bild an den Aufrufer.
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Beispiel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("CreateTheImage"); ret=ExecOld("GetTheImage"); /* diese Zeilen wird nie erreicht*/ print("Diese Zeile wird nie erreicht");
End;
CreateTheImage, ExtendToActiveLayers, ExtendToLayers, Pan, ZoomIn, ZoomOut, ZoomToSelect
Zentriert das Kartenbild auf den angegebenen Punkt und erzeugt das Bild.
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
X
Y
CreateIt
Generiert das Bild - CreateTheImage ist nicht nötig (wenn nicht durch CreateIt unterbunden).
Bitte beachten Sie die Hinweise für Koordinatenangaben.
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Beispiel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("Pan",x:"i50",y:"i100");
End;
ZoomIn, ZoomOut, ZoomToSelect, Koordinatenangaben
Setzt einen neuen Extent auf die angegebenen Koordinaten und
erzeugt das Bild.
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
X1
Y1
X2
Y2
CreateIt
Wenn createIt nicht angegeben wurde, wird das Bild generiert. Der Befehl CreateTheImage ist dann nicht nötig.
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Beispiel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("ZoomIn",x1:20,y1:24,x2:34,y2:10);
End;
ZoomOut, Pan, ZoomToSelect, Koordinatenangaben
Verdoppelt die Extentbreite und -höhe, zentriert auf den angegebenen Punkt und erzeugt das Bild.
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
X
Y
CreateIt
Wenn createIt nicht angegeben wurde, wird das Bild generiert. Der Befehl CreateTheImage ist dann nicht nötig.
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Beispiel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("ZoomOut",x:34,y:56);
End;
ZoomIn, Pan, ZoomToSelect, Koordinatenangaben
Passt die Ausdehnung der Karte so an, dass eine in der aktuellen Sitzung vorhandene Selektionsmenge vollständig darin enthalten ist. Das Kartenbild wird erzeugt, wenn es nicht durch den Parameter CreateIt unterbunden wurde.
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
theOffset
CreateIt
Der Aufruf dieses Befehls ohne eine gültige Selektionsmengen in der aktuellen Sitzung führt zu einem Fehler!
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Beispiel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("ZoomToSelect", theOffset:30 CreateIt:true); ret=ExecOld("GetTheImage");
End;