Section 3: library functions
MAPIQM – Terminates a string of calls to the routine MAPITM. SynopsisCALL MAPIQM (IAMA,XCRA,YCRA,MCRA,IAAI,IAGI,NOGI,ULPR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapiqm (int *iama, float *xcra, float *ycra, int mcra, int *iaai, int *iagi, int nogi, int (*ulpr)(float *xcra, float *ycra, int *mcra, int *iaai, int *iagi, int *nogi)) Description IAMA (an input/output array of type INTEGER, dimensioned…
MAPIQD – Terminates a string of calls to MAPITD. SynopsisCALL MAPIQD C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapiqd() DescriptionMAPIQD has no arguments. UsageMAPIQD flushes MAPITD’s buffers. It is particularly important that this be done before a STOP or a CALL FRAME, and before changing the color index, dash pattern, etc. For more information, see the man page…
MAPIQA – Terminates a string of calls to MAPITA. SynopsisCALL MAPIQA (IAMA,IGID,IAIL,IAIR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapiqa (int *iama, int igid, int iail, int iair) void c_mapita (float rlat, float rlon, int ifst, int *iama, int igid, int iail, int iair) DescriptionIAMA (an input/output array of type INTEGER, dimensioned as specified in a call to…
MAPIQ – Terminates a string of calls to MAPIT. SynopsisCALL MAPIQ C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapiq() DescriptionMAPIQ has no arguments. UsageMAPIQ flushes MAPIT’s buffers. It is particularly important that this be done before a STOP or a CALL FRAME, and before changing the color index, dash pattern, etc. For more information, see the man page…
MAPINT – Initialization. SynopsisCALL MAPINT C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapint() DescriptionMAPINT has no arguments. UsageMAPINT is required initially and again after a call to any of the routines MAPPOS, MAPROJ, or MAPSET. The flag ‘IN’, which may be retrieved by a call to MAPGTI or MAPGTL, indicates whether or not initialization is required at a…
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…
MAPGRM – Draws lines of latitude and longitude masked against an existing area map. SynopsisCALL MAPGRM (IAMA,XCRA,YCRA,MCRA,IAAI,IAGI,MNOG,ULPR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapgrm (int *iama, float *xcra, float *ycra, int mcra, int *iaai, int *iagi, int mnog, int (*ulpr)(float *xcra, float *ycra, int *ncs, int *iaai, int *iagi, int *nai)) DescriptionIAMA (an input/output array, dimensioned as…
MAPGRD – Draws a lat/lon grid. SynopsisCALL MAPGRD C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapgrd() DescriptionMAPGRD has no arguments. UsageThe statement: CALL MAPGRD draws a grid consisting of lines of constant latitude (parallels) and lines of constant longitude (meridians), spaced as specified by the value of the internal parameter ‘GR’. If EZMAP needs initialization or if the…
MAPGCI – Returns a set of points on the shortest great circle route between two user-specified points on the globe. SynopsisCALL MAPGCI(ALAT,ALON,BLAT,BLON,NOPI,RLTI,RLNI) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapgci( float alat, float alon, float blat, float blon, int nopi, float *rlti, float *rlni) DescriptionALAT and ALON (input expressions, of type REAL) are the latitude and longitude of…
MAPFST – Draws lines on a map – used in conjunction with MAPVEC. SynopsisCALL MAPFST (RLAT,RLON) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapfst (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…
MAPEOD – Called by the EZMAP routines MAPLOT and MAPBLA. The default version does nothing. A user-written version may be supplied to examine each outline-dataset segment and, perhaps, to delete selected ones. Note that this routine is not called by any of the EZMAPB routines; for the same purpose, they call the routine MPCHLN. SynopsisCALL…
MAPDRW – Draws the complete map described by the current values of the internal parameters of EZMAP. Note that this routine uses whichever old outline dataset is selected by the value of the internal parameter ‘OU’; to access the new map database "Earth..1", which was created in 1998, one must call instead the routines that…
MAPBLM – Draws geographical outlines masked against an existing area map. Note that this routine uses whichever old outline dataset is selected by the value of the internal parameter ‘OU’; to access the new map database "Earth..1", which was created in 1998, one must call instead the EZMAPB routine MPLNDM. SynopsisCALL MAPBLM (IAMA,XCRA,YCRA,MCRA,IAAI,IAGI,MNOG,ULPR) C-Binding Synopsis#include…
MAPBLA – Adds to the area map in the array IAMA the set of boundary lines, of projected geographical entities, determined by the current state of the internal parameters of EZMAP. Note that this routine uses whichever old outline dataset is selected by the value of the internal parameter ‘OU’; to access the new map…
MAPACI – Normally used to pick colors for the areas created by the boundary lines added to an area map by a call to MAPBLA. Note that this function should not be used to select color indices for areas defined by the new map database "Earth..1", which was created in 1998; for that purpose, use…
LINED – Draws a line segment between two points whose user coordinates are given. SynopsisCALL LINED (XA,XB,YA,YB) C-Binding Synopsis#include <ncarg/ncargC.h> void c_lined (float xa, float xb, float ya, float yb) DescriptionXA (an input expression of type REAL) defines the X user coordinate of the starting point of a line segment. YA (an input expression of…
LINE3 – Draws the straight-line segment joining the projections of two points in 3-space. SynopsisCALL LINE3 (UA,VA,WA,UB,VB,WB) C-Binding Synopsis#include <ncarg/ncargC.h> void c_line3 (float ua, float va, float wa, float ub, float vb, float wb) DescriptionUA,VA,WA (input expressions of type REAL) are the coordinates of the first point in 3-space. UB,VB,WB (input expressions of type REAL)…