ShapeObj

Managerklasse für das Arbeiten mit Geometrien.

Properties
Methods
Properties
string defaultObjectColor

Standardfarbe zur Darstellung von abgeschlossenen Geometrien, die selbst keine Farbe gesetzt haben.
(Eine Änderung dieses Wertes wirkt auch auf alle bereits bestehenden Objekte.)

string unfinishedObjectColor

Standardfarbe zur Darstellung von Geometrien, die gerade erstellt werden, d.h. noch nicht abgeschlossen sind.

Methods
addGeomStrings(geometries, noMultiPartWarning, color)

Fügt dem Objekt weitere Geometrien hinzu.
Neben den auf http://webmapserver.de/theGeometry dokumentierten Formaten gibt es noch:

gAnno:x|y|Text|Textgröße in Karteneinheiten°Farbe°Hintergrundfarbe°Bold°Italic°Ausrichtung°Schriftart
gSymobol:x|y|Zeichen|Symbolgröße in Karteneinheiten°Farbe°Hintergrundfarbe°Bold°Italic°Ausrichtung°Schriftart

Als Zeichen bei Symbol sollte eine Unicode Entity-Referenz in Verbindung mit einer Unicode Schriftart (z.B. Arial) benutzt werden.

glbMap.shape.addGeomStrings(["gSYMBOL:5418310.04081|5655735.82258|☺|1500°red°transparent°0°0°cc°Arial"]);
parameters
string|string[] geometries

String oder Array von Strings mit Geometrien in der IWAN Textrepräsentation (nur geografische Koordinaten!)

bool [noMultiPartWarning]

unterdrücken des Warnhinweises beim Hinzufügen von Multipart-Geometrien

(Standardwert: true)
string [color]

HTML Farbangabe, falls die Geometrien nicht in der Standardfarbe dargestellt werden sollen.

clearAll()

Löscht alle im Objekt enthaltenen Geometrien.

getGeomStrings(typeFilter, separator, closePoly, onlySingleParts)

Gibt die im Objekt enthaltenen Geometrien in Form der IWAN-Textrepräsentation zurück.

parameters
string [typeFilter]

"GEOM" um nur "richtige" Geometrien zu erhalten, "ANNO" um Annotation und Symbol zu erhlaten oder weglassen bzw. null übergeben, um alles zu bekommen.

string [separator]

Separator für die Koordinaten

(Standardwert: "|")
bool [closePoly]

Bei Polygonen noch einen schließenden Stützpunkt einfügen, der sich mit dem ersten deckt.

(Standardwert: false)
onlySingleParts
returns
string[] Array mit Geometrien in der IWAN-Textrepräsentation
inExtent(e, offset)

Bestimmt, ob die im Objekt enthaltenen Geometrien im aktuellen Kartenausschnitt liegen. (Dieser ist durch die interne Kopplung mit dem Map-Control bekannt.)

parameters
object [e]

Referenz auf eine Struktur, welche nach Durchlauf der Funktion die Ausdehnung aller Geometrien enthalten wird. Die Struktur muss folgende Member haben, die mit null vorbelegt sind:

double x0
double y0
double x1
double y1
double [offset]

Abstand in Karteneinheiten, der in allen Richtungen noch auf e zugegeben werden soll.

(Standardwert: 0)
returns
int -1 - keine Aussage möglich (keine Geometrie oder kein Karten-Extent verfügbar)
 0 - Geometrien vollständig außerhalb des Ausschnitts
 1 - Geometrien teilweise innerhalb des Ausschnitts
 2 - Geometrien vollständig innerhalb des Ausschnitts
paint()

Veranlasst das Neuzeichnen der Geometrien. Die Verwendung dieser Methode ist nur in Ausnahmefällen nötig, da sie i.d.R. implizit durch andere Funktionen aufgerufen wird.