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

NAME

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

STATUS

14       Metacode units are no longer used in NCAR Graphics; thus, PLOTIT is
15       considered an obsolete routine.
16
17       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
23       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
27       The following definition of the Metacode Coordinate System is included
28       for the purpose of interpreting and converting codes:
29
30       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

SYNOPSIS

37       CALL PLOTIT (IX,IY,IP)
38

C-BINDING SYNOPSIS

40       #include <ncarg/ncargC.h>
41
42       void c_plotit(int ix, int iy, int ip);
43

DESCRIPTION

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
49       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
53       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
60                   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
66                   The SPPS polyline buffer is provided to increase drawing
67                   efficiency.
68

C-BINDING DESCRIPTION

70       The C-binding argument descriptions are the same as the FORTRAN
71       argument descriptions.
72

ACCESS

74       To use PLOTIT or c_plotit, load the NCAR Graphics libraries ncarg,
75       ncarg_gks, and ncarg_c, preferably in that order.
76

SEE ALSO

78       Online: gpl, fl2int, plotif, setusv, getusv, sflush, frstpt, vector,
79       line, curve, spps, spps_converters
80
81       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
82       NCAR GKS-0A Graphics
83

85       Copyright (C) 1987-2009
86       University Corporation for Atmospheric Research
87       The use of this Software is governed by a License Agreement.
88
89
90
91UNIX                              March 1993                    PLOTIT(3NCARG)
Impressum