StereoVideoLib is a library I am using to experiment with stereo vision
algorithms on Mac OS X.

StereoVideoLib is based on David Cairns' <http://www.cse.psu.edu/~dcairns/>  
isight_texture <http://www.cse.psu.edu/~dcairns/images/isight_texture.tar>.
I am grateful to him for allowing me to redistribute a modified version of his code.

--------------------------------------------------------------------------------------------------------------------------------

This code provides the following to the programmer:
	1) left and right camera images (pFrameLeft, pFrameRight)
	2) direct pixel access to the images (frames),
	3) a function for displaying the frames in a window (StereoVideo_displayImage())
	4) a measurement of the frame rate (written to stdout)
	


All of the code you *need* to be concerned with is in main.c.  You will need to
write two functions:
	processFrames(), and
	drawFrames()
The code you will find in main.c implements an example that converts the left and right frames/images to grayscale (intensity) images.

You should create a Controls menu with the following commands using Interface Builder
(or just copy the menu from IntensityExample):
	<CTRL>-<OPTION>-S  :  swaps the cameras
	<CTRL>-<OPTION>-D  :  toggles the argument to drawFrames(), bDiagnostic, betwen true and false
	<CTRL>-<OPTION>-P  :  pause the system and leave the current images in the window
	<CTRL>-<OPTION>-A  :  toggles the argument to processFrames(), drawFrames(), bAB, betwen true and false

The code implementing these actions is already in StereoVideoLib.

bDiagnostic is intended to toggle the display between a "diagnostic" view, which might include partially-processed images,
debugging image output, etc., and a "final product" view in which only the final image(s) is(are) displayed.

bAB is intended to toggle the processing between two candidate algorithms (or algorithm options) so that their output can be compared.


I use two external iSight Firewire cameras to collect the images.  The maximum hardware frame rate is 30fps.  That's 30fps from
*each* camera which will be reported as "30fps" on stdout (at most; more processing of each frame results in lower frame rates).



David Sweet
dsweet@andamooka.org
<http://www.andamooka.org/~dsweet/>