NAME

       AREDAM - Adds edge segments to an area map.

SYNOPSIS

       CALL AREDAM (MAP,XCA,YCA,LCA,IGI,IDL,IDR)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_aredam (int *map, float *xca, float *yca, int lca, int igi, int idl, int idr)

DESCRIPTION

       MAP         (an  input/output  array  of  type  INTEGER)  - An array containing an area map that has been
                   initialized by a call to ARINAM.

                   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 AREDAM.)

       XCA         (an  input  array, dimensioned LCA, of type REAL) - The X coordinates, in the user coordinate
                   system, of the points defining an edge.

       YCA         (an input array, dimensioned LCA, of type REAL) - The Y coordinates, in the  user  coordinate
                   system, of the points defining an edge.

       LCA         (an input expression of type INTEGER) - The number of coordinates in XCA and YCA.

       IGI         (an input expression of type INTEGER) - Identifier of the group to which the edge belongs.

       IDL         (an  input  expression of type INTEGER) - Identifier of the area that lies to the left of the
                   edge.

       IDR         (an input expression of type INTEGER) - Identifier of the area that lies to the right of  the
                   edge.

C-BINDING DESCRIPTION

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

USAGE

       The  area-map  array  MAP must have been initialized by a call to ARINAM.  Each subsequent call to AREDAM
       adds to the area map the LCA-1 edge segments defined by the points whose  user  coordinates  are  in  the
       arrays  XCA  and YCA.  (Points 1 and 2 define the first edge segment, points 2 and 3 define the next edge
       segment, points 3 and 4 the next one, and so on.)

EXAMPLES

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

ACCESS

       To use AREDAM or c_aredam, 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,  argeti, argetr, argtai, arinam, armvam, arpram, arscam,
       arseti, arsetr, ncarg_cbind

       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial

COPYRIGHT

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

UNIX                                               March 1993                                     AREDAM(3NCARG)