| 1 | greg | 1.6 | .\" RCSid "$Id: vwright.1,v 1.5 2007/09/04 17:36:41 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 |  |  | 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 | 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) |