--- ray/doc/man/man1/rpict.1 2007/09/04 17:36:41 1.11 +++ ray/doc/man/man1/rpict.1 2008/11/10 19:08:17 1.13 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rpict.1,v 1.11 2007/09/04 17:36:41 greg Exp $" +.\" RCSid "$Id: rpict.1,v 1.13 2008/11/10 19:08:17 greg Exp $" .TH RPICT 1 2/26/99 RADIANCE .SH NAME rpict - generate a RADIANCE picture @@ -70,13 +70,21 @@ A cylindrical panorma may be selected by setting to the letter 'c'. This view is like a standard perspective vertically, but projected on a cylinder horizontally (like a soupcan's-eye view). -Two fisheye views are provided as well; 'h' yields a hemispherical fisheye -view and 'a' results in angular fisheye distortion. +Three fisheye views are provided as well; 'h' yields a hemispherical fisheye +view, 'a' results in angular fisheye distortion, and 's' +results in a planisphere (stereographic) projection. A hemispherical fisheye is a projection of the hemisphere onto a circle. The maximum view angle for this type is 180 degrees. An angular fisheye view is defined such that distance from the center of the image is proportional to the angle from the central view direction. An angular fisheye can display a full 360 degrees. +A planisphere fisheye view maintains angular relationships between lines, +and is commonly used for sun path analysis. +This is more commonly known as a +"stereographic projection," but we avoid the term here so as not to +confuse it with a stereoscopic pair. +A planisphere fisheye can display up to (but not including) 360 degrees, +although distortion becomes extreme as this limit is approached. Note that there is no space between the view type option and its single letter argument. .TP @@ -788,9 +796,9 @@ Boolean switch for warning messages. The default is to print warnings, so the first appearance of this option turns them off. .SH EXAMPLE -rpict \-vp 10 5 3 \-vd 1 \-.5 0 scene.oct > scene.pic +rpict \-vp 10 5 3 \-vd 1 \-.5 0 scene.oct > scene.hdr .PP -rpict \-S 1 \-o frame%02d.pic scene.oct < keyframes.vf +rpict \-S 1 \-o frame%02d.hdr scene.oct < keyframes.vf .SH ENVIRONMENT RAYPATH the directories to check for auxiliary files. .SH FILES