SPPS(3NCARG)

NAME
SPPS - a collection of routines for defining and managing NCAR Graphics coordinate systems, for drawing lines, markers, and text in those coordinate systems, and for implementing efficiency considerations such as polyline segment buffering.

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 document "The Use of X/Y Coordinates in NCAR Graphics" for descriptions of these coordinate systems.

The NCAR Graphics user coordinate system allows for axis reversal (mirror imaging) and non-linear (logarithmic) axes, which are two important extensions to the GKS world coordinate system.

Plotter address units (PAUs) were used frequently in various SPPS routine arguments and in some internal parameters. PAUs are not being used in new NCAR Graphics routines. Wherever they might still be encountered, simply interpret them according to the formula "1 PAU = 1/1023 NDC units".

SYNOPSIS
OPNGKS - Opens GKS, opens and activates an NCAR GCM workstation (workstation of type 1) with workstation ID of 1 and connection ID of 2.

CLSGKS - Deactivates workstation 1, closes workstation 1, and closes GKS.

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

FRSTPT - generates a "pen-up" move to a specified point in the user coordinate system. FRSTPT is used in conjunction with the routine VECTOR to draw lines.

VECTOR - generates a "pen-down" move to a specified point in the user coordinate system. VECTOR is used in conjunction with the routine FRSTPT to draw lines.

POINT - draws a point at a specified position in the user coordinate system.

POINTS - draws a marker at each of a series of specified positions in the user coordinate system. The markers can also be connected by drawing lines between them.

LINE - draws a line from the point (X1,Y1) to the point (X2,Y2). The "pen" (for subsequent calls to FRSTPT, VECTOR, PLOTIF, and PLOTIT) is left at (X2,Y2).

CURVE - draws the curve defined by a specified series of points in the user coordinate system. The "pen" (for subsequent calls to FRSTPT, VECTOR, PLOTIF, and PLOTIT) is left at the location of the last point in the curve.

SFLUSH - Flushes polylines, accumulated through calls to the routines PLOTIF and PLOTIT, from the SPPS polyline buffer shared by those routines; updates all open workstations; and flushes all system-level I/O buffers.

FRAME - advances to the next picture in the case of CGM output, and pauses in the window of most recent creation for X11 output. A mouse or key click in the window on pause will cause all active workstations to be cleared.

SET - defines the mapping between fractional and user coordinates: sets the values of the SPPS internal parameters 'LS' (axis linear/log scaling) and 'MI' (axis mirror imaging); defines GKS normalization transformation 1.

GETSET - returns a set of values which, if used as arguments in a call to SET, will cause normalization transformation 1, axis linear/log scaling (internal parameter 'LS'), and axis mirror imaging (internal parameter 'MI') to be defined in such a way as to duplicate the combined effects of the current normalization transformation, axis scaling, and axis mirror imaging.

SETUSV - sets the value of one of the internal parameters of SPPS.

GETUSV - gets the value of one of the internal parameters of SPPS.

CFUX, CFUY - Converts from fractional coordinates to user coordinates

CUFX, CUFY - Converts from user coordinates to fractional coordinates

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

void c_opngks()

void c_clsgks()

void c_frstpt (float px, float py)

void c_vector (float px, float py)

void c_point (float px, float py)

void c_points (float *px, float *py, int np, int ic, int il)

void c_line (float x1, float y1, float x2, float y2)

void c_curve (float *px, float *py, int np)

void c_sflush()

void c_frame()

void c_set(float vl, float vr, float vb, float vt, float wl, float wr, float wb, float wt, int lf)

void c_getset(float *vl, float *vr, float *vb, float *vt, float *wl, float *wr, float *wb, float *wt, int *lf)

void c_setusv (char *vn, int iv)

void c_getusv (char *vn, int *iv)

float c_cfux (float rx)

float c_cfuy (float ry)

float c_cufx (float rx)

float c_cufy (float ry)

SEE ALSO
Online: clsgks, curve, fl2int, frame, frstpt, getset, getsi, getusv, line, mxmy, opngks, plotif, plotit, point, points, pwrit, set, seti, setusv, sflush, vector, wtstr, spps_converters, spps_params, cfux, cfuy, cufx, cufy

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.