1FRST3(3NCARG)                    NCAR GRAPHICS                   FRST3(3NCARG)
2
3
4

NAME

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

SYNOPSIS

12       CALL FRST3 (U,V,W)
13

C-BINDING SYNOPSIS

15       #include <ncarg/ncargC.h>
16
17       void c_FRST3 (float u, float v, float w)
18

DESCRIPTION

20       U,V,W       (input expressions of type REAL) are the coordinates of a
21                   point in 3-space at the projection of which the drawing of
22                   a line is to begin.
23
24       Each call to FRST3 moves a conceptual "pen" to the new starting point
25       for a sequence of line draws.  Each call to VECT3 draws a line from the
26       current pen position to a new pen position and then makes that the
27       current pen position.
28
29       Line segments are drawn in the current polyline color, as determined by
30       the last call to the GKS routine GSPLCI; by default, color index 1 is
31       used.  Line width is determined by the last call to the GKS routine
32       GSLWSC; by default, the value of the line width scale factor is 1.
33
34       Note that the routines FRST3 and VECT3 do not flush the SPPS pen-move
35       buffer.  In fact, to have them do so would entirely defeat the purpose
36       of that buffer.  Therefore, if your last call was to the routine VECT3
37       and you are about to call GKS routines to change color or line width,
38       you must first call the SPPS routine PLOTIF to flush the buffer;
39       otherwise, the color and line width changes will affect line draws
40       flushed from the buffer later.
41

C-BINDING DESCRIPTION

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

EXAMPLES

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

ACCESS

51       To use FRST3 or c_frst3, load the NCAR Graphics libraries ncarg,
52       ncarg_gks, and ncarg_c, preferably in that order.
53

SEE ALSO

55       Online: threed, curve3, fence3, line3, perim3, point3, psym3, pwrz,
56       pwrzt, set3, threed, tick3, tick43, vect3, ncarg_cbind.
57
58       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
59
61       Copyright (C) 1987-2009
62       University Corporation for Atmospheric Research
63       The use of this Software is governed by a License Agreement.
64
65
66
67UNIX                              March 1993                     FRST3(3NCARG)
Impressum