SIS(1)

NAME
sis

SYNOPSIS
sis [ infile ] [ outfile ] [ options ]

DESCRIPTION
sis stands for single image stereogram. It reads a given depth-map in tga or tiff format as the infile and generates a SIS in tiff format as the outfile. The format of the input file is detected automatically. The 3D-effect is achieved by assigning two dots the same color in the SIS, if they correspond to the same point in the depth-map. Currently there are 3 algorithms for generating the SIS available. You can choose them with the -a option. The first algorithm is the simplest, and (you guess it) the fastest. The second algorithm additionally propagates pixels of the same color and is a tiny bit slower. The third one does some additional checks for hidden points in the depth-map.

Options

# stands for an integer. Parameters can be seperated from the option by a space, or not.

The most important options are:

-x #
    Width of the SIS in dots. Default is the width of the input picture. Ratios are kept if one of height or width isn't forced.

-x #i#
    Width of the SIS in tenths of inch with the resolution given in dots per inch.

-x #m#
    Width of the SIS in tenths of cm with the resolution given in dots per inch.

-y #
    Height of the SIS in dots. Default is the height of the input picture. Ratios are kept if one of height or width isn't forced.

-y #i#
    Height of the SIS in tenths of inch with the resolution given in dots per inch.

-y #m#
    Height of the SIS in tenths of cm with the resolution given in dots per inch.

-e #
    Distance of your eyes in dots.

-e #i#
    Distance of your eyes in tenths of inch with the resolution in dots per inch.

-e #m#
    Distance of your eyes in tenths of cm with the resolution in dots per inch.

-m  Add two triangles to the top of the SIS at a distance of the convergence strip width. This makes it much easier to reveal the magic effect.

-t file
    Use the tiff-picture file as a texture, instead of the default random black/white dots.

-a #
    Use algorithm # for generating the SIS. Default is algorithm 2.

The more sophisticated options are:

-c #
    Use random color dots for the SIS with # different colors. If # is omitted, the default value is 256.

-d #
    Percentage of black dots in the SIS (density of black).

-f #
    Distance of the far plane. # is the percentage of the distance between your eyes and the SIS.

-n #
    Distance of the near plane. # is the percentage of the distance between the SIS and the far plane.

-g #
    Use random grey dots for the SIS with # different grey-scales. If # is omitted, the default value is 2.

-h  Print a help message and exit.

-i  Invert the depth-map.

-o #
    Start the algorithm at # pixels from the left, i.e. determine the origin of the algorithm. Default is the middle of the picture.

-q  Don't print any messages.

-s #
    Start the random pixel-generation with seed value #.

-v  Print some messages and statistics.

-z  Compress the output picture.

BUGS
Currently, just up to 256 different colors are supported.

SEE ALSO
xli(1), povray(1)

AUTHORS

sis was written by Joerg Bakker. The tga code was taken from xli by Jim Frost.