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