ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/getbbox.1
Revision: 1.1
Committed: Tue Mar 11 19:20:21 2003 UTC (21 years, 2 months ago) by greg
Branch: MAIN
CVS Tags: rad3R5
Log Message:
Added documentation to repository

File Contents

# User Rev Content
1 greg 1.1 .\" RCSid "$Id"
2     .TH GETBBOX 1 11/15/93 RADIANCE
3     .SH NAME
4     getbbox - compute bounding box for RADIANCE scene
5     .SH SYNOPSIS
6     .B getbbox
7     [
8     .B \-w
9     ][
10     .B \-h
11     ]
12     [
13     .B "input .."
14     ]
15     .SH DESCRIPTION
16     .I Getbbox
17     reads each scene description
18     .I input
19     and computes the minimum axis-aligned parallelopiped that
20     will enclose all of the objects.
21     Each
22     .I input
23     can be either a file name, or a command (enclosed in quotes
24     and preceded by a `!').
25     If no arguments are given, the standard input is read.
26     A hyphen ('-') can also be used to indicate the standard input.
27     .PP
28     The
29     .I \-w
30     option suppresses warnings.
31     The
32     .I \-h
33     option suppresses the header line "xmin xmax ymin ymax zmin zmax".
34     .SH EXAMPLE
35     To compute the bounding box for the object ``thingy'':
36     .IP "" .2i
37     getbbox thingy
38     .PP
39     To preview ``scene'':
40     .IP "" .2i
41     preview -v FOUR -b `getbbox -h scene` scene
42     .SH NOTES
43     Since expanding a scene can require considerable overhead, it
44     is better to use the bounding cube produced by
45     .I oconv(1)
46     and read by
47     .I getinfo(1)
48     if an octree exists for the scene.
49     However, there are certain circumstances, such as foreign object
50     placement, that require knowing the bounding box rather than
51     just the bounding cube.
52     .SH AUTHOR
53     Greg Ward
54     .SH ACKNOWLEDGEMENT
55     Work on this program was sponsored by the LESO
56     group at EPFL in Switzerland.
57     .SH "SEE ALSO"
58     getinfo(1), oconv(1), xform(1)