From: Regina Obe <lr@pcorp.us>
Date: Fri, 16 Mar 2012 12:58:47 +0000 (+0000)
Subject: surreal clipping
X-Git-Tag: 2.0.0beta4~9
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=6d5bacd1fe857cfecc2d08300a17515215c86bef;p=postgis

surreal clipping

git-svn-id: http://svn.osgeo.org/postgis/trunk@9512 b70326c6-7e19-0410-871a-916f4a2858ee
---

diff --git a/doc/html/images/st_clip04.png b/doc/html/images/st_clip04.png
new file mode 100644
index 000000000..a1fbf5d9a
Binary files /dev/null and b/doc/html/images/st_clip04.png differ
diff --git a/doc/html/images/st_clip05.png b/doc/html/images/st_clip05.png
new file mode 100644
index 000000000..e1b1414c6
Binary files /dev/null and b/doc/html/images/st_clip05.png differ
diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml
index 67d875608..9ea47a5b5 100644
--- a/doc/reference_raster.xml
+++ b/doc/reference_raster.xml
@@ -5444,6 +5444,41 @@ WHERE rid = 6) As foo;
 		</row>
 	</tbody>
 </tgroup>
+</informaltable>
+			</refsection>
+			<refsection>
+				<title>Examples: 1 band clipping with no crop and add back other bands unchanged</title>				
+<programlisting>-- Same example as before, but we need to set crop to false to be able to use ST_AddBand
+-- because ST_AddBand requires all bands be the same Width and height
+SELECT ST_AddBand(ST_Clip(rast, 1,
+		ST_Buffer(ST_Centroid(ST_Envelope(rast)),20),false
+	), ARRAY[ST_Band(rast,2),ST_Band(rast,3)] ) from aerials.boston
+WHERE rid = 6;</programlisting>
+<informaltable>
+  <tgroup cols="2">
+	<tbody>
+	  <row>
+		<entry><para><informalfigure>
+			<mediaobject>
+			  <imageobject>
+				<imagedata fileref="images/st_clip04.png" />
+			  </imageobject>
+			  <caption><para>Full raster tile before clipping</para></caption>
+			</mediaobject>
+		  </informalfigure></para>
+		 </entry>
+		<entry><para><informalfigure>
+			<mediaobject>
+			  <imageobject>
+				<imagedata fileref="images/st_clip05.png" />
+			  </imageobject>
+			  <caption><para>After Clipping - surreal</para></caption>
+			</mediaobject>
+		  </informalfigure></para>
+		 </entry>
+		</row>
+	</tbody>
+</tgroup>
 </informaltable>
 			</refsection>
 			<refsection>