/usr/share/doc/raster3d/html/stereo3d.html is in raster3d-doc 3.0-3-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 | <html>
<head>
<title> stereo3d - Raster3D package </title>
<LINK REL=stylesheet HREF="r3d_docstyle.css" TEXT="text/css">
</head>
<body>
<h1 align=center>
STEREO3D
</h1>
<h4>
SYNOPSIS</h4>
stereo3d is a shell script that renders a single
<a href="raster3d.html"> Raster3D </a>
input file as a side-by-side stereo pair.
<pre>
stereo3d [options] [-png] [outfile.png ] < infile.r3d > outfile.png
stereo3d [options] -tiff [outfile.tiff] < infile.r3d > outfile.tiff
</pre>
stereo3d uses the Raster3D utilities
<a href="normal3d.html">normal3d</a> and
<a href="render.html">render</a>,
and the ImageMagick image processing package.
<p>
Input is from <i>stdin</i>, output is to <i>stdout</i> unless explicitly
given on the command line.
Default output format is PNG, but TIFF output can be chosen instead.
Intermediate files are created in directory $TMPDIR, if defined, otherwise
in /usr/tmp.
</p>
<p>
<ul>
<li>By default stereo3d generates stereo separation by applying a shear operator
to the left and right images. The -angsep option allows you to instead generate
stereo separation by rotation rather than shear. Neither method is perfect,
so you can't win. Below is a summary of the weak points of the two methods.
</ul>
<pre>
shear rotation
----- --------
Bounding planes always bad OK
shadows often bad OK
Z-clipping OK serious problem
specular highlights OK minor problem
</pre>
</p>
<h4>EXAMPLES</h4>
If the following line would render single image:
<pre>
render -png single.png < input.r3d
</pre>
then the following line would render the same scene as a stereo pair instead:
<pre>
stereo3d -png stereo.png < input.r3d
</pre>
<h4>OPTIONS</h4>
<dl>
<dt><i>-angsep</i></dt>
<dd>By default the stereo effect is created by applying a shear operator to
the left and right views. The -angset option instead creates stereo by
offsetting the two views by an angular separation of +/- 2.5° from the
original setting.
<dt><i>-border</i></dt>
<dd>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.</dd>
<dt><i>-size HHHxVVV</i></dt>
<dd>Force the size of the left and right images to HHHxVVV pixels,
overriding whatever values are given in the input file.
</dl>
<h4>ENVIRONMENT</h4>
This script requires the
<a href="http://imagemagick.org"> ImageMagick</a> image processing package.
By default stereo3d invokes render with the option <i>-labels</i>
so that labels are processed in stereo also.
<h4>AUTHORS</h4>
Ethan A Merritt.
<hr>
<a href="raster3d.html">
<img src="index_button.gif" align=top> Back to top </a>
<a href="http://www.bmsc.washington.edu/raster3d/raster3d.html">
<img src="r3d_icon.gif" alt="" align=top> Raster3D homepage </a>
</body>
</html>
|