ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/vwright.1
Revision: 1.8
Committed: Sun Jun 14 00:33:15 2009 UTC (15 years, 11 months ago) by greg
Branch: MAIN
Changes since 1.7: +7 -2 lines
Log Message:
Added new genklemsamp utility and made vwright more useful

File Contents

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