1GETSI(3NCARG) NCAR GRAPHICS GETSI(3NCARG)
2
3
4
6 GETSI - returns the exponents which define the plotting range in the
7 plotter address unit coordinate system.
8
10 Plotter Address Units (PAUs) are no longer used in NCAR Graphics; thus,
11 GETSI is considered an obsolete routine.
12
13 The current recognized coordinate systems are GKS world coordinates,
14 GKS normalized device coordinates, NCAR Graphics fractional
15 coordinates, and NCAR Graphics user coordinates. See the NCAR Graphics
16 document "The Use of X/Y Coordinates in NCAR Graphics" for a
17 description of these coordinate systems.
18
19 GETSI continues to be provided for compatibility of early NCAR Graphics
20 codes.
21
22 The following definition of the PAU Coordinate System is included for
23 the purpose of interpreting and converting PAU codes:
24
25 The plotter coordinates of a point are integers IPX and IPY, where IPX
26 is between 1 and 2**MX and IPY is between 1 and 2**MY. MX and MY are
27 internal parameters of SPPS; each has the default value 10. Values of
28 MX and MY can be set by routine SETI and retrieved by routine GETSI.
29
31 CALL GETSI (IX,IY)
32
34 IX (an output variable of type INTEGER) is the X axis exponent
35 for plotter coordinates defining a range of 1 to 2**IX - 1.
36 IX has a default value of 10.
37
38 IY (an output variable of type INTEGER) is the Y axis exponent
39 for plotter coordinates defining a range of 1 to 2**IY - 1.
40 IY has a default value of 10.
41
43 To use GETSI, load the NCAR Graphics libraries ncarg, ncarg_gks, and
44 ncarg_c, preferably in that order.
45
47 Online: spps, seti
48
49 Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
50 NCAR GKS-0A Graphics
51
53 Copyright (C) 1987-2007
54 University Corporation for Atmospheric Research
55
56 This documentation is free software; you can redistribute it and/or
57 modify it under the terms of the GNU General Public License as
58 published by the Free Software Foundation; either version 2 of the
59 License, or (at your option) any later version.
60
61 This software is distributed in the hope that it will be useful, but
62 WITHOUT ANY WARRANTY; without even the implied warranty of
63 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
64 General Public License for more details.
65
66 You should have received a copy of the GNU General Public License along
67 with this software; if not, write to the Free Software Foundation,
68 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
69
70
71
72UNIX March 1993 GETSI(3NCARG)