Festlegung von Parametern

AttachSession

fügt eine IWAN-Sitzung an eine IPS-Sitzung an

Syntax

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

AttachSession( );
Hinweise

nur in Verbindung mit dem IPS (IWAN Präsentation Server) für das System MeMaS 

CreateTheProject

erzeugt ein Projekt und macht dieses zum Aktiven für die aufrufende Benutzersitzung.

Syntax

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

CreateTheProject( 
theName:value,
theLegBGColor:value,
theProjection:value,
theFile:value,
theSessionTimeOut:value,
ForceSecurity:value,
SetSecurity:value,
DrawCopyRight:value,
theMaxDrawCount:value,
theMaxDrawDuration:value);

theName

der eindeutige Name des Projektes. Es treffen die Regeln aus Ebenen - Namenzu

theLegBGColor

* legt die Hintergrundfarbe für die Legendensymbole fest

theProjection

* EPSG - Nummer (ohne das Präfix EPSG!) für die Kennzeichnung der Transformation. Werden Ebenen in dieses Projekt eingefügt und für diese ist eine abweichende Projekt definiert, wird die Laufzeittransformation aktiviert.

theFile

* Pfad zu einer inc-Datei, die direkt eingebunden wird und alle HTTPMAP-Befehle enthalten kann(nützlich zum Beispiel um alle Ebenendefinitionen in einer separaten Datei zu halten). Dieses Angabe findet bei neuen Entwicklungen keine Beachtung mehr.

theSessionTimeOut

* Zeitspanne nach der letzten Anforderung an den Server bis die Sitzung abläuft, angegeben in Sekunden.

ForceSecurity

* legt fest ob eine Authentifizierung des Nutzers vorgenommen wird und Ebenen entsprechend den Nutzerrechten behandelt werden

SetSecurity

* legt die Benutzerrechte für das gesamte Projekt fest;die Einträge können von den einzelnen Ebenen noch modifiziert werden

DrawCopyRight

* Boolsche Angabe in der Form "true" oder "false", wird diese Option aktiviert wird in die Kartenbilder ein Text "powered by iwan" eingefügt.

theMaxDrawCount

* Legt die Anzahl der maximal gleichzeitigen Zeichenoperationen für dieses Projekt fest. Wird dieser Wert nicht angegeben erfolgt keine Beschränkung.

theMaxDrawDuration

* die maximale Zeit in Millisekunden welche bei konkurierenden Zeichenzugriffe auf Ebenen mit aktiviertem "maxDrawCount" gewartet werden soll.
Hinweise

