stereo3d(1) 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 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.


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


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


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.


  web URL:

        Ethan A Merritt

        University of Washington, Seattle WA 98195

        [email protected]


 Ethan A Merritt.