ncl_frstpt (3) - Linux Manuals

ncl_frstpt: generates a "pen-up" move to a specified point in the user

NAME

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.

SYNOPSIS

CALL FRSTPT (PX,PY)

C-BINDING SYNOPSIS

#include <ncarg/ncargC.h>

void c_frstpt (float px, float py)

DESCRIPTION

PX

(an input expression of type REAL) defines the X user coordinate.

PY

(an input expression of type REAL) defines the Y user coordinate.

C-BINDING DESCRIPTION ,,

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

USAGE

Polyline type, line width, and color can be set by calling the GKS routines GSLN, GSLWSC, GSCR, and GSPLCI before calling FRSTPT.

Note that, for the sake of efficiency, the routines FRSTPT and VECTOR buffer the polylines resulting from pen moves. One must be sure to flush the SPPS polyline buffer before changing polyline attributes. A "CALL PLOTIF (0.,0.,2)" will flush the buffer.

EXAMPLES

Use the ncargex command to see the following relevant examples: tgflas.

ACCESS

To use FRSTPT or c_frstpt, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

COPYRIGHT

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