Mercurial > mxd2map
annotate doku/source/restrictions.txt @ 270:8f93a60b9a24
Tagged as release 'release-0.9'
author | Stephan Holl <stephan.holl@intevation.de> |
---|---|
date | Thu, 08 Sep 2011 17:14:22 +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 |