From eeeb9c0ffe46a1e33d4963f9c6668d919033aa41 Mon Sep 17 00:00:00 2001
From: Regina Obe <lr@pcorp.us>
Date: Fri, 10 May 2013 07:42:03 +0000
Subject: [PATCH] example of a custom color map

git-svn-id: http://svn.osgeo.org/postgis/trunk@11398 b70326c6-7e19-0410-871a-916f4a2858ee
---
 doc/html/images/st_colormap_red.png | Bin 0 -> 2985 bytes
 doc/reference_raster.xml            |  40 +++++++++++++++++++++++-----
 2 files changed, 33 insertions(+), 7 deletions(-)
 create mode 100644 doc/html/images/st_colormap_red.png

diff --git a/doc/html/images/st_colormap_red.png b/doc/html/images/st_colormap_red.png
new file mode 100644
index 0000000000000000000000000000000000000000..b440a67c34b0ce41fb8fa1c5adc57345f5a61463
GIT binary patch
literal 2985
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

literal 0
HcmV?d00001

diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml
index 9e2f709db..1fa048bc5 100644
--- a/doc/reference_raster.xml
+++ b/doc/reference_raster.xml
@@ -10898,21 +10898,35 @@ FROM (SELECT
 <programlisting>SELECT ST_NumBands(rast) As n_orig
    , ST_NumBands(ST_ColorMap(rast, 'pseudocolor')) As npseudo
    , ST_NumBands(ST_ColorMap(rast, 'greyscale')) As ngrey
+   , ST_NumBands(ST_ColorMap(rast, '100% 255 0 0
+80% 160 0 0
+50% 130 0 0
+30% 30 0 0
+20% 60 0 0
+0% 0 0 0
+nv 255 255 255')) As nred
 FROM funky_shapes;
 
- n_orig | npseudo | ngrey
---------+---------+-------
-      1 |       4 |     1
+ n_orig | npseudo | ngrey | nred
+--------+---------+-------+------
+      1 |       4 |     1 |    3
 </programlisting>			
 			</refsection>
 			<refsection><title>Examples: Compare different color map looks using ST_AsPNG</title>
 				<programlisting>SELECT ST_AsPNG(rast) As orig_png
  , ST_AsPNG(ST_ColorMap(rast,'greyscale')) As grey_png
  , ST_AsPNG(ST_ColorMap(rast, 'pseudocolor')) As pseudo_png
+ , ST_AsPNG(ST_ColorMap(rast, '100% 255 0 0
+80% 160 0 0
+50% 130 0 0
+30% 30 0 0
+20% 60 0 0
+0% 0 0 0
+nv 255 255 255')) As red_png
 FROM funky_shapes;</programlisting>
 
 <informaltable>
-  <tgroup cols="3">
+  <tgroup cols="2">
 	<tbody>
 	  <row>
 		<entry><para><informalfigure>
@@ -10933,6 +10947,8 @@ FROM funky_shapes;</programlisting>
 			</mediaobject>
 		  </informalfigure></para>
 		 </entry>
+	 </row>
+	<row>
 		<entry><para><informalfigure>
 			<mediaobject>
 			  <imageobject>
@@ -10942,7 +10958,16 @@ FROM funky_shapes;</programlisting>
 			</mediaobject>
 		  </informalfigure></para>
 		 </entry>
-		</row>
+		 <entry><para><informalfigure>
+			<mediaobject>
+			  <imageobject>
+				<imagedata fileref="images/st_colormap_red.png" />
+			  </imageobject>
+			  <caption><para>red_png</para></caption>
+			</mediaobject>
+		  </informalfigure></para>
+		 </entry>
+	</row>	
 	</tbody>
 </tgroup>
 </informaltable>
@@ -10951,10 +10976,11 @@ FROM funky_shapes;</programlisting>
 			<refsection>
 				<title>See Also</title>
 				<para>
-					<xref linkend="RT_ST_MapAlgebra" />, 
-					<xref linkend="RT_ST_Reclass" />,
 					<xref linkend="RT_ST_AsPNG" />,
 					<xref linkend="RT_ST_AsRaster" />
+					<xref linkend="RT_ST_MapAlgebra" />, 
+					<xref linkend="RT_ST_Reclass" />,
+					<xref linkend="RT_ST_Union" />
 				</para>
 			</refsection>
 		</refentry>
-- 
2.50.1