annotate doku/source/functionality.txt @ 183:fe6dbfc86144

Updated documentation.
author Raimund Renkert <rrenkert@intevation.de>
date Mon, 18 Jul 2011 17:17:04 +0200
parents 91e2d46d7968
children 43f1cbdcd597
rev   line source
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
1 -------------
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
2 Functionality
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
3 -------------
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
4
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
5 The MXD2map converter works as a commandline tool to transform maps from the
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
6 proprietary ArcGIS file format "MXD" to a MapServer configuration file.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
7
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
8 To transform an ArcGIS mxd file to a MapServer configuration file the mxd file
183
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
9 must have a valid and available data source and must not fit the
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
10 :ref:`restriction-label` described in the appropriate section.
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
11
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
12 .. image:: ../funktionsweise/funktionsweise-MXD-konverter.svg
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
13
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
14 .. _howtouse-label:
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
15
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
16 How to use
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
17 ----------
183
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
18
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
19 The converter is started via the commandline running the command::
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
20
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
21 $java -jar mxd2map.jar
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
22
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
23 The converter can be configured in two ways:
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
24
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
25 1. The converter.properties file (see converter.properties.sample)
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
26 2. via commandline arguments
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
27
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
28 Both take a parameter for the path to the mxd file, the outputfile and a mapfile
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
29 template for initial mapfile config. Commandline parameters have a higher
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
30 priority than the properties file.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
31
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
32 The available parameters on the commandline are::
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
33
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
34 -m or --mxd The mxd file to convert.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
35
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
36 -a or --map The path to the output file. Should end with ".map".
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
37
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
38 -t or --template The template to use for an initial mapfile
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
39 configuration.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
40
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
41 To have the full functionality for ArcGIS map conversion it is necessary to have
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
42 the ESRI fonts available. ArcGIS products install these fonts to the default
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
43 windows font folder "c:\\windows\\fonts". To make them available for the converter
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
44 there has to be a MapServer font set (see
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
45 http://mapserver.org/mapfile/fontset.html). The MXD2map converter comes with an
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
46 initial fontset containing all relevant ESRI fonts and the free font FreeSans.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
47 The font set file named fonts.txt can be edited and further fonts can be added.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
48 To use a font set, the file needs to be referenced in the MapServer template
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
49 otherwise the converter can not create character symbols and will show up errors
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
50 in the conversion process.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
51
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
52 The converter uses a separate symbol file to provide symbol sets to the
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
53 MapServer configuration. A pre-build symbol file can be referenced in the
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
54 template to have initial symbols available. If no symbol file is referenced a
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
55 new one is created by the converter if necessary. The resulting symbol set is
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
56 written to the same directory as the output mapfile named
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
57 [mapfile-name]-symbols.sym.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
58
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
59
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
60 Features
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
61 --------
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
62
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
63 Currently supported features:
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
64
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
65 * The MXD2map converter can use ArcSDE database connections and local
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
66 shapefile datasources to create a mapfile.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
67
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
68 * Convertable symbols:
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
69
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
70 * Simple marker symbols
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
71 * Character marker symbols
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
72 * Arrow marker symbols
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
73 * Any combination of character marker symbols
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
74 * Linesymbols with pattern and cartographic attributes
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
75 * Polygons filled with solid color and outline
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
76 * Polygons filled with a hatch and outline
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
77
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
78 * Convertable layer:
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
79
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
80 * Feature layer
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
81 * Layer containing unique values
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
82 * Layer containing class breaks
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
83 * Grouplayer with one grouplevel
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
84
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
85 * Further map attributes:
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
86
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
87 * Projection and units
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
88 * Min/max scale denominations
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
89 * Map extents
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
90 * Simple labeling
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
91 * Filter and expressions
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
92
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)