ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/genbox.1
(Generate patch)

Comparing ray/doc/man/man1/genbox.1 (file contents):
Revision 1.4 by greg, Tue Sep 4 17:36:40 2007 UTC vs.
Revision 1.5 by greg, Fri Apr 9 01:48:20 2021 UTC

# Line 1 | Line 1
1   .\" RCSid "$Id$"
2   .TH GENBOX 1 11/15/93 RADIANCE
3   .SH NAME
4 < genbox - generate a RADIANCE description of a box
4 > genbox - generate a RADIANCE or Wavefront description of a box
5   .SH SYNOPSIS
6   .B "genbox mat name xsiz ysiz zsiz"
7   [
8   .B \-i
9   ][
10 .B "\-r rad"
11 |
10   .B "\-b bev"
11 + |
12 + .B "\-r rad"
13 + [
14 + .B "\-n nseg
15   ]
16 + ][
17 + .B \-o
18 + ]
19   .SH DESCRIPTION
20   .I Genbox
21   produces a RADIANCE scene description of a parallelepiped
# Line 22 | Line 27 | 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 + .PP
31   The
32   .I \-i
33   option can be used to produce a box with inward directed surface
34   normals.
35 + .PP
36   The
30 .I \-r
31 option can be used to specify the radius for rounded edges.
32 The
37   .I \-b
38   option can be used to specify the indentation for beveled edges.
39 + .PP
40 + The
41 + .I \-r
42 + 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 + The
55 + .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   .SH EXAMPLE
62 < To produce a rectangular box made of wood with beveled edges:
62 > To produce a rectangular box made of wood with rounded edges:
63   .IP "" .2i
64 < genbox wood box1 5 8 3 \-b .5 > box1
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 > .IP "" .2i
68 > genbox crystal box2 3 7 1 \-b .1 > box2.rad
69   .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 + 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   .SH "SEE ALSO"
82 < genrev(1), gensurf(1), genworm(1), rpict(1), rvu(1), xform(1)
82 > genrev(1), gensurf(1), genworm(1), obj2mesh(1), obj2rad(1),
83 > robjutil(1), rpict(1), rvu(1), xform(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines