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

NAME

6       MAPITA - Adds to an area map the projections of lines defined by a
7       series of lat/lon coordinates.
8

SYNOPSIS

10       CALL MAPITA (RLAT,RLON,IFST,IAMA,IGID,IAIL,IAIR)
11
12       CALL MAPIQA (IAMA,IGID,IAIL,IAIR)
13

C-BINDING SYNOPSIS

15       #include <ncarg/ncargC.h>
16
17       void c_mapita (float rlat, float rlon, int ifst,
18       int *iama, int igid, int iail, int iair)
19
20       void c_mapiqa (int *iama, int igid, int iail, int iair)
21

DESCRIPTION

23       RLAT and RLON
24                   (input expressions, of type REAL) specify the latitude and
25                   longitude of a point to which the "pen" is to be moved.
26                   Both are given in degrees. RLAT must be between -90. and
27                   +90., inclusive; RLON must be between -540. and +540.,
28                   inclusive.
29
30       IFST        (an input expression, of type INTEGER) is 0 to do a "pen-
31                   up" move, 1 to do a "pen-down" move only if the distance
32                   from the last point to the new point is greater than 'MV'
33                   plotter units, and 2 or greater to do a "pen-down" move
34                   regardless of the distance from the last point to the new
35                   one.
36
37       IAMA        (an input/output array of type INTEGER, dimensioned as
38                   specified in a call to the AREAS initialization routine
39                   ARINAM) is the area map to which lines in MAPITA's buffer
40                   are to be added.
41
42       IGID        (an input expression of type INTEGER) is the group
43                   identifier to be passed to the AREAS routine AREDAM when
44                   the lines in MAPITA's buffer are added to the area map in
45                   IAMA.
46
47       IAIL        (an input expression of type INTEGER) is the left area
48                   identifier to be passed to the AREAS routine AREDAM when
49                   the lines in MAPITA's buffer are added to the area map in
50                   IAMA.
51
52       IAIR        (an input expression of type INTEGER) is the right area
53                   identifier to be passed to the AREAS routine AREDAM when
54                   the lines in MAPITA's buffer are added to the area map in
55                   IAMA.
56

C-BINDING DESCRIPTION

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

USAGE

62       The routines MAPITA and MAPIQA may be used to add lines defined by a
63       set of user-specified latitudes and longitudes to an area map; they
64       attempt to omit non-visible portions of lines and to handle "cross-
65       over", in the same way that MAPIT does.
66
67       MAPITA is called like the EZMAP routine MAPIT, but it has some
68       additional arguments:
69
70           CALL MAPITA (RLAT,RLON,IFST,IAMA,IGID,IAIL,IAIR)
71
72       Additional arguments are the area map array IAMA, a group identifier
73       IGID, and left and right area identifiers IAIL and IAIR. MAPIQA is
74       called like the EZMAP routine MAPIQ, to terminate a series of calls to
75       MAPITA and to flush the buffers; it has the same additional arguments:
76
77           CALL MAPIQA (IAMA,IGID,IAIL,IAIR)
78
79       The additional arguments are passed by MAPITA and MAPIQA to the routine
80       AREDAM, in the package named AREAS.
81
82       For more information, see the man page for the routine MAPIT.
83

EXAMPLES

85       Use the ncargex command to see the following relevant examples: cmpita,
86       cpex08.
87

ACCESS

89       To use MAPITA or c_mapita, load the NCAR Graphics libraries ncarg,
90       ncarg_gks, and ncarg_c, preferably in that order.
91

SEE ALSO

93       Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod,
94       mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint,
95       mapiq, mapiqa, mapiqd, mapiqm, mapit, mapitd, mapitm, maplbl, maplmb,
96       maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc, mapsti,
97       mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln, mpfnme,
98       mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola,
99       mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri,
100       mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
101       ncarg_cbind
102
103       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
104

106       Copyright (C) 1987-2009
107       University Corporation for Atmospheric Research
108       The use of this Software is governed by a License Agreement.
109
110
111
112UNIX                              March 1993                    MAPITA(3NCARG)
Impressum