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

NAME

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

SYNOPSIS

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

C-BINDING SYNOPSIS

24       #include <ncarg/ncargC.h>
25
26       c_arinam
27       c_aredam
28       c_arpram
29       c_arscam
30       c_ardrln
31       c_argtai
32       c_argeti
33       c_arseti
34       c_ardbpa
35

ACCESS

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

MESSAGES

41       When error conditions are detected, the support routine SETER is
42       called. By default, SETER writes a message to the standard error file
43       (as defined by I1MACH(4)) and then terminates execution.  It is
44       possible to put SETER into recovery mode and regain control after a
45       recoverable error (which includes all of the possible errors).
46
47       The possible error messages are listed below.  All errors are
48       recoverable in the sense that a user program which has called ENTSR to
49       set recovery mode will get control back after one of these errors
50       occurs.
51
52            ARDBDA - UNCLEARED PRIOR ERROR
53            ARDBPA - BAD POINTERS IN AREA MAP
54            ARDBPA - ERROR EXIT FROM GQPLCI
55            ARDBPA - ERROR EXIT FROM GQTXCI
56            ARDBPA - INITIALIZATION DONE IMPROPERLY
57            ARDBPA - UNCLEARED PRIOR ERROR
58            ARDRLN - ALGORITHM FAILURE
59            ARDRLN - INITIALIZATION DONE IMPROPERLY
60            ARDRLN - MAI TOO SMALL
61            ARDRLN - UNCLEARED PRIOR ERROR
62            AREDAM - AREA-MAP ARRAY OVERFLOW
63            AREDAM - INITIALIZATION DONE IMPROPERLY
64            AREDAM - UNCLEARED PRIOR ERROR
65            ARGETI - PARAMETER NAME NOT KNOWN - X
66            ARGETI - PARAMETER NAME TOO SHORT - X
67            ARGETI - UNCLEARED PRIOR ERROR
68            ARGETR - PARAMETER NAME NOT KNOWN - X
69            ARGETR - PARAMETER NAME TOO SHORT - X
70            ARGETR - UNCLEARED PRIOR ERROR
71            ARGTAI - ALGORITHM FAILURE
72            ARGTAI - INITIALIZATION DONE IMPROPERLY
73            ARGTAI - MAI TOO SMALL
74            ARGTAI - UNCLEARED PRIOR ERROR
75            ARINAM - AREA-MAP ARRAY IS TOO SMALL
76            ARINAM - UNCLEARED PRIOR ERROR
77            ARINIT - VALUE OF 'LC' IS TOO LARGE
78            ARMPIA - MULTIPLE-PRECISION QUANTITY IS TOO BIG
79            ARMVAM - INITIALIZATION DONE IMPROPERLY
80            ARMVAM - NEW AREA-MAP ARRAY IS TOO SMALL
81            ARMVAM - UNCLEARED PRIOR ERROR
82            ARPRAM - ALGORITHM FAILURE
83            ARPRAM - AREA-MAP ARRAY OVERFLOW
84            ARPRAM - INITIALIZATION DONE IMPROPERLY
85            ARPRAM - NO EDGES IN AREA MAP
86            ARPRAM - UNCLEARED PRIOR ERROR
87            ARSCAM - ALGORITHM FAILURE
88            ARSCAM - AREA-MAP ARRAY OVERFLOW
89            ARSCAM - INITIALIZATION DONE IMPROPERLY
90            ARSCAM - MAI TOO SMALL
91            ARSCAM - MCS TOO SMALL
92            ARSCAM - UNCLEARED PRIOR ERROR
93            ARSETI - PARAMETER NAME NOT KNOWN - X
94            ARSETI - PARAMETER NAME TOO SHORT - X
95            ARSETI - UNCLEARED PRIOR ERROR
96            ARSETR - PARAMETER NAME NOT KNOWN - X
97            ARSETR - PARAMETER NAME TOO SHORT - X
98            ARSETR - UNCLEARED PRIOR ERROR
99
100

SEE ALSO

102       Online: areas_params, ardbpa, ardrln, aredam, argeti, argetr, argtai,
103       arinam, armvam, arpram, arscam, arseti, arsetr, ncarg_cbind
104
105       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
106       Fundamentals, UNIX Version
107

109       Copyright (C) 1987-2007
110       University Corporation for Atmospheric Research
111
112       This documentation is free software; you can redistribute it and/or
113       modify it under the terms of the GNU General Public License as
114       published by the Free Software Foundation; either version 2 of the
115       License, or (at your option) any later version.
116
117       This software is distributed in the hope that it will be useful, but
118       WITHOUT ANY WARRANTY; without even the implied warranty of
119       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
120       General Public License for more details.
121
122       You should have received a copy of the GNU General Public License along
123       with this software; if not, write to the Free Software Foundation,
124       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
125
126
127
128UNIX                              April 1995                     Areas(3NCARG)
Impressum