DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

(mysql.info.gz) General geometry property functions

Info Catalog (mysql.info.gz) Geometry property functions (mysql.info.gz) Geometry property functions (mysql.info.gz) Point property functions
 
 18.5.2.1 General Geometry Functions
 ...................................
 
 The functions listed in this section do not restrict their argument and
 accept a geometry value of any type.
 
 `Dimension(G)'
      Returns the inherent dimension of the geometry value G. The result
      can be -1, 0, 1, or 2. (The meaning of these values is given in
       GIS class geometry.)
 
           mysql> SELECT Dimension(GeomFromText('LineString(1 1,2 2)'));
           +------------------------------------------------+
           | Dimension(GeomFromText('LineString(1 1,2 2)')) |
           +------------------------------------------------+
           |                                              1 |
           +------------------------------------------------+
 
 `Envelope(G)'
      Returns the Minimum Bounding Rectangle (MBR) for the geometry
      value G.  The result is returned as a `Polygon' value.
 
           mysql> SELECT AsText(Envelope(GeomFromText('LineString(1 1,2 2)')));
           +-------------------------------------------------------+
           | AsText(Envelope(GeomFromText('LineString(1 1,2 2)'))) |
           +-------------------------------------------------------+
           | POLYGON((1 1,2 1,2 2,1 2,1 1))                        |
           +-------------------------------------------------------+
 
      The polygon is defined by the corner points of the bounding box:
 
           POLYGON((MINX MINY, MAXX MINY, MAXX MAXY, MINX MAXY, MINX MINY))
 
 `GeometryType(G)'
      Returns as a string the name of the geometry type of which the
      geometry instance G is a member.  The name will correspond to one
      of the instantiable `Geometry' subclasses.
 
           mysql> SELECT GeometryType(GeomFromText('POINT(1 1)'));
           +------------------------------------------+
           | GeometryType(GeomFromText('POINT(1 1)')) |
           +------------------------------------------+
           | POINT                                    |
           +------------------------------------------+
 
 `SRID(G)'
      Returns an integer indicating the Spatial Reference System ID for
      the geometry value G.
 
      In MySQL, the SRID value is just an integer associated with the
      geometry value. All calculations are done assuming Euclidean
      (planar) geometry.
 
           mysql> SELECT SRID(GeomFromText('LineString(1 1,2 2)',101));
           +-----------------------------------------------+
           | SRID(GeomFromText('LineString(1 1,2 2)',101)) |
           +-----------------------------------------------+
           |                                           101 |
           +-----------------------------------------------+
 
 
 The OpenGIS specification also defines the following functions, which
 MySQL does not implement:
 
 `Boundary(G)'
      Returns a geometry that is the closure of the combinatorial
      boundary of the geometry value G.
 
 `IsEmpty(G)'
      Returns 1 if the geometry value G is the empty geometry, 0 if it
      is not empty, and -1 if the argument is `NULL'.  If the geometry
      is empty, it represents the empty point set.
 
 `IsSimple(G)'
      Currently, this function is a placeholder and should not be used.
      If implemented, its behavior will be as described in the next
      paragraph.
 
      Returns 1 if the geometry value G has no anomalous geometric
      points, such as self-intersection or self-tangency. `IsSimple()'
      returns 0 if the argument is not simple, and -1 if it is `NULL'.
 
      The description of each instantiable geometric class given earlier
      in the chapter includes the specific conditions that cause an
      instance of that class to be classified as not simple.
 
 
Info Catalog (mysql.info.gz) Geometry property functions (mysql.info.gz) Geometry property functions (mysql.info.gz) Point property functions
automatically generated byinfo2html