out in missing protos for ST_Value and not that hasnodata is a new option for ST_Valu...

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

diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml
index ba8e72a80c247ec1724be9d64e8ed8d54f10a633..cb138e37794ac5668be708a450997c5d37322872 100644 (file)
--- a/doc/reference_raster.xml
+++ b/doc/reference_raster.xml
@@ -1884,7 +1884,7 @@ WHERE rid=2;
            <refentry id="RT_ST_Value">
                        <refnamediv>
                                <refname>ST_Value</refname>
-                               <refpurpose>Returns the value of a given band in a given columnx, rowy pixel or at a particular geometric point. Band numbers start at 1 and assumed to be 1 if not specified.</refpurpose>
+                               <refpurpose>Returns the value of a given band in a given columnx, rowy pixel or at a particular geometric point. Band numbers start at 1 and assumed to be 1 if not specified. If <varname>hasnodata</varname> is set to true, then only non <varname>nodata</varname> pixels are considered. If <varname>hasnodata</varname> is not passed in then reads it from metadata of raster.</refpurpose>
                        </refnamediv>
                
                        <refsynopsisdiv>
@@ -1893,6 +1893,12 @@ WHERE rid=2;
                                        <funcdef>double precision <function>ST_Value</function></funcdef>
                                        <paramdef><type>raster </type> <parameter>rast</parameter></paramdef>
                                        <paramdef><type>geometry </type> <parameter>pt</parameter></paramdef>
+                                 </funcprototype>
+                                  <funcprototype>
+                                       <funcdef>double precision <function>ST_Value</function></funcdef>
+                                       <paramdef><type>raster </type> <parameter>rast</parameter></paramdef>
+                                       <paramdef><type>geometry </type> <parameter>pt</parameter></paramdef>
+                                       <paramdef><type>boolean </type> <parameter>hasnodata</parameter></paramdef>
                                  </funcprototype>
                                  <funcprototype>
                                        <funcdef>double precision <function>ST_Value</function></funcdef>
@@ -1900,18 +1906,40 @@ WHERE rid=2;
                                        <paramdef><type>integer </type> <parameter>bandnum</parameter></paramdef>
                                        <paramdef><type>geometry </type> <parameter>pt</parameter></paramdef>
                                  </funcprototype>
+                                <funcprototype>
+                                       <funcdef>double precision <function>ST_Value</function></funcdef>
+                                       <paramdef><type>raster </type> <parameter>rast</parameter></paramdef>
+                                       <paramdef><type>integer </type> <parameter>bandnum</parameter></paramdef>
+                                       <paramdef><type>geometry </type> <parameter>pt</parameter></paramdef>
+                                       <paramdef><type>boolean </type> <parameter>hasnodata</parameter></paramdef>
+                                 </funcprototype>
                                  <funcprototype>
                                        <funcdef>double precision <function>ST_Value</function></funcdef>
                                        <paramdef><type>raster </type> <parameter>rast</parameter></paramdef>
                                        <paramdef><type>integer </type> <parameter>columnx</parameter></paramdef>
                                        <paramdef><type>integer </type> <parameter>rowy</parameter></paramdef>
                                  </funcprototype>
+                                 <funcprototype>
+                                       <funcdef>double precision <function>ST_Value</function></funcdef>
+                                       <paramdef><type>raster </type> <parameter>rast</parameter></paramdef>
+                                       <paramdef><type>integer </type> <parameter>columnx</parameter></paramdef>
+                                       <paramdef><type>integer </type> <parameter>rowy</parameter></paramdef>
+                                       <paramdef><type>boolean </type> <parameter>hasnodata</parameter></paramdef>
+                                 </funcprototype>
+                                 <funcprototype>
+                                       <funcdef>double precision <function>ST_Value</function></funcdef>
+                                       <paramdef><type>raster </type> <parameter>rast</parameter></paramdef>
+                                       <paramdef><type>integer </type> <parameter>bandnum</parameter></paramdef>
+                                       <paramdef><type>integer </type> <parameter>columnx</parameter></paramdef>
+                                       <paramdef><type>integer </type> <parameter>rowy</parameter></paramdef>
+                                 </funcprototype>
                                  <funcprototype>
                                        <funcdef>double precision <function>ST_Value</function></funcdef>
                                        <paramdef><type>raster </type> <parameter>rast</parameter></paramdef>
                                        <paramdef><type>integer </type> <parameter>bandnum</parameter></paramdef>
                                        <paramdef><type>integer </type> <parameter>columnx</parameter></paramdef>
                                        <paramdef><type>integer </type> <parameter>rowy</parameter></paramdef>
+                                       <paramdef><type>boolean </type> <parameter>hasnodata</parameter></paramdef>
                                  </funcprototype>
                                </funcsynopsis>
                        </refsynopsisdiv>
@@ -1919,9 +1947,10 @@ WHERE rid=2;
                        <refsection>
                                <title>Description</title>
                                
-                               <para>Returns the value of a given band in a given columnx, rowy pixel or at a given geometry point. Band numbers start at 1 and band is assumed to be 1 if not specified.</para>
+                               <para>Returns the value of a given band in a given columnx, rowy pixel or at a given geometry point. Band numbers start at 1 and band is assumed to be 1 if not specified.      
+                               If <varname>hasnodata</varname> is set to true, then only non <varname>nodata</varname> pixels are considered.  If <varname>hasnodata</varname> is set to false, then all pixels are considered.</para>
 
-                               
+                               <para>Changed: 2.0.0 hasnodata optional argument was added.</para>
                                </refsection>
                                
                                <refsection>
@@ -2068,7 +2097,7 @@ WHERE
                                        , <xref linkend="RT_ST_ScaleY" />, <xref linkend="RT_ST_UpperLeftX" />, 
                                        <xref linkend="RT_ST_UpperLeftY" />, <xref linkend="RT_ST_SRID" />, <xref linkend="ST_AsText" />,
                                        , <xref linkend="ST_Point" />, <xref linkend="ST_MakeEnvelope" />, 
-                                       <xref linkend="ST_Intersects" /></para>
+                                       <xref linkend="ST_Intersects" />, <xref linkend="ST_Intersection" /></para>
                        </refsection>
                </refentry>