STEREOIMG(1)

NAME

stereoimg - produce stereo pair of rendered molecule

MIDAS COMMAND SYNTAX

Command: stereoimg -p renderer [ -c ] [ -t ] [ -s ] [ -v ] [ -o outfile ] [ -C renderer_options ]

DESCRIPTION

Stereoimg takes the molecule(s) being displayed in MIDAS and creates a walleye stereo image pair using the specified renderer, which must be either ribbonjr, conic or neon. By default, the image is stored in a file called stereoimg.tiff and can be displayed with the program imgview.

The options flags have the following meanings:

-c

Generate a crosseye stereo pair instead of walleye.

-t

Normally stereoimg fits each half of the stereo pair into a half-screen by expanding one dimension of the original MIDAS window until it is the correct aspect ratio. If the -t option is given, the MIDAS window will be brought into the correct aspect ratio by trimming one dimension. This may result in part of the image being clipped, but will also result in less blank screen area. For optimal screen filling, reshape the MIDAS window to about the same aspect ratio as half the screen and get the image you want before running stereoimg.

-s

Show the image immediately with imgview(1). Without this flag, the image is deposited in the output file and not displayed.

-o

Deposit the image into the named output file, instead of the default stereoimg.tiff.

-p

Use the named rendering program to generate the pair image. Legal values for the renderer flag are conic, ribbonjr and neon. This flag is mandatory.

-v

Make the pair in a fashion appropriate for use with a mechanical stereo viewer, typically used with journal publications. Each eye image will have a square aspect ratio. If you convert the image to PostScript with the itops(1) program, giving a scale factor (with the -s option to itops) of 0.375 will produce a final image where each eye image is 2.5 inches square (a typical size used in journals). Other scale factors can be used for larger or smaller images.

-C

This flag indicates the end of arguments for stereoimg.

Any arguments which follow the -C flag will be passed on to the rendering program.

NeXT DIFFERENCES

On NEXTSTEP, ribbonjr does not work as a rendering program.

BUGS

Stereoimg assumes that the size of the screen is 1280 by 1024.

AUTHORS

Conrad Huang

Eric Pettersen

UCSF Computer Graphics Laboratory