Changeset 4832

Timestamp:

11/16/09 10:46:38 (2 years ago)

Author:

pramsey

Message:

Add doco and regression tests for ST_MakeEnvelope() (#199)

Location:

trunk

Files:

• doc/reference_constructor.xml (modified) (1 diff)
• regress/regress_expected (modified) (1 diff)
• regress/regress.sql (modified) (1 diff)

trunk/doc/reference_constructor.xml

@@ -1094 +1094 @@
                         <title>See Also</title>
                         <para><xref linkend="ST_AsEWKT" />, <xref linkend="ST_AsText" />, <xref linkend="ST_GeomFromText" />, <xref linkend="ST_MakePoint" /></para>
+                </refsection>
+        </refentry>
+
+
+        <refentry id="ST_MakeEnvelope">
+                <refnamediv>
+                <refname>ST_MakeEnvelope</refname>
+
+                <refpurpose>Creates a rectangular Polygon formed from the given minimums and maximums. Input
+                        values must be in SRS specified by the SRID.</refpurpose>
+                </refnamediv>
+
+                <refsynopsisdiv>
+                <funcsynopsis>
+                  <funcprototype>
+                        <funcdef>geometry <function>ST_MakeEnvelope</function></funcdef>
+                        <paramdef><type>double precision</type> <parameter>xmin</parameter></paramdef>
+                        <paramdef><type>double precision</type> <parameter>ymin</parameter></paramdef>
+                        <paramdef><type>double precision</type> <parameter>xmax</parameter></paramdef>
+                        <paramdef><type>double precision</type> <parameter>ymax</parameter></paramdef>
+                        <paramdef><type>integer </type> <parameter>srid</parameter></paramdef>
+                  </funcprototype>
+                </funcsynopsis>
+                </refsynopsisdiv>
+
+                <refsection>
+                        <title>Description</title>
+
+                        <para>Creates a rectangular Polygon formed from the minima and maxima. by the given shell. Input
+                                values must be in SRS specified by the SRID.</para>
+
+                </refsection>
+
+                <refsection>
+                <title>Example: Building an bounding box polygon</title>
+                 <programlisting>
+SELECT ST_AsText(ST_MakePolygon(10, 10, 11, 11, 4326));
+
+st_asewkt
+-----------
+POLYGON((10 10, 10 11, 11 11, 11 10, 10 10))
+                          </programlisting>
+                </refsection>
+                <refsection>
+                        <title>See Also</title>
+                        <para><xref linkend="ST_MakePoint" />, <xref linkend="ST_MakeLine" />, <xref linkend="ST_MakePolygon" /></para>
                 </refsection>
         </refentry>

trunk/regress/regress_expected

@@ -196 +196 @@
 150|SRID=6;GEOMETRYCOLLECTION(POLYGON((0 0,1 0,1 1,0 1,0 0)))
 150_|SRID=6;GEOMETRYCOLLECTION(POLYGON((0 0,1 0,1 1,0 1,0 0)))
+151|0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000
+152|4326

trunk/regress/regress.sql

@@ -275 +275 @@
 select '150_', asewkt(force_collection(setsrid('POLYGON((0 0, 1 0, 1 1, 0 1, 0 0))'::geometry, 6)));
 
+select '151', ST_MakeEnvelope(0, 0, 1, 1, 4326);
+select '152', ST_SRID(ST_MakeEnvelope(0, 0, 1, 1, 4326));
+
+
 -- Drop test table
 DROP table test;