ncl_mplndr (3) - Linux Manuals

ncl_mplndr: Reads a specified EZMAP database and draws boundary lines from it.

NAME

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

SYNOPSIS

CALL MPLNDR (FLNM,ILVL)

C-BINDING SYNOPSIS

#include <ncarg/ncargC.h>

void c_mplndr (char *flnm, int ilvl)

DESCRIPTION

FLNM

(an input expression of type CHARACTER) specifies the name of the database to be used. MPLNDR will first look for the files of the specified database in the current working directory; if the files are not found there, MPLNDR will look for them in the NCAR Graphics database directory. The database created in 1998 and provided as part of Version 4.1 of NCAR Graphics is named "Earth..1".

ILVL

(an input expression of type INTEGER) specifies the level at which the database is to be used. The value 1 says to use only land/water boundaries, the value 2 says to add continental boundaries (like the boundary which separates Africa from Eurasia), the value 3 says to add the boundaries of countries, and the value 4 says to add states. (The value 5 will eventually be used to add counties.)

C-BINDING DESCRIPTION

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

USAGE

MPLNDR draws the lines defined by the map database whose name is FLNM; the EZMAP internal parameter 'DO' determines whether solid lines or dotted lines are used. If EZMAP currently needs initialization, MPLNDR does nothing except read some information from the map database, so that subsequent calls to EZMAPB functions will work properly.

The outlines are drawn using calls to MAPIT and MAPIQ. By default, MPLNDR forces the value of the internal parameter 'DL' equal to the value of the internal parameter 'DO'; it also supplies the dash package with a solid-line dash pattern. When 'DO' is zero, the outlines are drawn using calls to the routines FRSTD and VECTD, in the dash package, and this gives solid lines. When 'DO' is non-zero, the outlines are drawn using calls to the SPPS routine POINTS, which gives dotted lines. Before returning control to the user, MAPLOT restores the original value of 'DL' and the original dash pattern. A user version of the routine MPCHLN may be supplied to change the way in which the outlines are drawn.

EXAMPLES

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

ACCESS

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

COPYRIGHT

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.