Hier erfolgt eine genaue Bescheibung des Styles "iconStyle" und alle dessen Besonderheiten.
Aufbau eines IconStyles
Das Attributblock "iconStyle" ist Optional. Hier kann alles Symbolspezifische über die im Beispiel angegebenen Attribute gesteuert werden.
<iconStyle> <icon> <layerValue>layerValue</layerValue> </icon> <anchorUnits>pixel</anchorUnits> <anchorX>0.0</anchorX> <anchorY>0.0</anchorY> <color> <layerValue> <rgbColor> <red>0</red> <green>0</green> <blue>0</blue> </rgbColor> </layerValue> </color> <iconType>xml</iconType> <rotation> <layerValue>0.0</layerValue> </rotation> <rotateWithView>true</rotateWithView> <scale> <layerValue>0.0</layerValue> </scale> </iconStyle>
Überblick
| Attribut | Beschreibung | Datentyp | Optional |
|---|---|---|---|
| icon | Angabe des Symbolnamens. | Text | nein |
| anchorUnits | Angabe Einheiten für die Verschiebung des Einfügepunktes. | AnchorUnits (pixel | fractions) | ja |
| anchorX | Verschiebung des Einfügepunktes für das Symbol in X-Richtung. | Double | ja |
| anchorY | Verschiebung des Einfügepunktes für das Symbol in Y-Richtung. | Double | ja |
| color | Angabe der Symbolfarbe | ColorIndexType | ja |
| iconType | Angabe des Symboltyps. Details siehe unten. | IconType (xml | png | svg | svg unscaled) | ja (Standard png) |
| rotation | Angabe, ob das Symbol gedreht werden soll. Angabe in Altgrad. | Double | ja (Standard 0.0) |
| rotateWithView | Angabe, ob Symbol bei Kartendrehung mitgedreht wird. | Boolean (true | false) | ja (Standard true) |
| scale | Skalierung des Symbols. | Double | ja (Standard 1.0) |
Hinweise zum iconType
GISX3 unterscheidet zwischen mitskalierenden Symbolen und nicht mit skalierenden Icons. Die folgende Tabelle fasst die Unterscheide zusammen:
| Mitskalierende Symbole | Nicht mitskalierende Icons | |
|---|---|---|
| Empfohlener Einsatz | Maßstäbliche Darstellung von Schächten, Bauwerken, Bäumen usw. | Allgemeine Darstellung von Points of Interests (POI), z.B. Schulen, Baustellen, Bushaltestellen, Verkehrszeichen oder zur Anzeige der Position von Bäumen (nicht maßstäblich) |
| Verfügbare Symboltypen | "xml", "svg" | "png", "svg unscaled" |
| Ablageordner (siehe Verzeichnisstruktur) | <gisx3>\symbols | <gisx3>\images\icons |
Hinweise zur Symbol- oder Iconskalierung mittels scale
Die Berechnung der tatsächlichen Größe in einer Karte oder eines PDF ist je nach gewähltem iconType unterschiedlich:
| iconType | scale ist ... | Berechnung der Symbolgröße |
|---|---|---|
| xml | relativ | XML-Symbole besitzen Angaben in m. Diese werden über das scale-Attribute skaliert. |
| svg unscaled | relativ | SVG-Symbole können eine bevorzugte Ausgabegröße definieren. (Dies geschieht über die Attribute width und height im <svg>-Tag). Diese Größe kann in mm, cm, Zoll (in), Pixeln (px), Punkt (pt) oder % erfolgen. Für die Umrechnung mm, cm und Zoll wird eine Auflösung von 72 dpi, also Pixel pro Inch, verwendet. |
| svg | relativ | Das für "svg unscaled" Gesagte gilt auch hier. Allerdings wird die Symbolgröße hier auf einen Kartenmaßstab von 1:1 bezogen, d.h. bei Maßstab 1:1000 wird das Symbol mit 1/1000 seiner bevorzugten Ausgabegröße ausgegeben. Beispiel: Ein Symbol besitzt eine Ausgabegröße von 1m. Im Maßstab 1:100 wird es bei Skalierung 1 folglich 1 cm breit dargestellt, bei Skalierung 42 42 cm breit usw. |
| png | relativ | PNG-Icons besitzen eine feste Größe in Pixeln. Durch die Angabe von "scale" werden sie um den angegebenen Faktor skaliert. |