1MAPIQM(3NCARG) NCAR GRAPHICS MAPIQM(3NCARG)
2
6 MAPIQM - Terminates a string of calls to the routine MAPITM.
7
9 CALL MAPIQM (IAMA,XCRA,YCRA,MCRA,IAAI,IAGI,NOGI,ULPR)
10
12 #include <ncarg/ncargC.h>
13 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
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 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 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 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 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 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
58 The C-binding argument descriptions are the same as the FORTRAN
59 argument descriptions.
60
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 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
71 To use MAPIQM or c_mapiqm, load the NCAR Graphics libraries ncarg,
72 ncarg_gks, and ncarg_c, preferably in that order.
73
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 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
86
88 Copyright (C) 1987-2007
89 University Corporation for Atmospheric Research
90 This documentation is free software; you can redistribute it and/or
92 modify it under the terms of the GNU General Public License as
93 published by the Free Software Foundation; either version 2 of the
94 License, or (at your option) any later version.
95 This software is distributed in the hope that it will be useful, but
97 WITHOUT ANY WARRANTY; without even the implied warranty of
98 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
99 General Public License for more details.
100 You should have received a copy of the GNU General Public License along
102 with this software; if not, write to the Free Software Foundation,
103 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
104UNIX March 1993 MAPIQM(3NCARG)