annotate doku/source/restrictions.txt @ 325:ebe500ec8a91

Update and clarify release instructions
author Andre Heinecke <aheinecke@intevation.de>
date Mon, 15 Oct 2012 11:42:28 +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)