KPG1_INCOx

Obtains a list of co-ordinates from the environment

Description:

The supplied parameter is used to get a list of co-ordinates from the environment. These co-ordinates are stored in dynamic workspace which is expanded as necessary so that any number of points can be given. The user indicates the end of the list of points by a null value. Pointers to the workspace arrays holding the co-ordinates are returned, and should be annulled when no longer needed by calling PSX_FREE.

Invocation

CALL KPG1_INCOx( PNAME, NDIM, NPOINT, IPCO, STATUS )

Arguments

PNAME = CHARACTER ∗ ( ∗ ) (Given)
Name of the parameter with which to associate the co-ordinates.
NDIM = INTEGER (Returned)
The number of co-ordinate dimensions. It must be positive and no more than DAT__MXDIM.
NPOINT = INTEGER (Returned)
The number of points specified.
IPCO = INTEGER (Returned)
A pointer to workspace of type <HTYPE > and size NDIM by NPOINT holding the co-ordinates of each point.
STATUS = INTEGER (Given and Returned)
The global status.

Notes: