Mercurial > mxd2map
annotate doku/source/functionality.txt @ 220:671737e8edc2
Make date visible in documentation
author | Stephan Holl <stephan.holl@intevation.de> |
---|---|
date | Wed, 27 Jul 2011 09:16:28 +0200 |
parents | 1d7fc059e538 |
children | df533a03ad9f |
rev | line source |
---|---|
202
1e3a5019c4ed
* INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
Stephan Holl <stephan.holl@intevation.de>
parents:
188
diff
changeset
|
1 .. index:: features, functionality, configuration, runtime-parameter, commandline |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
2 |
182
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 Functionality |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
5 ------------- |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
6 |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
7 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
|
8 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
|
9 |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
10 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
|
11 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
|
12 :ref:`restriction-label` described in the appropriate section. |
fe6dbfc86144
Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents:
182
diff
changeset
|
13 |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
14 .. image:: ../funktionsweise/funktionsweise-MXD-konverter.png |
202
1e3a5019c4ed
* INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
Stephan Holl <stephan.holl@intevation.de>
parents:
188
diff
changeset
|
15 :align: center |
1e3a5019c4ed
* INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
Stephan Holl <stephan.holl@intevation.de>
parents:
188
diff
changeset
|
16 :alt: MXD2map-Schema |
1e3a5019c4ed
* INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
Stephan Holl <stephan.holl@intevation.de>
parents:
188
diff
changeset
|
17 :width: 500px |
183
fe6dbfc86144
Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents:
182
diff
changeset
|
18 |
fe6dbfc86144
Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents:
182
diff
changeset
|
19 .. _howtouse-label: |
182
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 How to use |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
22 ---------- |
183
fe6dbfc86144
Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents:
182
diff
changeset
|
23 |
182
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
24 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
|
25 |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
26 $java -jar mxd2map.jar |
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 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
|
29 |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
30 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
|
31 2. via commandline arguments |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
32 |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
33 The converter.properties.sample file:: |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
34 |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
35 |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
36 # Java properties file for the MXD Converter Tool. |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
37 mxd = \\full\\path\\to\\mxd-file |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
38 map = \\full\\path\\to\\map-file |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
39 map-template = \\full\\path\\to\\mapfile-template |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
40 |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
41 Make sure you mask backslahes with an additional backslash. |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
42 |
182
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
43 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
|
44 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
|
45 priority than the properties file. |
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 available parameters on the commandline are:: |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
48 |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
49 -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
|
50 |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
51 -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
|
52 |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
53 -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
|
54 configuration. |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
55 |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
56 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
|
57 the ESRI fonts available. ArcGIS products install these fonts to the default |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
58 windows font folder ``c:\\windows\\fonts``. To make them available for the converter |
182
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
59 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
|
60 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
|
61 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
|
62 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
|
63 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
|
64 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
|
65 in the conversion process. |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
66 |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
67 The converter uses a separate symbol file to provide symbol sets to the |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
68 |
182
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
69 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
|
70 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
|
71 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
|
72 [mapfile-name]-symbols.sym. |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
73 |
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 Features |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
76 -------- |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
77 |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
78 MXD2map currently supportes the following features: |
182
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
79 |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
80 * Datasources |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
81 * ArcSDE database connections (requires MapServer built against ArcSDE, Client-dlls needed) |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
82 * ESRI-Shapefiles |
182
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
83 |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
84 * Symbols: |
182
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
85 |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
86 * Simple marker symbols |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
87 * Character marker symbols |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
88 * Arrow marker symbols |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
89 * Symbols based on TTF-characters of special cartographic fonts |
182
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
90 * Any combination of character marker symbols |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
91 * Linesymbols with pattern and cartographic attributes |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
92 * Polygons filled with solid color and outline |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
93 * Polygons filled with a hatch and hatched outline |
182
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
94 |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
95 * Layer types: |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
96 |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
97 * Featurelayer (vectors) as POINT, LINESTRING and POLYGON |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
98 * Classifications with unique values |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
99 * Classifications with class breaks |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
100 * Grouplayers with one grouplevel (as MapServer does not support more than one nested level) |
182
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
101 |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
102 * Further map attributes: |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
103 |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
104 * Projections and units based on the EPSG-table |
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
105 * Min/max scale denominations at layer and label-level |
182
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
106 * Map extents |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
107 * Simple labeling |
91e2d46d7968
Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents:
diff
changeset
|
108 * Filter and expressions |
188
43f1cbdcd597
Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents:
183
diff
changeset
|
109 * ArcSDE Jointables |
202
1e3a5019c4ed
* INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
Stephan Holl <stephan.holl@intevation.de>
parents:
188
diff
changeset
|
110 * Mapfile-Templating for OGC-related stuff |
209
1d7fc059e538
* doku/source/functionality.txt: Added part about the translation
Stephan Holl <stephan.holl@intevation.de>
parents:
202
diff
changeset
|
111 |
1d7fc059e538
* doku/source/functionality.txt: Added part about the translation
Stephan Holl <stephan.holl@intevation.de>
parents:
202
diff
changeset
|
112 * Other features |
1d7fc059e538
* doku/source/functionality.txt: Added part about the translation
Stephan Holl <stephan.holl@intevation.de>
parents:
202
diff
changeset
|
113 |
1d7fc059e538
* doku/source/functionality.txt: Added part about the translation
Stephan Holl <stephan.holl@intevation.de>
parents:
202
diff
changeset
|
114 * Umlauts are translated into its equivalents within LAYERnames, |
1d7fc059e538
* doku/source/functionality.txt: Added part about the translation
Stephan Holl <stephan.holl@intevation.de>
parents:
202
diff
changeset
|
115 CLASSnames and also mapfile-names. Though it is good standard not to |
1d7fc059e538
* doku/source/functionality.txt: Added part about the translation
Stephan Holl <stephan.holl@intevation.de>
parents:
202
diff
changeset
|
116 use them since they mostly cause problems when using them within |
1d7fc059e538
* doku/source/functionality.txt: Added part about the translation
Stephan Holl <stephan.holl@intevation.de>
parents:
202
diff
changeset
|
117 OWS-related services. |