Webcam Drivers for GP2X
=======================

To make sure your webcam works, a special driver has to be compiled for the gp2x.
There should be 200+ drivers already working. So far drivers have been compiled:

	STV680		Trust Spycam and many others	WORKING!
				More information: http://stv0680-usb.sourceforge.net/

	OV51x		Eyetoy and others				WORKING!
				More information: http://www.rastageeks.org/ov51x-jpeg/

				A special thanks to mfk for testing this and sending debug output.

	SPCA5xx		244 supported webcams			WORKING!
				More information: http://mxhaard.free.fr/spca5xx.html

				A special thanks to mfk for testing this and sending debug output.

	CPIA USB	cpia based webcams				SHOULD WORK / NOT TESTED


Failed, need to be adjusted to work on older kernel versions:
	PWC			Philips Webcams					FAIL kernel 2.6.9 needed


It's important to first open the script that loads all the drivers.
Then connect your webcam to your usb port (bob/cable/built-in).
Then open the cam2x_test.gpe program (in drivers/testprograms/).
This should display 30 frames to your screen and then stop.

In case it does not work, open a telnet/ssh/serial connection.
Then execute "dmesg" you should see that driver was loaded.

Then you have to connect the webcam. Execute "dmesg" again, it should now
register your webcam. Something like this:

	stv680.c: [stv680_probe:1610] STV(i): STV0680 camera found.
	stv680.c: [stv680_probe:1638] STV(i): registered new video device: video0
	usb.c: stv680 driver claimed interface c1bb2fe0

If you see something similar, you are using the right driver.
If this doesn't work, send me the dmesg output (dmesg > dump.txt and send dump.txt).
I will try to add support for other webcams.

It it works. You can try the Photocam2x program:

PHOTOCAM2X
==========

After loading the webcam driver. Open the photocam2x.gpe program.

You will first see a splash screen of the competition, followed by an overview of 
the keys. In case you no longer want to wait every time the program start, just 
delete the png files in ./data/, they will be skipped if they are not found.

After the splash screens, you should see a live feed from your webcam. In the left 
bottom corner you will see the current battery status. This will be updated every 
frame capture. In the right bottom corner you will see the number of photos you can 
take until your sd card is full.

Each "photo" is saved as a 24bit bitmap and since the resolution is 320x240, 
each photo takes 225kb.

Everytime you take a picture, the frame will be on the screen for approx. 3 seconds, 
the battery led will light up when it is writing to the sd. After everything is 
written you can capture again.

Album
-----

If you press Y you go to the album menu. There you can use the joystick to browse 
in the captured photos. If you click on a photo I will open full screen, click again 
and you back to the album.

Effects
-------

When you press A or B, you change the effects. So far there are 6 effects:

	1. Greyscaling (based on color image)
	2. Red color filter
	3. Green color filter
	4. Blue color filter
	5. Odd lines only
	6. Sepia

If an effect is enabled the photos will be saved with the effect on.

ISSUES
======

The sepia effect gives some red and black on very bright objects.

Sometimes after disconnecting the webcam, the webcam isn't recognized correctly. 
Reloading the driver can fix this. If not restarting the gp2x should fix this.

Brightness control is not always handled correctly for all webcams. Make sure there 
is not too much light in case the brightness correction fails.

Special Thanks
==============

A special thanks to mfk for beta testing the application, and testing and debugging 
the drivers for webcams (ov51x and spca5xx) that I couldn't not test.
