perim3(3NCARG)
NAME
PERIM3 - Draws the projection of a rectangular perimeter in a plane parallel to one of the three coordinate planes, with inward-pointing tick marks at specified intervals.
SYNOPSIS
CALL PERIM3 (MAJOR1,MINOR1,MAJOR2,MINOR2,IAXIS,VALUE)
C-BINDING SYNOPSIS
#include <ncarg/ncargC.h> void c_perim3 (int major1, int minor1, int major2, int minor2, int iaxis, float value)
DESCRIPTION
MAJOR1 (an input expression of type INTEGER) specifies the number
of major divisions of those sides of the perimeter parallel
to direction 1. (Directions 1 and 2 are defined by the
value of IAXIS.) Major divisions are indicated by tick
marks.
MINOR1 (an input expression of type INTEGER) specifies the number
of minor divisions per major division along those sides of
the perimeter parallel to direction 1. (Directions 1 and 2
are defined by the value of IAXIS.) Minor divisions are
indicated by tick marks that, by default, are smaller than
the tick marks indicating major divisions.
MAJOR2 (an input expression of type INTEGER) specifies the number
of major divisions of those sides of the perimeter parallel
to direction 2. (Directions 1 and 2 are defined by the
value of IAXIS.) Major divisions are indicated by tick
marks.
MINOR2 (an input expression of type INTEGER) specifies the number
of minor divisions per major division along those sides of
the perimeter parallel to direction 2. (Directions 1 and 2
are defined by the value of IAXIS.) Minor divisions are
indicated by tick marks that, by default, are smaller than
the tick marks indicating major divisions.
IAXIS (an input expression of type INTEGER) specifies which of
the three axes the perimeter is to be perpendicular to and
identifies directions 1 and 2:
1 The perimeter is to be perpendicular to the U axis.
Direction 1 is parallel to the V axis and direction 2 is
parallel to the W axis.
2 The perimeter is to be perpendicular to the V axis.
Direction 1 is parallel to the U axis and direction 2 is
parallel to the W axis.
3 The perimeter is to be perpendicular to the W axis.
Direction 1 is parallel to the U axis and direction 2 is
parallel to the V axis.
VALUE (an input expression of type REAL) is the value at which
the plane of the perimeter is to intersect the axis
specified by IAXIS. If IAXIS is a 1, VALUE is a U
coordinate; if IAXIS is a 2, VALUE is a V coordinate; and,
if IAXIS is a 3, VALUE is a W coordinate.
Each call to PERIM3 draws a perimeter: a rectangle representing the
intersection of a plane perpendicular to one of the three axes with the
box specified by the arguments UMIN, UMAX, VMIN, VMAX, WMIN, and WMAX
in the last call to SET3. The perimeter can be placed at any desired
position along the axis to which it is perpendicular; it can have
inward-pointing major and minor tick marks along its edges, spaced as
specified by the user. Tick marks along two parallel edges of the
perimeter are controlled by one pair of arguments, and tick marks along
the other two parallel edges are controlled by the other pair of
arguments.
Each of the arguments MAJOR1 and MAJOR2 refers to the number of major
divisions (spaces between ticks) rather than to the number of major
ticks; counting those at the ends, there will be one more major tick
than there are major divisions.
Each of the arguments MINOR1 and MINOR2 refers to the number of minor
divisions (spaces between ticks) rather than to the number of minor
ticks; in a given major interval, there will be one fewer minor tick
than there are minor divisions.
The rectangle itself is drawn in the current polyline color, as
determined by the last call to the GKS routine GSPLCI; by default,
color index 1 is used. Major ticks and minor ticks are drawn in the
colors implied by the values of the variables ITHRMJ and ITHRMN in the
Threed COMMON block
COMMON /THRINT/ ITHRMJ,ITHRMN,ITHRTX
The default value of both ITHRMJ and ITHRMN is 1; user code may change
these values.
All lines are drawn using the current GKS line width scale factor, as
set by the last call to the GKS routine GSLWSC.
C-BINDING DESCRIPTION
The C-binding argument descriptions are the same as the FORTRAN argument descriptions.
EXAMPLES
Use the ncargex command to see the following relevant examples: tthree, fthex01, fthex02, fthex03, fthex04, fthex05.
ACCESS
To use PERIM3 or c_perim3, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.
SEE ALSO
Online: threed, curve3, fence3, frst3, line3, point3, psym3, pwrz, pwrzt, set3, threed, tick3, tick43, vect3, ncarg_cbind. Hardcopy: NCAR Graphics Fundamentals, UNIX Version
COPYRIGHT
Copyright (C) 1987-2009 University Corporation for Atmospheric Research The use of this Software is governed by a License Agreement.
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