Existiert das Projekt bereits wird dieser Befehl ignoriert. Zum entladen eines Projektes kann der Telnet-Zugang verwendet werden. Änderungen an den Parametern erfordern i.d.R. das Neuladen des Projektes. Nachdem ein Projekt vorhanden ist, können mit den Befehlen zum Ebenen erstellen Ebenen in dieses Projekt geladen werden. Der Zugriff einer Sitzung ist immer nur auf die Elemente in einem Projekt möglich. Projektübergreifende Zugriffe sind dabei nicht möglich.

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

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
/*Im folgenden Beispiel wird das Projekt DEMOPROJEKT erstellt. /*Es sind maximal 8 Parallele Zeichenzugriffe zulässig. /*Sind alle 8 Prozesse belegt werden in die in die Warteschlange /*eingereihten Anforderungen nach einer Wartezeit von 10 Sekunden /*zurückgewiesen. CreateTheProject theName=DEMOPROJEKT ForceSecurity=TRUE SetSecurity=NATUR:aGA+adG+add+ theSessionTimeOut=1200 theMaxDrawCount=8 theSessionTimeOut=1200 theMaxDrawDuration=10000 theFile=e:\web\inc\Ebenen\definitionen.inc;
End;


ExportTheLayer

exportiert eine Ebene oder Teile einer Ebene
- diese Befehl sollte nicht mehr verwendet werden-

Syntax

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

ExportTheLayer( );
Hinweise

Ist eine Selektion auf dem Layer, wird immer diese verwendet,
Geometrie muss zum Layertyp passen. Soll Ergebnis direkt als Mail versendet werden, so gelten die beim SendMail vergebenen Parameter.

Tipp: Es existiert ein separater Exportserver, diese Funktion wird nicht weiter gepflegt.

GetLegSymbol

Gibt das Legendensymbol für eine Ebene zurück. Für klassifizierte Ebenen wird ein Bild mit Beschriftung für alle vorhandenen Einträge erstellt. Für Ebenen mit Einzelsymbol wird nur das Bild in der Größe 35x18 Pixel.

Syntax

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

GetLegSymbol( 
theLayer:value);

theLayer

Ebenenname für den das Symbol ausgelesen werden soll
Hinweise

Die Hintergrundfarbe für die Legendensymbole kann bei CreateTheProject mit angegeben werden.

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

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("GetLegSymbol",theLayer:"STRASSE");
End;


MakeRedLine

Ermöglicht die Darstellung eines frei definierbaren Objektes in einer Sitzung. Das Objekt bleibt über die gesamte Sitzung vorhanden. Es können beliebig viel RedLine Objekte vorhanden sein.
Das Löschen einzelner Objekte ist nicht vorgesehen.

Syntax

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

MakeRedLine( 
theType:value,
theGeometry:value,
theSymbol:value,
theROP2Code:value,
theName:value,
theSymbolSet:value);

theType

legt die Art der Aktion fest.
  • clear - löscht das bestehende Redline-Objekt (keine weiteren Argumente sinnvoll)
  • add - fügt die angegebene Geometrie dem Objekt hinzu
  • replace - ersetzt das bestehende Objekt mit der angegebenen Geometrie

theGeometry

String Repräsentation einer Geometrie

theSymbol

Symbolnummer für das Redline-Objekt.

theROP2Code

legt fest, wie die Redline und Kartenbild übereinander gelegt werden (z.B. einfaches Überdecken, Ineinanderkopieren, Negativ usw.) für Angaben dazu siehe MSDN. (Bsp.: "R2_MaskPen")

theName

Optionaler Name für diesen Eintrag. Wird in Verwendung mit CLEAR kein Name angegeben, werden alle Einträge gelöscht. Ansonsten nur die Benannten. Die Namen müssen nicht eindeutig sein.

theSymbolSet

Lädt eine spezielle Symbolpalette für die Redline Objekte. Die Projektglobale Symbolpalette für RedLines wird damit überschrieben.
Hinweise

Die Symbolnummer bezieht sich immer auf das Projektsymbolset, es sei denn bei SetTheRedlineParameters wird ein anderes definiert.
Die Darstellung erfolgt mit der nächsten Kartenanforderung.

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

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
MakeRedLine theType=ADD TheGeometry=gPOINT:450000|560000 theSymbol=12 theROP2Code=R2_MaskPen;
End;


SendMail

Versendet eine e-Mail. Damit kann zum Beispiel auch ein Kartenbild verschickt werden.

Syntax

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

SendMail( 
theName:value,
theServer:value,
theTag:value,
theText:value,
theType:value,
theDispatcher:value);

theName

e-Mail-Adresse des Empfängers

theServer

Mailserver, über den die e-Mail versendet werden soll

theTag

Betreffzeile der e-Mail

theText

Textkörper der e-Mail

theType

"Image" - hängt das aktuelle Kartenbild an
"Text" - sendet die Mail ohne Kartenbild

theDispatcher

e-Mail-Adresse des Sendenden
Hinweise

null

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

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
SendMail theName=info@idu.de theDispatcher=ich@home.de theTag=Betreff:IDU theText=Infomail theType=image theServer=mail.idu.de;
End;


SetErrorOutput

leitet die Errorausgabe um. Wird nicht mehr benutzt

Syntax

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

SetErrorOutput( );

SetTheDrawSelParameters

Setzt die Einstellung zur Darstellung selektierter Objekte.

Syntax

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

SetTheDrawSelParameters( 
MarkerTypeAuto:value,
UseDrawSel:value,
UseMarker:value,
theSelSymbols:value,
theSelPointRadius:value,
theROP2Code:value);

MarkerTypeAuto

Selektierte Punktobjekte können mit einem (Truetype) Marker oder einem Vektor-Kreis dargestellt werden. Soll diese Entscheidung auf Grund der Symboleigenschaft getroffen werden, kann dieser Parameter auf "true" gesetzt werden.

UseDrawSel

bestimmt, ob überhaupt Selektionselemente gezeichnet werden sollen. Ausdruck "true" oder "false"

UseMarker

Legt die explizite Verwendung eines Markersymbols für selektierte Punkte fest.

theSelSymbols

bestimmt die Symbole, die zum Zeichnen der Selektionselemente benutzt werden und zwar für jeden Ebenentyp extra in der Reihenfolge: theSelSymbols=Point|Line|Poly. theSelSymbol="0|1|2" verwendet Symbol mit dem Index 0 aus dem aktuellen Symbolset für Punktdarstellunge, 1 für Linien und 2 für Polygone.

theSelPointRadius

ist nur für Punktobjekte relevant,wird als Wert ''''''''USEMARKER'''''''' angegeben, wird ein Punktsymbol gezeichnet, andernfalls wird ein Kreis mit dem angegebenen Radius in Pixeln oder Metern (dazu px oder m der Zahl direkt nachstellen) dargestellt. In diesem Falle kommte die Pinseleigenschaft des Symbols zum Einsatz.

theROP2Code

legt fest, wie Selektionssymbol und Kartenbild übereinander gelegt werden (z.B. einfaches Überdecken, Ineinanderkopieren, Negativ usw.) für Angaben dazu siehe MSDN. (Bsp.: "R2_MaskPen").
Hinweise

Standardmäßig werden Selektionen nicht dargestellt. Die Aktivierung erfolgt erst durch den Parameter UseDrawSel=true.

Bei nicht sichtbare Ebenen werden standardmäßig keine Selektionselemente gezeichnet. Ist dies gewünscht kann in der Ebenendefinition UseDrawSel auf TRUE gesetzt werden.

Selektionsdarstellungen werden immer am Ende eines Zeichenvorgangs dargestellt. Damit liegen diese immer über allen anderen Elementen.

Die Symbolnummern beziehen sich immer auf das der Ebene zugewiesene Symbolset.

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

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("SetTheDrawSelParameters" UseDrawSel:true, theSelSymbols:"0|1|2", theSelPointRadius:"20m", theROP2Code:"R2_MASKPEN");
End;


SetTheImageParameters

setzt verschiedene Parameter bezüglich der zu erzeugenden Kartenbilder für die aufrufende Sitzung.

Syntax

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

SetTheImageParameters( 
theImageType:value,
theTransparencyColor:value,
theQuality:value,
theEcwCompressionFator:value,
theWidth:value,
theHeight:value,
theMinScale:value,
theMaxScale:value,
UseTheProject:value,
theLayerList:value,
theBGColor:value,
Xmin:value,
Ymin:value,
Xmax:value,
Ymax:value,
thePrintMode:value);

theImageType

* gibt die Kompressionsmethode für das Bild an. Mögliche Werte sind "PNG","GIF","JPG","EMF","PNG8","ECW"

theTransparencyColor

* ist theImageType als "PNG" definiert, kann eine Farbe als transparent festgelegt werden.

theQuality

* ist theImageType "JPG", dann kann die Bildqualität in Prozent angegeben werden. Der Wertebereich ist eine Ganzahl zwischen 1 und 100. Wobei 1 die schlechteste Qualität aber geringste Bildgröße darstellt.

theEcwCompressionFator

* ist theImageType "ECW" kann hier der Komprimierungsfaktor angegeben werden. Numerischer Wert 1-20. Standard ist 10.

theWidth

Ausgabebreite in Pixeln

theHeight

* Ausgabehöhe in Pixeln

theMinScale

* legt die Maßstabszahl für die untere Darstellungsgrenze fest (maximale Vergrößerung)

theMaxScale

* legt die Maßstabszahl für die obere Darstellungsgrenze fest (minimale Vergrößerung)

UseTheProject

* kann benutzt werden um eine Sitzung zu starten, wenn dies nicht bereits durch einen CreateTheProjekt-Aufruf erfolgte;erwartet den Namen eines geladenen Projektes.

theLayerList

* Liste der Ebenennamen, die dargestellt werden sollen, getrennt durch ''''''''|''''''''. Das zuletzt genannte wird auch als letztes gezeichnet.Um alle Ebenen zu laden kann als Wert ''''''''all'''''''' angegeben werden.

theBGColor

* Hintergrundfarbe des Kartenbildes

Xmin

* X-Wert der linken unteren Koordinate zum Festlegen eines Extenten

Ymin

* Y-Wert der linken unteren Koordinate zum Festlegen eines Extenten

Xmax

* X-Wert der rechten oberen Koordinate zum Festlegen eines Extenten

Ymax

* Y-Wert der rechten oberen Koordinate zum Festlegen eines Extenten

thePrintMode

Boolescher Wert in der Form "true" oder "false". Dieser Hinweis kann für durch das jeweilige Symbol ausgewertet werden, wenn z.B. für den Printmodus andere Farben in dem Symbol definiert wurden.
Hinweise

Wird in der Sitzung keine Angabe zu theLayerList gemacht, so werden alle Ebenen in der Reihenfolge ihrer Definition dargestellt. Sämtliche gesetzten Parameter werden in der Sitzung gespeichert. Bei Änderungen genügt die Angabe für den neuen gewünschten Parameter.

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

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("SetTheImageParameters" theImageType:"png", theTrancparencyColor:"#FFFFFF", theWidth:420, theHeight:340, theMinScale:200, theMaxScale:5000000, UseTheProject:"DEMOPROJEKT", theLayerList:"KREISGEBIET|ORTE|STRASSEN|GEBAEUDE", theBGColor:"White"); SetTheImageParameters theImageType=jpg theQuality=90 theBGColor=white Xmin=g5512345 Ymin=g5654321 Xmax=g5556788 Ymax=g5723433;
End;


SetTheRedlineParameters

Legt Eigenschaften für die Darstellung des Redline-Objektes fest.

Syntax

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

SetTheRedlineParameters( 
theSymbolset:value);

theSymbolset

relativer oder absoluter Pfad zu einer extra Symboldatei. Erfolgt diese Angabe nicht, wird das Symbolset des Projektes verwendet.
Hinweise

null

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

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
SetTheRedlineParameters theSymbolset=../redline.ipal
End;
Verwandte Themen

MakeRedLine

 

StoreParamExtern

speichert Parameter in einer externen Session. Server)

Syntax

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

StoreParamExtern( 
Xmin:value,
Ymin:value,
Xmax:value,
Ymax:value);

Xmin

X-Wert der linken, unteren Koordinate

Ymin

Y-Wert der linken, unteren Koordinate

Xmax

X-Wert der rechten, oberen Koordinate

Ymax

Y-Wert der rechten, oberen Koordinate
Hinweise

Nur in Verbindung mit IPS (IWAN Presentation Server für MeMaS)

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

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/

End;
Verwandte Themen

AttachSession

 

UseTheSymbolset

Legt die Symboldatei für das Projekt fest.

Syntax

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

UseTheSymbolset( 
theFile:value);

theFile

relativer oder absoluter Pfad zur Symboldatei (Ipal, bzw. Ipalx).
Hinweise

Dieser Befehl kann nur direkt bei der Projekterstellung verwendet werden. Ein einmal gesetztes Symbolset bleibt über die gesamte Lebenszeit des Projektes gültig.

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

Beispiel


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("UseTheSymbolSet", theFile:"e:\web\Symbols\main.ipal");
End;
Verwandte Themen

CreateTheProject