man/man1/genbox.1

.\" RCSid "$Id: genbox.1,v 1.4 2007/09/04 17:36:40 greg Exp $"
.TH GENBOX 1 11/15/93 RADIANCE
.SH NAME
genbox - generate a RADIANCE or Wavefront description of a box
.SH SYNOPSIS
.B "genbox mat name xsiz ysiz zsiz"
[
.B \-i
][
.B "\-b bev"
|
.B "\-r rad"
[
.B "\-n nseg
]
][
.B \-o
]
.SH DESCRIPTION
.I Genbox
produces a RADIANCE scene description of a parallelepiped
with one corner at the origin and the opposite corner at
.I "(xsiz, ysiz, zsiz)."
The sides of the box will be parallel to the three coordinate
planes.
The surfaces that make up the box will be modified by
.I mat
and their identifiers will begin with
.I name.
.PP
The
.I \-i
option can be used to produce a box with inward directed surface
normals.
.PP
The
.I \-b
option can be used to specify the indentation for beveled edges.
.PP
The
.I \-r
option can be used to specify the radius for rounded edges, which
are modeled as cylinders and spheres for non-inverted RADIANCE output.
However, this type of model only makes sense for external views of
an opaque object.
If a rounded box is inverted using
.I \-i,
then the corners and edges are modeled with polygons, instead.
This option can also be forced by specifying a minum number of
segments with the
.I \-n
option.
.PP
The
.I \-o
option specifies Wavefront .OBJ output, and
also forces polygons to be used with the
.I \-r
option.
In this case, vertex normals are also produced for smooth rendering.
.SH EXAMPLE
To produce a rectangular box made of wood with rounded edges:
.IP "" .2i
genbox wood box1 5 8 3 \-r .5 > box1.rad
.PP
To produce a box made of crystal with beveled edges:
.IP "" .2i
genbox crystal box2 3 7 1 \-b .1 > box2.rad
.SH AUTHOR
Greg Ward
.SH BUGS
Because spheres and cylinders are used to construct boxes with
rounded edges, a transparent box of this type appears quite messy.
The preferred alternative in this case is the
.I \-n
option, which produces polygons, instead.
However, normal smoothing is only applied to the Wavefront .OBJ output,
so this must be passed through
.I obj2rad
to get perfectly smooth results.
.SH "SEE ALSO"
genrev(1), gensurf(1), genworm(1), obj2mesh(1), obj2rad(1),
robjutil(1), rpict(1), rvu(1), xform(1)
Revision:	1.5
Committed:	Fri Apr 9 01:48:20 2021 UTC (4 years, 6 months ago) by greg
Branch:	MAIN
Changes since 1.4:	+48 -10 lines
Log Message:	feat(genbox): Added polygonal modeling of rounded edges and -o option for .OBJ
#	User	Rev	Content
1	greg	1.5	.\" RCSid "$Id: genbox.1,v 1.4 2007/09/04 17:36:40 greg Exp $"
2	greg	1.1	.TH GENBOX 1 11/15/93 RADIANCE
3			.SH NAME
4	greg	1.5	genbox - generate a RADIANCE or Wavefront description of a box
5	greg	1.1	.SH SYNOPSIS
6			.B "genbox mat name xsiz ysiz zsiz"
7			[
8			.B \-i
9			][
10	greg	1.5	.B "\-b bev"
11			\|
12	greg	1.1	.B "\-r rad"
13	greg	1.5	[
14			.B "\-n nseg
15			]
16			][
17			.B \-o
18	greg	1.1	]
19			.SH DESCRIPTION
20			.I Genbox
21			produces a RADIANCE scene description of a parallelepiped
22			with one corner at the origin and the opposite corner at
23			.I "(xsiz, ysiz, zsiz)."
24			The sides of the box will be parallel to the three coordinate
25			planes.
26			The surfaces that make up the box will be modified by
27			.I mat
28			and their identifiers will begin with
29			.I name.
30	greg	1.5	.PP
31	greg	1.1	The
32			.I \-i
33			option can be used to produce a box with inward directed surface
34			normals.
35	greg	1.5	.PP
36			The
37			.I \-b
38			option can be used to specify the indentation for beveled edges.
39			.PP
40	greg	1.1	The
41			.I \-r
42	greg	1.5	option can be used to specify the radius for rounded edges, which
43			are modeled as cylinders and spheres for non-inverted RADIANCE output.
44			However, this type of model only makes sense for external views of
45			an opaque object.
46			If a rounded box is inverted using
47			.I \-i,
48			then the corners and edges are modeled with polygons, instead.
49			This option can also be forced by specifying a minum number of
50			segments with the
51			.I \-n
52			option.
53			.PP
54	greg	1.1	The
55	greg	1.5	.I \-o
56			option specifies Wavefront .OBJ output, and
57			also forces polygons to be used with the
58			.I \-r
59			option.
60			In this case, vertex normals are also produced for smooth rendering.
61	greg	1.1	.SH EXAMPLE
62	greg	1.5	To produce a rectangular box made of wood with rounded edges:
63			.IP "" .2i
64			genbox wood box1 5 8 3 \-r .5 > box1.rad
65			.PP
66			To produce a box made of crystal with beveled edges:
67	greg	1.1	.IP "" .2i
68	greg	1.5	genbox crystal box2 3 7 1 \-b .1 > box2.rad
69	greg	1.1	.SH AUTHOR
70			Greg Ward
71			.SH BUGS
72			Because spheres and cylinders are used to construct boxes with
73			rounded edges, a transparent box of this type appears quite messy.
74	greg	1.5	The preferred alternative in this case is the
75			.I \-n
76			option, which produces polygons, instead.
77			However, normal smoothing is only applied to the Wavefront .OBJ output,
78			so this must be passed through
79			.I obj2rad
80			to get perfectly smooth results.
81	greg	1.1	.SH "SEE ALSO"
82	greg	1.5	genrev(1), gensurf(1), genworm(1), obj2mesh(1), obj2rad(1),
83			robjutil(1), rpict(1), rvu(1), xform(1)