Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


  >  Docs Center  >  IDL Reference  >  I/O - Other Data Formats  >  IDLffShape::PutEntity

IDLffShape::PutEntity

IDLffShape::PutEntity

The IDLffShape::PutEntity procedure method inserts an entity into the Shapefile object. The entity must be in the proper structure. For more information on the structure, see Entities.

Note: The shape type of the new entity must be the same as the shape type defined for the Shapefile. If the shape type has not been defined for the Shapefile using the ENTITY_TYPE keyword for the IDLffShape::Open or IDLffShape::Init methods, the first entity that is inserted into the Shapefile defines the type.

Note: Only new entities can be inserted into a Shapefile. Existing entities cannot be updated.

Syntax


Obj->[IDLffShape::]PutEntity, Data

Arguments


Data

A scalar or an array of entity structures.

Keywords


None

Examples


In the following example, we create a new shapefile, define a new entity, and then use the PutEntity method to insert it into the new file:

PRO ex_shapefile_putentity
 
  ; Create the new shapefile and define the entity type to Point.
  mynewshape=OBJ_NEW('IDLffShape', DIALOG_PICKFILE(FILE='shape_entity.shp', /WRITE), $
     	/UPDATE, ENTITY_TYPE=1)
   
  ; Create structure for new entity.
  entNew = {IDL_SHAPE_ENTITY}
   
  ; Define the values for the new entity.
  entNew.SHAPE_TYPE = 1
  entNew.BOUNDS[0] = -104.87270
  entNew.BOUNDS[1] = 39.768040
  entNew.BOUNDS[2] = 0.00000000
  entNew.BOUNDS[3] = 0.00000000
  entNew.BOUNDS[4] = -104.87270
  entNew.BOUNDS[5] = 39.768040
  entNew.BOUNDS[6] = 0.00000000
  entNew.BOUNDS[7] = 0.00000000
   
  ; Add the new entity to new shapefile.
  mynewshape->PutEntity, entNew
   
  ; Close the shapefile
  mynewshape->Close
   
  ; Close the shapefile.
  OBJ_DESTROY, mynewshape
 
END

Version History


5.4

Introduced



© 2018 Harris Geospatial Solutions, Inc. |  Privacy Policy
My Account    |    Store    |    Contact Us