| STEREOGRAPH(1) | General Commands Manual | STEREOGRAPH(1) |
NAME¶
stereograph - stereogram generator
SYNOPSIS¶
stereograph [options] -b base -t texture [-o output]
DESCRIPTION¶
Stereograph is a stereogram generator. In detail it is a single image stereogram (SIS) generator. It produces twodimensional images that seem to be threedimensional.
base is the file describung the ”relief“ of the 3d model. It is a simple graphic where the brightness of a pixel defines its individual depth. The darker a pixel is, the more far away it will seem to be in the final stereogram - the brighter it is, the closer it will be.
The texture is that what everyone sees when regarding your stereogram - even if he cannot get in the third dimensions of the composition.
The width of the texture stands for the maximum depth of any steregram and it cannot be greater than the distance of a viewer's two eyes - otherwise they won't be able to see anything in the stereogram but the beautiful great texture. As a hand rule, 100 should work nice for stereograms of 640*480 up to 800*600 pixels. Use 110 to 120 for greater ones.
The files given as base and texture must be supplied either in the tga or in the png format. Which you used is derived from the file name.
output is the file where the stereogram is written to. The file format to use is deduced from the filename given if not overridden by -F. (q.tga“, (q.png“, and (q.ppm“ are supported. If not given, stereograph will write the image in PPM or the format given with -F format to the standard output.
OPTIONS¶
- -v
- Be verbose.
- -F outputformat
- outputformat is one of the following: tga, png, or ppm.
Quality controling arguments¶
- -a anti-aliasing
- anti-aliasing describes a value between 1 and 32 (4 is the default) that declares how many pixels shall be calculated by the renderer virtually for ONE pixel.
- You can calculate easily: physically you habe n depth levels, where n is the width of the texture used for the stereogram. With the AA feature you now have theoretically a*n levels. This feature increases _massively_ the color depth of the output file
- -z zoom
- based on the same idea as AA and has the same effects but physically increases the file size. Values range from 1 (default) up to 32.
- -r (experimental)
- The anti-artefacts feature tells stereograph to process every second line in reversed order to prevent artefacts. This flag should be used only with random textures.
perspective¶
- -d distance
- distance describes the distance of your eyes and the virtual glass that is between you and your stereogram. Allowed are values from 0.0 up to 8.0 where 0.6 is the default.
- -e eye-shift
- eye-shift (a value between -1.0 and 1.0) controls the perspective along the x axis (left to right). That is if e is positive the image is shifted slightly to the right. The default value of 0.0 is exactly the centered perspective.
layout¶
- -x texture-insert-x
- texture-insert-x is a value between 0 and the width of the texture controlling where the texture is inserted the first time and where the rendering process begins its round. default: 0 (left image border).
- -y texture-insert-y
- texture-insert-y is a value between 0 and the height of the texture controlling where the texture is inserted the first time and where the rendering process begins its round. default: 0 (top image border).
BUGS¶
There's still no random texture generator implemented yet.
SEE ALSO¶
/usr/share/doc/stereograph/README
AUTHOR¶
stereograph has been written by Fabian Januszewski <fabian.linux@januszewski.de>.
This manual page was written by Peter Palfrader <ppalfrad@cosy.sbg.ac.at> using large parts from the README file, for the Debian GNU/Linux system (but may be used by others).
| April 20, 2000 |