SYNOPSISCALL LINE3 (UA,VA,WA,UB,VB,WB)
C-BINDING SYNOPSIS#include <ncarg/ncargC.h>
void c_line3 (float ua, float va, float wa, float ub,
float vb, float wb)
- (input expressions of type REAL) are the coordinates of the first point in 3-space.
- (input expressions of type REAL) are the coordinates of the second point in 3-space.
The statement "CALL LINE3 (UA,VA,WA,UB,VB,WB)" is equivalent to the three statements "CALL FRST3 (UA,VA,WA)", "CALL VECT3 (UB,VB,,WB)", and "CALL PLOTIF (0.,0.,2), but is slightly more efficient. To approximate a curve defined by three or more points, though, it is not efficient to use LINE3, because the first point of each line segment after the first will be a repeat of the second point of the previous line segment and will therefore be repeated in the metafile. Thus, to approximate a curve, you should use FRST3 and VECT3 or CURVE3.
Straight-line segments drawn by LINE3 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 line width scale factor is 1.
C-BINDING DESCRIPTIONThe C-binding argument descriptions are the same as the FORTRAN argument descriptions.
EXAMPLESUse the ncargex command to see the following relevant example: tpwrzt, fthex02.
ACCESSTo use LINE3 or c_line3, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.
COPYRIGHTCopyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.