1PERIM3(3NCARG) NCAR GRAPHICS PERIM3(3NCARG)
2
6 PERIM3 - Draws the projection of a rectangular perimeter in a plane
7 parallel to one of the three coordinate planes, with inward-pointing
8 tick marks at specified intervals.
9
11 CALL PERIM3 (MAJOR1,MINOR1,MAJOR2,MINOR2,IAXIS,VALUE)
12
14 #include <ncarg/ncargC.h>
15 void c_perim3 (int major1, int minor1, int major2, int minor2,
17 int iaxis, float value)
18
20 MAJOR1 (an input expression of type INTEGER) specifies the number
21 of major divisions of those sides of the perimeter parallel
22 to direction 1. (Directions 1 and 2 are defined by the
23 value of IAXIS.) Major divisions are indicated by tick
24 marks.
25 MINOR1 (an input expression of type INTEGER) specifies the number
27 of minor divisions per major division along those sides of
28 the perimeter parallel to direction 1. (Directions 1 and 2
29 are defined by the value of IAXIS.) Minor divisions are
30 indicated by tick marks that, by default, are smaller than
31 the tick marks indicating major divisions.
32 MAJOR2 (an input expression of type INTEGER) specifies the number
34 of major divisions of those sides of the perimeter parallel
35 to direction 2. (Directions 1 and 2 are defined by the
36 value of IAXIS.) Major divisions are indicated by tick
37 marks.
38 MINOR2 (an input expression of type INTEGER) specifies the number
40 of minor divisions per major division along those sides of
41 the perimeter parallel to direction 2. (Directions 1 and 2
42 are defined by the value of IAXIS.) Minor divisions are
43 indicated by tick marks that, by default, are smaller than
44 the tick marks indicating major divisions.
45 IAXIS (an input expression of type INTEGER) specifies which of
47 the three axes the perimeter is to be perpendicular to and
48 identifies directions 1 and 2:
49 1 The perimeter is to be perpendicular to the U axis.
51 Direction 1 is parallel to the V axis and direction 2 is
52 parallel to the W axis.
53 2 The perimeter is to be perpendicular to the V axis.
55 Direction 1 is parallel to the U axis and direction 2 is
56 parallel to the W axis.
57 3 The perimeter is to be perpendicular to the W axis.
59 Direction 1 is parallel to the U axis and direction 2 is
60 parallel to the V axis.
61 VALUE (an input expression of type REAL) is the value at which
63 the plane of the perimeter is to intersect the axis
64 specified by IAXIS. If IAXIS is a 1, VALUE is a U
65 coordinate; if IAXIS is a 2, VALUE is a V coordinate; and,
66 if IAXIS is a 3, VALUE is a W coordinate.
67 Each call to PERIM3 draws a perimeter: a rectangle representing the
69 intersection of a plane perpendicular to one of the three axes with the
70 box specified by the arguments UMIN, UMAX, VMIN, VMAX, WMIN, and WMAX
71 in the last call to SET3. The perimeter can be placed at any desired
72 position along the axis to which it is perpendicular; it can have
73 inward-pointing major and minor tick marks along its edges, spaced as
74 specified by the user. Tick marks along two parallel edges of the
75 perimeter are controlled by one pair of arguments, and tick marks along
76 the other two parallel edges are controlled by the other pair of
77 arguments.
78 Each of the arguments MAJOR1 and MAJOR2 refers to the number of major
80 divisions (spaces between ticks) rather than to the number of major
81 ticks; counting those at the ends, there will be one more major tick
82 than there are major divisions.
83 Each of the arguments MINOR1 and MINOR2 refers to the number of minor
85 divisions (spaces between ticks) rather than to the number of minor
86 ticks; in a given major interval, there will be one fewer minor tick
87 than there are minor divisions.
88 The rectangle itself is drawn in the current polyline color, as
90 determined by the last call to the GKS routine GSPLCI; by default,
91 color index 1 is used. Major ticks and minor ticks are drawn in the
92 colors implied by the values of the variables ITHRMJ and ITHRMN in the
93 Threed COMMON block
94 COMMON /THRINT/ ITHRMJ,ITHRMN,ITHRTX
96 The default value of both ITHRMJ and ITHRMN is 1; user code may change
98 these values.
99 All lines are drawn using the current GKS line width scale factor, as
101 set by the last call to the GKS routine GSLWSC.
102
104 The C-binding argument descriptions are the same as the FORTRAN
105 argument descriptions.
106
108 Use the ncargex command to see the following relevant examples: tthree,
109 fthex01, fthex02, fthex03, fthex04, fthex05.
110
112 To use PERIM3 or c_perim3, load the NCAR Graphics libraries ncarg,
113 ncarg_gks, and ncarg_c, preferably in that order.
114
116 Online: threed, curve3, fence3, frst3, line3, point3, psym3, pwrz,
117 pwrzt, set3, threed, tick3, tick43, vect3, ncarg_cbind.
118 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
120
122 Copyright (C) 1987-2007
123 University Corporation for Atmospheric Research
124 This documentation is free software; you can redistribute it and/or
126 modify it under the terms of the GNU General Public License as
127 published by the Free Software Foundation; either version 2 of the
128 License, or (at your option) any later version.
129 This software is distributed in the hope that it will be useful, but
131 WITHOUT ANY WARRANTY; without even the implied warranty of
132 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
133 General Public License for more details.
134 You should have received a copy of the GNU General Public License along
136 with this software; if not, write to the Free Software Foundation,
137 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
138UNIX March 1993 PERIM3(3NCARG)