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

NAME

6       ARMVAM - Moves an area map from one integer array to another.
7

SYNOPSIS

9       CALL ARMVAM (IAM,IAN,LAN)
10

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_armvam (int *iam, int *ian, int lan)
15

DESCRIPTION

17       IAM         (an input array of type INTEGER) - An array containing an
18                   area map that has at least been initialized by a call to
19                   ARINAM.
20
21                   Note: As part of initializing the area map, ARINAM stores
22                   the dimension of MAP in MAP(1); therefore, the dimension
23                   does not have to be given as an argument in calls to
24                   ARMVAM.)
25
26       IAN         (an input array, dimensioned LAN, of type INTEGER) - An
27                   array to which the area map in the array IAM is to be
28                   moved.
29
30       LAN         (an input expression of type INTEGER) - The length of the
31                   array IAN.  This may be less than or greater than the
32                   length of the array IAM.
33

C-BINDING DESCRIPTION

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

USAGE

39       This routine may be used for two purposes: 1) to pack an area map down
40       into the smallest possible space in the area map array; 2) during
41       recovery from an area map array overflow condition, to move the area
42       map from a smaller array to a larger array.
43
44       The area-map array IAM must at least have been initialized by a call to
45       ARINAM, and it may have appeared in calls to one or more of AREDAM,
46       ARPRAM, ARGTAI, ARDRLN, and ARSCAM. If the arrays IAM and IAN overlap
47       in memory, they must start at the same location in memory.
48

EXAMPLES

50       Use the ncargex command to see the following relevant examples: arex02.
51

ACCESS

53       To use ARMVAM or c_armvam, load the NCAR Graphics libraries ncarg,
54       ncarg_gks, and ncarg_c, preferably in that order.
55

MESSAGES

57       See the areas man page for a description of all Areas error messages
58       and/or informational messages.
59

SEE ALSO

61       Online: areas, areas_params, ardbpa, ardrln, argeti, argetr, argtai,
62       arinam, arpram, arscam, arseti, arsetr, ncarg_cbind
63
64       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
65

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