[mapserver-commits] r11670 - trunk/docs/en/mapfile

[svn at osgeo.org]

Author: havatv
Date: 2011-05-11 01:38:09 -0700 (Wed, 11 May 2011)
New Revision: 11670

Modified:
   trunk/docs/en/mapfile/label.txt
   trunk/docs/en/mapfile/style.txt
   trunk/docs/en/mapfile/symbol.txt
Log:
Update anti-aliasing documentation

Modified: trunk/docs/en/mapfile/label.txt
===================================================================
--- trunk/docs/en/mapfile/label.txt	2011-05-10 16:00:12 UTC (rev 11669)
+++ trunk/docs/en/mapfile/label.txt	2011-05-11 08:38:09 UTC (rev 11670)
@@ -41,8 +41,11 @@
     pair: LABEL; ANTIALIAS
 
 ANTIALIAS [true|false]
-    Should text be antialiased? Note that this requires more available colors, 
-    decreases drawing performance, and results in slightly larger output images.
+    Should text be antialiased? Note that this requires more available
+    colors, decreases drawing performance, and results in slightly
+    larger output images.  Only useful for GD (gif) rendering.
+    Default is false.  Has no effect for the other renderers (where
+    anti-aliasing can not be turned off).
 
 BACKGROUNDCOLOR [r] [g] [b]
     Color to draw a background rectangle (i.e. billboard). Off by default.

Modified: trunk/docs/en/mapfile/style.txt
===================================================================
--- trunk/docs/en/mapfile/style.txt	2011-05-10 16:00:12 UTC (rev 11669)
+++ trunk/docs/en/mapfile/style.txt	2011-05-11 08:38:09 UTC (rev 11670)
@@ -65,7 +65,9 @@
     .. deprecated:: 5.0
 
 ANTIALIAS [true|false]
-    Should TrueType fonts be antialiased.
+    Should TrueType fonts be antialiased.  Only useful for GD (gif)
+    rendering.  Default is false.  Has no effect for the other
+    renderers (where anti-aliasing can not be turned off).
 
 BACKGROUNDCOLOR [r] [g] [b]
     Color to use for non-transparent symbols.

Modified: trunk/docs/en/mapfile/symbol.txt
===================================================================
--- trunk/docs/en/mapfile/symbol.txt	2011-05-10 16:00:12 UTC (rev 11669)
+++ trunk/docs/en/mapfile/symbol.txt	2011-05-11 08:38:09 UTC (rev 11670)
@@ -4,11 +4,11 @@
  SYMBOL
 *****************************************************************************
 
-- Symbol definitions can be included within the main MapFile or, more 
-  commonly, in a separate file. Symbol definitions in a separate file 
-  are designated using the SYMBOLSET keyword, as part of the :ref:`MAP Object <map>`. 
-  This recommended setup is ideal for re-using symbol definitions across 
-  multiple MapServer applications.
+- Symbol definitions can be included within the main map file or, more
+  commonly, in a separate file. Symbol definitions in a separate file
+  are designated using the SYMBOLSET keyword, as part of the
+  :ref:`MAP object <map>`.  This recommended setup is ideal for
+  re-using symbol definitions across multiple MapServer applications.
 - There are 3 main types of symbols in MapServer: Markers, 
   Lines and Shadesets.
 - Symbol 0 is always the degenerate case for a particular class of 
@@ -17,10 +17,12 @@
   is a single pixel wide line.
 - Symbol definitions contain no color information, colors are set within 
   :ref:`STYLE` objects.
-- For MapServer versions < 5 there is a maximum of 64 symbols per file. This can
-  be changed by editing mapsymbol.h and changing the value of MS_MAXSYMBOLS at the 
-  top of the file.  As of MapServer 5.0 there is no symbol limit.
-- More information can be found in the :ref:`Construction of Cartographic Symbols <sym_construction>`
+- For MapServer versions < 5 there is a maximum of 64 symbols per
+  file. This can be changed by editing mapsymbol.h and changing the
+  value of MS_MAXSYMBOLS at the top of the file.  As of MapServer 5.0
+  there is no symbol limit.
+- More information can be found in the
+  :ref:`Construction of Cartographic Symbols <sym_construction>`
   document.
 
 
@@ -28,7 +30,9 @@
     pair: ANTIALIAS; SYMBOL
     
 ANTIALIAS [true|false]
-    Should TrueType fonts be antialiased.
+    Should TrueType fonts be antialiased.  Only useful for GD (gif)
+    rendering.  Default is false.  Has no effect for the other
+    renderers (where anti-aliasing can not be turned off).
 
 CHARACTER [char]
     Character used to reference a particular TrueType font character. 
@@ -78,19 +82,22 @@
 
 POINTS [x y] [x y] ... END
 
-    Signifies the start of the definition of points that make up a
-    vector symbol or that define the x and y radius of an ellipse
-    symbol. The end of this section is signified with the keyword END.
-    The `x` and `y` values can be given using decimal numbers.  The
-    maximum `x` and `y` values define the bounding box of the symbol.
-    The size (actually height) of a symbol is defined in the
-    :ref:`STYLE`.  You can create non-contiguous paths by inserting
-    negative coordinates at the appropriate place.
+    Signifies the start of a sequence of points that make up a symbol
+    of `TYPE` `vector` or that define the x and y radius of a symbol
+    of `TYPE` `ellipse`.  The end of this section is signified with
+    the keyword `END`.  The `x` and `y` values can be given using
+    decimal numbers.  The maximum `x` and `y` values define the
+    bounding box of the symbol.  The size (actually height) of a
+    symbol is defined in the :ref:`STYLE`.  You can create
+    non-contiguous paths by inserting "-99 -99" at the appropriate
+    places.
 
-    For ellipse symbols you provide a single point that defines the x
-    and y radius of an ellipse. Circles are created when `x` and `y`
-    are equal.
+    x values increase to the right, y values increase downwards.
 
+    For symbols of `TYPE` `ellipse`, a single point is specified that
+    defines the x and y radius of the ellipse. Circles are created
+    when `x` and `y` are equal.
+
     .. note::
 
       If a :ref:`STYLE` using this symbol doesn't contain an explicit