[mapserver-commits] r8435 - trunk/docs/mapfile

[svn at osgeo.org]

Author: tbonfort
Date: 2009-01-16 13:35:22 -0500 (Fri, 16 Jan 2009)
New Revision: 8435

Modified:
   trunk/docs/mapfile/style.txt
Log:
add geomtransform, fractional size and width, autoangle, and opacity


Modified: trunk/docs/mapfile/style.txt
===================================================================
--- trunk/docs/mapfile/style.txt	2009-01-16 18:23:35 UTC (rev 8434)
+++ trunk/docs/mapfile/style.txt	2009-01-16 18:35:22 UTC (rev 8435)
@@ -12,7 +12,7 @@
 re-usable through the mapfile. This is the new, preferred way of defining 
 the appearance of an object, notably a class.
 
-ANGLE [double|attribute]
+ANGLE [double|attribute|AUTO]
 
     - Angle, given in degrees, to draw the line work. Default is 0. For
       symbols of Type HATCH, this is the angle of the hatched lines. For its
@@ -35,6 +35,8 @@
         END 
 
       The associated RFC document for this feature is :ref:`RFC19`.
+    - The AUTO keyword was added in version 5.4, and currently only applies
+      when coupled with the GEOMTRANSFORM keyword.
 
 ANGLEITEM [string]
 
@@ -68,6 +70,19 @@
 
       The associated RFC document for this feature is :ref:`RFC19`.
 
+GEOMTRANSFORM [start|end|vertices|bbox]
+    
+    - Used to indicate that the current feature will be transformed before the actual
+      style is applied. Only applies to versions from 5.4
+    - "bbox": uses the current style for rendering the bounding box of the underlying
+      geometry
+    - "start" and "end": uses the current style to render a marker on the first or last
+      vertex of the current geometry. When used with ANGLE AUTO, this can be used to
+      render arrowheads or tails on line segments.
+    - "vertices": uses the current style for rendering a marker on the intermediate
+      vertices of the underlying geometry. When used with ANGLE AUTO, the marker is
+      oriented by the half angle formed by the two adjacent line segments.
+
 MAXSIZE [integer]
     Maximum size in pixels to draw a symbol. Default is 50.
 
@@ -79,7 +94,11 @@
 
 OFFSET [x][y]
     Offset values for shadows, hollow symbols, etc ...
-  
+
+OPACITY [integer]
+    Opacity to draw the current style (:ref:`AGG` only, does not apply to pixmap
+    symbols)
+
 OUTLINECOLOR [r] [g] [b] | [attribute]
 
     - Color to use for outlining polygons and certain marker symbols. Line 
@@ -101,7 +120,7 @@
 
 SIZE [integer|attribute]
 
-    - Height, in pixels, of the symbol/pattern to be used. Only useful with 
+    - Height, in layer SIZEUNITS, of the symbol/pattern to be used. Only useful with 
       scalable symbols. Default is 1. For symbols of Type HATCH, the SIZE is the
       distance between hatched lines. For its use with hatched lines, see
       Example#8 in the :ref:`symbology examples <sym_examples>`.
@@ -122,6 +141,9 @@
         END 
 
       The associated RFC document for this feature is :ref:`RFC19`.
+    - Starting from version 5.4, the value can also be a fractional value (and not
+      only integer). Note that currently only the :ref:`AGG <AGG>` renderer can
+      correctly render fractional widths.
 
 SIZEITEM [string]
 
@@ -142,8 +164,16 @@
     You can also specify a gif or png filename. The path is relative to the 
     location of the mapfile. 
 
-WIDTH [integer]
-    Width refers to the thickness of line work drawn, in pixels. Default is 1. 
-    For symbols of Type HATCH, the WIDTH is how thick the hatched lines are. 
-    For its use with hatched lines, see Example#8 in the 
-    :ref:`symbology examples <sym_examples>`.
+WIDTH [integer|attribute]
+    
+    - Width refers to the thickness of line work drawn, in layer `SIZEUNITS`.
+      Default is 1.
+    - For symbols of Type HATCH, the WIDTH is how thick the hatched lines are. 
+      For its use with hatched lines, see Example#8 in the 
+      :ref:`symbology examples <sym_examples>`.
+    - Attribute binding was added in version 5.2
+    - Starting from version 5.4, the value can also be a fractional value (and not
+      only integer). Note that currently only the :ref:`AGG <AGG>` renderer can
+      correctly render fractional widths.
+
+