ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/vwright.1
Revision: 1.4
Committed: Tue Jan 18 00:33:15 2005 UTC (19 years, 4 months ago) by greg
Branch: MAIN
CVS Tags: rad3R7P2, rad3R7P1, rad3R8
Changes since 1.3: +2 -1 lines
Log Message:
Added -pd option for depth-of-field sampling and -vd focal distance entry

File Contents

# User Rev Content
1 greg 1.4 .\" RCSid "$Id: vwright.1,v 1.3 2004/01/01 19:31:45 greg Exp $"
2 greg 1.1 .TH VWRIGHT 1 8/29/96 RADIANCE
3     .SH NAME
4     vwright - normalize a RADIANCE view, shift it to the right
5     .SH SYNOPSIS
6     .B vwright
7     .B distance
8     .br
9     .B vwright
10     .B name
11     .SH DESCRIPTION
12     .I Vwright
13     shifts a RADIANCE view from a picture or view file given on the standard input
14     the specified distance to the right, putting out a complete set of
15     view parameters in a single line on the standard output.
16     This utility is most often used to compute a right-eyed view from
17     a left-eye view for stereo imaging.
18     .PP
19     The
20     .I distance
21     given is in world coordinate units.
22     A negative value indicates a shift to the left rather than the
23     right.
24     .PP
25     The second form substitutes a name prefix in place of the shift
26     distance, and produces constant assignments on the standard output
27     suitable for passing directly to
28     .I rcalc(1).
29     For a given prefix
30     .I N,
31     the constant names are as follows:
32     .sp
33     .nf
34     Nt: view type ('v'==1,'l'==2,'a'==3,'h'==4,'c'==5)
35     Npx: view point x value
36     Npy: view point y value
37     Npz: view point z value
38     Ndx: view direction x value (normalized)
39     Ndy: view direction y value (normalized)
40     Ndz: view direction z value (normalized)
41 greg 1.4 Nd: view focal distance
42 greg 1.1 Nux: view up vector x value (normalized)
43     Nuy: view up vector y value (normalized)
44     Nuz: view up vector z value (normalized)
45     Nh: view horizontal size
46     Nv: view vertical size
47     Ns: view shift
48     Nl: view lift
49     No: view fore clipping distance
50     Na: view aft clipping distance
51     Nhx: derived horizontal image vector x value (normalized)
52     Nhy: derived horizontal image vector y value (normalized)
53     Nhz: derived horizontal image vector z value (normalized)
54     Nhn: derived horizontal image vector multiplier
55     Nvx: derived vertical image vector x value (normalized)
56     Nvy: derived vertical image vector y value (normalized)
57     Nvz: derived vertical image vector z value (normalized)
58     Nvn: derived vertical image vector multiplier
59     .fi
60     .SH EXAMPLES
61     To start
62     .I rpict(1)
63     on a view .06 meters left of the view in the file "right.vf":
64     .IP "" .2i
65     rpict `vwright -.06 < right.vf` scene.oct > right.pic &
66     .PP
67     To move the
68     .I rad(1)
69     view named "left" 2.5 inches to the right
70     and render from there:
71     .IP "" .2i
72     rad -v "right `rad -n -s -V -v left examp.rif | vwright 2.5`" examp.rif &
73     .PP
74     To pass a view to
75     .I rcalc
76     for conversion to some other view:
77     .IP "" .2i
78     rcalc -n -e `vwright orig < orig.vf` -f viewmod.cal -o view.fmt > new.vf
79     .SH AUTHOR
80     Greg Ward
81     .SH "SEE ALSO"
82 greg 1.3 pdfblur(1), rad(1), rcalc(1), rpict(1), rvu(1)