Iwan bietet verschiedene Möglichkeiten Symbole in Abhängigkeit vom aktuellen Kartenmaßstab darzustellen. Dabei kann es entweder um Optimierung der Darstellungsqualität gehen, oder auch um die Performance zu optimieren.

Beispiel

Im Folgenden soll anhand eines Punktsymboles die verschiedenen Möglichkeiten demonstriert werden.

Wie eindeutig zu erkennen ist, ist die Darstellung mit einem Vektormarker ca. 2x so schnell, wie die Darstellung mit einem TrueType Marker (jeweils ein Symbollayer). Die angegebenen Zeiten beziehen sich auf die Darstellung einer ungefilterten Punktmenge aus einer Shape Datei. Dabei wurde alle ~23.000 Punkte zur Anzeige gebracht. 

	TrueType - Marker mit 2 Layern Zeichendauer: 1450 ms Bereich: 1:0 ... 1:2000
	TrueType - Marker mit 1 Layer Zeichendauer: 1079 ms Bereich: 1:2001 ... 1:5000
	Vektormaker, 1 Element Zeichendauer: 520 ms Bereich: 1:5001 ...

Die Symbolpalette (ipalx)

Go;

   SetNewSymbolCount(20,false,false);

  

   /////////////////////////////////////////////////////////////7

   //1. Defintion des Standardsymboles

   // Diese bietet die detailierteste Darstellung

   /////////////////////////////////////////////////////////////7

   SetTrueTypeMarker(10,

                   "Webdings", //Name der Schriftart

                   10,         //Größe in Karteneinheiten

                   "None",     //Keine Hintergrundfarbe

                   "Red",110,  //Marker-Layer 1: Roter Kreis

                   "Yellow",120);//Marker-Layer 2: Weißes Kreis mit Diagonale

   /////////////////////////////////////////////////////////////7

   //Skalierung begrenzen. Symbol ist hier mit 10 Karteneinheiten

   //als Größe definiert

   //Nie kleiner als 10 Pixel, nie größer als 15 Pixel

   /////////////////////////////////////////////////////////////7

   SetMinMaxWidth(10,10,50);  

   /////////////////////////////////////////////////////////////7

   //Einfacherer Darstellung des Objektes

   /////////////////////////////////////////////////////////////7

   SetTrueTypeMarker(11,

                   "Wingdings 2",  //Name der Schriftart

                   20,         //Größe in Karteneinheiten

                   "None",     //Keine Hintergrundfarbe

                   "Red",156); //Marker-Layer 1: Roter Kreis mit "Loch"

   /////////////////////////////////////////////////////////////7

   //Wenn der Maßstab von 0-1000 ist, dann Symbol 10 verwenden.

   //Außerhalb diese Maßstabes Symbol Nr. 11 verwenden

   /////////////////////////////////////////////////////////////7

   SetSymbolRule(10,   //Diese Regel für Symbol Nr. 10 definieren

                   11, //Alternatives Symbol, falls diese Regel *nicht* zutrifft

                   0,  //Symbol 10 trifft zu, wenn MinScale >= 0

                   1000/*  bis MaxScale <= 1000 gegeben ist,

                           ansonsten verwende Symbol Nr. 11*/);

   /////////////////////////////////////////////////////////////7

   //Bis hier ist die Darstellung optisch gelungen, aber die Performance

   //lässt zu wünschen übrige. Die Datenmenge ist i.d.R. vom

   //Maßstab abhängig. Ein TrueType Marker ist immer etwas "langsamer"

   //als ein Vektor-Marker, also noch ein Symbol und eine Regel dazu definieren

   /////////////////////////////////////////////////////////////7

   BeginVectorMarker(12,

                   10, //Größe in Karteneinheiten

                   "Yellow", //Rahmenfarbe

                   "Red"); //Hintergrundfarbe

           VMBox(0,0,100,100);/*Rechteck in den log. Koordinate

                   0,0 bis 100%,100%  */

   EndVectorMarker();

   //Skalierung "aushebeln", immer mit 10px darstellen

   SetMinMaxWidth(12,10,10);  

   /////////////////////////////////////////////////////////////7

   //Wenn der Maßstab von 1000 - 5000 ist, dann Symbol 11 verwenden.

   //Außerhalb diese Maßstabs Symbol Nr. 12 verwende

   /////////////////////////////////////////////////////////////7

   SetSymbolRule(11,   //Diese Regel für Symbol Nr. 11 definieren

                   12, //Alternatives Symbol, falls diese Regel *nicht* zutrifft

                   1000,  //Symbol 10 trifft zu, wenn MinScale >= 0

                   5000/*  bis MaxScale <= 5000 gegeben ist,

                           ansonsten verwende Symbol Nr. 12*/);

End;

Ebenendefinition

