Section 3: library functions
MAPTRN – Projects points. SUPCON is an alternate name for the routine MAPTRN. SynopsisCALL MAPTRN (RLAT, RLON, UVAL, VVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_maptrn (float rlat, float rlon, float *uval, float *vval) DescriptionRLAT and RLON (input expressions, of type REAL) are the latitude and longitude, respectively, of a point on the globe. RLAT must be…
MAPTRI – Performs inverse transformations. SynopsisCALL MAPTRI (UVAL,VVAL,RLAT,RLON) C-Binding Synopsis#include <ncarg/ncargC.h> void c_maptri (float uval, float vval, float *rlat, float *rlon) DescriptionUVAL and VVAL (input expressions, of type REAL) define the point (UVAL,VVAL) that is the projection in the u/v plane of the point whose latitude and longitude are desired. The units of UVAL and…
MAPTRA – Projects points. SynopsisCALL MAPTRA (RLAT,RLON,UVAL,VVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_maptra (float rlat, float rlon, float *uval, float *vval) DescriptionRLAT and RLON (input expressions, of type REAL) are the latitude and longitude, respectively, of a point on the globe. RLAT must be between -90. and +90., inclusive; RLON must be between -540. and +540.,…
MAPSTR – Sets the values of certain EZMAP parameters of type REAL. MPSETR is an alternate name for the routine MAPSTR. SynopsisCALL MAPSTR (PNAM,RVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapstr (char *pnam, float rval) DescriptionPNAM (an input expression, of type CHARACTER*2) specifies the name of an internal parameter whose value is to be set. Only the…
MAPSTL – Sets the values of certain EZMAP parameters of type LOGICAL. MPSETL is an alternate name for the routine MAPSTL. SynopsisCALL MAPSTL (PNAM,LVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapstl (char *pnam, int lval) DescriptionPNAM (an input expression, of type CHARACTER*2) specifies the name of an internal parameter whose value is to be set. Only the…
MAPSTI – Sets the values of certain EZMAP parameters of type INTEGER. MPSETI is an alternate name for the routine MAPSTI. SynopsisCALL MAPSTI (PNAM,IVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapsti (char *pnam, int ival) DescriptionPNAM (an input expression, of type CHARACTER*2) specifies the name of an internal parameter whose value is to be set. Only the…
MAPSTC – Sets the values of certain EZMAP parameters of type CHARACTER. MPSETC is an alternate name for the routine MAPSTC. SynopsisCALL MAPSTC (PNAM,CVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapstc(char *pnam, char *cval) DescriptionPNAM (an input expression, of type CHARACTER*2) specifies the name of an internal parameter whose value is to be set. Only the first…
MAPSET – Specifies the rectangular portion of the u/v plane to be drawn. SynopsisCALL MAPSET (JLTS, PLM1, PLM2, PLM3, PLM4) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapset (char *jlts, float *plm1, float *plm2, float *plm3, float *plm4) DescriptionJLTS (an input expression, of type CHARACTER) is a character string specifying how the limits of the map are to…
MAPSAV – Saves the current state of EZMAP for later restoration by MAPRST. SynopsisCALL MAPSAV (INFO) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapsav (int info) DescriptionINFO (an input expression, of type INTEGER) is the number of a unit to which a single unformatted record is to be written. It is the user’s responsibility to position this unit….
MAPRST – Restores the state of EZMAP saved by an earlier call to MAPSAV. SynopsisCALL MAPRST (INFO) C-Binding Synopsis#include <ncarg/ncargC.h> void c_maprst (int info) DescriptionINFO (an input expression, of type INTEGER) is the number of a unit from which a single unformatted record is to be read. It is the user’s responsibility to position this…
MAPRS – Re-calls SET. SynopsisCALL MAPRS C-Binding Synopsis#include <ncarg/ncargC.h> void c_maprs() DescriptionMAPRS has no arguments. UsageThis routine allows you to have the SPPS routine SET re-called with the same arguments that MAPINT would use, but executes a little faster than MAPINT. This is useful when you are about to call one of the routines MAPBLA,…
MAPROJ – Sets the map projection to be used. SynopsisCALL MAPROJ (JPRJ, PLAT, PLON, ROTA) C-Binding Synopsis#include <ncarg/ncargC.h> void c_maproj (char *jprj, float plat, float plon, float rota) DescriptionJPRJ (an input expression, of type CHARACTER) defines the desired projection type. All the possible values are two characters in length; these are the possibilities: The conic…
MAPPOS – Positions the map on the plotter frame. SynopsisCALL MAPPOS (XLOW,XROW,YBOW,YTOW) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mappos (float xlow, float xrow, float ybow, float ytow) DescriptionXLOW (an input expression, of type REAL) specifies the position of the left edge of the window. The default is .05. XROW (an input expression, of type REAL) specifies the…
MAPLOT – Draws geographical outlines. 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 MPLNDR. SynopsisCALL MAPLOT C-Binding Synopsis#include <ncarg/ncargC.h> void c_maplot() DescriptionMAPLOT has no arguments….
MAPLMB – Draws a limb line. SynopsisCALL MAPLMB C-Binding Synopsis#include <ncarg/ncargC.h> void c_maplmb() DescriptionIn many filled or masked maps, you may need a limb line. You can draw a limb line by calling MAPLMB. ExamplesUse the ncargex command to see the following relevant example: mpex07. AccessTo use MAPLMB or c_maplmb, load the NCAR Graphics libraries…
MAPLBL – Labels the map. SynopsisCALL MAPLBL C-Binding Synopsis#include <ncarg/ncargC.h> void c_maplbl() DescriptionMAPLBL has no arguments. UsageIf the parameter ‘LA’ is set appropriately, MAPLBL labels the international date line (ID), the equator (EQ), the Greenwich Meridian (GM), and the poles (NP and SP), and if the parameter ‘PE’ is set appropriately, it draws the perimeter…
MAPITM – Draws lines on a map, masked by a specified area map. Synopsis CALL MAPITM (RLAT,RLON,IFST,IAMA,XCRA,YCRA,MCRA,IAAI,IAGI, + NOGI,ULPR) CALL MAPIQM (IAMA,XCRA,YCRA,MCRA,IAAI,IAGI,NOGI,ULPR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapitm (float rlat, float rlon, int ifst, 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…
MAPITD – Draws lines on a map. MAPITD is just like MAPIT, but, ultimately, DASHPACK routines are called instead of DASHCHAR routines. SynopsisCALL MAPITD (RLAT,RLON,IFST) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapitd (float rlat, float rlon, int ifst) Description RLAT and RLON(input expressions, of type REAL) specify the latitude and longitude of a point to which the…
MAPITA – Adds to an area map the projections of lines defined by a series of lat/lon coordinates. SynopsisCALL MAPITA (RLAT,RLON,IFST,IAMA,IGID,IAIL,IAIR) CALL MAPIQA (IAMA,IGID,IAIL,IAIR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapita (float rlat, float rlon, int ifst, int *iama, int igid, int iail, int iair) void c_mapiqa (int *iama, int igid, int iail, int iair) Description RLAT…
MAPIT – Draws lines on a map. SynopsisCALL MAPIT (RLAT,RLON,IFST) C-Binding Synopsis#include <ncarg/ncargC.h> void c_mapit (float rlat, float rlon, int ifst) Description RLAT 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 must be between – 90. and…