VECCreateShape()

  VECSetVertices

Description

VECCreateShape() is used to create a new vector shape on a layer.

Call Signature

int VECCreateShape ( int/string filespec, int segment_num [, int new_shapeid] )

Return Value

int

The shape id of the new shape. -1 is returned if an error occurs.

Arguments

int/string filespec:

This can either be the handle returned by DBOpen(), or the name of an open file.

int segment_num:

The vector layer (segment) number being accessed.

[ int new_shapeid ]:

The suggested new shape id for the shape to be created. This argument is optional and may be ignored by some formats.

Remarks

A shape consists of a list of zero or more vertices and a record of attributes consisting of fields. The returned shape id may be passed to other intrinsic functions such as VECSetVertices() and VECSetField().

See also

GDB file functions

GDB vector file functions

VECDeleteShape()

© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.