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

Comparing ray/doc/man/man1/gensurf.1 (file contents):
Revision 1.1 by greg, Tue Mar 11 19:20:21 2003 UTC vs.
Revision 1.9 by greg, Tue Jan 21 01:56:27 2025 UTC

# Line 1 | Line 1
1 < .\" RCSid "$Id"
1 > .\" RCSid "$Id$"
2   .TH GENSURF 1 11/15/93 RADIANCE
3   .SH NAME
4 < gensurf - generate a RADIANCE description of a curved surface
4 > gensurf - generate a RADIANCE or Wavefront description of a curved surface
5   .SH SYNOPSIS
6   .B "gensurf mat name 'x(s,t)' 'y(s,t)' 'z(s,t)' m n"
7   [
# Line 10 | Line 10 | gensurf - generate a RADIANCE description of a curved
10   .B "\-f file"
11   ][
12   .B \-s
13 + ][
14 + .B \-i
15 + ][
16 + .B \-o
17   ]
18   .br
19   .B "gensurf mat name 'x(s,t)' 'y(s,t)' dfile m n"
# Line 19 | Line 23 | gensurf - generate a RADIANCE description of a curved
23   .B "\-f file"
24   ][
25   .B \-s
26 + ][
27 + .B \-i
28 + ][
29 + .B \-o
30   ]
31   .br
32   .B "gensurf mat name dfile dfile dfile m n"
33   [
34   .B \-s
35 + ][
36 + .B \-i
37 + ][
38 + .B \-o
39   ]
40   .SH DESCRIPTION
41   .I Gensurf
42 < produces a RADIANCE scene description of a
43 < functional surface defined by the parametric equations
42 > produces either a RADIANCE scene description or a Wavefront .OBJ
43 > file of a functional surface defined by the parametric equations
44   .I x(s,t),
45   .I y(s,t),
46   and
# Line 54 | Line 66 | in any number of
66   and
67   .I \-f
68   options.
69 + The variable and function definitions in each
70 + .I \-f source
71 + file are read and compiled from the RADIANCE library where it is found.
72   The
73   .I \-s
74   option adds smoothing (surface normal interpolation) to the surface.
75 + The
76 + .I \-i
77 + option reverses surface normal directions from the standard
78 + clockwise-from-front orientation.
79 + The
80 + .I \-o
81 + option produces a Wavefront .OBJ file rather than a RADIANCE
82 + scene description.
83 + This is most useful as input to the
84 + .I obj2mesh(1)
85 + program for producing a compiled mesh.
86 + A single "usemtl" statement will appear at the beginning
87 + of the .OBJ output, echoing the modifier given on the command line.
88   .PP
89   Rough holes may be cut in the mesh by defining a valid(s,t) function.
90   Where this function is positive, polygon vertices will be produced.
# Line 93 | Line 121 | gensurf crystal ball 'sin(PI*s)*cos(2*PI*t)' 'cos(PI*s
121   To generate a 10x20 smoothed height field from 12 recorded vertex
122   z values:
123   .IP "" .2i
124 < gensurf dirt ground '10*s' '20*t' height.dat 2 3 -s
124 > gensurf dirt ground '10*s' '20*t' height.dat 2 3 \-s
125 > .SH ENVIRONMENT
126 > RAYPATH         the directories to check for auxiliary files.
127   .SH AUTHOR
128   Greg Ward
129   .SH BUGS
130   The smoothing operation requires that functions be defined
131   beyond the [0,1] boundaries of s and t.
132   .SH "SEE ALSO"
133 < calc(1), genbox(1), genrev(1), genworm(1), rpict(1), rview(1), xform(1)
133 > genbox(1), genrev(1), genworm(1), icalc(1),
134 > obj2mesh(1), obj2rad(1), robjutil(1), rpict(1), rvu(1), xform(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines