--- ray/doc/man/man1/vwright.1 2005/01/18 00:33:15 1.4 +++ ray/doc/man/man1/vwright.1 2009/06/22 00:03:47 1.9 @@ -1,21 +1,28 @@ -.\" RCSid "$Id: vwright.1,v 1.4 2005/01/18 00:33:15 greg Exp $" +.\" RCSid "$Id: vwright.1,v 1.9 2009/06/22 00:03:47 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 "[ view options ]" .B name .SH DESCRIPTION -.I Vwright -shifts a RADIANCE view from a picture or view file given on the standard input +In the first form, +.I vwright +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,7 +38,7 @@ 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 @@ -62,20 +69,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"