Neuerungen des UMN MapServers 5.0

==Mapfile==
Siehe auch: http://trac.osgeo.org/mapserver/browser/branches/branch-5-0/mapserver/MIGRATION_GUIDE.TXT
Mittlerweile ist es möglich, dass Labelbeschriftungen dynamisch aus einem Wertefeld generiert werden. Dieses funktioniert über „SIZE [meingroessenfeld]“ 
Eine Anbindung an eine PostGIS-Datenbank z.B. , welche in einer Tabelle die Spalte „groesse“ mit unterschiedlichen Integerwerten beinhaltet, produziert dann über folgende Mapfile-Angaben:
 LABEL
 TYPE TRUETYPE
 FONT 'arial'
 SIZE [groesse]
 COLOR 0 0 0
 END
z.B. folgende Karte:
Größenangaben aus Tabelle generiert
In 5.0 funktionieren die LAYER- Parameter LABELANGLEITEM und LABELSIZEITEM nicht mehr, genauso wenig 
wie die STYLE-Parameter ANGLEITEM und SIZEITEM.
Nicht nur für Labelgrössen können Werte aus einem Tabellenfeld gelesen werden. Dieses funktioniert 
nun auch im STYLE-Bereich für folgende Parameter:
 ANGLE, COLOR, OUTLINECOLOR, SIZE, SYMBOL
bzw. im Label-Bereich für 
 ANGLE, COLOR, OUTLINECOLOR, SIZE, FONT, PRIORITY
