Stereo Viewer

Download Stereo Viewer

Stereo Viewer is a Java VM application using some elements of the Open Source Physics api. It is designed to view stereoscopic images with a GeoWall stereoscopic projection system in the spanning video mode. Stereo Viewer includes a stereo-cursor that will appear to move in 3-dimensions. It will load and display the left and right stereo image pairs that are placed in the Left and Right subdirectories and in the same alpha-numeric order of their file names. Supported file types include jpg, gif, and png formats. Below is a screen capture of the program in use. 

How to use

Stereo Viewer is designed to be viewed with a stereoscopic projection system such as a GeoWall. As such, everything that appears on the computer monitor is also projected onto a screen for general viewing. Consequently, when the program is running the display space is used almost exclusivly for the stereoscopic image. There does appear at the upper left hand corner of each image a small X-button to exit the program. Most of the program control is through the keyboard.

    Stereo Images

    Stereo Viewer alows for the stereoscopic projection of three different sources of stereo images. One source provides seperate image files for the left and right eyes. These may originate from a single camera moved a small horizontal distance or from two cameras mounted side-by-side. To view these images, place the left-eye images in the Left subdirectory and the right-eye images in the Right subdirectory. The program will automatically pair the images according to the alphanumeric order of their file names. Another source provides left and right eye images in a single file with the left-eye image on the left hand side. To view these images place them in the Keyed subdirectory. A third source provides left and right eye images in a single file with the left-eye image on the right hand side. These images are intended for cross-eyed vieweing on a computer screen or printed page. Place these images in the KeyedX subdirectory and the program will automatically display the left-eye image on the left hand side of a dual video display.

    Image alignment

    Alignment of the stereo projectors is part of the general setup procedure for a GeoWall system. However, sometimes when making stereo image pairs, by either taking 2 pictures with a single camera moved a small horizontal displacment or using two cameras mounted side-by-side, a particular pair of images may not be vertically aligned or may have a disagreeable toe angle making the 3-dimensional image hard to see. This can be corrected as required by adjusting the image alignment "on the fly". 
  • L key: press to shift right-eye image in the left hand direction.
  • R key: press to shift right-eye image in the right hand direction.
  • U key: press to shift right-eye image in the up direction.
  • D key: press to shift right-eye image in the down direction.
  • Stereo Cursor adjustment

    The stereo cursor will appear to move in 3-dimensional space and can be made to land on a particular point or feature in the stereoscopic image. Regular mouse control will move the cursor in the x-y plane. 
  • Mouse scrolling dial: if the user has a mouse or other pointing device with a scrolling dial the stereo cursor can be made to appear to move towards or away from the viewer by rolling the dial towards or away from the user.
  • Left arrow key: press to move stereo cursor away from viewer.
  • Right arrow key: press to move stereo cursor towards viewer.
  • Up arrow key: press to adjust right-eye cursor in the up direction.
  • Down arrow key: press to adjust right-eye cursor in the down direction.
  • C key: press to change the color of the crosshair stereo cursor. Will cycle through colors orange, blue, green, red, cyan, magenta, yellow, white, gray, and black.
  • Image positioning and magnification

    The stereo image can be moved and zoomed in and out using the mouse. 
  • Left click and drag: to move the image across the screen.
  • Right click and drag up: to increase magnification.
  • Right click and drag down: to decrease magnification.

Credits

Stereo Viewer: Phillip Dukes
Open Source Physics: Wolfgang Christian