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-2007
60       University Corporation for Atmospheric Research
61
62       This documentation is free software; you can redistribute it and/or
63       modify it under the terms of the GNU General Public License as
64       published by the Free Software Foundation; either version 2 of the
65       License, or (at your option) any later version.
66
67       This software is distributed in the hope that it will be useful, but
68       WITHOUT ANY WARRANTY; without even the implied warranty of
69       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
70       General Public License for more details.
71
72       You should have received a copy of the GNU General Public License along
73       with this software; if not, write to the Free Software Foundation,
74       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
75
76
77
78UNIX                              March 1993                     LINE3(3NCARG)
Impressum