1FRST3(3NCARG) NCAR GRAPHICS FRST3(3NCARG)
2
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
12 CALL FRST3 (U,V,W)
13
15 #include <ncarg/ncargC.h>
16 void c_FRST3 (float u, float v, float w)
18
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 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 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 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
43 The C-binding argument descriptions are the same as the FORTRAN
44 argument descriptions.
45
47 Use the ncargex command to see the following relevant fthex01, fthex02,
48 fthex03.
49
51 To use FRST3 or c_frst3, load the NCAR Graphics libraries ncarg,
52 ncarg_gks, and ncarg_c, preferably in that order.
53
55 Online: threed, curve3, fence3, line3, perim3, point3, psym3, pwrz,
56 pwrzt, set3, threed, tick3, tick43, vect3, ncarg_cbind.
57 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
59
61 Copyright (C) 1987-2007
62 University Corporation for Atmospheric Research
63 This documentation is free software; you can redistribute it and/or
65 modify it under the terms of the GNU General Public License as
66 published by the Free Software Foundation; either version 2 of the
67 License, or (at your option) any later version.
68 This software is distributed in the hope that it will be useful, but
70 WITHOUT ANY WARRANTY; without even the implied warranty of
71 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
72 General Public License for more details.
73 You should have received a copy of the GNU General Public License along
75 with this software; if not, write to the Free Software Foundation,
76 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
77UNIX March 1993 FRST3(3NCARG)