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

NAME

6       MAPACI - Normally used to pick colors for the areas created by the
7       boundary lines added to an area map by a call to MAPBLA.  Note that
8       this function should not be used to select color indices for areas
9       defined by the new map database "Earth..1", which was created in 1998;
10       for that purpose, use EZMAPB functions instead (in particular, MPISCI).
11

SYNOPSIS

13       ICIR=MAPACI(IAID)
14

C-BINDING SYNOPSIS

16       #include <ncarg/ncargC.h>
17
18       int c_mapaci (int iaid)
19

DESCRIPTION

21       IAID        (an input expression of type INTEGER) is an area identifier
22                   for one of the areas defined by the set of boundary lines
23                   added to an area map by a call to MAPBLA.
24

C-BINDING DESCRIPTION

26       The C-binding argument description is the same as the FORTRAN argument
27       description.
28

USAGE

30       Executing the statement "ICIR=MAPACI(IAID)" gives ICIR a value between
31       1 and 7, inclusive, that may be used to select a color index for the
32       area whose area identifier is IAID.  It is guaranteed that MAPACI will
33       not return the same value for adjacent areas; this fact can be used to
34       ensure that adjacent areas will have different colors.
35
36       Note that it is the responsibility of the user to define the colors
37       associated with color indices used; this is done by calling the GKS
38       routine GSCR.
39

EXAMPLES

41       Use the ncargex command to see the following relevant example: eezmpa.
42

ACCESS

44       To use MAPACI or c_mapaci, load the NCAR Graphics libraries ncarg,
45       ncarg_gks, and ncarg_c, preferably in that order.
46

SEE ALSO

48       Online: ezmap, ezmap_params, mapbla, mapblm, mapdrw, mapeod, mapfst,
49       mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint, mapiq,
50       mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl, maplmb,
51       maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc, mapsti,
52       mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln, mpfnme,
53       mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola,
54       mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri,
55       mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
56       ncarg_cbind
57
58       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
59

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