| 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) |