[mapserver-commits] r12734 - in trunk/docs/en: images mapfile/symbology

[svn at osgeo.org]

Author: havatv
Date: 2011-11-01 09:19:11 -0700 (Tue, 01 Nov 2011)
New Revision: 12734

Modified:
   trunk/docs/en/images/symcon-hatch.png
   trunk/docs/en/images/symcon-points.png
   trunk/docs/en/mapfile/symbology/construction.txt
Log:
Some corrections to the symbol construction document.

Modified: trunk/docs/en/images/symcon-hatch.png
===================================================================
(Binary files differ)

Modified: trunk/docs/en/images/symcon-points.png
===================================================================
(Binary files differ)

Modified: trunk/docs/en/mapfile/symbology/construction.txt
===================================================================
--- trunk/docs/en/mapfile/symbology/construction.txt	2011-11-01 14:10:11 UTC (rev 12733)
+++ trunk/docs/en/mapfile/symbology/construction.txt	2011-11-01 16:19:11 UTC (rev 12734)
@@ -367,12 +367,11 @@
 
   .. note::
 
-    Current behaviour is for the bounding box of a vector symbol to
-    always have 0,0 (in the :ref:`symbol` coordinate system) as its
-    upper left corner.  To be safe, the top and left edges of the
-    bounding box of the symbol should be at y=0 and x=0 respectively.
+    The bounding box of a vector symbol has (0,0) in the symbol
+    coordinate system as its upper left corner.  This can be used to
+    precisely control symbol placement.  Since version 6.2
+    :ref:`symbol` `ANCHORPOINT` should be used instead.
 
-
 .. index::
    single: Truetype symbols
 
@@ -713,8 +712,7 @@
 with even and odd numbered `SIZE` parameters, as this tends to produce
 larger irregularities.
 
-.. figure:: ../../images/point-symbols.png
-   :width: 730
+.. figure:: ../../images/point-symbols.png   :width: 730
    :height: 508
    :align: center
 
@@ -783,7 +781,9 @@
 the right column).  At the bottom a :ref:`symbol` of `TYPE` `ellipse`
 has been used, then a :ref:`symbol` of `TYPE` `vector`, then a
 :ref:`symbol` of `TYPE` `font` and then a :ref:`symbol` of `TYPE`
-`pixmap`.
+`pixmap`.  To control the placement of the symbols relative to the
+line (to get asymmetrical styling), use :ref:`symbol` `ANCHORPOINT`
+(as explained later).
 
 .. note::
 
@@ -846,12 +846,13 @@
     TYPE vector
     FILLED true
     POINTS
-      0 5
+      0 0
       0 10
-      1.4 10
-      1.4 5
-      0 5
+      2.4 10
+      2.4 0
+      0 0
     END # POINTS
+    ANCHORPOINT 0.5 0
   END # SYMBOL
 
   SYMBOL
@@ -1061,7 +1062,7 @@
       STYLE
         COLOR 0 0 0
         SYMBOL "vertline"
-        SIZE 20.0
+        SIZE 10.0
         ANGLE 30
         GAP -50
       END # STYLE
@@ -1404,7 +1405,7 @@
    |      SYMBOL "hatchsymbol"      |
    |      COLOR 0 0 0               |
    |      WIDTH 10                  |
-   |      SIZE 10                   |
+   |      SIZE 3                    |
    |      ANGLE 45                  |
    |      PATTERN 20 10 10 10 END   |
    |    END # STYLE                 |
@@ -1594,15 +1595,18 @@
 specified symbol for the tiles.  The bounding box of the symbol is
 used when tiling.
 
-The upper right corner of the bounding box of a symbols of `TYPE`
-`vector` is always (0, 0).  The lower left corner of the bounding box
-is determined by the maximum x and y values of the symbol definition
-(`POINTS` parameter).
-
 Creating vector symbols for polygon fills is done in much the same
 way as for pixmap symbols.  Precision is necessary to get nice
 symmetrical symbols.
 
+The upper left corner of the bounding box of a symbol of `TYPE`
+`vector` is always (0, 0) in the symbol's coordinate system.  The
+lower right corner of the bounding box is determined by the maximum x
+and y values of the symbol definition (`POINTS` parameter).  The fact
+that the upper left corner always is at (0,0) makes it convenient to
+construct symbols such as the dash signature found as number two from
+the bottom in the centre column of the example below.
+
 Both polygon (`FILLED` `true`) and line (`FILLED` `false`) vector
 symbols can be used.  For line symbols, the `WIDTH` parameter of the
 :ref:`style` will give the line width and the `SIZE` parameter will