ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/vwright.1
Revision: 1.7
Committed: Mon Nov 10 19:08:17 2008 UTC (16 years, 6 months ago) by greg
Branch: MAIN
Changes since 1.6: +2 -2 lines
Log Message:
Changed ".pic" extension to ".hdr" throughout

File Contents

# User Rev Content
1 greg 1.7 .\" RCSid "$Id: vwright.1,v 1.6 2008/03/11 02:21:46 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 greg 1.6 Nt: view type ('v'==1,'l'==2,'a'==3,'h'==4,'c'==5,'s'==6)
35 greg 1.1 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 greg 1.7 rpict `vwright -.06 < right.vf` scene.oct > right.hdr &
66 greg 1.1 .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 greg 1.5 rad \-v "right `rad \-n \-s \-V \-v left examp.rif | vwright 2.5`" examp.rif &
73 greg 1.1 .PP
74     To pass a view to
75     .I rcalc
76     for conversion to some other view:
77     .IP "" .2i
78 greg 1.5 rcalc \-n \-e `vwright orig < orig.vf` \-f viewmod.cal \-o view.fmt > new.vf
79 greg 1.1 .SH AUTHOR
80     Greg Ward
81     .SH "SEE ALSO"
82 greg 1.3 pdfblur(1), rad(1), rcalc(1), rpict(1), rvu(1)