| 1 | 
greg | 
1.3 | 
.\" RCSid "$Id: genprism.1,v 1.2 2003/12/09 15:59:06 greg Exp $" | 
| 2 | 
greg | 
1.1 | 
.TH GENPRISM 1 3/19/96 RADIANCE | 
| 3 | 
  | 
  | 
.SH NAME | 
| 4 | 
  | 
  | 
genprism - generate a RADIANCE description of a prism | 
| 5 | 
  | 
  | 
.SH SYNOPSIS | 
| 6 | 
  | 
  | 
.B "genprism mat name" | 
| 7 | 
  | 
  | 
{ | 
| 8 | 
  | 
  | 
.B - | 
| 9 | 
  | 
  | 
| | 
| 10 | 
  | 
  | 
.B vfile | 
| 11 | 
  | 
  | 
| | 
| 12 | 
  | 
  | 
.B "N v1 v2 .. vN" | 
| 13 | 
  | 
  | 
} | 
| 14 | 
  | 
  | 
[ | 
| 15 | 
  | 
  | 
.B "\-l lvect" | 
| 16 | 
  | 
  | 
][ | 
| 17 | 
  | 
  | 
.B "\-r radius" | 
| 18 | 
  | 
  | 
][ | 
| 19 | 
  | 
  | 
.B \-c | 
| 20 | 
  | 
  | 
][ | 
| 21 | 
  | 
  | 
.B \-e | 
| 22 | 
  | 
  | 
] | 
| 23 | 
  | 
  | 
.SH DESCRIPTION | 
| 24 | 
  | 
  | 
.I Genprism | 
| 25 | 
  | 
  | 
produces a RADIANCE scene description of a prism, or extruded polygon. | 
| 26 | 
  | 
  | 
The polygon to extrude lies in the z==0 plane, and | 
| 27 | 
  | 
  | 
is given as a list of (x,y) pairs on the | 
| 28 | 
  | 
  | 
standard input (-), or from the file | 
| 29 | 
  | 
  | 
.I vfile, | 
| 30 | 
  | 
  | 
or on the command line preceded by the number of vertices, | 
| 31 | 
  | 
  | 
.I N. | 
| 32 | 
  | 
  | 
The order of the vertices and the extrusion vector | 
| 33 | 
  | 
  | 
.I lvect | 
| 34 | 
  | 
  | 
(default (0,0,1)) determine the surface orientations. | 
| 35 | 
  | 
  | 
The surfaces that make up the prism will be modified by | 
| 36 | 
  | 
  | 
.I mat | 
| 37 | 
  | 
  | 
and their identifiers will begin with | 
| 38 | 
  | 
  | 
.I name. | 
| 39 | 
  | 
  | 
The | 
| 40 | 
  | 
  | 
.I \-r | 
| 41 | 
  | 
  | 
option may be used to round the corners of the object using spheres | 
| 42 | 
  | 
  | 
and cylinders. | 
| 43 | 
  | 
  | 
The | 
| 44 | 
  | 
  | 
.I \-c | 
| 45 | 
  | 
  | 
option inhibits generation of a face connecting the last vertex to the first. | 
| 46 | 
  | 
  | 
The | 
| 47 | 
  | 
  | 
.I \-e | 
| 48 | 
  | 
  | 
option inhibits generation of the end polygons. | 
| 49 | 
  | 
  | 
.SH EXAMPLE | 
| 50 | 
  | 
  | 
To produce a equilateral triangular prism: | 
| 51 | 
  | 
  | 
.IP "" .2i | 
| 52 | 
  | 
  | 
genprism clear_plastic prism 3 0 0 .5 .866 1 0 | 
| 53 | 
  | 
  | 
.SH AUTHOR | 
| 54 | 
  | 
  | 
Greg Ward | 
| 55 | 
  | 
  | 
.SH BUGS | 
| 56 | 
  | 
  | 
The rounding option only works for opaque prisms with outward facing | 
| 57 | 
  | 
  | 
normals. | 
| 58 | 
  | 
  | 
If the normals face inward, the appearance will be bizarre. | 
| 59 | 
  | 
  | 
.SH "SEE ALSO" | 
| 60 | 
greg | 
1.3 | 
genbox(1), genrev(1), gensurf(1), genworm(1), rpict(1), rvu(1), xform(1) |