Kartenerstellung/Navigation

CreateTheImage

Erzeugt das Kartenbild mit den aktuellen Einstellung und hält es in einem Sitzungspuffer bereit.

Syntax

Hinweis: 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.
Hinweise

Der Aufruf dieser Funktion generiert die Karte mit den in der Sitzung vorgenommenen Einstellungen. Ein wiederholter Aufruf dieser Funktion verwirft das zuletzt erstellte Kartenbild.

Beispiele
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("ExtendToLayers",theLayerList:"xyz"); // Karte erstellen ret=ExecOld("CreateTheImage"); // Karte anfordern ret=ExecOld("GetTheImage");
End;


 

ExtendToActiveLayers

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.

Syntax

Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional

ExtendToActiveLayers( 
CreateIt:value);

CreateIt

"true" oder "false", dieser optionale Parameter legt fest, ob durch diesen Aufruf die Karte generiert werden soll oder ob nur die Sitzungsparameter geändert werden. Standardwert ist "true".
Hinweise
Beispiele
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("ExtendToActiveLayers");
End;
Verwandte Themen

CreateTheImage, SetTheImageParameters

ExtendToLayers

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.

Syntax

Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional

ExtendToLayers( 
theLayerList:value,
CreateIt:value);

theLayerList

Liste der Ebenennamen aus dem aktiven Projekt getrennt durch "|" Zeichen.

CreateIt

"true" oder "false", dieser optionale Parameter legt fest, ob durch diesen Aufruf die Karte generiert werden soll oder ob nur die Sitzungsparameter geändert werden. Standardwert ist "true".
Hinweise
Beispiele
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("ExtendToLayer", theLayerList:"STRASSEN|FLUESSE", CreateIt:false); ret=ExecOld("CreateTheImage"); ret=ExecOld("GetTheImage");
End;
Verwandte Themen

ExtentToActiveLayers, GetTheImage, CreateTheImage, SetTheImageParameters

GetTheImage

Holt das zuletzt erstellte Kartenbild aus dem Sitzungspuffer und sendet dies direkt an den Aufrufer.

Syntax

Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional

GetTheImage( );
Hinweise

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.

Beispiele
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("CreateTheImage"); ret=ExecOld("GetTheImage"); /* diese Zeilen wird nie erreicht*/ print("Diese Zeile wird nie erreicht");
End;
Verwandte Themen

CreateTheImage, ExtendToActiveLayers, ExtendToLayers, Pan, ZoomIn, ZoomOut, ZoomToSelect

Pan

Zentriert das Kartenbild auf den angegebenen Punkt und erzeugt das Bild.

Syntax

Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional

Pan( 
X:value,
Y:value,
CreateIt:value);

X

X-Wert der Koordinate

Y

Y-Wert der Koordinate

CreateIt

"true" oder "false", dieser optionale Parameter legt fest, ob durch diesen Aufruf die Karte generiert werden soll oder ob nur die Sitzungsparameter geändert werden. Standardwert ist "true".
Hinweise

Generiert das Bild - CreateTheImage ist nicht nötig (wenn nicht durch CreateIt unterbunden).

Bitte beachten Sie die Hinweise für Koordinatenangaben.

Beispiele
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("Pan",x:"i50",y:"i100");
End;
Verwandte Themen

ZoomIn, ZoomOut, ZoomToSelect, Koordinatenangaben

 

ZoomIn

Setzt einen neuen Extent auf die angegebenen Koordinaten und
erzeugt das Bild.

Syntax

Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional

ZoomIn( 
X1:value,
Y1:value,
X2:value,
Y2:value,
CreateIt:value);

X1

X-Wert der linken, unteren Koordinate

Y1

Y-Wert der linken, unteren Koordinate

X2

X-Wert der rechten, oberen Koordinate

Y2

Y-Wert der rechten, oberen Koordinate

CreateIt

"true" oder "false", dieser optionale Parameter legt fest, ob durch diesen Aufruf die Karte generiert werden soll oder ob nur die Sitzungsparameter geändert werden. Standardwert ist "true".
Hinweise

Wenn createIt nicht angegeben wurde, wird das Bild generiert. Der Befehl CreateTheImage ist dann nicht nötig.

Beispiele
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("ZoomIn",x1:20,y1:24,x2:34,y2:10);
End;
Verwandte Themen

ZoomOut, Pan, ZoomToSelect, Koordinatenangaben

 

ZoomOut

Verdoppelt die Extentbreite und -höhe, zentriert auf den angegebenen Punkt und erzeugt das Bild.

Syntax

Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional

ZoomOut( 
X:value,
Y:value,
CreateIt:value);

X

X-Wert

Y

Y-Wert

CreateIt

"true" oder "false", dieser optionale Parameter legt fest, ob durch diesen Aufruf die Karte generiert werden soll oder ob nur die Sitzungsparameter geändert werden. Standardwert ist "true".
Hinweise

Wenn createIt nicht angegeben wurde, wird das Bild generiert. Der Befehl CreateTheImage ist dann nicht nötig.

Beispiele
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("ZoomOut",x:34,y:56);
End;
Verwandte Themen

ZoomIn, Pan, ZoomToSelect, Koordinatenangaben

ZoomToSelect

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.

Syntax

Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional

ZoomToSelect( 
theOffset:value,
CreateIt:value);

theOffset

Abstand vom Rand der Selektion zum Kartenrand in Metern.

CreateIt

"true" oder "false", dieser optionale Parameter legt fest, ob durch diesen Aufruf die Karte generiert werden soll oder ob nur die Sitzungsparameter geändert werden. Standardwert ist "true".
Hinweise

Der Aufruf dieses Befehls ohne eine gültige Selektionsmengen in der aktuellen Sitzung führt zu einem Fehler!

Beispiele
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("ZoomToSelect", theOffset:30 CreateIt:true); ret=ExecOld("GetTheImage");
End;
Verwandte Themen

ZoomIn, ZoomOut, Pan