NAME

       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

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.