gdlShapeCreate - geographicdeterminationlibrary - 2024.00

Geographic Determination Library Reference for Windows and z/OS

Product type
Software
Portfolio
Locate
Product family
GeoStan Geocoding Suite
Product
GeoStan Geocoding Suite > Geographic Determination Library
Version
2024.00
Language
English
Product name
GeoStan Geocoding Suite
Title
Geographic Determination Library Reference for Windows and z/OS
Topic type
Reference
Copyright
2024
First publish date
1994
ft:lastEdition
2024-05-09
ft:lastPublication
2024-05-09T00:55:21.277227

Creates a shape of a given type with specified coordinates.

Syntax

intl gdlShapeCreate( gdlHandle hGdl, gdlShape* shape, char* name, intl type, double* x, double* y, intl* pointsPerPart, intl partCount);

Arguments

hGdl

The gdlHandle initialized by gdlInitialize. Input.

shape

A pointer to the new gdlShape object. Output.

name

The name of the object being created. Input.

type

The type of shape to create. Input.

Type options:

GDL Shape Types
GDL_POINT
GDL_LINE
GDL_POLYGON

x

An array of x coordinates in decimal degrees. Input.

y

An array of y coordinates in decimal degrees. Input.

pointsPerPart

An array of integers indicating the number of points in each part. Input.

partCount

The number of parts. Input.

Return values

GDL_WRONG_TYPE

GDL_NOT_FOUND

GDL_ERROR

GDL_OK

Prerequisites

gdlInitialize

Alternates

None.

Notes

Following instances of this function, you should call gdlShapeFree with the output shape when you are finished using the output shape to release system resources.