1MPLNDR(3NCARG) NCAR GRAPHICS MPLNDR(3NCARG)
2
6 MPLNDR - Reads a specified EZMAP database and draws boundary lines from
7 it.
8
10 CALL MPLNDR (FLNM,ILVL)
11
13 #include <ncarg/ncargC.h>
14 void c_mplndr (char *flnm, int ilvl)
16
18 FLNM (an input expression of type CHARACTER) specifies the name
19 of the database to be used. MPLNDR will first look for the
20 files of the specified database in the current working
21 directory; if the files are not found there, MPLNDR will
22 look for them in the NCAR Graphics database directory. The
23 database created in 1998 and provided as part of Version
24 4.1 of NCAR Graphics is named "Earth..1".
25 ILVL (an input expression of type INTEGER) specifies the level
27 at which the database is to be used. The value 1 says to
28 use only land/water boundaries, the value 2 says to add
29 continental boundaries (like the boundary which separates
30 Africa from Eurasia), the value 3 says to add the
31 boundaries of countries, and the value 4 says to add
32 states. (The value 5 will eventually be used to add
33 counties.)
34
36 The C-binding argument description is the same as the FORTRAN argument
37 description.
38
40 MPLNDR draws the lines defined by the map database whose name is FLNM;
41 the EZMAP internal parameter 'DO' determines whether solid lines or
42 dotted lines are used. If EZMAP currently needs initialization, MPLNDR
43 does nothing except read some information from the map database, so
44 that subsequent calls to EZMAPB functions will work properly.
45 The outlines are drawn using calls to MAPIT and MAPIQ. By default,
47 MPLNDR forces the value of the internal parameter 'DL' equal to the
48 value of the internal parameter 'DO'; it also supplies the dash package
49 with a solid-line dash pattern. When 'DO' is zero, the outlines are
50 drawn using calls to the routines FRSTD and VECTD, in the dash package,
51 and this gives solid lines. When 'DO' is non-zero, the outlines are
52 drawn using calls to the SPPS routine POINTS, which gives dotted lines.
53 Before returning control to the user, MAPLOT restores the original
54 value of 'DL' and the original dash pattern. A user version of the
55 routine MPCHLN may be supplied to change the way in which the outlines
56 are drawn.
57
59 Use the ncargex command to see the following relevant example: tezmpb.
60
62 To use MPLNDR or c_mplndr, load the NCAR Graphics libraries ncarg,
63 ncarg_gks, and ncarg_c, preferably in that order.
64
66 Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod,
67 mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint,
68 mapiq, mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl,
69 maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc,
70 mapsti, mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln,
71 mpfnme, mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb,
72 mpiola, mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplnri,
73 mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
74 ncarg_cbind
75
77 Copyright (C) 1987-2007
78 University Corporation for Atmospheric Research
79 This documentation is free software; you can redistribute it and/or
81 modify it under the terms of the GNU General Public License as
82 published by the Free Software Foundation; either version 2 of the
83 License, or (at your option) any later version.
84 This software is distributed in the hope that it will be useful, but
86 WITHOUT ANY WARRANTY; without even the implied warranty of
87 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
88 General Public License for more details.
89 You should have received a copy of the GNU General Public License along
91 with this software; if not, write to the Free Software Foundation,
92 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
93UNIX April 1998 MPLNDR(3NCARG)