ncl_areas man page

Areas — A set of routines allowing you to create an area map from a set of edges and then to use the area map for various purposes.

Synopsis

ARINAM - Initializes an area map.
AREDAM - Adds edges to an area map.
ARMVAM - Moves an area map from one integer array to another.
ARPRAM - Preprocesses an area map.
ARSCAM - Obtains definitions of areas created by edges in an area map.
ARDRLN - Draws a polyline masked by a given area map.
ARGTAI - Gets area identifiers associated with a given point.
ARGETI - Retrieves the integer value of an Areas parameter.
ARGETR - Retrieves the real value of an Areas parameter.
ARSETI - Provides a new integer value for an Areas parameter.
ARSETR - Provides a new real value for an Areas parameter.
ARDBPA - Produces a picture of a specified portion of the area map.

C-Binding Synopsis

#include <ncarg/ncargC.h>

c_arinam
c_aredam
c_arpram
c_arscam
c_ardrln
c_argtai
c_argeti
c_arseti
c_ardbpa

Access

To use the Areas Fortran or C routines, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

Messages

When error conditions are detected, the support routine SETER is called. By default, SETER writes a message to the standard error file (as defined by I1MACH(4)) and then terminates execution. It is possible to put SETER into recovery mode and regain control after a recoverable error (which includes all of the possible errors).

The possible error messages are listed below. All errors are recoverable in the sense that a user program which has called ENTSR to set recovery mode will get control back after one of these errors occurs.

ARDBDA - UNCLEARED PRIOR ERROR
ARDBPA - BAD POINTERS IN AREA MAP
ARDBPA - ERROR EXIT FROM GQPLCI
ARDBPA - ERROR EXIT FROM GQTXCI
ARDBPA - INITIALIZATION DONE IMPROPERLY
ARDBPA - UNCLEARED PRIOR ERROR
ARDRLN - ALGORITHM FAILURE
ARDRLN - INITIALIZATION DONE IMPROPERLY
ARDRLN - MAI TOO SMALL
ARDRLN - UNCLEARED PRIOR ERROR
AREDAM - AREA-MAP ARRAY OVERFLOW
AREDAM - INITIALIZATION DONE IMPROPERLY
AREDAM - UNCLEARED PRIOR ERROR
ARGETI - PARAMETER NAME NOT KNOWN - X
ARGETI - PARAMETER NAME TOO SHORT - X
ARGETI - UNCLEARED PRIOR ERROR
ARGETR - PARAMETER NAME NOT KNOWN - X
ARGETR - PARAMETER NAME TOO SHORT - X
ARGETR - UNCLEARED PRIOR ERROR
ARGTAI - ALGORITHM FAILURE
ARGTAI - INITIALIZATION DONE IMPROPERLY
ARGTAI - MAI TOO SMALL
ARGTAI - UNCLEARED PRIOR ERROR
ARINAM - AREA-MAP ARRAY IS TOO SMALL
ARINAM - UNCLEARED PRIOR ERROR
ARINIT - VALUE OF 'LC' IS TOO LARGE
ARMPIA - MULTIPLE-PRECISION QUANTITY IS TOO BIG
ARMVAM - INITIALIZATION DONE IMPROPERLY
ARMVAM - NEW AREA-MAP ARRAY IS TOO SMALL
ARMVAM - UNCLEARED PRIOR ERROR
ARPRAM - ALGORITHM FAILURE
ARPRAM - AREA-MAP ARRAY OVERFLOW
ARPRAM - INITIALIZATION DONE IMPROPERLY
ARPRAM - NO EDGES IN AREA MAP
ARPRAM - UNCLEARED PRIOR ERROR
ARSCAM - ALGORITHM FAILURE
ARSCAM - AREA-MAP ARRAY OVERFLOW
ARSCAM - INITIALIZATION DONE IMPROPERLY
ARSCAM - MAI TOO SMALL
ARSCAM - MCS TOO SMALL
ARSCAM - UNCLEARED PRIOR ERROR
ARSETI - PARAMETER NAME NOT KNOWN - X
ARSETI - PARAMETER NAME TOO SHORT - X
ARSETI - UNCLEARED PRIOR ERROR
ARSETR - PARAMETER NAME NOT KNOWN - X
ARSETR - PARAMETER NAME TOO SHORT - X
ARSETR - UNCLEARED PRIOR ERROR

See Also

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

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics Fundamentals, UNIX Version

Info

April 1995 UNIX NCAR GRAPHICS