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-2007
107       University Corporation for Atmospheric Research
108
109       This documentation is free software; you can redistribute it and/or
110       modify it under the terms of the GNU General Public License as
111       published by the Free Software Foundation; either version 2 of the
112       License, or (at your option) any later version.
113
114       This software is distributed in the hope that it will be useful, but
115       WITHOUT ANY WARRANTY; without even the implied warranty of
116       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
117       General Public License for more details.
118
119       You should have received a copy of the GNU General Public License along
120       with this software; if not, write to the Free Software Foundation,
121       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
122
123
124
125UNIX                              March 1993                    MAPITA(3NCARG)
Impressum