From: Regina Obe Date: Thu, 17 Jul 2008 12:14:54 +0000 (+0000) Subject: Move ST_BuildArea expand on definition, provide example, Move ST_BdPolyFromText and... X-Git-Tag: 1.4.0b1~832 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=8d050f4d771d71bad78899c22188cd20b0e2bc48;p=postgis Move ST_BuildArea expand on definition, provide example, Move ST_BdPolyFromText and ST_BdMPolyFromText git-svn-id: http://svn.osgeo.org/postgis/trunk@2867 b70326c6-7e19-0410-871a-916f4a2858ee --- diff --git a/doc/reference.xml b/doc/reference.xml index d848cf8b4..8b29396b7 100644 --- a/doc/reference.xml +++ b/doc/reference.xml @@ -1000,48 +1000,8 @@ GROUP BY gid, field1,field2; throws an error if WKB is not a GEOMETRYCOLLECTION + - - ST_BdPolyFromText(text WKT, integer SRID) - - - Construct a Polygon given an arbitrary collection of closed - linestrings as a MultiLineString text representation. - - Throws an error if WKT is not a MULTILINESTRING. Throws an - error if output is a MULTIPOLYGON; use BdMPolyFromText in that case, or - see BuildArea() for a - postgis-specific approach. - - OGC SFSQL 1.1 - 3.2.6.2 - - Availability: 1.1.0 - requires GEOS >= 2.1.0. - - - - - ST_BdMPolyFromText(text WKT, integer SRID) - - - Construct a MultiPolygon given an arbitrary collection of - closed linestrings as a MultiLineString text - representation. - - Throws an error if WKT is not a MULTILINESTRING. Forces - MULTIPOLYGON output even when result is really only composed by a - single POLYGON; use BdPolyFromText if you're sure a - single POLYGON will result from operation, or see BuildArea() for a postgis-specific - approach. - - OGC SFSQL 1.1 - 3.2.6.2 - - Availability: 1.1.0 - requires GEOS >= 2.1.0. - - - @@ -1729,24 +1689,6 @@ FROM - - ST_BuildArea(geometry) - - - Creates an areal geometry formed by the constituent linework - of given geometry. The return type can be a Polygon or - MultiPolygon, depending on input. If the input lineworks do not - form polygons NULL is returned. - - See also BdPolyFromText and BdMPolyFromText - wrappers to - this function with standard OGC interface. - - Availability: 1.1.0 - requires GEOS >= 2.1.0. - - - ST_Polygonize(geometry set) diff --git a/doc/reference_new.xml b/doc/reference_new.xml index 47fb4c41b..77e465b63 100644 --- a/doc/reference_new.xml +++ b/doc/reference_new.xml @@ -349,7 +349,180 @@ Check constraints: - Geometry Constructors + Geometry Constructors + + + ST_BdPolyFromText + + Construct a Polygon given an arbitrary collection of closed + linestrings as a MultiLineString Well-Known text representation. + + + + + + geometery ST_BdPolyFromText + text WKT + + + + + + Description + + Construct a Polygon given an arbitrary collection of closed + linestrings as a MultiLineString Well-Known text representation. + + + + Throws an error if WKT is not a MULTILINESTRING. Throws an + error if output is a MULTIPOLYGON; use ST_BdMPolyFromText in that case, or + see ST_BuildArea() for a + postgis-specific approach. + + + + + + + + This method implements the OpenGIS Simple Features + Implementation Specification for SQL. OGC SFSQL 1.1 - 3.2.6.2 + + Availability: 1.1.0 - requires GEOS >= 2.1.0. + + + + Examples + + Forthcoming + + + + See Also + , + + + + + ST_BdMPolyFromText + Construct a MultiPolygon given an arbitrary collection of + closed linestrings as a MultiLineString text + representation Well-Known text representation. + + + + + + geometery ST_BdMPolyFromText + text WKT + + + + + + Description + + Construct a Polygon given an arbitrary collection of closed + linestrings, polygons, MultiLineStrings as Well-Known text representation. + + + + Throws an error if WKT is not a MULTILINESTRING. Forces + MULTIPOLYGON output even when result is really only composed by a + single POLYGON; use BdPolyFromText if you're sure a + single POLYGON will result from operation, or see BuildArea() for a postgis-specific + approach. + + + + + + + + This method implements the OpenGIS Simple Features + Implementation Specification for SQL. OGC SFSQL 1.1 - 3.2.6.2 + + Availability: 1.1.0 - requires GEOS >= 2.1.0. + + + + Examples + + Forthcoming + + + + See Also + , + + + + + ST_BuildArea + + Creates an areal geometry formed by the constituent linework + of given geometry + + + + + + boolean ST_BuildArea + geometry A + + + + + + Description + + Creates an areal geometry formed by the constituent linework + of given geometry. The return type can be a Polygon or + MultiPolygon, depending on input. If the input lineworks do not + form polygons NULL is returned. The inputs can be LINESTRINGS, MULTILINESTRINGS, POLYGONS, MULTIPOLYGONS, and GeometryCollections. + + This function will assume all inner geometries represent holes + Availability: 1.1.0 - requires GEOS >= 2.1.0. + + + + Examples + + +--This will create a donut +SELECT ST_BuildArea(ST_Collect(smallc,bigc)) +FROM (SELECT ST_Buffer(ST_GeomFromText('POINT(1 2)'), 10) As smallc, + ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As bigc) As foo + +--This will create a gaping hole +--inside the circle with prongs sticking out +SELECT ST_BuildArea(ST_Collect(line,circle)) +FROM (SELECT ST_Buffer(ST_MakeLine(ST_MakePoint(21, 22),ST_MakePoint(-19, -18)),1) As line, + ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As circle) As foo; + +--this creates the same gaping hole +--but using linestrings instead of polygons +SELECT ST_AsBinary(ST_BuildArea(ST_Collect(ST_ExteriorRing(line),ST_ExteriorRing(circle)))) +FROM (SELECT ST_Buffer(ST_MakeLine(ST_MakePoint(21, 22),ST_MakePoint(-19, -18)),1) As line, + ST_Buffer(ST_GeomFromText('POINT(1 2)'), 20) As circle) As foo + + + + + See Also + + + , + wrappers to + this function with standard OGC interface + + + ST_MakeLine