Mercurial > mxd2map

annotate doku/source/functionality.txt @ 182:91e2d46d7968

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added functionality, restrictions and how to build runtime enviroment to documentation.
author Raimund Renkert <rrenkert@intevation.de>
date Mon, 18 Jul 2011 15:12:24 +0200
parents
children fe6dbfc86144
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
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
9 must have a valid and available data source and must not fit the restrictions
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
10 described in the appropriate section.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
11
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
12 How to use
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
13 ----------
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
14 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
15
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
16 $java -jar mxd2map.jar
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
17
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
18 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
19
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
20 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
21 2. via commandline arguments
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 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
24 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
25 priority than the properties file.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
26
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
27 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
28
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
29 -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
30
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
31 -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
32
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
33 -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
34 configuration.
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 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
37 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
38 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
39 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
40 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
41 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
42 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
43 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
44 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
45 in the conversion process.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
46
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
47 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
48 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
49 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
50 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
51 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
52 [mapfile-name]-symbols.sym.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
53
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
54
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
55 Features
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
56 --------
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
57
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
58 Currently supported features:
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 * 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
61 shapefile datasources to create a mapfile.
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 * Convertable symbols:
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 * Simple marker symbols
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
66 * Character marker symbols
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
67 * Arrow marker symbols
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
68 * Any combination of character marker symbols
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
69 * Linesymbols with pattern and cartographic attributes
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
70 * 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
71 * 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
72
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
73 * Convertable layer:
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
74
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
75 * Feature layer
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
76 * Layer containing unique values
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
77 * Layer containing class breaks
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
78 * Grouplayer with one grouplevel
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 * Further map attributes:
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
81
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
82 * Projection and units
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
83 * Min/max scale denominations
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
84 * Map extents
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
85 * Simple labeling
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
86 * Filter and expressions
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff changeset
87
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)