PLOTIT(3NCARG)

NAME
PLOTIT - A line-drawing routine, described in terms of "pen moves". Most calls to PLOTIT specify whether the "pen" should be up (not drawing) or down (drawing) and then move it to a designated position in the metacode coordinate system. The polylines resulting from the pen moves are buffered; some calls to PLOTIT just cause the SPPS polyline buffer to be flushed.

STATUS
Metacode units are no longer used in NCAR Graphics; thus, PLOTIT is considered an obsolete routine.

The current recognized coordinate systems are GKS world coordinates, GKS normalized device coordinates, NCAR Graphics fractional coordinates, and NCAR Graphics user coordinates. See the NCAR Graphics User Document "NCAR Graphics Fundamentals, UNIX Version" for a description of these coordinate systems.

PLOTIT continues to be provided for compatibility of early NCAR Graphics codes. If you are writing new code, we suggest that you use the routine PLOTIF which uses fractional coordinates.

The following definition of the Metacode Coordinate System is included for the purpose of interpreting and converting codes:

The metacode coordinates of a point are integers IMX and IMY between 0 and 32767 inclusive. The area addressed is a square in a "metacode space" that is usually mapped into a square subset of the addressable area of the plotting device. Metacode coordinates were used in calls to the routine PLOTIT and are returned in calls to FL2INT.

SYNOPSIS
CALL PLOTIT (IX,IY,IP)

C-BINDING SYNOPSIS
#include <ncarg/ncargC.h>

void c_plotit(int ix, int iy, int ip);

DESCRIPTION

IX  (an input expression of type INTEGER) is the X metacode coordinate of the point to which the plotter pen is to be moved.

IY  (an input expression of type INTEGER) is the Y metacode coordinate of the point to which the plotter pen is to be moved.

IP  (an input expression of type INTEGER) determines whether the movement of the plotter pen to the point (IX,IY) will occur with the pen up (IP = 0), or with the pen down (IP = 1). If IP = 2, no pen move occurs, but the SPPS polyline buffer is flushed. For historical reasons, a "CALL PLOTIT (0,0,0)" will also flush the buffer.

    The size of the SPPS polyline buffer can be changed by calling the parameter-setting routine SETUSV to set the parameter 'PB'. The legal range of 'PB' is between 2 and 50. For example, to set 'PB' to 2, use "CALL SETUSV ('PB',2)".

    The SPPS polyline buffer is provided to increase drawing efficiency.

C-BINDING DESCRIPTION
The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

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

SEE ALSO
Online: gpl, fl2int, plotif, setusv, getusv, sflush, frstpt, vector, line, curve, spps, spps_converters

Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

COPYRIGHT
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.