Bei der Definition der Ebene ist lediglich darauf zu achten, dass hier Symbol 10 zugewiesen werden muss. Dieses wird durch die Symbolregeln abhängig vom Maßstab während des Zeichenvorgangs durch das entsprechend definierte Symbol ersetzt. In der Legende wird immer Symbol Nr. 10 dargestellt.

Klassifikationen

Zur Klassifikation von Elementen einer Ebene kann eine Legendendatei angegeben werden. Die Legendendateien haben immer die Extension ".ILF". Dies steht für IwanLegendFile.

Bei diesen Dateien handelt es sich ebenfalls um einfache ASCII Dateien, welche z.B. mit einem einfachen Text-Editor erstellt werden können.

Die Legendendateien werden einmalig beim Laden einer Ebenen gelesen. Veränderungen wirken sich erst nach dem Neuladen der Ebene aus.
Es gibt zwei Typen von Klassifikationen:

• Eindeutiger Wert,
• Bereich ("von bis")

Bei beiden Typen muss in der ersten Zeile der Legendetyp in Großschreibung angegeben werden.
Der nächste Wert ist jeweils der Name des Bezugsfeld in der Ebene.
Die Legendendatei wird durch die theSymbolFile bei der Ebenendefinition angegeben. Auch eine Inline-Definition ist möglich, weiteres dazu am Ende dieser Seite.

Zusätzliche Steuerparameter

Ab Version 3.2.0 können in der ersten Zeile weitere Schlüsselwörter eingefügt werden:

{FORCEORDER|NOORDER}
Legt fest, ob bei der Ausgabe der Legende die Reihenfolge wie beim Einlesen erhalten bleibt (FORCEORDER), oder ob die Ausgabe alphanumerisch sortiert erfolgen soll. (nur für UNIQUE) 

{FORCECOUNTING|NOCOUNTING}
ForceCounting legt fest, dass nur für die Einheiten, welche auch mind. eine Geometrie enthalten, die Ausgabe in der Legende erfolgen soll. Zudem wird in der Legende die Anzahl der Elemente je Eintrag mit ausgegeben. Diese Option wirkt nur auf ShapeLayer.
NoCounting ist die Standardeinstellung. Dabei werden immer alle Einträge der Legendendatei in der von IWAN automatisch generierten Legende angezeigt.

Ab Version 3.3.1 steht zusätzlich:
SYMBOLRULE{minScale,maxScale,alternateSmbIndex} zur Verfügung.
Diese Angabe legt fest, das für einen bestimmten Maßstabsbereich nur ein einfaches Symbol zum Einsatz kommt.

Ab der Iwan Version 3.4.x ist die Verwendung von ILF Dateien im Zusammenhang mit mehr als einem Symbol möglich. Dabei werden verschiedene neue Optionen in der Kopfzeile definiert.

Die Schreibweise scheint auf den ersten Blick berechtigter Weise nicht sehr komfortabel, aber die damit gewährleistete Abwärtskompatibilität ist uns in der Entwicklung sehr wichtig.

Die Verwendung der gebotenen Möglichkeit umgeht ein bekanntes Darstellungsproblem von geschichteten Symbolen, dazu finden Sie [hier] weitere Details.

Neu sind dabei die Schlüsselwörter:

SYMBOLLAYERCOUNT:n

Dieser Parameter ist im Fall des Einsatzes von mehreren Symbolebenen nicht optional und gibt die Anzahl der Layer vor. Jeder folgende Klassifikationseintrag in dieser ILF Datei muss genau über die durch nfestgelegte Anzahl von Symbolen verfügen. Die Symbolnummern werden dabei durch ein | - Zeichen getrennt, siehe Beispiel.

... und ...

LAYERRULES{index,showInLegend,minScale,maxScale;...}

Dieser Parameter ist optional. Die Argumente stellen ein Viererpaar von kommagetrennten Werten pro Symbollayer dar, die zu beschreibenden Layer werden durch ein Semikolon getrennt.

• index - der Null basierte Index des Symbollayers für welche die folgenden Werte zutreffen
• showInLegend - ein Boolscher Wert (true/false) welcher angibt das dieser Symbollayer in der Legende mit aufgenommen werden soll. Die Legendensymbole für diesen Layer werden je Klassifikationseintrag in der angegebenen Reihenfolge übereinander dargestellt, wenn an dieser Stelle keine Ausnahme (durch Angabe von false) definiert wird
• minScale - die unterer Maßstabsgrenze ...
• maxScale - und die obere Maßstabsgrenze in der dieser Symbollayer dargestellt werden soll. Die Werte -1 definieren "unendlich" groß bzw. klein.

Die Angabe kann für jeden Layer optional erfolgen. Standardwerte sind: - immmer in Legende anzeigen,
- keine Maßstabsbegrenzung.

