1AREDAM(3NCARG)                   NCAR GRAPHICS                  AREDAM(3NCARG)
2
3
4

NAME

6       AREDAM - Adds edge segments to an area map.
7

SYNOPSIS

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

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_aredam (int *map, float *xca, float *yca, int lca, int igi, int
15       idl, int idr)
16

DESCRIPTION

18       MAP         (an input/output array of type INTEGER) - An array
19                   containing an area map that has been initialized by a call
20                   to ARINAM.
21
22                   Note: As part of initializing the area map, ARINAM stores
23                   the dimension of MAP in MAP(1); therefore, the dimension
24                   does not have to be given as an argument in calls to
25                   AREDAM.)
26
27       XCA         (an input array, dimensioned LCA, of type REAL) - The X
28                   coordinates, in the user coordinate system, of the points
29                   defining an edge.
30
31       YCA         (an input array, dimensioned LCA, of type REAL) - The Y
32                   coordinates, in the user coordinate system, of the points
33                   defining an edge.
34
35       LCA         (an input expression of type INTEGER) - The number of
36                   coordinates in XCA and YCA.
37
38       IGI         (an input expression of type INTEGER) - Identifier of the
39                   group to which the edge belongs.
40
41       IDL         (an input expression of type INTEGER) - Identifier of the
42                   area that lies to the left of the edge.
43
44       IDR         (an input expression of type INTEGER) - Identifier of the
45                   area that lies to the right of the edge.
46

C-BINDING DESCRIPTION

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

USAGE

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

EXAMPLES

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

ACCESS

64       To use AREDAM or c_aredam, load the NCAR Graphics libraries ncarg,
65       ncarg_gks, and ncarg_c, preferably in that order.
66

MESSAGES

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

SEE ALSO

72       Online: areas, areas_params, ardbpa, ardrln, argeti, argetr, argtai,
73       arinam, armvam, arpram, arscam, arseti, arsetr, ncarg_cbind
74
75       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
76

78       Copyright (C) 1987-2007
79       University Corporation for Atmospheric Research
80
81       This documentation is free software; you can redistribute it and/or
82       modify it under the terms of the GNU General Public License as
83       published by the Free Software Foundation; either version 2 of the
84       License, or (at your option) any later version.
85
86       This software is distributed in the hope that it will be useful, but
87       WITHOUT ANY WARRANTY; without even the implied warranty of
88       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
89       General Public License for more details.
90
91       You should have received a copy of the GNU General Public License along
92       with this software; if not, write to the Free Software Foundation,
93       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
94
95
96
97UNIX                              March 1993                    AREDAM(3NCARG)
Impressum