ncl_frst3 (3) - Linux Manuals

NAME

FRST3 - Specifies the first in a sequence of points connected by straight-line segments, the projections of which are to be drawn. (FRST3 is called for the first point in the sequence and VECT3 is called for the rest.)

SYNOPSIS

CALL FRST3 (U,V,W)

C-BINDING SYNOPSIS

#include <ncarg/ncargC.h>

void c_FRST3 (float u, float v, float w)

DESCRIPTION

U,V,W

(input expressions of type REAL) are the coordinates of a point in 3-space at the projection of which the drawing of a line is to begin.

Each call to FRST3 moves a conceptual "pen" to the new starting point for a sequence of line draws. Each call to VECT3 draws a line from the current pen position to a new pen position and then makes that the current pen position.

Line segments are drawn in the current polyline color, as determined by the last call to the GKS routine GSPLCI; by default, color index 1 is used. Line width is determined by the last call to the GKS routine GSLWSC; by default, the value of the line width scale factor is 1.

Note that the routines FRST3 and VECT3 do not flush the SPPS pen-move buffer. In fact, to have them do so would entirely defeat the purpose of that buffer. Therefore, if your last call was to the routine VECT3 and you are about to call GKS routines to change color or line width, you must first call the SPPS routine PLOTIF to flush the buffer; otherwise, the color and line width changes will affect line draws flushed from the buffer later.

C-BINDING DESCRIPTION

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

EXAMPLES

Use the ncargex command to see the following relevant fthex01, fthex02, fthex03.

ACCESS

To use FRST3 or c_frst3, 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.