Als Beispiel folgende Anweisung (type ist entsprechend der untenstehenden Definition zu ersetzten):

type SYMBOLLAYERCOUNT:2 LAYERRULES{0,TRUE,-1,-1;1,TRUE,-1,100000}
OBJART
3201 120|121 Schienenbahn
3205 120|121 Bahnstrecke
...

Für den Platzhalter Type ist entsprechend den Ausführungen unten IWAN_LEGEND_UNIQUE oder IWAN_LEGEND_RANGE einzusetzten.

Dabei wird festgelegt, dass der später zugewiesene Layer zwei Zeichendurchgänge erfährt. Die Schienenbahn/Bahnstrecke wird im Maßstabsbereich von >100000 nur mit Symbol Nummer 120 dargestellt, darunter wird diese Ebene einmal vollständig mit Symbol Nr. 120 und danach mit Symbol Nr. 121 gezeichnet. Das Legendensymbol wird für jede Zeile als Überlagerung beider Symbole dargestellt.

 

Ab Version 4.0.3 ist das Schlüsselwort ALLOWQUERYOPTIMIZE verfügbar.

Wenn SYMBOLLAYERCOUNT definiert wurde, kann je nach Datenquelle eine Optimierung bei dem Zeichenvorgang erfolgen.

Umgesetzt z.Z. bei dem Ebenentyp Oracle SDO.

Bei Zeichenvorgängen wird das generierte SQL Statement um " ... BEZUGSSPALTE IN (Alle,In,Frage,Kommenden,Werte,Bei,DiesemMaßstab)" erweitert.

Sie sollten einen Index auf die Bezugsspalte vorsehen.

Ab Version 4.1.4.201

ENABLESTRINGESCAPE ermöglicht das Niederschreiben der Werte mit Escape-Zeichen um Sonderzeichen zu maskieren. Ausgewertet werden Maskierungen für TAB, LF, CR und dem Backslash.

WARNINGSASERROR behandelt Warnungen als Fehler. Konkret ist dies dann gegeben, wenn nicht alle Zeilen korrekte Werte enhalten. Bisher wurde nur eine Warnung im Tracefile ausgegeben.

Eindeutiger Wert

Ab der dritten Zeile folgen die Einträge in der Form:

FELDWERT{TAB}SYMBOLNUMMER{TAB}BESCHRIFTUNG{CRLF}

IWAN_LEGEND_UNIQUE
OBJART
3501	51	Bahnhofsanlage
3502	50	Raststätte
3514	52	Brücke/Überführung/Unterführung

Ab der Version 4.0.2.186 kann als Wert auch $NULL angegeben werden. In diesem Fall werden Datenbank NULL Werte entsprechend zugewiesen. Die Angabe eines leeren Wertes führt zur Konvertierung in den Zieldatentypen. (z.B. wird "" als Ganzahl 0 interpretiert)

Bereichsklassifizierung

Diese Art der Klassifizierung ist nur für Numerische Datentypen möglich.
Es muss eine Angabe des Datentyp erfolgen. IWAN unterscheiden zwischen Fließkommazahlen und Ganzzahlen.
Für Ganzzahlige Argumente ist das Schlüsselwort LONG, für Fließkommazahlen das Wort FLOAT zu verwenden.
Die Werte werden in folgender Form geprüft: VAL>=LOWER AND VAL<=HIGHER, wie zu erkennen ist, sollte die Liste entsprechend Sortiert vorliegen.
Die Angabe vierten Zeile folgen die Einträge in der Form:
LOWER{TAB}HIGHER{TAB}SYMBOL{TAB}BESCHRIFTUNG{CRLF}

IWAN_LEGEND_RANGE
GUETE
LONG
1	10	1	gering
10	100	2	mittel
100	900	3	hoch

Allgemeine Hinweise

In der letzten Zeile muss ebenfalls ein Zeilenumbruch erfolgen.

Kommentare werden durch ein vorangestelltes /* Zeichen pro Zeile eingeleitet. Es ist zu beachten, dass Kommentare nur im Datenteil ausgewertet werden.

Ab Version 3.2.5 kann der Pseudowert $ALLOTHER verwendet werden. Dabei werden alle anderen Werte mit diesem Symbol dargestellt.

Die Syntax dafür lautet:

$ALLOTHER{TAB}SYMBOL{TAB}BESCHRIFTUNG{CRLF}

Inline-Definition

Ab der Iwan Version 3.3.3.450 ist die Angabe von Inlinedefinitionen möglich. Dabei muss keine separate Datei mehr erstellt werden, die Angabe des Inhaltes kann direkt in der .iws Datei mit erfolgen. Dazu muss als erstes Wort "INLINE:" angegeben werden. Danach kommt, in der gleichen Zeile, der Inhalt der Datei. Diese Schreibweise ist an Stelle des Dateinamen zu verwenden.