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)
Check Out this Related Man Page
Raster3D(1) General Commands Manual Raster3D(1)NAME
Raster3D - molecular graphics package
SYNOPSIS
The Raster3D molecular graphics package consists of a core program render and a number of ancillary programs (balls, rastep, rods) which
produce input files for rendering from PDB (Protein Data Bank) files of atomic coordinates. Raster3D can also render images composed using
other programs such as MOLSCRIPT [Per Kraulis (1991), J. Appl. Cryst. 24, 946-950].
Raster3D is freely available. If you use the package to prepare figures for publication, please give proper credit to the authors. The
proper citation for the current version is Merritt & Bacon (1997).
Bacon & Anderson (1988) J. Molec. Graphics 6, 219-220.
Merritt & Murphy (1994) Acta Cryst. D50, 869-873.
Merritt & Bacon (1997) Meth. Enzymol. 277, 505-524.
DESCRIPTION
Raster3D uses a fast Z-buffer algorithm to produce high quality pixel images featuring one shadowing light source, additional non-shadowing
light sources, specular highlighting, transparency, and Phong shaded surfaces. Output is in the form of a pixel image with 24 bits of
color information per pixel. Raster3D does not depend on graphics hardware.
The following image output formats are supported: AVS, JPEG, PNG, TIFF, and SGI libimage. To actually view or manipulate the images pro-
duced, you must also have installed an image viewing package (e.g. John Cristy's ImageMagick or the SGI libimage utilities). A filter
utility avs2ps is included in the package which can convert an AVS format output stream directly to a dithered monochrome PostScript image.
Although Raster3D is not intended as a general purpose ray-tracing package, nothing in the rendering process is specific to molecular
graphics.
EXAMPLES
Using only programs included in the Raster3D distribution one can create and render space-filling models, ball-and-stick models, ribbon
models, and figures composed of any combination of these. The following set of commands would produce a composite figure of an Fe-contain-
ing metalloprotein with a smoothly shaded ribbon representation of the protein and spheres drawn for the Fe atoms:
#
# Draw smooth ribbon with default color scheme 2,
# save description (with header records) in ribbon.r3d
#
cat protein.pdb | ribbon -d2 > ribbon.r3d
#
# Extract Fe atoms only, and draw as spheres.
# Color info is taken from colorfile.
# Save description (with no header records) in irons.r3d
#
grep "FE" protein.pdb | cat colorfile - | balls -h > irons.r3d
#
# combine the two descriptions and render to a PNG image
#
cat ribbon.r3d irons.r3d | render > picture.png
Integrated use of MOLSCRIPT/Raster3D/ImageMagick allows one to describe, render, and view 3D representations of existing MOLSCRIPT figures:
molscript -r infile.dat | render | display png:-
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), rastep(l), rods(l), ribbon(l), balls(l), avs2ps(l), stereo3d(l)
AUTHORS
Originally written by David J Bacon and Wayne F Anderson.
Ancillary programs by Mark Israel, Stephen Samuel, Michael Murphy, Albert Berghuis, and Ethan A Merritt. Extensions, revisions, and modi-
fications by Ethan A Merritt.
Raster3D V3.0 14 December 2010 Raster3D(1)