Farbangaben können mittlerweile nicht nur in RGB (z.B. 220 0 0) sondern auch hexadezimal 
angegeben werden (z.B. #ff00ff).
Einige Parameter scheinen früher oder später ausgetauscht zu werden.
So wird im empfohlen im Layerbereich nicht mehr den Parameter TRANSPARENCY sondern ab jetzt 
OPACITY zu verwenden.
Anstelle von MINSCALE,SYMBOLSCLALE etc. wird empfohlen MINSCALEDENOM bzw. SYMBOLSCALEDENOM zu nutzen (DENOM steht für „denominator“, zu Deutsch: „Nenner“; somit soll verdeutlicht werden, dass sich der Wert z.B. MINSCALEDENOM 24000 auf den Nenner-Wert des Maßstab 1:24000 bezieht).
Neu ist zudem der Parameter PRIORITY im LABEL-Bereich. Mit diesem kann festgelegt werden, welches Label (sogar bezogen auf Attribute) mit welcher Priorität gezeichnet werden soll.
Im MapServer sind mittlerweile die DEBUGGING-Möglichkeiten gestiegen. Waren früher nur die Parameter DEBUG ON/OFF möglich,
so geht jetzt DEBUG 0, DEBUG 1, DEBUG 2,........DEBUG 5.
Je höher die Zahl desto mehr Informationen.
Bei der Versionsabfrager über ./mapserv -v (z.B.) erscheint nun kein SUPPORTS=DEBUG mehr. Der Debug-Modus ist nun per se aktiviert.
Ein "enable-Debug" beim konfigurieren ist nur für Fehlermeldungen während des kompilierens notwendig.
===Diagramme (Layertypus Chart)===
Seit Version 5.0 kann man im MapServer den Layertypus CHART setzen, welcher für Diagramme zuständig ist.
Siehe dazu auch: http://mapserver.gis.umn.edu/docs/howto/dynamic-charting
Ein einfaches Beispiel:
 LAYER
 	NAME 'chart'
 	TYPE CHART
 	STATUS DEFAULT
 	PROCESSING "CHART_TYPE=pie"
 	PROCESSING "CHART_SIZE=30"
 CONNECTIONTYPE postgis 
 	CONNECTION 'blablabla'
 	DATA 'the_geom from landkreis'
 	CLASS
 	NAME "Bevölkerung 0-18"
 	STYLE
 	SIZE [bev_0_18] 
 	COLOR 220 0 0
 END
 	END
 	CLASS
 	NAME "Bevölkerung 19-30"
 	STYLE
 	SIZE [bev_19_30] 
 	COLOR 0 0 220
 	END
 	END
 END
Ergibt z.B. das (hier fiktive Werte): 
 
Durch das Setzen des Parameters 
 PROCESSING "CHART_TYPE=BAR"
erhält man dann auch Balkendiagramme
==Symbolfile==
Im Symbolfile wird empfohlen den STYLE-Parameter durch „Pattern“ zu ersetzen, also von nun an z.B. 
 # Streitige Grenze,OS 0235
 SYMBOL
 Name 'linie_6_1'
 TYPE VECTOR
 POINTS
 1 1
 2 1
 2 2
 1 2
 1 1
 END
 PATTERN
 17
 2
 END
 END
Der Grund ist, dass es in der Vergangenheit immer wieder zu Verwechselungen mit dem STYLE-Parameter im CLASS-Bereich des Mapfiles kam.
==Styling/Symbology==
In MapServer 5.0 ist es jetzt auch möglich, dass PIXMAP-Symbole entlang einer Linie gezeichnet werden und durch den GAP-Parameter ein Zwischenraum deklariert wrid (mit TrueTypeFonts ging das ja auch zuvor schon).
==URL==
In früheren MapServer-Versionen war es auf mehr oder minder umständlichem Wege bereits möglich im CGI-Modus Parameter des Mapfiles zu verändern.
In Version 5 ist dieses vereinfacht worden, es lassen sich nun ganze Bereiche austauschen.
Beispiel für Veränderung der Maßstabsleiste:
 ...&map.scalebar=UNITS+MILES+COLOR+121+121+121+SIZE+300+2&...
==PHP/Mapscript==
Auch hier gibt es einige Umbenennungen.
Der Parameter für die Layertransparenz heißt nun „Opacity“.
Parameter, welche „scale“ enthalten (symbolscale, maxscale, etc.), erhalten nun die Endung „denom“ , also z.B. symblscaledenom, maxscaledenom etc.
Der Parameter „style“ des SymbolObjects heisst jetzt pattern.
“Stylelength”, “setStyle()” und “getStyleArray()” warden in patternlength, setPattern() and getPatternArray() umbenannt.
layer.getShape(int tileindex, int shapeindex) ändert sich in layer.getFeature(int shapeindex [, int tileindex = -1]).
class.getExpression() and layer.getFilter() sollten durch class.getExpressionString() bzw. layer.getFilterString(= ersetzt warden.
==OGC WMS==
In der Vergangenheit brauchte man bei WMS-Aufrufen in Verbindung mit dem UMN nicht alle von der OGC vorgeschriebenen Parameter aufrufen. Siehe dazu auch:
http://www.selbstverwaltung-bundesweit.de/mapserver/anleitungen/wms_wfs_anleitung.pdf (S.9-10)
Um OGC-WMS-Konformität zu erzeugen werden nun die von der OGC terminierten Parameter auch verpflichtend vom UMN erwartet.
Ein Aufruf der Art von:
 http://localhost/cgi-bin/mapserv.exe?map=C:/ms4w/Apache/htdocs/umnkursII/
 wms_wfs/wms_ogc/wms_server.map&SERVICE=WMS&Request=GetMap&VERSION=1.1.1&
 layers=landkreis_wms,punktdaten_wms&BBOX=3430000,5899000,3490000,5953000&
 FORMAT=image/png&width=400&height=400&STYLES=,,
würde also eine Fehlermeldung produzieren, weil der SRS-Parameter fehlt.
==AGG-Rendering==
MapServer arbeitet jetzt mit der AGG-Rendering-Bibliothek.
Siehe dazu: http://mapserver.gis.umn.edu/docs/howto/agg-rendering-specifics
Die deutschsprachige Übersetzung dieses Dokumentes stammt von Kai Behncke.