1PLOTIT(3NCARG) NCAR GRAPHICS PLOTIT(3NCARG)
2
6 PLOTIT - A line-drawing routine, described in terms of "pen moves".
7 Most calls to PLOTIT specify whether the "pen" should be up (not
8 drawing) or down (drawing) and then move it to a designated position in
9 the metacode coordinate system. The polylines resulting from the pen
10 moves are buffered; some calls to PLOTIT just cause the SPPS polyline
11 buffer to be flushed.
12
14 Metacode units are no longer used in NCAR Graphics; thus, PLOTIT is
15 considered an obsolete routine.
16 The current recognized coordinate systems are GKS world coordinates,
18 GKS normalized device coordinates, NCAR Graphics fractional
19 coordinates, and NCAR Graphics user coordinates. See the NCAR Graphics
20 User Document "NCAR Graphics Fundamentals, UNIX Version" for a
21 description of these coordinate systems.
22 PLOTIT continues to be provided for compatibility of early NCAR
24 Graphics codes. If you are writing new code, we suggest that you use
25 the routine PLOTIF which uses fractional coordinates.
26 The following definition of the Metacode Coordinate System is included
28 for the purpose of interpreting and converting codes:
29 The metacode coordinates of a point are integers IMX and IMY between 0
31 and 32767 inclusive. The area addressed is a square in a "metacode
32 space" that is usually mapped into a square subset of the addressable
33 area of the plotting device. Metacode coordinates were used in calls
34 to the routine PLOTIT and are returned in calls to FL2INT.
35
37 CALL PLOTIT (IX,IY,IP)
38
40 #include <ncarg/ncargC.h>
41 void c_plotit(int ix, int iy, int ip);
43
45 IX (an input expression of type INTEGER) is the X metacode
46 coordinate of the point to which the plotter pen is to be
47 moved.
48 IY (an input expression of type INTEGER) is the Y metacode
50 coordinate of the point to which the plotter pen is to be
51 moved.
52 IP (an input expression of type INTEGER) determines whether
54 the movement of the plotter pen to the point (IX,IY) will
55 occur with the pen up (IP = 0), or with the pen down (IP =
56 1). If IP = 2, no pen move occurs, but the SPPS polyline
57 buffer is flushed. For historical reasons, a "CALL PLOTIT
58 (0,0,0)" will also flush the buffer.
59 The size of the SPPS polyline buffer can be changed by
61 calling the parameter-setting routine SETUSV to set the
62 parameter 'PB'. The legal range of 'PB' is between 2 and
63 50. For example, to set 'PB' to 2, use "CALL SETUSV
64 ('PB',2)".
65 The SPPS polyline buffer is provided to increase drawing
67 efficiency.
68
70 The C-binding argument descriptions are the same as the FORTRAN
71 argument descriptions.
72
74 To use PLOTIT or c_plotit, load the NCAR Graphics libraries ncarg,
75 ncarg_gks, and ncarg_c, preferably in that order.
76
78 Online: gpl, fl2int, plotif, setusv, getusv, sflush, frstpt, vector,
79 line, curve, spps, spps_converters
80 Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
82 NCAR GKS-0A Graphics
83
85 Copyright (C) 1987-2007
86 University Corporation for Atmospheric Research
87 This documentation is free software; you can redistribute it and/or
89 modify it under the terms of the GNU General Public License as
90 published by the Free Software Foundation; either version 2 of the
91 License, or (at your option) any later version.
92 This software is distributed in the hope that it will be useful, but
94 WITHOUT ANY WARRANTY; without even the implied warranty of
95 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
96 General Public License for more details.
97 You should have received a copy of the GNU General Public License along
99 with this software; if not, write to the Free Software Foundation,
100 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
101UNIX March 1993 PLOTIT(3NCARG)