[postgis-commits] svn - r3280 - trunk/doc

[postgis-commits at postgis.refractions.net]

Author: robe
Date: 2008-11-07 22:46:32 -0800 (Fri, 07 Nov 2008)
New Revision: 3280

Modified:
   trunk/doc/reference_new.xml
Log:
document support for curves of functions Mark C just fixed with disclaimer only works in 1.3.4+

Modified: trunk/doc/reference_new.xml
===================================================================
--- trunk/doc/reference_new.xml	2008-11-07 17:07:12 UTC (rev 3279)
+++ trunk/doc/reference_new.xml	2008-11-08 06:46:32 UTC (rev 3280)
@@ -2990,12 +2990,22 @@
 			<title>Description</title>
 			
 			<para>Return the number of points in a geometry.  Works for all geometries.</para>
+			<note><para>Prior to 1.3.4, this function crashes if used with geometries that contain CURVES.  This is fixed in 1.3.4+</para></note>
 						<!-- Optionally mention 3d support -->
 			<para><inlinemediaobject>
 			<imageobject>
 			  <imagedata fileref="images/check.png" />
 			</imageobject>
 		  </inlinemediaobject> This function supports 3d and will not drop the z-index.</para>
+		  
+		  <!-- Optionally mention Circular String Support -->
+		 <para><inlinemediaobject>
+	        <imageobject>
+	          <imagedata fileref="images/check.png" />
+	        </imageobject>
+	      </inlinemediaobject> This method supports Circular Strings and Curves </para>
+		  
+		  
 		</refsection>
 		
 		<refsection>
@@ -4748,6 +4758,8 @@
 		  <para>If using more than one transformation, it is useful to have a functional index on the commonly used
 		  	transformations to take advantage of index usage.</para>
 		</note>
+		
+		<note><para>Prior to 1.3.4, this function crashes if used with geometries that contain CURVES.  This is fixed in 1.3.4+</para></note>
 	
 		<!-- Optionally mention OpenGIS compliancy if appropriate -->
 		<para><inlinemediaobject>
@@ -4765,6 +4777,13 @@
 			</imageobject>
 		  </inlinemediaobject> This method implements the SQL/MM specification:
 		SQL-MM 3: 5.1.6</para>
+		
+		<!-- Optionally mention Circular String Support -->
+	    <para><inlinemediaobject>
+	        <imageobject>
+	          <imagedata fileref="images/check.png" />
+	        </imageobject>
+	      </inlinemediaobject> This method supports Circular Strings and Curves </para>
 	  </refsection>
 	
 	  <refsection>
@@ -4780,6 +4799,16 @@
 -71.1775844305465 42.3903826677917,-71.1775825927231 42.3902893647987,-71.177684
 8522251 42.3902896512902));
 (1 row)
+
+--3D Circular String example
+SELECT ST_AsEWKT(ST_Transform(ST_GeomFromEWKT('SRID=2249;CIRCULARSTRING(743238 2967416 1,743238 2967450 2,743265 2967450 3,743265.625 2967416 3,743238 2967416 4)'),4326));
+
+                 st_asewkt                                                                                                      
+--------------------------------------------------------------------------------------
+ SRID=4326;CIRCULARSTRING(-71.1776848522251 42.3902896512902 1,-71.1776843766326 42.3903829478009 2,
+ -71.1775844305465 42.3903826677917 3,
+ -71.1775825927231 42.3902893647987 3,-71.1776848522251 42.3902896512902 4)
+
 		</programlisting>
 		<para>Example of creating a partial functional index.  For tables where you are not sure all the geometries
 			will be filled in, its best to use a partial index that leaves out null geometries which will both conserve space and make your index smaller and more efficient.</para>
@@ -4832,6 +4861,8 @@
 		<para>Returns a new geometry whose coordinates are translated delta x,delta y,delta z units. Units are
 		based on the units defined in spatial reference (SRID) for this geometry.</para>
 		
+		<note><para>Prior to 1.3.4, this function crashes if used with geometries that contain CURVES.  This is fixed in 1.3.4+</para></note>
+		
 		<para>Availability: 1.2.2</para>
 		<!-- Optionally mention 3d support -->	
 		<para><inlinemediaobject>
@@ -4839,6 +4870,13 @@
 				  <imagedata fileref="images/check.png" />
 				</imageobject>
 			  </inlinemediaobject> This function supports 3d and will not drop the z-index.</para>
+			  
+		<!-- Optionally mention Circular String Support -->
+	    <para><inlinemediaobject>
+	        <imageobject>
+	          <imagedata fileref="images/check.png" />
+	        </imageobject>
+	      </inlinemediaobject> This method supports Circular Strings and Curves </para>
 	  </refsection>
 	
 	  <refsection>
@@ -4863,6 +4901,12 @@
 	---------
 	POINT(5 12 3)	
 		</programlisting>
+		<para>Move a curve and a point</para>
+<programlisting>SELECT ST_AsText(ST_Translate(ST_Collect('CURVEPOLYGON(CIRCULARSTRING(4 3,3.12 0.878,1 0,-1.121 5.1213,6 7, 8 9,4 3))','POINT(1 3)'),1,2));
+		                                                 st_astext                                                  
+------------------------------------------------------------------------------------------------------------
+ GEOMETRYCOLLECTION(CURVEPOLYGON(CIRCULARSTRING(5 5,4.12 2.878,2 2,-0.121 7.1213,7 9,9 11,5 5)),POINT(2 5))
+</programlisting>
 	  </refsection>
 	
 	  <!-- Optionally add a "See Also" section -->