man/man1/genbox.1

.\" RCSid "$Id: genbox.1,v 1.6 2021/04/15 23:51:04 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 \-s
]
][
.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 normally
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 minimum number of
segments with the
.I \-n
option.
The
.I \-s
option controls whether surface normal smoothing is applied as well.
.PP
The
.I \-o
option specifies Wavefront .OBJ output, and
also forces polygons to be used with the
.I \-r
option.
If the
.I \-s
option is present, 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
.PP
To produce a transparent box with smoothed, rounded edges:
.IP "" .2i
genbox glassy box3 2 4 3 -r .25 -n 16 -s > box3.rad
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
genrev(1), gensurf(1), genworm(1), obj2mesh(1), obj2rad(1),
robjutil(1), rpict(1), rvu(1), xform(1)
Revision:	1.7
Committed:	Thu Mar 9 23:48:45 2023 UTC (2 years, 1 month ago) by greg
Branch:	MAIN
CVS Tags:	rad5R4, HEAD
Changes since 1.6:	+2 -2 lines
Log Message:	docs: corrected typo
#	User	Rev	Content
1	greg	1.7	.\" RCSid "$Id: genbox.1,v 1.6 2021/04/15 23:51:04 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	greg	1.6	][
16			.B \-s
17	greg	1.5	]
18			][
19			.B \-o
20	greg	1.1	]
21			.SH DESCRIPTION
22			.I Genbox
23			produces a RADIANCE scene description of a parallelepiped
24			with one corner at the origin and the opposite corner at
25			.I "(xsiz, ysiz, zsiz)."
26			The sides of the box will be parallel to the three coordinate
27			planes.
28			The surfaces that make up the box will be modified by
29			.I mat
30			and their identifiers will begin with
31			.I name.
32	greg	1.5	.PP
33	greg	1.1	The
34			.I \-i
35			option can be used to produce a box with inward directed surface
36			normals.
37	greg	1.5	.PP
38			The
39			.I \-b
40			option can be used to specify the indentation for beveled edges.
41			.PP
42	greg	1.1	The
43			.I \-r
44	greg	1.5	option can be used to specify the radius for rounded edges, which
45	greg	1.6	are normally
46			modeled as cylinders and spheres for non-inverted RADIANCE output.
47	greg	1.5	However, this type of model only makes sense for external views of
48			an opaque object.
49			If a rounded box is inverted using
50			.I \-i,
51			then the corners and edges are modeled with polygons, instead.
52	greg	1.7	This option can also be forced by specifying a minimum number of
53	greg	1.5	segments with the
54			.I \-n
55			option.
56	greg	1.6	The
57			.I \-s
58			option controls whether surface normal smoothing is applied as well.
59	greg	1.5	.PP
60	greg	1.1	The
61	greg	1.5	.I \-o
62			option specifies Wavefront .OBJ output, and
63			also forces polygons to be used with the
64			.I \-r
65			option.
66	greg	1.6	If the
67			.I \-s
68			option is present, vertex normals are also produced for smooth rendering.
69	greg	1.1	.SH EXAMPLE
70	greg	1.5	To produce a rectangular box made of wood with rounded edges:
71			.IP "" .2i
72			genbox wood box1 5 8 3 \-r .5 > box1.rad
73			.PP
74			To produce a box made of crystal with beveled edges:
75	greg	1.1	.IP "" .2i
76	greg	1.5	genbox crystal box2 3 7 1 \-b .1 > box2.rad
77	greg	1.6	.PP
78			To produce a transparent box with smoothed, rounded edges:
79			.IP "" .2i
80			genbox glassy box3 2 4 3 -r .25 -n 16 -s > box3.rad
81	greg	1.1	.SH AUTHOR
82			Greg Ward
83			.SH "SEE ALSO"
84	greg	1.5	genrev(1), gensurf(1), genworm(1), obj2mesh(1), obj2rad(1),
85			robjutil(1), rpict(1), rvu(1), xform(1)