1FENCE3(3NCARG) NCAR GRAPHICS FENCE3(3NCARG)
2
3
4
6 FENCE3 - Draws the projection of a curve, just as CURVE3 does, but with
7 a "fence" of straight line segments that are parallel to one of the
8 three axes and extend from the curve to a specified plane perpendicular
9 to that axis.
10
12 CALL FENCE3 (U,V,W,N,IOREN,BOT)
13
15 #include <ncarg/ncargC.h>
16
17 void c_fence3 (float *u, float *v, float *w, int n,
18 int ioren, float bot)
19
21 U,V,W (input arrays, dimensioned at least N, of type REAL)
22 contain the U, V, and W coordinates, respectively, of the
23 points defining the curve whose projection is to be drawn.
24
25 N (an input expression of type INTEGER) is the number of
26 points defining the curve.
27
28 IOREN (an input expression of type INTEGER) is the direction in
29 which fence lines are to be drawn, as follows:
30
31 1 Parallel to the U axis.
32
33 2 Parallel to the V axis.
34
35 3 Parallel to the W axis.
36
37 BOT (an input expression of type REAL) specifies where the
38 bottom of the fence is to be drawn. For example, if the
39 fence lines are to be drawn parallel to the W-axis, and
40 BOT=2., then the bottom of the fence would be the plane
41 W=2.
42
43 The word "bottom" may be misleading here; the entire curve
44 might be below the plane of the "bottom" and the fence
45 might be horizontal, rather than vertical, in the three-
46 dimensional space.
47
48 The curve and the fence are drawn in the colors implied by the values
49 of the variables ITHRMJ and ITHRMN, respectively, in the Threed COMMON
50 block
51
52 COMMON /THRINT/ ITHRMJ,ITHRMN,ITHRTX
53
54 The default value of both ITHRMJ and ITHRMN is 1; user code may change
55 these values.
56
58 The C-binding argument descriptions are the same as the FORTRAN
59 argument descriptions.
60
62 Use the ncargex command to see the following relevant example: fthex04.
63
65 To use FENCE3 or c_fence3, load the NCAR Graphics libraries ncarg,
66 ncarg_gks, and ncarg_c, preferably in that order.
67
69 Online: threed, curve3, frst3, line3, perim3, point3, psym3, pwrz,
70 pwrzt, set3, threed, tick3, tick43, vect3, ncarg_cbind.
71
72 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
73
75 Copyright (C) 1987-2007
76 University Corporation for Atmospheric Research
77
78 This documentation is free software; you can redistribute it and/or
79 modify it under the terms of the GNU General Public License as
80 published by the Free Software Foundation; either version 2 of the
81 License, or (at your option) any later version.
82
83 This software is distributed in the hope that it will be useful, but
84 WITHOUT ANY WARRANTY; without even the implied warranty of
85 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
86 General Public License for more details.
87
88 You should have received a copy of the GNU General Public License along
89 with this software; if not, write to the Free Software Foundation,
90 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
91
92
93
94UNIX March 1993 FENCE3(3NCARG)