1MAPTRN(3NCARG) NCAR GRAPHICS MAPTRN(3NCARG)
2
3
4
6 MAPTRN - Projects points.
7
8 SUPCON is an alternate name for the routine MAPTRN.
9
11 CALL MAPTRN (RLAT, RLON, UVAL, VVAL)
12
14 #include <ncarg/ncargC.h>
15
16 void c_maptrn (float rlat, float rlon, float *uval,
17 float *vval)
18
20 RLAT and RLON
21 (input expressions, of type REAL) are the latitude and
22 longitude, respectively, of a point on the globe. RLAT must
23 be between -90. and +90., inclusive; RLON must be between
24 -540. and +540., inclusive.
25
26 UVAL and VVAL
27 (output variables, of type REAL) define the point
28 (UVAL,VVAL) that is the projection in the u/v plane of
29 (RLAT,RLON). The units of UVAL and VVAL depend on the
30 projection.
31
32 If the point is not projectable, UVAL is returned equal to
33 1.E12. If the point is projectable, but outside the
34 boundary of the map (as defined by the last call to MAPSET
35 and by the value of the parameter 'EL'), the routine
36 MAPTRN, unlike MAPTRA, still returns its u and v
37 coordinates.
38
40 The C-binding argument descriptions are the same as the FORTRAN
41 argument descriptions.
42
44 Use the ncargex command to see the following relevant examples: cpex03,
45 mpex09.
46
48 To use MAPTRN or c_maptrn, load the NCAR Graphics libraries ncarg,
49 ncarg_gks, and ncarg_c, preferably in that order.
50
52 See the ezmap man page for a description of all EZMAP error messages
53 and/or informational messages.
54
56 Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod,
57 mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint,
58 mapiq, mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl,
59 maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc,
60 mapsti, mapstl, mapstr, maptra, maptri, mapusr, mapvec, mpchln, mpfnme,
61 mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola,
62 mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri,
63 mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
64 ncarg_cbind
65
66 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
67
69 Copyright (C) 1987-2007
70 University Corporation for Atmospheric Research
71
72 This documentation is free software; you can redistribute it and/or
73 modify it under the terms of the GNU General Public License as
74 published by the Free Software Foundation; either version 2 of the
75 License, or (at your option) any later version.
76
77 This software is distributed in the hope that it will be useful, but
78 WITHOUT ANY WARRANTY; without even the implied warranty of
79 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
80 General Public License for more details.
81
82 You should have received a copy of the GNU General Public License along
83 with this software; if not, write to the Free Software Foundation,
84 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
85
86
87
88UNIX March 1993 MAPTRN(3NCARG)