Langue: en

Version: 19 May 2003 (ubuntu - 07/07/09)

Section: 1 (Commandes utilisateur)


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


   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 label3d, 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.

The syntax for stereo3d has been changed in version 2.6e to match that of render. Input is from stdin, output is to stdout unless a filename is given as an argument to the -png or -tiff options.


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



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.


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.

-size HHHxVVV

Both the left and right eye views are forced to this size in pixels, overriding whatever size is given in the header records of the input file.


  web URL:

        Ethan A Merritt

        University of Washington, Seattle WA 98195


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


 Ethan A Merritt.