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

NAME

6       MPISCI - Given the area identifier of one of the areas defined by
7       whatever database was last read by one of the EZMAPB routines MPLNAM,
8       MPLNDM, MPLNDR, and MPLNRI, this function returns a suggested color
9       index for that area.
10

SYNOPSIS

12       ISCI=MPISCI(IAIN)
13

C-BINDING SYNOPSIS

15       #include <ncarg/ncargC.h>
16
17       int c_mpisci (int iain)
18

DESCRIPTION

20       IAIN        is an input expression of type INTEGER, specifying the area
21                   identifier of a particular area of interest.
22

C-BINDING DESCRIPTION

24       The C-binding argument description is the same as the FORTRAN argument
25       description.
26

USAGE

28       The statement "ISCI=MPISCI(IAIN)" retrieves in ISCI the suggested color
29       index for the area with area identifier IAIN.  For example, if IMAD is
30       the area identifier of the little island in Lake Superior called "Lake
31       Madeline", then MPISCI(IMAD) has the value 6.  The suggested color
32       indices are defined in such a way as to ensure that areas that touch
33       each other have different color indices.
34
35       To get a suggested color index for the area, at a specified level, that
36       contains the area with a specified area identifier, use MPISCI in
37       combination with MPIOAR (which see).  For example,
38       MPISCI(MPIOAR(IMAD,4)) has the value 6, which is the color index for
39       "Wisconsin" or any portion thereof, and MPISCI(MPIOAR(IMAD,2)) = 5,
40       which is the color index for "North America".
41

EXAMPLES

43       Use the ncargex command to see the following relevant examples: mpex11,
44       mpex12.
45

ACCESS

47       To use MPISCI or c_mpisci, load the NCAR Graphics libraries ncarg,
48       ncarg_gks, and ncarg_c, preferably in that order.
49

SEE ALSO

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

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