comparison doku/source/functionality.txt @ 188:43f1cbdcd597

Modified and beautified the documentation: * INSTALL.txt, doku/Makefile, doku/source/conf.py, doku/source/functionality.txt, doku/source/index.txt, doku/source/restrictions.txt, website/favicon.png, LICENCE.txt: added more details to the content of the documentation. some more configurations. * doku/source/LICENCE.txt: New. Added a licence-text (symlinking into the documentation). * doku/source/_static/favicon.png, doku/source/_static/logo_wide.png, doku/source/_templates/indexsidebar.html, doku/source/_templates/layout.html: Optic-cosmetics.
author Stephan Holl <stephan.holl@intevation.de>
date Wed, 20 Jul 2011 15:53:01 +0200
parents fe6dbfc86144
children 1e3a5019c4ed
comparison
equal deleted inserted replaced
187:ea7858d75459 188:43f1cbdcd597
1 .. index:: features, functionality, configuration, runtime-parameter,
2 commandline
3
1 ------------- 4 -------------
2 Functionality 5 Functionality
3 ------------- 6 -------------
4 7
5 The MXD2map converter works as a commandline tool to transform maps from the 8 The MXD2map converter works as a commandline tool to transform maps from the
7 10
8 To transform an ArcGIS mxd file to a MapServer configuration file the mxd file 11 To transform an ArcGIS mxd file to a MapServer configuration file the mxd file
9 must have a valid and available data source and must not fit the 12 must have a valid and available data source and must not fit the
10 :ref:`restriction-label` described in the appropriate section. 13 :ref:`restriction-label` described in the appropriate section.
11 14
12 .. image:: ../funktionsweise/funktionsweise-MXD-konverter.svg 15 .. image:: ../funktionsweise/funktionsweise-MXD-konverter.png
13 16
14 .. _howtouse-label: 17 .. _howtouse-label:
15 18
16 How to use 19 How to use
17 ---------- 20 ----------
22 25
23 The converter can be configured in two ways: 26 The converter can be configured in two ways:
24 27
25 1. The converter.properties file (see converter.properties.sample) 28 1. The converter.properties file (see converter.properties.sample)
26 2. via commandline arguments 29 2. via commandline arguments
30
31 The converter.properties.sample file::
32
33
34 # Java properties file for the MXD Converter Tool.
35 mxd = \\full\\path\\to\\mxd-file
36 map = \\full\\path\\to\\map-file
37 map-template = \\full\\path\\to\\mapfile-template
38
39 Make sure you mask backslahes with an additional backslash.
27 40
28 Both take a parameter for the path to the mxd file, the outputfile and a mapfile 41 Both take a parameter for the path to the mxd file, the outputfile and a mapfile
29 template for initial mapfile config. Commandline parameters have a higher 42 template for initial mapfile config. Commandline parameters have a higher
30 priority than the properties file. 43 priority than the properties file.
31 44
38 -t or --template The template to use for an initial mapfile 51 -t or --template The template to use for an initial mapfile
39 configuration. 52 configuration.
40 53
41 To have the full functionality for ArcGIS map conversion it is necessary to have 54 To have the full functionality for ArcGIS map conversion it is necessary to have
42 the ESRI fonts available. ArcGIS products install these fonts to the default 55 the ESRI fonts available. ArcGIS products install these fonts to the default
43 windows font folder "c:\\windows\\fonts". To make them available for the converter 56 windows font folder ``c:\\windows\\fonts``. To make them available for the converter
44 there has to be a MapServer font set (see 57 there has to be a MapServer font set (see
45 http://mapserver.org/mapfile/fontset.html). The MXD2map converter comes with an 58 http://mapserver.org/mapfile/fontset.html). The MXD2map converter comes with an
46 initial fontset containing all relevant ESRI fonts and the free font FreeSans. 59 initial fontset containing all relevant ESRI fonts and the free font FreeSans.
47 The font set file named fonts.txt can be edited and further fonts can be added. 60 The font set file named fonts.txt can be edited and further fonts can be added.
48 To use a font set, the file needs to be referenced in the MapServer template 61 To use a font set, the file needs to be referenced in the MapServer template
49 otherwise the converter can not create character symbols and will show up errors 62 otherwise the converter can not create character symbols and will show up errors
50 in the conversion process. 63 in the conversion process.
51 64
52 The converter uses a separate symbol file to provide symbol sets to the 65 The converter uses a separate symbol file to provide symbol sets to the
53 MapServer configuration. A pre-build symbol file can be referenced in the 66
54 template to have initial symbols available. If no symbol file is referenced a 67 template to have initial symbols available. If no symbol file is referenced a
55 new one is created by the converter if necessary. The resulting symbol set is 68 new one is created by the converter if necessary. The resulting symbol set is
56 written to the same directory as the output mapfile named 69 written to the same directory as the output mapfile named
57 [mapfile-name]-symbols.sym. 70 [mapfile-name]-symbols.sym.
58 71
59 72
60 Features 73 Features
61 -------- 74 --------
62 75
63 Currently supported features: 76 MXD2map currently supportes the following features:
64 77
65 * The MXD2map converter can use ArcSDE database connections and local 78 * Datasources
66 shapefile datasources to create a mapfile. 79 * ArcSDE database connections (requires MapServer built against ArcSDE, Client-dlls needed)
80 * ESRI-Shapefiles
67 81
68 * Convertable symbols: 82 * Symbols:
69 83
70 * Simple marker symbols 84 * Simple marker symbols
71 * Character marker symbols 85 * Character marker symbols
72 * Arrow marker symbols 86 * Arrow marker symbols
87 * Symbols based on TTF-characters of special cartographic fonts
73 * Any combination of character marker symbols 88 * Any combination of character marker symbols
74 * Linesymbols with pattern and cartographic attributes 89 * Linesymbols with pattern and cartographic attributes
75 * Polygons filled with solid color and outline 90 * Polygons filled with solid color and outline
76 * Polygons filled with a hatch and outline 91 * Polygons filled with a hatch and hatched outline
77 92
78 * Convertable layer: 93 * Layer types:
79 94
80 * Feature layer 95 * Featurelayer (vectors) as POINT, LINESTRING and POLYGON
81 * Layer containing unique values 96 * Classifications with unique values
82 * Layer containing class breaks 97 * Classifications with class breaks
83 * Grouplayer with one grouplevel 98 * Grouplayers with one grouplevel (as MapServer does not support more than one nested level)
84 99
85 * Further map attributes: 100 * Further map attributes:
86 101
87 * Projection and units 102 * Projections and units based on the EPSG-table
88 * Min/max scale denominations 103 * Min/max scale denominations at layer and label-level
89 * Map extents 104 * Map extents
90 * Simple labeling 105 * Simple labeling
91 * Filter and expressions 106 * Filter and expressions
107 * ArcSDE Jointables
108 *
92 109
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)