[Plplot-cvs] SF.net SVN: plplot:[12137] trunk/doc/docbook/src/advanced.xml

[<ai...@us...>]

Revision: 12137
          http://plplot.svn.sourceforge.net/plplot/?rev=12137&view=rev
Author:   airwin
Date:     2012-01-20 20:07:52 +0000 (Fri, 20 Jan 2012)
Log Message:
-----------
Clarify the introduction to color to make it clear both
plcol0 and plcol1 set the current color which is used for all
subsequent plotting actions.

Modified Paths:
--------------
    trunk/doc/docbook/src/advanced.xml

Modified: trunk/doc/docbook/src/advanced.xml
===================================================================
--- trunk/doc/docbook/src/advanced.xml	2012-01-20 10:34:19 UTC (rev 12136)
+++ trunk/doc/docbook/src/advanced.xml	2012-01-20 20:07:52 UTC (rev 12137)
@@ -1403,14 +1403,22 @@
     of globally turning off the color (and subsequently turning it on again
     if so desired) using &plscolor;. </para>
 
-    <para> The PLplot color model utilizes two color maps which can be used
-    interchangeably.  However, color map0 (discussed in <xref
-    linkend="color-map-0"/>) has discrete colors with no particular order
-    and is most suited to coloring the background, axes, lines, and labels,
-    and color map1 (discussed in <xref linkend="color-map-1"/>) has
-    continuously changing colors and is most suited to plots (see <xref
-    linkend="contour-plots"/>) in which data values are represented by
-    colors. </para>
+    <para> The PLplot color model allows the user to set the current
+    color from a wide range of colours using two distinct color maps.
+    Color map0 (discussed in <xref linkend="color-map-0"/>) has discrete
+    colors with no particular order and is most suited to coloring the
+    background, axes, lines, and labels, and color map1 (discussed in
+    <xref linkend="color-map-1"/>) has continuously changing colors and is
+    most suited to plots (see <xref linkend="contour-plots"/>) in which
+    data values are represented by colors.  Setting the background color
+    is a special case that is handled exclusively by color map 0 (as
+    discussed in <xref linkend="color-map-0"/>).  The user can change the
+    current color (as opposed to the background color) at any point in the
+    plot by selecting any of the colors from either color map 0 or 1 using
+    calls to &plcol0; or &plcol1;. When the current color is changed all
+    subsequent drawing actions will utilise the new color until it is
+    changed again.
+</para>
 
     <sect2 id="color-map-0">
       <title>Color Map0</title>

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.