Mercurial > mxd2map
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 |