Section 3: library functions
MPLNDM – Reads a specified EZMAP database and draws boundary lines from it, masked by a specified area map. SynopsisCALL MPLNDM (FLNM,ILVL,IAMA,XCRA,YCRA,MCRA,IAAI,IAGI,NOGI,ULPR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mplndm (char *flnm, int ilvl, int *iama, float *xcra, float *ycra, int mcra, int *iaai, int *iagi, int nogi, int (*ulpr_)(float *xcra, float *ycra, int *ncra, int *iaai, int…
MPLNAM – Reads a specified EZMAP database and sends boundary lines from it to a specified area map. SynopsisCALL 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…
MPISCI – Given the area identifier of one of the areas defined by whatever database was last read by one of the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI, this function returns a suggested color index for that area. SynopsisISCI=MPISCI(IAIN) C-Binding Synopsis#include <ncarg/ncargC.h> int c_mpisci (int iain) DescriptionIAIN is an input expression of type INTEGER,…
MPIPAR – Given the area identifier of one of the areas defined by whatever database was last read by one of the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI, this function returns the area identifier of that area’s containing (parent) area. SynopsisIPAR=MPIPAR(IAIN) C-Binding Synopsis#include <ncarg/ncargC.h> int c_mpipar (int iain) DescriptionIAIN is an input expression of…
MPIPAN – Given the area identifier of one of the areas defined by whatever database was last read by the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI and a name, this function has a non-zero value if and only if the area with the specified area identifier is part of some area with the specified…
MPIPAI – Given the area identifiers of two of the areas defined by whatever database was last read by the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI, this function has a non-zero value if and only if the first area is a part of the second. SynopsisIPRT=MPIPAI(IAIN,IAIP) C-Binding Synopsis#include <ncarg/ncargC.h> int c_mpipai (int iain, int…
MPIOSA – Given the area identifier of one of the areas defined by whatever database was last read by one of the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI, this function returns the area identifier of the smallest area, at a specified level, that contains it. SynopsisIOSA=MPIOSA(IAIN,ILVL) C-Binding Synopsis#include <ncarg/ncargC.h> int c_mpiosa (int iaid, int…
MPIOLA – Given the area identifier of one of the areas defined by whatever database was last read by one of the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI, this function returns the area identifier of the largest area, at a specified level, that contains it. SynopsisIOLA=MPIOLA(IAIN,ILVL) C-Binding Synopsis#include <ncarg/ncargC.h> int c_mpiola (int iaid, int…
MPILNB – A simple utility function that finds the index of the last non-blank character in a character string. SynopsisILNB=MPILNB(CHRS) C-Binding Synopsis#include <ncarg/ncargC.h> int c_mpilnb (char *chrs) DescriptionCHRS is an input expression of type CHARACTER.C-Binding DescriptionThe C-binding argument description is the same as the FORTRAN argument description. UsageThe statement "ILNB=MPILNB(CHRS)" sets the value of ILNB…
MPIFNB – A simple utility function that finds the index of the first non-blank character in a character string. SynopsisIFNB=MPIFNB(CHRS) C-Binding Synopsis#include <ncarg/ncargC.h> int c_mpifnb (char *chrs) DescriptionCHRS is an input expression of type CHARACTER.C-Binding DescriptionThe C-binding argument description is the same as the FORTRAN argument description. UsageThe statement "IFNB=MPIFNB(CHRS)" sets the value of IFNB…
MPIATY – Given the area identifier of one of the areas defined by whatever database was last read by one of the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI, this function returns the area type of the area. SynopsisIATY=MPIATY(IAIN) C-Binding Synopsis#include <ncarg/ncargC.h> int c_mpiaty (int iain) DescriptionIAIN is an input expression of type INTEGER, specifying…
MPGLTY – Retrieves the type of the line currently being drawn by MPLNDM. SynopsisCALL MPGLTY (ILTY) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mpglty (int *ilty) Description ILTY (an output variable of type INTEGER) is the type of the line: 1 => a line separating land from water, 2 => a line separating one "continent" from another (as,…
MAPGTR – Gets the current value of a specified EZMAP parameter of type REAL. MPGETR is an alternate name for the routine MAPGTR. SynopsisCALL MAPGTR (PNAM,RVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapgtr (char *pnam, float *rval) DescriptionPNAM (an input expression of type CHARACTER) specifies the name of the parameter to get. Only the first two characters…
MAPGTL – Gets the current value of a specified EZMAP parameter of type LOGICAL. MPGETL is an alternate name for the routine MAPGTL. SynopsisCALL MAPGTL (PNAM,LVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapgtl (char *pnam, int *lval) DescriptionPNAM (an input expression of type CHARACTER) specifies the name of the parameter to get. Only the first two characters…
MAPGTI – Gets the current value of a specified EZMAP parameter of type INTEGER. MPGETI is an alternate name for the routine MAPGTI. SynopsisCALL MAPGTI (PNAM,IVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapgti (char *pnam, int *ival) DescriptionPNAM (an input expression of type CHARACTER) specifies the name of the parameter to get. Only the first two characters…
MAPGTC – Gets the current value of a specified EZMAP parameter of type CHARACTER. MPGETC is an alternate name for the routine MAPGTC. SynopsisCALL MAPGTC (PNAM,CVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapgtc (char *pnam, char *cval, int len) DescriptionPNAM (an input expression of type CHARACTER) specifies the name of the parameter to get. Only the first…
MPFNME – Given the area identifier of one of the areas defined by whatever database was last read by one of the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI, this function returns the full name of the area, including the prepended names of all containing (parent) areas, up to and including a specified level. SynopsisCHARACTER*128…
MPCHLN – This routine is called repeatedly as boundary lines are processed by MPLNAM, MPLNDM, and MPLNDR. The default version of the routine does nothing. A user-supplied version may take action to change various characteristics of the lines. SynopsisCALL MPCHLN (IACT,ILTY,IOAL,IOAR,NPTS,PNTS) C-Binding SynopsisNone. Description IACT(an input expression of type INTEGER) specifies which of the EZMAPB…
MAPVEC – Draws lines on a map – used in conjunction with MAPFST. SynopsisCALL MAPVEC (RLAT,RLON) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapvec (float rlat, float rlon) DescriptionRLAT and RLON (input expressions, of type REAL) specify the latitude and longitude of a point to which the "pen" is to be moved. Both are given in degrees. RLAT…
MAPUSR – Called by EZMAP routines that draw the various parts of the map. The default version does nothing. A user-written version may be supplied to change the appearance of the map. Note that this routine is not called by any of the EZMAPB routines; they call MPCHLN instead. SynopsisCALL MAPUSR (IPRT) Description IPRT (input…