MVW gisconfig.php

MVW gisconfig.php

This file contains PHP constants used by the MapViewer and other web GIS tools if enabled/implemented. The main constants relevant for the MapViewer are:

MapViewer's map properties

• GE_MAP_HEIGHT: Height of the map
• GE_MAP_WIDTH: Width of the map
• GE_MAP_MINX: Minimum horizontal coordinate (longitude) of the map’s initial extent
• GE_MAP_MINY: Minimum vertical coordinate (latitude) of the map’s initial extent
• GE_MAP_MAXX: Maximum horizontal coordinate (longitude) of the map’s initial extent
• GE_MAP_MAXY: Maximum vertical coordinate (latitude) of the map’s initial extent
• GE_MAP_BBOX_EPSG: Coordinate Reference Systems which initial extent coordinates are expressed in
• $aGE_MVW_PROJECTIONS: Array of supported Coordinate Reference Systems
• GE_MAP_EPSG_PROJ: Coordinate Reference Systems used by default / during initialization by the OpenLayers map object
• GE_MAP_EPSG_DISPLAYPROJ: Coordinate Reference Systems used during initialization for map visualization
• GE_MAP_INIT_CENTRE: Coordinates of the point where the map must be centred during initialization
• GE_MAP_INIT_ZOOMLEVEL: OpenLayers zoom level at which the map must be zoomed during initialization
• GE_MAP_SINGLETILE_ALL: true to draw layers with a single tile, false to draw with multiple tiles; this is a global setting and can be overridden by singleTile attribute at layer level in mapConfig.js

MapViewer's functionalities

• GE_REPROJECT_BBOX: If true, after a map re-projection the map.zoomToExtent method is called, otherwise map.zoomTo and map.setCenter are used
• IDENTIFY_GRID_PROBING_GE: List of queries to be executed during “Identify all indicators”
• IDENTIFY_GRID_PROBING_CELLINFO: true to display the ID of the queried cell in the results pop-up; false or not set to skip
• IDENTIFY_GRID_PROBING_TITLE: Title of “Identify all indicators” in select list
• KML_GENERATOR: Program used to generate KML exports of queried features
• GE_TOOLBAR_GOTO_ZSCALE: Scale denominator acting as a threshold for the “Go to” function: if the current map scale denominator is greater than this constant, the map is not only centered into the selected feature but also zoomed to scale 1: GE_TOOLBAR_GOTO_ZSCALE.
• GE_TOOLBAR_CHANGEPROJ: Enables (true) or disables (false) the Change Projection tool, displaying or skipping it into the toolbar
• GE_MVW_SCALE_APPROX_TO: Approximation to display scale denominators in the toolbar’s scale selector: for example, if GE_MVW_SCALE_APPROX_TO=100000 and the scale corresponding to the map zoom level 9 is 1:3364374, the scale 1:3400000 is visualized instead.
• GE_OVERVIEWMAP_MINRATIO: Value to be set for the minRatio attribute during the construction of the Overview Map (OpenLayers.Control.OverviewMap).

MapViewer's layout

• GE_PANEL_HEIGHT: Height of the whole GeoExt container (map panel + footer)
• GE_LAYERTREE_COLLAPSIBLE: Boolean to set if the layer tree panel can (true) or cannot (false) be collapsed
• GE_LAYERTREE_COLLAPSED: Boolean to set if the layer tree panel must be collapsed (true) or not (false) when initialized
• GE_LAYERTREE_WIDTH: Width in pixels of the layer tree panel
• GE_LOCK: This Boolean setting has two applications: 1) in layerTreeConfig.js can be used as the value of the hidden property in a definition of a GeoExt.tree.LayerContainer (group or subgroup): if hidden is present and GE_LOCK is defined, the value of GE_LOCK determines if the LayerContainer will be visible with a lock icon before its name (GE_LOCK=true) or hidden (GE_LOCK=false); 2) within the function lockLayers of ol_geMapViewer.js, if GE_LOCK is false, a layer can be displayed on the map only if it has the attribute locked false or not set; if GE_LOCK is true or not defined, all layers are displayed.

MapServer references

• MF_DIR_GE: Directory of project-specific mapfiles and related resources for the current GeoExt-based MapViewer
• GE_MF_WMS_BASE: Name and path of the mapfile thought to contain generic geographic layers (e.g. coastlines, countries, towns)
• GE_MF_WMS_IND: Name and path of the mapfile thought to contain drought-related indicators (e.g. SPI, fAPAR Anomaly)
• GE_SLIDER_SLIDINGCHANGE: This constant allows (value is true) or prevents (false) date update and map regeneration when moving a time slider or an opacity slider. See slidingChange option in mapConfig.js for details.
• MAPSERVER_CALL: CGI call of OSGeo MapServer (without server name)

Paths

• GISDATA_DIR: Path of project-specific geographical data under web root (/html/ in this installation of Mukau)
• PHP_GIS_DIR: Web path of /php/gis/ directory within the project directory (/html/mukau/ in this installation of Mukau)
• PHP_GIS_DIR_ABSOLUTE: Absolute path of /php/gis/ directory
• AJAX_PHP_GIS: Relative path of gis/ directory from php/ directory
• FACTSHEETS_DIR: Directory of indicators’ factsheets

Note: As said before, some of these PHP constants are made available to the MapViewer as JavaScript variables by means of gisconfigphp2js.php.