| 1 |
.\" RCSid "$Id: getbbox.1,v 1.2 2003/12/09 15:59:06 greg Exp $" |
| 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) |
