stereo3d(1) [debian man page]

STEREO3D(1)						      General Commands Manual						       STEREO3D(1)

NAME

       stereo3d - render a Raster3D scene as a side-by-side stereo pair

SYNOPSIS

	  stereo3d [options] [-png  [outfile.png ]] < infile.r3d > outfile.png
	  stereo3d [options]  -tiff [outfile.tiff]  < infile.r3d > outfile.tiff

       stereo3d is a shell script that renders a single Raster3D input file as a side-by-side stereo pair.

       stereo3d uses the Raster3D utilities normal3d and render, and the ImageMagick image processing package.	Intermediate scratch files are
       created in directory TMPDIR, if defined, otherwise in /usr/tmp.

       The right eye and left eye views are separately rendered, optionally given black borders, and merged to form a single side-by-side stereo
       pair.

       Input is from stdin, output is to stdout unless a filename is given as an argument to the -png or -tiff options.

EXAMPLES

       If the following line would render a single image:

	    render -tiff single.tiff < input.r3d

       then the following line would render the same scene as a stereo pair instead:

	    stereo3d -tiff stereo.tiff < input.r3d

OPTIONS

       The options below are specific to stereo3d.  All other options, e.g. -labels or -gamma 1.2 are passed through to the render program.

       -angsep

       By default the stereo effect is generated by a shear operation.	The -angsep option creates stereo by using angular separation instead.
       Neither option is perfect: the default handles shadows badly, and the -angsep option blurs specular highlights.

       -border

       By default the left and right images are placed next to each other with no intervening space and no frame around them.  The -border option
       requests a 4 pixel wide black border separating and surrounding the component images.

SOURCE

       web URL:
	    http://www.bmsc.washington.edu/raster3d/raster3d.html

       contact:
	    Ethan A Merritt
	    University of Washington, Seattle WA 98195
	    merritt@u.washington.edu

SEE ALSO

       normal3d(l), render(l), raster3d(l)

AUTHORS

	Ethan A Merritt.

Raster3D							    19 Dec 2010 						       STEREO3D(1)

NORMAL3D(1)						      General Commands Manual						       NORMAL3D(1)

NAME

       normal3d - apply transformation matrix in Raster3D input file

SYNOPSIS

       normal3d [options] < infile.r3d > normalized.r3d

DESCRIPTION

       normal3d reads a Raster3D input file from stdin, applies any coordinate manipulations specified in the header, and writes the modified file
       to stdout.

       The output file from normal3d describes exactly the same image as the original input file. Header records are left unchanged except for the
       transfomation matrix (which becomes the identity matrix) and the format specifiers (which are set to *). The -h flag suppresses all header
       records in the output file.  All objects in the input file are also in the output file, but their coordinate descriptions have been normal-
       ized (i.e. the original transformation matrix has been applied).

OPTIONS

       -ang AA

       Only relevant for generating stereo pairs. By default stereo separation is created using a shear operator. The -ang option instead intro-
       duces an angular separation by rotating the left and right eye images by +/- AA degrees with respect to the original view angle.

       -expand

       In-line and normalize all instances of file indirection in the input stream.  This results in a single input file containing no file indi-
       rection.  The default is to simply copy file indirection lines (those begining with @) to the new input file without opening them or nor-
       malizing their contents.

       -h

       Suppress header records in output.  This option is useful for producing files which describe only part of a scene, and which are to be
       later combined with descriptor files

       -size HHHxVVV

       Force the image size to HHH pixels horizontal and VVV pixels vertical.

       -stereo [scratch]

       This option causes the program to produce two additional files, left.r3d and right.r3d, that contain header records suitable for rendering
       the normalized object desctiption file as a side-by-side stereo pair.  This option always suppresses header records in the primary output
       file.  If a scratch directory name is given, it is prepended to give output files {scratch}_left.r3d and {scratch}_right.r3d

SOURCE

       web URL:
	    http://www.bmsc.washington.edu/raster3d/raster3d.html

       contact:
	    Ethan A Merritt
	    University of Washington, Seattle WA 98195
	    merritt@u.washington.edu

SEE ALSO

       render(l), raster3d(l), stereo3d(l)

AUTHORS

	Ethan A Merritt.

Raster3D							    12 Dec 2010 						       NORMAL3D(1)