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

Comparing ray/doc/man/man1/vwrays.1 (file contents):
Revision 1.3 by greg, Thu May 26 06:55:22 2005 UTC vs.
Revision 1.10 by greg, Thu Jun 14 22:42:21 2012 UTC

# Line 4 | Line 4
4   vwrays - compute rays for a given picture or view
5   .SH SYNOPSIS
6   .B vwrays
7 < .B "[ -i -f{a|f|d} | -d ]"
7 > .B "[ -i -u -f{a|f|d} -c rept | -d ]"
8   {
9   .B "view opts .."
10   |
# Line 22 | Line 22 | If a given pixel has no corresponding ray (because it
22   legal view boundaries), then six zero values are sent instead.
23   .PP
24   The
25 < .I -i
25 > .I \-i
26   option may be used to specify desired pixel positions on the standard
27   input rather than generating all the pixels for a given view.
28 + If the
29 + .I \-u
30 + option is also given, output will be unbuffered.
31   .PP
32   The
33 < .I -f
33 > .I \-f
34   option may be used to set the record format to something other than the
35   default ASCII.
36   Using raw float or double records for example can reduce the time
37   requirements of transferring and interpreting information in
38   .I rtrace.
39   .PP
40 + The
41 + .I \-c
42 + option repeats each pixel the given number of times (default is 1).
43 + This is most useful when sending rays to
44 + .I rcontrib(1)
45 + with the same
46 + .I \-c
47 + setting, providing a much faster way to average pixels over image sets.
48 + The
49 + .I \-pj
50 + option should be used to jitter sample postions in most cases.
51 + .PP
52   View options may be any combination of standard view parameters described
53   in the
54   .I rpict(1)
# Line 41 | Line 56 | manual page, including input from a view file with the
56   .I \-vf
57   option.
58   Additionally, the target X and Y dimensions may be specified with
59 < .I -x
59 > .I \-x
60   and
61 < .I -y
61 > .I \-y
62   options, and the pixel aspect ratio may be given with
63 < .I -p.
63 > .I \-pa.
64   The default dimensions are 512x512, with a pixel aspect ratio of 1.0.
65   Just as in
66   .I rpict,
67   the X or the Y dimension will be reduced if necessary
68   to best match the specified pixel
69   aspect ratio, unless this ratio is set to zero.
70 + The
71 + .I \-pj
72 + option may be used to jitter samples.
73 + The default value of 0 turns off ray jittering.
74   .PP
75   If the
76 < .I -d
76 > .I \-d
77   option is given, then
78   .I vwrays
79   just prints the computed image dimensions, which are based on the view
80   aspect and the pixel aspect ratio just described.
81   The
82 < .I -ld
82 > .I \-ld
83   switch will also be printed, with
84 < .I -ld+
84 > .I \-ld+
85   if the view file has an aft clipping plane, and
86 < .I -ld-
86 > .I \-ld-
87   otherwise.
88   This is useful for passing options to the
89   .I rtrace
# Line 78 | Line 97 | equal the maximum distance for each pixel, which will
97   correctly by
98   .I rtrace
99   with the
100 < .I -ld+
100 > .I \-ld+
101   option.
102   Note that this option should not be given unless there is an aft
103   clipping plane, since the ray direction vectors will be normalized
# Line 86 | Line 105 | otherwise, which would produce a uniform clipping dist
105   .PP
106   If a picture is given on the command line rather than a set of view options,
107   then the view and image dimensions are taken from the picture file, and
108 < the reported ray origins and directions will exactly match the center of each
109 < pixel in the picture.
108 > the reported ray origins and directions will match the center of each
109 > pixel in the picture (plus optional jitter).
110   .PP
111   If a depth buffer file is given as well, then
112   .I vwrays
# Line 101 | Line 120 | for light rays leaving the scene surfaces to strike ea
120   To compute the ray intersection points and returned directions corresponding
121   to a picture and its depth buffer:
122   .IP "" .2i
123 < vwrays scene_v2.pic scene_v2.zbf > scene_v2.pts
123 > vwrays scene_v2.hdr scene_v2.zbf > scene_v2.pts
124   .PP
125   To determine what the dimensions of a given view would be:
126   .IP "" .2i
127 < vwrays -d -vf myview.vf -x 2048 -y 2048
127 > vwrays \-d \-vf myview.vf \-x 2048 \-y 2048
128   .PP
129   To generate a RADIANCE picture using
130   .I rtrace
131   instead of
132   .I rpict:
133   .IP "" .2i
134 < vwrays -ff -vf view1.vf -x 1024 -y 1024 |
135 < rtrace `vwrays -d -vf view1.vf -x 1024 -y 1024` -ffc scene.oct > view1.pic
134 > vwrays \-ff \-vf view1.vf \-x 1024 \-y 1024 |
135 > rtrace `vwrays \-d \-vf view1.vf \-x 1024 \-y 1024` \-ffc scene.oct > view1.hdr
136   .SH AUTHOR
137   Greg Ward Larson
138   .SH ACKNOWLEDGMENT
# Line 125 | Line 144 | can reproduce any pixel ordering (i.e., any image orie
144   a rendered picture, it will only produce standard scanline-ordered rays when
145   given a set of view parameters.
146   .SH "SEE ALSO"
147 < rcalc(1), rpict(1), rtcontrib(1), rtrace(1)
147 > rcalc(1), rpict(1), rcontrib(1), rtrace(1)

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines