SYNOPSIS

CALL MPLNAM (FLNM,ILVL,IAMA)

C-BINDING SYNOPSIS

#include <ncarg/ncargC.h>

void c_mplnam (char *flnm, int ilvl, int *iama)

DESCRIPTION

FLNM

(an input expression of type CHARACTER) specifies the name of the database to be used. MPLNAM will first look for the files of the specified database in the current working directory; if the files are not found there, MPLNAM 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.)

IAMA

(an input/output array of type INTEGER) is the area map array to which boundary lines are to be added.

C-BINDING DESCRIPTION

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

USAGE

Calling MPLNAM adds boundary lines to the area map in the array IAMA. The area map must previously have been initialized by calling the routine ARINAM, in the package AREAS, using a statement like "CALL ARINAM (IAMA,LAMA)", where LAMA is the length of the array IAMA. The area map may subsequently be used in various ways; for example, one may call the AREAS routine ARSCAM to draw a solid-filled map.

One or two groups of boundary lines are added to the area map by a call to MPLNAM. The first, having group identifier 'G1' (default value 1), consists of a perimeter (either rectangular or elliptical, depending on the value of the internal parameter 'EL') and the set of projected boundary lines implied by the user's selection of a map database and level. For certain projections, a limb line may also be included.

If the parameter 'VS' has a value greater than zero, the group 'G2' is added to the area map; it consists of a copy of the perimeter and the limb line (if any) plus a set of vertical lines splitting the area inside the perimeter into 'VS' vertical strips. (By default, the value of 'VS' is 1.) The object of the group 'G2' is to split areas up, reducing the number of points required to define a typical area below the level at which some target hardware device begins to fail. (This is more important when using MPLNAM than it was when using MAPBLA because the new database is at a higher resolution.)

The perimeter and the limb in the groups 'G1' and 'G2' have the following left and right area identifiers:

0

Identifies the area inside the perimeter or limb.

-1

Identifies the area outside the perimeter or limb.

The vertical lines in the group 'G2' have left and right area identifiers of 0.

To set the values of 'G1', 'G2', and 'VS', call the EZMAP routine MAPSTI. To get the current values of 'G1', 'G2', and 'VS', call the EZMAP routine MAPGTI. See the man pages for MAPSTI and MAPGTI.

EXAMPLES

Use the ncargex command to see the following relevant examples: mpex11, tezmpb.

ACCESS

To use MPLNAM or c_mplnam, 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.