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

NAME

6       Isosrfhr - Draws a wireframe surface with hidden contours removed.
7

STATUS

9       Isosrfhr is obsolete.  It was written to do one contour plane at a time
10       when computers had small memories.  It has been replaced by the
11       Isosurface utility.  For a description of Isosurface: type "man
12       isosurface".
13
14       Isosrfhr continues to be provided for compatibility of early NCAR
15       Graphics codes.  If you are writing new code, we suggest that you use
16       Isosurface.
17

SYNOPSIS

19       DANDR - Draws the contours represented by a single U plane.  The
20       calling program must loop over the number of U planes (NU) which
21       routine INIT3D has stored on a scratch file.
22       INIT3D - Transforms the VW grids (NU of them) into a series of 2-D
23       perspectives which are stored on a file.  Entry INIT3D must be called
24       before the entry DANDR is called for the first time.
25

USAGE

27       Entries INIT3D and DANDR must be used in tandem to create a plot.
28       First call entry INIT3D to create a set of 2-D perspective planes which
29       are output to a scratch file.  Then, in the calling program you must
30       loop over the U dimension of UVW space starting at the last slab, NU,
31       and moving forward to slab 1.  Initially set all elements of IOBJS to
32       zeros.  Then, at all locations (J,K) where the surface of an object
33       would appear, set IOBJS(J,K) = 1.  When IOBJS(J,K) has been defined for
34       that VW slab (U = NU - I + 1), call the entry DANDR, which draws any
35       object contours based on the 2-D perspective defined for that slab.
36
37       An Isosrfhr example of the logical structure of a program follows:
38
39        C  Entry INIT3D writes NU 2-D perspective planes, ST1(NV,NW,2),
40        C   of the UVW grid, viewed from the position EYE, to a scratch file.
41        C
42             CALL INIT3D(EYE,NU,NV,NW,ST1,LX,NY,IS2,IU,S)
43        C
44        C NU is the extent of the U dimension.
45        C
46             DO 1 IBKWDS = 1,NU
47             I = NU+1-IBKWDS
48        C
49        C You must define the presence of the objects at each VW grid point for
50        C all slabs in the U direction. Ones are used to indicate the presence
51        C of an object.  Zeros indicate no object.
52        C
53        C      IF (OBJ.EQ.YES) IOBJS(J,K) = 1
54        C      IF (OBJ.EQ.NO)  IOBJS(J,K) = 0
55        C
56        C  DANDR reads ST1(NV,NW,2) for slab I.
57        C
58           1 CALL DANDR(NV,NW,ST1,LX,NX,NY,IS2,IU,S,IOBJS,MV)
59
60

ACCESS

62       To use Isosrfhr, load the NCAR Graphics libraries ncarg, ncarg_gks, and
63       ncarg_c, preferably in that order.
64

SEE ALSO

66       Online: init3d, dandr, isosurface, isosurface_params, ezisos, isgeti,
67       isgetr, isosrf, isseti, issetr, pwrzi, ncarg_cbind
68
69       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
70       Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
71
73       Copyright (C) 1987-2007
74       University Corporation for Atmospheric Research
75
76       This documentation is free software; you can redistribute it and/or
77       modify it under the terms of the GNU General Public License as
78       published by the Free Software Foundation; either version 2 of the
79       License, or (at your option) any later version.
80
81       This software is distributed in the hope that it will be useful, but
82       WITHOUT ANY WARRANTY; without even the implied warranty of
83       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
84       General Public License for more details.
85
86       You should have received a copy of the GNU General Public License along
87       with this software; if not, write to the Free Software Foundation,
88       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
89
90
91
92UNIX                              March 1993                  Isosrfhr(3NCARG)
Impressum