Frameworks v0.3.6
Pat Mahoney <pat@polycrystal.org>

Command line:
  frameworks [-r] [device file]

Flags
  -r    Forces frameworks to use the read() method of accessing the
        camera, instead of the default mmap().  Maybe be useful in
        places where frameworks thinks mmap() should work but it
	doesn't.

  --force_palette n

	Forces frameworks to use color palette (misnomer?) number
	"n". Palettes are defined from numbers 0 to 15.  Specifying
	an invalid palette will likely cause frameworks to crash
	(segfault). This is a gross hack; either the Creative Webcam
	III lies about the palette is uses (it claims 10 but decodes
	with 14), or frameworks is confusing the names of the
	palettes. 

  <device file>    The device file of the camera to use.  Defaults
                   to /dev/video

  --dump  Outputs a raw video frame + header info to stdout
          (frameworks --dump > raw_frame)

Example
  frameworks -r /dev/video1

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

Frameworks is a webcam controlling software geared toward stop-motion
animation.  It is based on gqcam 0.9 by Cory Lueninghoener
<cluenin1@bigred.unl.edu>.  Its job is to grab a frame, then grab
another after you've slightly changed your scene.  It ouputs (PNG
format) files like this:

frame_0001.png
frame_0002.png
... etc.

This is the filename scheme that the GIMP Aniamtion Plugin (GAP) uses
(convenient yes?).  Many other programs that use a series of images
(mencoder for example) just use them in normal sorting order (which
works with this naming scheme of course).

Frameworks does not do everything gqcam does (namely, single
snapshots, timelapse).  It does support (should anyway) viewing a live
camera feed, and adjusting brightness, etc. controls.

In addition to what gqcam does, frameworks adds support for
stop-motion animation.  First choose a filename and directory
(defaults to "frame" in the current directory), then clicking "Grab
Frame" will save a frame (PNG format only for now) to
"frame_0001.png", etc. as explained above.  It also supports frame
averaging.  With frame averaging enabled, each time frameworks "Grab
Frame"'s, it takes a number of snapshots (5 by default), and averages
these together (simple arithmetic mean of each pixel) to cut down on
graininess of webcams.  5 seems to be a good default; you may want
more depending on lighting conditions and your camera.

Summary of supported things:

* color RGB webcams using video4linux (not video4linux2) via mmap() or
  read()
* brightness etc. controls
* saving files in order for GIMP or other tools
* frame averaging
* frame overlay / onion skinning
* cross-hairs over the video
* continuous preview mode

This isn't very impressive, but it's more or less the *necessary* things
(for me) to get work done which is why I'm releasing it at this early
stage.  The code will probably change a lot in the future, but you're
certainly welcome to hack on it if you wish.