[mapserver-commits] r8058 - trunk/docs/howto

[svn at osgeo.org]

Author: hobu
Date: 2008-11-23 15:02:50 -0500 (Sun, 23 Nov 2008)
New Revision: 8058

Modified:
   trunk/docs/howto/agg-rendering-specifics.txt
Log:
tweak ReST

Modified: trunk/docs/howto/agg-rendering-specifics.txt
===================================================================
--- trunk/docs/howto/agg-rendering-specifics.txt	2008-11-23 19:54:44 UTC (rev 8057)
+++ trunk/docs/howto/agg-rendering-specifics.txt	2008-11-23 20:02:50 UTC (rev 8058)
@@ -1,14 +1,23 @@
-..
+*****************************************************************************
+ AGG Rendering Specifics 
+*****************************************************************************
 
-:Author: Thomas Bonfort
-:Contact: thomas.bonfort(at)gmail
+:Author:  Thomas Bonfort
+:Contact: thomas.bonfort at gmail
+:Revision: $Revision$
+:Date: $Date$
 :Last Updated: 2007/08/21
 
----------
+.. sectnum::
 
+.. contents:: Table of Contents
+    :depth: 2
+    :backlinks: top
+
 Introduction
 ============
-Mapserver 5.0 will be released with a new rendering backend. This howto details the changes and new functionality that this adds to map creation. This howto supposes
+Mapserver 5.0 will be released with a new rendering backend. This howto details 
+the changes and new functionality that this adds to map creation. This howto supposes
 you already now the basics of mapfile syntax. If not, you should probably be reading
 `the mapfile syntax </docs/reference/mapfile>`__.
 
@@ -45,10 +54,11 @@
     IMAGEMODE RGB
  END
 
-png output, with number of colors reduced with quantization . ( **Note**: this functionality
-is not supported with RGBA images, that is outputformats with IMAGEMODE RGBA,
-or maps with TRANSPARENT ON ) :
+png output, with number of colors reduced with quantization . ( 
 
+.. note:: this functionality is not supported with RGBA images, that 
+is outputformats with IMAGEMODE RGBA, or maps with TRANSPARENT ON.
+
 ::
 
  OUTPUTFORMAT
@@ -62,11 +72,12 @@
 
 New Features
 =============
-* All rendering is now done antialiased by default. All ANTIALIAS keywords are now ignored, as well as 
-  TRANSPARENCY ALPHA. Pixmaps and fonts are now all drawn respecting the image's internal alpha channel
-  (unless a backgroundcolor is specified).
-* As with GD in ver. 4.10, using a SYMBOL of type ELLIPSE to draw thick lines isn't mandatory anymore.
-  To draw a thick line just use:
+* All rendering is now done antialiased by default. All ANTIALIAS keywords 
+  are now ignored, as well as TRANSPARENCY ALPHA. Pixmaps and fonts are now 
+  all drawn respecting the image's internal alpha channel (unless a 
+  backgroundcolor is specified).
+* As with GD in ver. 4.10, using a SYMBOL of type ELLIPSE to draw thick 
+  lines isn't mandatory anymore. To draw a thick line just use:
 
 ::
 
@@ -75,31 +86,38 @@
    COLOR 0 0 255
   END
 
-* A line symbolizer has been added, that works with vector or pixmap symbols, to draw textured lines.
-  This happens by default if a line's style is given a symbol of type vector or pixmap. To enable "shield"
-  symbolization, i.e. a marker placed only on some points of the line, you must add a GAP parameter to your
-  symbol definition. This GAP value is scaled w.r.t the style's SIZE parameter. Specify a positive gap value
-  for symbols always facing north (optionally rotated by the ANGLE of the current style), or a negative
-  value for symbols that should follow the line orientation
+* A line symbolizer has been added, that works with vector or pixmap 
+  symbols, to draw textured lines. This happens by default if a line's style 
+  is given a symbol of type vector or pixmap. To enable "shield" symbolization,
+  i.e. a marker placed only on some points of the line, you must add a GAP 
+  parameter to your symbol definition. This GAP value is scaled w.r.t the 
+  style's SIZE parameter. Specify a positive gap value for symbols always 
+  facing north (optionally rotated by the ANGLE of the current style), or 
+  a negative value for symbols that should follow the line orientation
 
 .. image:: /docs/howto/agg-rendering-specifics/linesymbolization.png
 
 * This happens by default if a line's style is given a symbol of type vector
-  or pixmap. To enable "shield" symbolization, i.e. a marker placed only on some points of the line, you 
-  must add a GAP parameter to your symbol definition. This GAP value is scaled w.r.t the style's SIZE parameter
-  - specify a positive gap value for symbols always facing north (optionally rotated by the ANGLE of the 
-  current style), or a negative value for symbols that should follow the line orientation
+  or pixmap. To enable "shield" symbolization, i.e. a marker placed only on 
+  some points of the line, you must add a GAP parameter to your symbol 
+  definition. This GAP value is scaled w.r.t the style's SIZE parameter - 
+  specify a positive gap value for symbols always facing north (optionally 
+  rotated by the ANGLE of the current style), or a negative value for symbols 
+  that should follow the line orientation
 * Pixmap and font symbols can now be rotated without loosing their transparency
-* For POLYGON layers with no specific SYMBOL, the WIDTH keyword specifies the width of the outline, if an 
-  OUTLINECOLOR was specified. This is a shorthand that avoids having to create multiple styles for basic 
-  rendering, and will provide a marginal performance gain. Note that in this case, the width of the outline
-  is /not/ scale dependent.
+* For POLYGON layers with no specific SYMBOL, the WIDTH keyword specifies the 
+  width of the outline, if an OUTLINECOLOR was specified. This is a shorthand 
+  that avoids having to create multiple styles for basic rendering, and will 
+  provide a marginal performance gain. Note that in this case, the width of 
+  the outline is /not/ scale dependent.
 
 Modified Behavior
 ==================
-* When specifying a SYMBOL for a polygon shape, the GAP parameter of the symbol is used as a separation between
-  each rendered symbol. This works for symbols of type vector, pixmap and ellipse. For example a symbol defined by
 
+* When specifying a SYMBOL for a polygon shape, the GAP parameter of the 
+  symbol is used as a separation between each rendered symbol. This works for 
+  symbols of type vector, pixmap and ellipse. For example a symbol defined by
+
 ::
 
   SYMBOL
@@ -120,4 +138,5 @@
 .. image:: solid-symbol-gap
 
 * layers of type CIRCLE support hatch type symbol filling
-* the ENCODING keyword for labels is now enforced. If unset, mapserver will treat your label text byte-by-byte (resulting in corrupt special characters).
\ No newline at end of file
+* the ENCODING keyword for labels is now enforced. If unset, mapserver will 
+  treat your label text byte-by-byte (resulting in corrupt special characters).
\ No newline at end of file