PostGIS  3.7.0dev-r@@SVN_REVISION@@

◆ lwgeom_dimension()

int lwgeom_dimension ( const LWGEOM geom)

For an LWGEOM, returns 0 for points, 1 for lines, 2 for polygons, 3 for volume, and the max dimension of a collection.

Definition at line 1361 of file lwgeom.c.

1362 {
1363 
1364  /* Null? Zero. */
1365  if( ! geom ) return -1;
1366 
1367  LWDEBUGF(4, "lwgeom_dimension got type %s",
1368  lwtype_name(geom->type));
1369 
1370  /* Empty? Zero. */
1371  /* if( lwgeom_is_empty(geom) ) return 0; */
1372 
1373  switch (geom->type)
1374  {
1375  case POINTTYPE:
1376  case MULTIPOINTTYPE:
1377  return 0;
1378  case CIRCSTRINGTYPE:
1379  case LINETYPE:
1380  case COMPOUNDTYPE:
1381  case MULTICURVETYPE:
1382  case MULTILINETYPE:
1383  return 1;
1384  case TRIANGLETYPE:
1385  case POLYGONTYPE:
1386  case CURVEPOLYTYPE:
1387  case MULTISURFACETYPE:
1388  case MULTIPOLYGONTYPE:
1389  case TINTYPE:
1390  return 2;
1391  case POLYHEDRALSURFACETYPE:
1392  {
1393  /* A closed polyhedral surface contains a volume. */
1394  int closed = lwpsurface_is_closed((LWPSURFACE*)geom);
1395  return ( closed ? 3 : 2 );
1396  }
1397  case COLLECTIONTYPE:
1398  {
1399  int maxdim = 0;
1400  uint32_t i;
1401  LWCOLLECTION *col = (LWCOLLECTION*)geom;
1402  for( i = 0; i < col->ngeoms; i++ )
1403  {
1404  int dim = lwgeom_dimension(col->geoms[i]);
1405  maxdim = ( dim > maxdim ? dim : maxdim );
1406  }
1407  return maxdim;
1408  }
1409  default:
1410  lwerror("%s: unsupported input geometry type: %s",
1411  __func__, lwtype_name(geom->type));
1412  }
1413  return -1;
1414 }
#define COLLECTIONTYPE
Definition: liblwgeom.h:108
#define COMPOUNDTYPE
Definition: liblwgeom.h:110
#define CURVEPOLYTYPE
Definition: liblwgeom.h:111
#define MULTILINETYPE
Definition: liblwgeom.h:106
#define MULTISURFACETYPE
Definition: liblwgeom.h:113
#define LINETYPE
Definition: liblwgeom.h:103
#define MULTIPOINTTYPE
Definition: liblwgeom.h:105
#define POINTTYPE
LWTYPE numbers, used internally by PostGIS.
Definition: liblwgeom.h:102
#define TINTYPE
Definition: liblwgeom.h:116
#define MULTIPOLYGONTYPE
Definition: liblwgeom.h:107
#define POLYGONTYPE
Definition: liblwgeom.h:104
#define POLYHEDRALSURFACETYPE
Definition: liblwgeom.h:114
#define CIRCSTRINGTYPE
Definition: liblwgeom.h:109
const char * lwtype_name(uint8_t type)
Return the type name string associated with a type number (e.g.
Definition: lwutil.c:216
#define MULTICURVETYPE
Definition: liblwgeom.h:112
#define TRIANGLETYPE
Definition: liblwgeom.h:115
int lwpsurface_is_closed(const LWPSURFACE *psurface)
Definition: lwpsurface.c:99
int lwgeom_dimension(const LWGEOM *geom)
For an LWGEOM, returns 0 for points, 1 for lines, 2 for polygons, 3 for volume, and the max dimension...
Definition: lwgeom.c:1361
#define LWDEBUGF(level, msg,...)
Definition: lwgeom_log.h:106
void void lwerror(const char *fmt,...) __attribute__((format(printf
Write a notice out to the error handler.
uint32_t ngeoms
Definition: liblwgeom.h:580
LWGEOM ** geoms
Definition: liblwgeom.h:575
uint8_t type
Definition: liblwgeom.h:462

References CIRCSTRINGTYPE, COLLECTIONTYPE, COMPOUNDTYPE, CURVEPOLYTYPE, LWCOLLECTION::geoms, LINETYPE, LWDEBUGF, lwerror(), lwgeom_dimension(), lwpsurface_is_closed(), lwtype_name(), MULTICURVETYPE, MULTILINETYPE, MULTIPOINTTYPE, MULTIPOLYGONTYPE, MULTISURFACETYPE, LWCOLLECTION::ngeoms, POINTTYPE, POLYGONTYPE, POLYHEDRALSURFACETYPE, TINTYPE, TRIANGLETYPE, and LWGEOM::type.

Referenced by lwgeom_dimension(), LWGEOM_dimension(), lwgeom_node(), lwgeom_offsetcurve(), lwgeom_subdivide_prec(), and lwgeom_subdivide_recursive().

Here is the call graph for this function:
Here is the caller graph for this function: