STEREO3D
SYNOPSIS
stereo3d is a shell script that renders a single
Raster3D
input file as a side-by-side stereo pair.
The resulting image is placed in file stereo.tiff.
stereo3d [-border] render_input_file.r3d
stereo3d uses the Raster3D utilities
label3d,
normal3d and
render,
and the utility programs identify, mogrify, and montage from
John Cristy's ImageMagick image processing package.
Three intermediate files are produced by normal3d:
- stereo3d.tmp - normalized version of the input file
- left.r3d - header records for left eye view
- right.r3d - header records for right eye view
Additional intermediate files may be produced by label3d.
The two views are separately rendered to yield images left.tiff and right.tiff
(deleted upon completion), optionally given black borders, and merged to form a single
side-by-side stereo pair stereo.tiff.
EXAMPLES
If the following line would render and display a single image:
render -tiff single.tiff < input.r3d; display single.tiff
then the following line would render and display the same scene
as a stereo pair instead:
stereo3d input.r3d; display stereo.tiff
NB: The output image is always called stereo.tiff; there is no
provision at present to specify some other name.
OPTIONS
- -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.
ENVIRONMENT
This script requires TIFF support in render, the unix utility sed, and the
ImageMagick image processing package. The three intermediate files
listed above are created each time the script is run. Any exiting files
named left.tiff, right.tiff, or stereo.tiff will be destroyed.
The default version of stereo3d invokes the label3d
script so that labels are processed in stereo also. If label3d processing
is not configured on your machine you may want to replace the stereo3d
script with an alternate version named stereo3d_nolabels in the Raster3D
distribution package.
AUTHORS
Ethan A Merritt.
Back to top
Raster3D homepage