Mercurial > mxd2map

annotate doku/source/restrictions.txt @ 306:ea3fde77ea48

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Catch generic Exceptions to avoid leaking them and creating silent errors
author Andre Heinecke <aheinecke@intevation.de>
date Thu, 06 Sep 2012 18:56:20 +0200
parents 4dc2b9aa3c57
children
rev   line source
256
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
1 ..
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
2 .. Copyright (c) 2011 by Intevation GmbH, Germany <info@intevation.de>
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
3 ..
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
4 .. This file is part of MXD2map.
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
5 ..
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
6 .. This program is free software under the LGPL (>=v2.1)
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
7 .. Read the file LICENCE.txt coming with the software for details
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
8 .. or visit http://www.gnu.org/licenses/ if it does not exist.
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
9 ..
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
10 .. MXD2map has been developed on behalf of the
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
11 .. Bundesamt fuer Seeschifffahrt und Hydrographie (BSH) in Hamburg
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
12 .. by Intevation GmbH.
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
13 ..
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
14 .. Authors:
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
15 .. Raimund Renkert <raimund.renkert@intevation.de>
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
16 .. Bjoern Schilberg <bjoern.schilberg@intevation.de>
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
17 .. Stephan Holl <stephan.holl@intevation.de>
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
18
4dc2b9aa3c57 Added LGPL header.
raimund renkert <raimund.renkert@intevation.de>
parents: 250
diff changeset
19
250
d10fd4de02aa Documented a bunch of new features
Stephan Holl <stephan.holl@intevation.de>
parents: 230
diff changeset
20 .. index:: restrictions, label, Raster, ArcSDE, SDE, workaround, picture-symols, windows, ArcEngine
202
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
Stephan Holl <stephan.holl@intevation.de>
parents: 188
diff changeset
21 .. _restriction-label:
183
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
22
139
2040463cb4f7 * doku/Makefile, doku/source/conf.py, doku/source/index.rst,
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
23 ------------
2040463cb4f7 * doku/Makefile, doku/source/conf.py, doku/source/index.rst,
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
24 Restrictions
2040463cb4f7 * doku/Makefile, doku/source/conf.py, doku/source/index.rst,
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
25 ------------
2040463cb4f7 * doku/Makefile, doku/source/conf.py, doku/source/index.rst,
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
26
250
d10fd4de02aa Documented a bunch of new features
Stephan Holl <stephan.holl@intevation.de>
parents: 230
diff changeset
27 Currently there are some restrictions in the usage of the converter. One
d10fd4de02aa Documented a bunch of new features
Stephan Holl <stephan.holl@intevation.de>
parents: 230
diff changeset
28 of the main restrictions is the fact that the converter currently only
d10fd4de02aa Documented a bunch of new features
Stephan Holl <stephan.holl@intevation.de>
parents: 230
diff changeset
29 runs on Windows. This is due to the fact that the needed ArcEngine did
d10fd4de02aa Documented a bunch of new features
Stephan Holl <stephan.holl@intevation.de>
parents: 230
diff changeset
30 never reliably work on Linux. This was tested with ArcEngine 10.0.
139
2040463cb4f7 * doku/Makefile, doku/source/conf.py, doku/source/index.rst,
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
31
2040463cb4f7 * doku/Makefile, doku/source/conf.py, doku/source/index.rst,
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
32 Supported datasources:
2040463cb4f7 * doku/Makefile, doku/source/conf.py, doku/source/index.rst,
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
33
2040463cb4f7 * doku/Makefile, doku/source/conf.py, doku/source/index.rst,
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
34 * ArcSDE-passwords cannot be read since they are encrypted. The converter
188
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 183
diff changeset
35 exports the string ``<PASSWORD>`` which needs to be replaced later on in the
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 183
diff changeset
36 resulting mapfile.
139
2040463cb4f7 * doku/Makefile, doku/source/conf.py, doku/source/index.rst,
Stephan Holl <stephan.holl@intevation.de>
parents:
diff changeset
37
188
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 183
diff changeset
38 * Since MapServer cannot use a FileGeodatabase datasources (yet) the MXD2map
230
df533a03ad9f completed the features and restrictions-section
Stephan Holl <stephan.holl@intevation.de>
parents: 206
diff changeset
39 does not support this datasource and will not transform the MXD-file at
df533a03ad9f completed the features and restrictions-section
Stephan Holl <stephan.holl@intevation.de>
parents: 206
diff changeset
40 all. This may change in the near future.
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
41
230
df533a03ad9f completed the features and restrictions-section
Stephan Holl <stephan.holl@intevation.de>
parents: 206
diff changeset
42 * Raster data is not supported by the converter yet, though ArcSDE
df533a03ad9f completed the features and restrictions-section
Stephan Holl <stephan.holl@intevation.de>
parents: 206
diff changeset
43 Raster-support will be available in the near future.
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
44
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
45 Symbol support:
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
46
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
47 * Line symbols with pattern cannot be combined with marker symbols. The
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
48 converter reads all symbols and writes the corresponding styles to the
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
49 resulting mapfile but the marker symbols are rendered without any gap.
188
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 183
diff changeset
50 The resulting mapimage may not look as intended.
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
51
202
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
Stephan Holl <stephan.holl@intevation.de>
parents: 188
diff changeset
52 .. hint::
188
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 183
diff changeset
53 Workarround: For small marker symbols it is recommended to use a line symbol in
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
54 combination with pattern (in ArcGIS called template) to create the
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
55 symbology.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
56 The reason why marker symbols cannot be used in combination with a template
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
57 is the difficulty to interpret the read attributes like marks and gaps and
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
58 write the appropriate symbols with the appropiate gap to the mapfile.
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
59
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
60 * The converter sets the width to 1 for line symbols that have a width
250
d10fd4de02aa Documented a bunch of new features
Stephan Holl <stephan.holl@intevation.de>
parents: 230
diff changeset
61 smaller than 1.
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
62
202
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
Stephan Holl <stephan.holl@intevation.de>
parents: 188
diff changeset
63 .. tip::
1e3a5019c4ed * INSTALL.txt, LICENCE.txt, doku/source/LICENCE.txt,
Stephan Holl <stephan.holl@intevation.de>
parents: 188
diff changeset
64 To avoid lines and line colors (specially outlines) to be handled by the
183
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
65 converter, use integer numbers for line width only.
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
66
188
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 183
diff changeset
67 * In ArcGIS maps default symbols can be defined as fallback within classifications.
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 183
diff changeset
68 Since MapServer does not support such fallback symbols or styles
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 183
diff changeset
69 within classifications the converter does not read these default symbols.
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
70
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
71 * In ArcGIS predefined symbols like bars or pie charts can be used to display
188
43f1cbdcd597 Modified and beautified the documentation:
Stephan Holl <stephan.holl@intevation.de>
parents: 183
diff changeset
72 values. The converter does not support these symbols yet.
182
91e2d46d7968 Added functionality, restrictions and how to build runtime enviroment
Raimund Renkert <rrenkert@intevation.de>
parents: 140
diff changeset
73
183
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
74 Layer support:
fe6dbfc86144 Updated documentation.
Raimund Renkert <rrenkert@intevation.de>
parents: 182
diff changeset
75
206
4ebba3c52924 Updated restrictions.
Raimund Renkert <rrenkert@intevation.de>
parents: 202
diff changeset
76 * Expressions for label are parsed by an internal parser in ArcGIS. The
230
df533a03ad9f completed the features and restrictions-section
Stephan Holl <stephan.holl@intevation.de>
parents: 206
diff changeset
77 interpretation of this expressions is very limited though.
206
4ebba3c52924 Updated restrictions.
Raimund Renkert <rrenkert@intevation.de>
parents: 202
diff changeset
78 Therefore label expressions may not contain any special functions or must fit
4ebba3c52924 Updated restrictions.
Raimund Renkert <rrenkert@intevation.de>
parents: 202
diff changeset
79 the mapserver expression design pattern.
4ebba3c52924 Updated restrictions.
Raimund Renkert <rrenkert@intevation.de>
parents: 202
diff changeset
80
This site is hosted by Intevation GmbH (Datenschutzerklärung und Impressum | Privacy Policy and Imprint)