1MAPIQM(3NCARG)                   NCAR GRAPHICS                  MAPIQM(3NCARG)
2
3
4

NAME

6       MAPIQM - Terminates a string of calls to the routine MAPITM.
7

SYNOPSIS

9       CALL MAPIQM (IAMA,XCRA,YCRA,MCRA,IAAI,IAGI,NOGI,ULPR)
10

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_mapiqm (int *iama, float *xcra, float *ycra,
15       int mcra, int *iaai, int *iagi, int nogi,
16       int (*ulpr)(float *xcra, float *ycra, int *mcra,
17       int *iaai, int *iagi, int *nogi))
18

DESCRIPTION

20       IAMA        (an input/output array of type INTEGER, dimensioned as
21                   specified in a call to the AREAS initialization routine
22                   ARINAM) is the array containing the area map against which
23                   lines drawn by MAPIQM will be masked.
24
25       XCRA and YCRA
26                   (scratch arrays of type REAL, each dimensioned MCRA) are to
27                   be passed by MAPIQM to the AREAS routine ARDRLN, which uses
28                   them in calls to the user line-processing routine ULPR.
29                   They will hold the X and Y coordinates of points in the
30                   fractional coordinate system defining some portion of the
31                   projection of a user-defined polyline on the globe.
32
33       MCRA        (an input expression of type INTEGER) is the size of each
34                   of the arrays XCRA and YCRA. The value of MCRA must be at
35                   least two. For most applications, the value 100 works
36                   nicely.
37
38       IAAI and IAGI
39                   (scratch arrays of type INTEGER, each dimensioned NOGI) are
40                   to be passed by MAPIQM to the AREAS routine ARDRLN, which
41                   uses them in calls to the user line-processing routine
42                   ULPR. They will hold area identifier/group identifier pairs
43                   for the area containing the polyline fragment defined by
44                   XCRA and YCRA.
45
46       NOGI        (an input expression of type INTEGER) is the size of each
47                   of the arrays IAAI and IAGI. The value of NOGI must be
48                   greater than or equal to the number of groups of edges
49                   placed in the area map in IAMA.
50
51       ULPR        is the name of a user-provided line-processing routine.
52                   This name must appear in an EXTERNAL statement in the
53                   routine that calls MAPITM, so that the compiler and loader
54                   will know that it is the name of a routine to be called,
55                   rather than the name of a variable.
56

C-BINDING DESCRIPTION

58       The C-binding argument descriptions are the same as the FORTRAN
59       argument descriptions.
60

USAGE

62       You must call MAPITM once for each point along the line.  After the
63       last call to MAPITM for a given line, you must call MAPIQM to signal
64       the end of the line.
65
66       For more information, see the man pages for the routines MAPIT and
67       MAPITM.  SH EXAMPLES Use the ncargex command to see the following
68       relevant example: cmpitm,
69

ACCESS

71       To use MAPIQM or c_mapiqm, load the NCAR Graphics libraries ncarg,
72       ncarg_gks, and ncarg_c, preferably in that order.
73

SEE ALSO

75       Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod,
76       mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint,
77       mapiq, mapiqa, mapiqd, mapit, mapita, mapitd, mapitm, maplbl, maplmb,
78       maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc, mapsti,
79       mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln, mpfnme,
80       mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola,
81       mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri,
82       mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
83       ncarg_cbind
84
85       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
86
88       Copyright (C) 1987-2009
89       University Corporation for Atmospheric Research
90       The use of this Software is governed by a License Agreement.
91
92
93
94UNIX                              March 1993                    MAPIQM(3NCARG)
Impressum