File Geodatabase API
FileGDBAPI::MultiPointShapeBuffer Class Reference

MultiPoint Shape Buffer accessor functions. More...

Inherits FileGDBAPI::ShapeBuffer.

Public Member Functions

fgdbError GetExtent (double *&extent) const
 Get a pointer to the geomtries extent. More...
 
fgdbError GetNumPoints (int &numPoints) const
 Get the number of coordinates in the geometry. More...
 
fgdbError GetPoints (Point *&points) const
 Get a pointer to the point array. More...
 
fgdbError GetZExtent (double *&zExtent) const
 Get a pointer to the z extent. More...
 
fgdbError GetZs (double *&zArray) const
 Get a pointer to the z array. More...
 
fgdbError GetMExtent (double *&mExtent) const
 Get a pointer to the m extent. More...
 
fgdbError GetMs (double *&mArray) const
 Get a pointer to the m array. More...
 
fgdbError GetIDs (int *&ids) const
 Get a pointer to the id array. More...
 
fgdbError Setup (ShapeType shapeType, int numPoints)
 Setup a shape buffer for insert. More...
 
fgdbError CalculateExtent (void)
 Calculates the extent for the shape after all of the coordinate arrays have been filled. More...
 
- Public Member Functions inherited from FileGDBAPI::ShapeBuffer
bool Allocate (size_t length)
 Allocates a byte array of the specified size. More...
 
bool IsEmpty (void) const
 Is the ShapeBuffer empty. More...
 
void SetEmpty (void)
 Set the ShapeBuffer empty.
 
fgdbError GetShapeType (ShapeType &shapeType) const
 Gets the shape type from the shape buffer. More...
 
fgdbError GetGeometryType (GeometryType &geometryType) const
 Gets the geometry type which corresponds to the shape type in the shape buffer. More...
 
 ShapeBuffer (size_t length=0)
 The class constructor.
 
virtual ~ShapeBuffer ()
 The class destructor.
 

Additional Inherited Members

- Static Public Member Functions inherited from FileGDBAPI::ShapeBuffer
static bool HasZs (ShapeType shapeType)
 Does the shape buffer contain Z values. More...
 
static bool HasMs (ShapeType shapeType)
 Does the shape buffer contain Ms. More...
 
static bool HasIDs (ShapeType shapeType)
 Does the shape buffer contain IDs. More...
 
static bool HasCurves (ShapeType shapeType)
 Does the shape buffer contain Curves. More...
 
static bool HasNormals (ShapeType shapeType)
 Does the shape buffer includes Normals. More...
 
static bool HasTextures (ShapeType shapeType)
 Does the shape buffer include Textures. More...
 
static bool HasMaterials (ShapeType shapeType)
 Does the shape buffer include Materials. More...
 
static GeometryType GetGeometryType (ShapeType shapeType)
 Gets the geometry type from a shape type. More...
 
- Public Attributes inherited from FileGDBAPI::ShapeBuffer
byte * shapeBuffer
 The underlying byte array.
 
size_t allocatedLength
 The capacity of the byte array.
 
size_t inUseLength
 The number of bytes being used in the array.
 

Detailed Description

MultiPoint Shape Buffer accessor functions.

These functions provide access to the shape buffer. Consult the extended shapefile format document for the buffer layout. When reading a multipoint shape buffer you should first create the appropriate shape buffer, get the geometry, get the number of points, get a pointer to the part array, get a pointer to the point array, and, if present, pointers to the z, m, and id arrays. To write a multipoint shape buffer create a row buffer, create a shape buffer, set up the shape buffer, get the points, assign the coordinates to the point array, and if needed get the z, m, id and curve arrays and populate, calculate the extent of the geometry, set the geometry and insert the row. To improve load use Table::LoadOnlyMode. Set it to true before you insert any rows and set it too false when finished. If all grid size values in the spatial index are zero, the values will be calculated based on the existing geometries.

Member Function Documentation

fgdbError FileGDBAPI::MultiPointShapeBuffer::GetExtent ( double *&  extent) const

Get a pointer to the geomtries extent.

Parameters
[out]extentA pointer to the geometries extent.
Returns
Error code indicating whether the method finished successfully.
fgdbError FileGDBAPI::MultiPointShapeBuffer::GetNumPoints ( int &  numPoints) const

Get the number of coordinates in the geometry.

Parameters
[out]numPointsThe number of points.
Returns
Error code indicating whether the method finished successfully.
fgdbError FileGDBAPI::MultiPointShapeBuffer::GetPoints ( Point *&  points) const

Get a pointer to the point array.

Parameters
[out]pointsA pointer to the coordinate array.
Returns
Error code indicating whether the method finished successfully.
fgdbError FileGDBAPI::MultiPointShapeBuffer::GetZExtent ( double *&  zExtent) const

Get a pointer to the z extent.

Parameters
[out]zExtentA pointer to the z extent.
Returns
Error code indicating whether the method finished successfully.
fgdbError FileGDBAPI::MultiPointShapeBuffer::GetZs ( double *&  zArray) const

Get a pointer to the z array.

Parameters
[out]zArrayA pointer to the z array.
Returns
Error code indicating whether the method finished successfully.
fgdbError FileGDBAPI::MultiPointShapeBuffer::GetMExtent ( double *&  mExtent) const

Get a pointer to the m extent.

Parameters
[out]mExtentA pointer to the m extent.
Returns
Error code indicating whether the method finished successfully.
fgdbError FileGDBAPI::MultiPointShapeBuffer::GetMs ( double *&  mArray) const

Get a pointer to the m array.

Parameters
[out]mArrayA pointer to the m array.
Returns
Error code indicating whether the method finished successfully.
fgdbError FileGDBAPI::MultiPointShapeBuffer::GetIDs ( int *&  ids) const

Get a pointer to the id array.

Parameters
[out]idsA pointer to the id array.
Returns
Error code indicating whether the method finished successfully.
fgdbError FileGDBAPI::MultiPointShapeBuffer::Setup ( ShapeType  shapeType,
int  numPoints 
)

Setup a shape buffer for insert.

Allocates the correct length buffer for the selected shape type.

Parameters
[in]shapeTypeThe shape type of the buffer. Shape Type
[in]numPointsThe number of points to be loaded.
Returns
Error code indicating whether the method finished successfully.
fgdbError FileGDBAPI::MultiPointShapeBuffer::CalculateExtent ( void  )

Calculates the extent for the shape after all of the coordinate arrays have been filled.

Returns
Error code indicating whether the method finished successfully.