ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/vwright.1
Revision: 1.2
Committed: Tue Dec 9 15:59:07 2003 UTC (20 years, 5 months ago) by greg
Branch: MAIN
Changes since 1.1: +1 -1 lines
Log Message:
Fixed RCSid specification

File Contents

# Content
1 .\" RCSid "$Id$"
2 .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 Nux: view up vector x value (normalized)
42 Nuy: view up vector y value (normalized)
43 Nuz: view up vector z value (normalized)
44 Nh: view horizontal size
45 Nv: view vertical size
46 Ns: view shift
47 Nl: view lift
48 No: view fore clipping distance
49 Na: view aft clipping distance
50 Nhx: derived horizontal image vector x value (normalized)
51 Nhy: derived horizontal image vector y value (normalized)
52 Nhz: derived horizontal image vector z value (normalized)
53 Nhn: derived horizontal image vector multiplier
54 Nvx: derived vertical image vector x value (normalized)
55 Nvy: derived vertical image vector y value (normalized)
56 Nvz: derived vertical image vector z value (normalized)
57 Nvn: derived vertical image vector multiplier
58 .fi
59 .SH EXAMPLES
60 To start
61 .I rpict(1)
62 on a view .06 meters left of the view in the file "right.vf":
63 .IP "" .2i
64 rpict `vwright -.06 < right.vf` scene.oct > right.pic &
65 .PP
66 To move the
67 .I rad(1)
68 view named "left" 2.5 inches to the right
69 and render from there:
70 .IP "" .2i
71 rad -v "right `rad -n -s -V -v left examp.rif | vwright 2.5`" examp.rif &
72 .PP
73 To pass a view to
74 .I rcalc
75 for conversion to some other view:
76 .IP "" .2i
77 rcalc -n -e `vwright orig < orig.vf` -f viewmod.cal -o view.fmt > new.vf
78 .SH AUTHOR
79 Greg Ward
80 .SH "SEE ALSO"
81 pdfblur(1), rad(1), rcalc(1), rpict(1), rview(1)