IDLffShape::PutEntity

Syntax | Arguments | Keywords | Examples | Version History

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