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.

SEE ALSO

       Online: threed, curve3, fence3, line3, perim3, point3, psym3, pwrz, pwrzt, set3, threed,  tick3,  tick43,
       vect3, ncarg_cbind.

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

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

UNIX                                               March 1993                                      FRST3(3NCARG)