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.12 by greg, Sat Dec 4 16:29:29 2021 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+
89 > .I \-ld+
90   if the view file has an aft clipping plane, and
91 < .I -ld-
91 > .I \-ld-
92   otherwise.
93   This is useful for passing options to the
94   .I rtrace
# Line 78 | Line 102 | equal the maximum distance for each pixel, which will
102   correctly by
103   .I rtrace
104   with the
105 < .I -ld+
105 > .I \-ld+
106   option.
107   Note that this option should not be given unless there is an aft
108   clipping plane, since the ray direction vectors will be normalized
# Line 86 | Line 110 | otherwise, which would produce a uniform clipping dist
110   .PP
111   If a picture is given on the command line rather than a set of view options,
112   then the view and image dimensions are taken from the picture file, and
113 < the reported ray origins and directions will exactly match the center of each
114 < pixel in the picture.
113 > the reported ray origins and directions will match the center of each
114 > pixel in the picture (plus optional jitter).
115   .PP
116   If a depth buffer file is given as well, then
117   .I vwrays
# Line 101 | Line 125 | for light rays leaving the scene surfaces to strike ea
125   To compute the ray intersection points and returned directions corresponding
126   to a picture and its depth buffer:
127   .IP "" .2i
128 < vwrays scene_v2.pic scene_v2.zbf > scene_v2.pts
128 > vwrays scene_v2.hdr scene_v2.zbf > scene_v2.pts
129   .PP
130   To determine what the dimensions of a given view would be:
131   .IP "" .2i
132 < vwrays -d -vf myview.vf -x 2048 -y 2048
132 > vwrays \-d \-vf myview.vf \-x 2048 \-y 2048
133   .PP
134   To generate a RADIANCE picture using
135   .I rtrace
136   instead of
137   .I rpict:
138   .IP "" .2i
139 < vwrays -ff -vf view1.vf -x 1024 -y 1024 |
140 < rtrace `vwrays -d -vf view1.vf -x 1024 -y 1024` -ffc scene.oct > view1.pic
139 > vwrays \-ff \-vf view1.vf \-x 1024 \-y 1024 |
140 > rtrace `vwrays \-d \-vf view1.vf \-x 1024 \-y 1024` \-ffc scene.oct > view1.hdr
141   .SH AUTHOR
142   Greg Ward Larson
143   .SH ACKNOWLEDGMENT
# Line 125 | Line 149 | can reproduce any pixel ordering (i.e., any image orie
149   a rendered picture, it will only produce standard scanline-ordered rays when
150   given a set of view parameters.
151   .SH "SEE ALSO"
152 < rcalc(1), rpict(1), rtcontrib(1), rtrace(1)
152 > rcalc(1), rcode_depth(1), rcontrib(1), rpict(1), rtpict(1), rtrace(1)

Diff Legend

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