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

NAME

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

SYNOPSIS

11       CALL PERIM3 (MAJOR1,MINOR1,MAJOR2,MINOR2,IAXIS,VALUE)
12

C-BINDING SYNOPSIS

14       #include <ncarg/ncargC.h>
15
16       void c_perim3 (int major1, int minor1, int major2, int minor2,
17       int iaxis, float value)
18

DESCRIPTION

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
26       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
33       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
39       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
46       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
50                   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
54                   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
58                   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
62       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
68       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
79       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
84       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
89       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
95             COMMON /THRINT/ ITHRMJ,ITHRMN,ITHRTX
96
97       The default value of both ITHRMJ and ITHRMN is 1; user code may change
98       these values.
99
100       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

C-BINDING DESCRIPTION

104       The C-binding argument descriptions are the same as the FORTRAN
105       argument descriptions.
106

EXAMPLES

108       Use the ncargex command to see the following relevant examples: tthree,
109       fthex01, fthex02, fthex03, fthex04, fthex05.
110

ACCESS

112       To use PERIM3 or c_perim3, load the NCAR Graphics libraries ncarg,
113       ncarg_gks, and ncarg_c, preferably in that order.
114

SEE ALSO

116       Online: threed, curve3, fence3, frst3, line3, point3, psym3, pwrz,
117       pwrzt, set3, threed, tick3, tick43, vect3, ncarg_cbind.
118
119       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
120
122       Copyright (C) 1987-2009
123       University Corporation for Atmospheric Research
124       The use of this Software is governed by a License Agreement.
125
126
127
128UNIX                              March 1993                    PERIM3(3NCARG)
Impressum