ncl_argtai - Man Page

Returns the area identifiers associated with a given point.

Synopsis

CALL ARGTAI (MAP,XCD,YCD,IAI,IAG,MAI,NAI,ICF)

C-Binding Synopsis

#include <ncarg/ncargC.h>

void c_argtai (int *map, float xcd, float ycd, int *iai, int *iag,  int mai, int *nai, int icf)

Description

MAP

(an input/output array of type INTEGER) - An array containing an area map that has been initialized by a call to ARINAM and to which edges have been added by calls to AREDAM.  If you did not preprocess the area map by calling ARPRAM, ARGTAI calls it before doing anything else.

Note: As part of initializing the area map, ARINAM stores the dimension of MAP in MAP(1); therefore, the dimension does not have to be given as an argument in calls to ARGTAI.)

XCD

(an input expression of type REAL) -  The X coordinate, in the current  user coordinate system, of a point about which  you want to obtain information.

YCD

(an input expression of type REAL) -  The Y coordinate, in the current user  coordinate system, of a point about which you want to  obtain information.

IAI

(an output array, dimensioned MAI, of type INTEGER) -  The array in which area identifiers for the area containing the specified point will be returned.

IAG

(an output array, dimensioned MAI, of type INTEGER) -  The array in which group identifiers for the area containing the specified point will be returned.

MAI

(an input expression of type INTEGER) -  Dimension of each of the arrays IAI and  IAG. MAI must be greater than or equal to NAI.

NAI

(an output expression of type INTEGER) -  The number of values returned in IAI and  IAG. NAI equals the number of groups of edges that you  put in the area map.

ICF

(an input expression of type INTEGER) -  Flag set nonzero by you to indicate that  the definition of the user coordinate system has been  changed since the last call to ARGTAI; in this case, calls  to GETSET must be executed by ARGTAI. If you set the  flag to zero, Areas assumes that the information  retrieved previously is still correct and skips calls to  GETSET. This option is valuable if you are  planning to make thousands of calls to ARGTAI  with the same area map: do the first one with ICF = 1 and the rest with ICF = 0.

C-Binding Description

The C-binding argument descriptions are the same as the FORTRAN  argument descriptions.

Examples

Use the ncargex command to see the following relevant examples:  carfill, carline, carmap, cbex01, tareas, fsppoint.

Access

To use ARGTAI or c_argtai, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

Messages

See the areas man page for a description of all Areas error messages and/or informational messages.

See Also

Online: areas, areas_params, ardbpa, ardrln, aredam, argeti, argetr, arinam, armvam, arpram, arscam, arseti, arsetr, ncarg_cbind

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

Info

March 1993 UNIX NCAR GRAPHICS