stephan@202: .. index:: features, functionality, configuration, runtime-parameter, commandline stephan@188: rrenkert@182: ------------- rrenkert@182: Functionality rrenkert@182: ------------- rrenkert@182: rrenkert@182: The MXD2map converter works as a commandline tool to transform maps from the rrenkert@182: proprietary ArcGIS file format "MXD" to a MapServer configuration file. rrenkert@182: rrenkert@182: To transform an ArcGIS mxd file to a MapServer configuration file the mxd file rrenkert@183: must have a valid and available data source and must not fit the rrenkert@183: :ref:`restriction-label` described in the appropriate section. rrenkert@183: stephan@188: .. image:: ../funktionsweise/funktionsweise-MXD-konverter.png stephan@202: :align: center stephan@202: :alt: MXD2map-Schema stephan@202: :width: 500px rrenkert@183: rrenkert@183: .. _howtouse-label: rrenkert@182: rrenkert@182: How to use rrenkert@182: ---------- rrenkert@183: rrenkert@182: The converter is started via the commandline running the command:: rrenkert@182: rrenkert@182: $java -jar mxd2map.jar rrenkert@182: rrenkert@182: The converter can be configured in two ways: rrenkert@182: rrenkert@182: 1. The converter.properties file (see converter.properties.sample) rrenkert@182: 2. via commandline arguments rrenkert@182: stephan@188: The converter.properties.sample file:: stephan@188: stephan@188: stephan@188: # Java properties file for the MXD Converter Tool. stephan@188: mxd = \\full\\path\\to\\mxd-file stephan@188: map = \\full\\path\\to\\map-file stephan@188: map-template = \\full\\path\\to\\mapfile-template stephan@188: stephan@188: Make sure you mask backslahes with an additional backslash. stephan@188: rrenkert@182: Both take a parameter for the path to the mxd file, the outputfile and a mapfile rrenkert@182: template for initial mapfile config. Commandline parameters have a higher rrenkert@182: priority than the properties file. rrenkert@182: rrenkert@182: The available parameters on the commandline are:: rrenkert@182: rrenkert@182: -m or --mxd The mxd file to convert. rrenkert@182: rrenkert@182: -a or --map The path to the output file. Should end with ".map". rrenkert@182: rrenkert@182: -t or --template The template to use for an initial mapfile rrenkert@182: configuration. rrenkert@182: rrenkert@182: To have the full functionality for ArcGIS map conversion it is necessary to have rrenkert@182: the ESRI fonts available. ArcGIS products install these fonts to the default stephan@188: windows font folder ``c:\\windows\\fonts``. To make them available for the converter rrenkert@182: there has to be a MapServer font set (see rrenkert@182: http://mapserver.org/mapfile/fontset.html). The MXD2map converter comes with an rrenkert@182: initial fontset containing all relevant ESRI fonts and the free font FreeSans. rrenkert@182: The font set file named fonts.txt can be edited and further fonts can be added. rrenkert@182: To use a font set, the file needs to be referenced in the MapServer template rrenkert@182: otherwise the converter can not create character symbols and will show up errors rrenkert@182: in the conversion process. rrenkert@182: rrenkert@182: The converter uses a separate symbol file to provide symbol sets to the stephan@188: rrenkert@182: template to have initial symbols available. If no symbol file is referenced a rrenkert@182: new one is created by the converter if necessary. The resulting symbol set is rrenkert@182: written to the same directory as the output mapfile named rrenkert@182: [mapfile-name]-symbols.sym. rrenkert@182: rrenkert@182: rrenkert@182: Features rrenkert@182: -------- rrenkert@182: stephan@188: MXD2map currently supportes the following features: rrenkert@182: stephan@188: * Datasources stephan@188: * ArcSDE database connections (requires MapServer built against ArcSDE, Client-dlls needed) stephan@188: * ESRI-Shapefiles rrenkert@182: stephan@188: * Symbols: rrenkert@182: rrenkert@182: * Simple marker symbols rrenkert@182: * Character marker symbols rrenkert@182: * Arrow marker symbols stephan@188: * Symbols based on TTF-characters of special cartographic fonts rrenkert@182: * Any combination of character marker symbols rrenkert@182: * Linesymbols with pattern and cartographic attributes rrenkert@182: * Polygons filled with solid color and outline stephan@188: * Polygons filled with a hatch and hatched outline rrenkert@182: stephan@188: * Layer types: stephan@188: stephan@188: * Featurelayer (vectors) as POINT, LINESTRING and POLYGON stephan@188: * Classifications with unique values stephan@188: * Classifications with class breaks stephan@188: * Grouplayers with one grouplevel (as MapServer does not support more than one nested level) rrenkert@182: rrenkert@182: * Further map attributes: rrenkert@182: stephan@188: * Projections and units based on the EPSG-table stephan@188: * Min/max scale denominations at layer and label-level rrenkert@182: * Map extents rrenkert@182: * Simple labeling rrenkert@182: * Filter and expressions stephan@188: * ArcSDE Jointables stephan@202: * Mapfile-Templating for OGC-related stuff stephan@209: stephan@209: * Other features stephan@209: stephan@209: * Umlauts are translated into its equivalents within LAYERnames, stephan@209: CLASSnames and also mapfile-names. Though it is good standard not to stephan@209: use them since they mostly cause problems when using them within stephan@209: OWS-related services.