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.2 by greg, Tue Dec 9 15:59:07 2003 UTC vs.
Revision 1.13 by greg, Sat Apr 9 17:18:08 2022 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 + and/or
51 + .I \-pd
52 + options should be used to jitter sample postions in most cases.
53 + .PP
54   View options may be any combination of standard view parameters described
55   in the
56   .I rpict(1)
# Line 41 | Line 58 | manual page, including input from a view file with the
58   .I \-vf
59   option.
60   Additionally, the target X and Y dimensions may be specified with
61 < .I -x
61 > .I \-x
62   and
63 < .I -y
63 > .I \-y
64   options, and the pixel aspect ratio may be given with
65 < .I -p.
65 > .I \-pa.
66   The default dimensions are 512x512, with a pixel aspect ratio of 1.0.
67   Just as in
68   .I rpict,
69   the X or the Y dimension will be reduced if necessary
70   to best match the specified pixel
71   aspect ratio, unless this ratio is set to zero.
72 + The
73 + .I \-pj
74 + option may be used to jitter samples.
75 + The
76 + .I \-pd
77 + option specifies a world-diameter aperture for depth-of-field jittering.
78 + The default value of 0 for both options turns off all ray jittering.
79   .PP
80   If the
81 < .I -d
81 > .I \-d
82   option is given, then
83   .I vwrays
84   just prints the computed image dimensions, which are based on the view
85   aspect and the pixel aspect ratio just described.
86   The
87 < .I -ld
87 > .I \-ld
88   switch will also be printed, with
89 < .I -ld+
90 < if the view file has an aft clipping plane, and
67 < .I -ld-
68 < otherwise.
89 > .I \-ld+
90 > if the view has an aft clipping plane.
91   This is useful for passing options to the
92   .I rtrace
93   command line.
# Line 78 | Line 100 | equal the maximum distance for each pixel, which will
100   correctly by
101   .I rtrace
102   with the
103 < .I -ld+
103 > .I \-ld+
104   option.
105   Note that this option should not be given unless there is an aft
106   clipping plane, since the ray direction vectors will be normalized
# Line 86 | Line 108 | otherwise, which would produce a uniform clipping dist
108   .PP
109   If a picture is given on the command line rather than a set of view options,
110   then the view and image dimensions are taken from the picture file, and
111 < the reported ray origins and directions will exactly match the center of each
112 < pixel in the picture.
111 > the reported ray origins and directions will match the center of each
112 > pixel in the picture (plus optional jitter).
113   .PP
114   If a depth buffer file is given as well, then
115   .I vwrays
# Line 101 | Line 123 | for light rays leaving the scene surfaces to strike ea
123   To compute the ray intersection points and returned directions corresponding
124   to a picture and its depth buffer:
125   .IP "" .2i
126 < vwrays scene_v2.pic scene_v2.zbf > scene_v2.pts
126 > vwrays scene_v2.hdr scene_v2.zbf > scene_v2.pts
127   .PP
128   To determine what the dimensions of a given view would be:
129   .IP "" .2i
130 < vwrays -d -vf myview.vf -x 2048 -y 2048
130 > vwrays \-d \-vf myview.vf \-x 2048 \-y 2048
131   .PP
132   To generate a RADIANCE picture using
133   .I rtrace
134   instead of
135   .I rpict:
136   .IP "" .2i
137 < vwrays -ff -vf view1.vf -x 1024 -y 1024 |
138 < rtrace `vwrays -d -vf view1.vf -x 1024 -y 1024` -ffc scene.oct > view1.pic
137 > vwrays \-ff \-vf view1.vf \-x 1024 \-y 1024 |
138 > rtrace `vwrays \-d \-vf view1.vf \-x 1024 \-y 1024` \-ffc scene.oct > view1.hdr
139   .SH AUTHOR
140   Greg Ward Larson
141   .SH ACKNOWLEDGMENT
# Line 125 | Line 147 | can reproduce any pixel ordering (i.e., any image orie
147   a rendered picture, it will only produce standard scanline-ordered rays when
148   given a set of view parameters.
149   .SH "SEE ALSO"
150 < rcalc(1), rpict(1), rtrace(1)
150 > rcalc(1), rcode_depth(1), rcontrib(1), rpict(1), rtpict(1), rtrace(1)

Diff Legend

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