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

NAME

6       MPLNDR - Reads a specified EZMAP database and draws boundary lines from
7       it.
8

SYNOPSIS

10       CALL MPLNDR (FLNM,ILVL)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_mplndr (char *flnm, int ilvl)
16

DESCRIPTION

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
26       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

C-BINDING DESCRIPTION

36       The C-binding argument description is the same as the FORTRAN argument
37       description.
38

USAGE

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
46       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

EXAMPLES

59       Use the ncargex command to see the following relevant example: tezmpb.
60

ACCESS

62       To use MPLNDR or c_mplndr, load the NCAR Graphics libraries ncarg,
63       ncarg_gks, and ncarg_c, preferably in that order.
64

SEE ALSO

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-2009
78       University Corporation for Atmospheric Research
79       The use of this Software is governed by a License Agreement.
80
81
82
83UNIX                              April 1998                    MPLNDR(3NCARG)
Impressum