LegendGraphic

From MapbenderWiki

no maintainer

Contents 1 Description 1.1 english 1.1.1 How To 1.1.2 Example 1.1.3 Notice 1.2 deutsch 1.2.1 Anwendung 1.2.1.1 MapServer Anwendungsbeispiel 1.2.2 Beispiel: 1.2.3 Hinweis: 2 Files 3 SQL

Description

english

Calls a getLegendGraphic URL and displays the image in a reserved window or frame.

Make sure, that your WMS Version and your MapServer supports the request getLegendGraphic (have a look at your getCapabilities-Request)

• OGS WMS has the optional getLegendGraphic-request since Version 1.1.0
• UMN MapServer Supports the request getLegendGraphic from Version 4.0 on (?). Put a LEGEND-Block in your mapfile and give a NAME in the CLASS-block to every item you want to be displayed in the legend.

Example for UMN legend-tag:

LEGEND
 STATUS ON
 KEYSIZE 16 10
 TRANSPARENT ON
 LABEL
  TYPE TRUETYPE
  FONT 'arial'
  SIZE 8
  COLOR 1 1 1
 END
END

How To

You have to integrate in your GUI an iframe called legend.

• Target: mapframe1
• SRC: ../mapbender2/http/javascripts/mod_legend.php?sessionID

When you display the legend Mapbender will make a request for every layer in the wms.
Please modify the embedded legend.css if you want another layout of your legend.

Example

here is an Example for a getLegendGraphic-request:

http://wms1.ccgis.de/cgi-bin/mapserv?map=/data/umn/mapbender_user/mapbender_user.map&VERSION=1.1.1&REQUEST=GetLegendGraphic&LAYER=Mapbender_User&Format=image/png

Notice

Notice, that at the moment the mod_legend.php can't handle grouped layers and raster layer.

---

deutsch

Für jeden Layer wird ein getLegendGraphic-Request abgeschickt. Die zurückgelieferten Bilder werden in einem dafür angelegten Fenster oder IFrame angezeigt.

Unbedingt darauf achten, dass der WMS den Request getLegendGraphic unterstützt (Anzeige im getCapabilities-Aufruf).

Anwendung

• OGC WMS verfügt seit der Version 1.1.0 über die optionale Operation getLegendGraphic.
• Das Modul wird über das Anlegen eines IFrames namens legend eingebunden.
  Die Ausgestaltung der Legende bestimmen Legendengraphik und das Stylesheet legend.css aus dem Mapbender /css-Ordner.
• Target: mapframe1
• SRC: ../mapbender2/http/javascripts/mod_legend.php?sessionID

MapServer Anwendungsbeispiel

Der UMN MapServer bietet im WMS-Modus die Möglichkeit, ein Legenden-Objekt zu erzeugen. Hierzu muß in der Mapdatei nach dem Header-Bereich der Legend-Block angegeben werden. Außerdem muß jede CLASS, die in der Legende erscheinen soll, über die Angabe des Parameters NAME verfügen. Beispiel für UMN Legend-tag:

LEGEND
 STATUS ON
 KEYSIZE 16 10
 TRANSPARENT ON
 LABEL
  TYPE TRUETYPE
  FONT 'arial'
  SIZE 8
  COLOR 1 1 1
 END
END

Beispiel:

Hier ein Beispiel für einen getLegend Graphic-Request: http://wms1.ccgis.de/cgi-bin/mapserv?map=/data/umn/mapbender_user/mapbender_user.map&VERSION=1.1.1&REQUEST=GetLegendGraphic&LAYER=Mapbender_User&Format=image/png

Hinweis:

Bitte beachten, dass das Modul mod_legend.php derzeit nur ungruppierte Layer ansprechen kann, da im Request der Layername angegeben werden muß (nicht der GROUP-Name). Raster-Layer geben beim getLegendGraphic-Request ebenfalls kein Image zurück.

Files

For this module the following files are required / Für dieses Modul werden die folgenden Dateien benötigt:

• http://trac.osgeo.org/mapbender/browser/trunk/mapbender/http/javascripts/mod_legend.php?format=raw

SQL

Use this sql statement to insert this module in the corresponding gui / Mit diesem SQL kann das Modul in die entsprechende GUI eingefügen werden:

INSERT INTO gui_element(fkey_gui_id, e_id, e_pos, e_public, e_comment, e_element, e_src, e_attributes, e_left, e_top, e_width, e_height, e_z_index, e_more_styles, e_content, e_closeTag, e_js_file, e_mb_mod, e_target, e_requires) VALUES('gui_de', 'legend', '0002', '1', 'legend', 'iframe', '../javascripts/mod_legend_tab.php?sessionID&wms_legend = yes', 'frameborder=\\\'0\\\'', '280', '180', '200', '400', '3', 'visibility:hidden;', '', 'iframe', '', '', 'mapframe1', '');