--- ray/doc/man/man1/vwright.1 2004/01/01 19:31:45 1.3 +++ ray/doc/man/man1/vwright.1 2009/06/14 00:33:15 1.8 @@ -1,21 +1,26 @@ -.\" RCSid "$Id: vwright.1,v 1.3 2004/01/01 19:31:45 greg Exp $" +.\" RCSid "$Id: vwright.1,v 1.8 2009/06/14 00:33:15 greg Exp $" .TH VWRIGHT 1 8/29/96 RADIANCE .SH NAME vwright - normalize a RADIANCE view, shift it to the right .SH SYNOPSIS .B vwright +.B "[ view options ]" .B distance .br .B vwright .B name .SH DESCRIPTION .I Vwright -shifts a RADIANCE view from a picture or view file given on the standard input +shifts a RADIANCE view the specified distance to the right, putting out a complete set of view parameters in a single line on the standard output. This utility is most often used to compute a right-eyed view from a left-eye view for stereo imaging. .PP +If no options are specified on the command line, +.I vwright +reads a view from its standard input. +.PP The .I distance given is in world coordinate units. @@ -31,13 +36,14 @@ For a given prefix the constant names are as follows: .sp .nf -Nt: view type ('v'==1,'l'==2,'a'==3,'h'==4,'c'==5) +Nt: view type ('v'==1,'l'==2,'a'==3,'h'==4,'c'==5,'s'==6) Npx: view point x value Npy: view point y value Npz: view point z value Ndx: view direction x value (normalized) Ndy: view direction y value (normalized) Ndz: view direction z value (normalized) +Nd: view focal distance Nux: view up vector x value (normalized) Nuy: view up vector y value (normalized) Nuz: view up vector z value (normalized) @@ -61,20 +67,20 @@ To start .I rpict(1) on a view .06 meters left of the view in the file "right.vf": .IP "" .2i -rpict `vwright -.06 < right.vf` scene.oct > right.pic & +rpict `vwright -.06 < right.vf` scene.oct > right.hdr & .PP To move the .I rad(1) view named "left" 2.5 inches to the right and render from there: .IP "" .2i -rad -v "right `rad -n -s -V -v left examp.rif | vwright 2.5`" examp.rif & +rad \-v "right `rad \-n \-s \-V \-v left examp.rif | vwright 2.5`" examp.rif & .PP To pass a view to .I rcalc for conversion to some other view: .IP "" .2i -rcalc -n -e `vwright orig < orig.vf` -f viewmod.cal -o view.fmt > new.vf +rcalc \-n \-e `vwright orig < orig.vf` \-f viewmod.cal \-o view.fmt > new.vf .SH AUTHOR Greg Ward .SH "SEE ALSO"