fügt eine IWAN-Sitzung an eine IPS-Sitzung an
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
nur in Verbindung mit dem IPS (IWAN Präsentation Server) für das System MeMaS
CreateTheProjecterzeugt ein Projekt und macht dieses zum Aktiven für die aufrufende Benutzersitzung. SyntaxHinweis: 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.
HinweiseExistiert 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. BeispieleGo; |
exportiert eine Ebene oder Teile einer Ebene
- diese Befehl sollte nicht mehr verwendet werden-
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
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.
GetLegSymbolGibt 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. SyntaxHinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional GetLegSymbol(
theLayer:value); theLayer Ebenenname für den das Symbol ausgelesen werden soll
HinweiseDie Hintergrundfarbe für die Legendensymbole kann bei CreateTheProject mit angegeben werden. BeispieleGo; |
MakeRedLineErmö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. SyntaxHinweis: 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.
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.
HinweiseDie Symbolnummer bezieht sich immer auf das Projektsymbolset, es sei denn bei SetTheRedlineParameters wird ein anderes definiert. BeispieleGo; |
SendMailVersendet eine e-Mail. Damit kann zum Beispiel auch ein Kartenbild verschickt werden. SyntaxHinweis: 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
Hinweisenull BeispieleGo; |
leitet die Errorausgabe um. Wird nicht mehr benutzt
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
SetTheDrawSelParametersSetzt die Einstellung zur Darstellung selektierter Objekte. SyntaxHinweis: 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").
HinweiseStandardmäß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. BeispieleGo; |
SetTheImageParameterssetzt verschiedene Parameter bezüglich der zu erzeugenden Kartenbilder für die aufrufende Sitzung. SyntaxHinweis: 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.
HinweiseWird 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. BeispieleGo; |
Legt Eigenschaften für die Darstellung des Redline-Objektes fest.
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
theSymbolset
null
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Beispiel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
SetTheRedlineParameters theSymbolset=../redline.ipal
End;
speichert Parameter in einer externen Session. Server)
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
Xmin
Ymin
Xmax
Ymax
Nur in Verbindung mit IPS (IWAN Presentation Server für MeMaS)
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Beispiel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
End;
Legt die Symboldatei für das Projekt fest.
Hinweis: alle mit einem * in der Beschreibung gekennzeichneten Angaben sind optional
theFile
Dieser Befehl kann nur direkt bei der Projekterstellung verwendet werden. Ein einmal gesetztes Symbolset bleibt über die gesamte Lebenszeit des Projektes gültig.
Go;
/*~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Beispiel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~*/
ret=ExecOld("UseTheSymbolSet", theFile:"e:\web\Symbols\main.ipal");
End;