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

NAME

6       LINE3 - Draws the straight-line segment joining the projections of two
7       points in 3-space.
8

SYNOPSIS

10       CALL LINE3 (UA,VA,WA,UB,VB,WB)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_line3 (float ua, float va, float wa, float ub,
16       float vb, float wb)
17

DESCRIPTION

19       UA,VA,WA    (input expressions of type REAL) are the coordinates of the
20                   first point in 3-space.
21
22       UB,VB,WB    (input expressions of type REAL) are the coordinates of the
23                   second point in 3-space.
24
25       The statement "CALL LINE3 (UA,VA,WA,UB,VB,WB)" is equivalent to the
26       three statements "CALL FRST3 (UA,VA,WA)", "CALL VECT3 (UB,VB,,WB)", and
27       "CALL PLOTIF (0.,0.,2), but is slightly more efficient.  To approximate
28       a curve defined by three or more points, though, it is not efficient to
29       use LINE3, because the first point of each line segment after the first
30       will be a repeat of the second point of the previous line segment and
31       will therefore be repeated in the metafile.  Thus, to approximate a
32       curve, you should use FRST3 and VECT3 or CURVE3.
33
34       Straight-line segments drawn by LINE3 are drawn in the current polyline
35       color, as determined by the last call to the GKS routine GSPLCI; by
36       default, color index 1 is used.  Line width is determined by the last
37       call to the GKS routine GSLWSC; by default, the line width scale factor
38       is 1.
39

C-BINDING DESCRIPTION

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

EXAMPLES

45       Use the ncargex command to see the following relevant example: tpwrzt,
46       fthex02.
47

ACCESS

49       To use LINE3 or c_line3, load the NCAR Graphics libraries ncarg,
50       ncarg_gks, and ncarg_c, preferably in that order.
51

SEE ALSO

53       Online: threed, curve3, fence3, frst3, perim3, point3, psym3, pwrz,
54       pwrzt, set3, threed, tick3, tick43, vect3, ncarg_cbind.
55
56       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
57

59       Copyright (C) 1987-2009
60       University Corporation for Atmospheric Research
61       The use of this Software is governed by a License Agreement.
62
63
64
65UNIX                              March 1993                     LINE3(3NCARG)
Impressum