camediaplay
$Id: README.english,v 1.13 2001/02/11 01:00:34 itojun Exp $


WHAT'S THE HELL IS THIS?
	Guess what :-)

USAGE
	see manpage.

INSTALLATION
	% cd build
	% ./configure
	% make
	% su
	Password: xxxx
	# make install

KNOWN TO WORK WITH
	The following lines list is based on Japanese product code.
	(US product code is in paren - EPSON's naming scheme is too confusing)
	- Olympus "Camedia" C-400L (Olympus D-200L)
	- Olympus "Camedia" C-820L (Olympus D-320L)
	- Olympus "Camedia" C-1000L (Olympus D-500L)
	- Olympus D-450Z
	- Olympus "Camedia" C-2020Z
	- Sanyo DSC-V1 (Sanyo VPC-G200E)
	- EPSON "Colorio Photo" CP-100 (EPSON PhotoPC)
	- EPSON "Colorio Photo" CP-200 (EPSON PhotoPC 500)
	- EPSON "Colorio Photo" CP-500 (EPSON PhotoPC 600)
	- Nikon CP-900

SHOULD WORK WITH
	Any camera with Sanyo firmware/CPU.
	Olympus, Epson, Agfa and Sanyo digital cameras falls into this
	category, reportedly.

TWISTS
	- There are several commands that the program sends, WITHOUT knowing
	  the meaning.  Therefore, the program may affect the camera's
	  settings, without notice.
	- Camediaplay simply extracts images in the camera.
	  Official tool may, however, implement some image retouch/enhancement.
	  Therefore, image quality for both cases may not be the same.

	  camediaplay has an advantage over official tool.  jpeg files
	  extracted from some of the supported cameras have extra parameter
	  embedded into it.  Though some of the official tools removes those
	  parameters, camediaplay doesn't.
	- Early Olympus cameras are very sensitive to timing parameter
	  of the serial port.  If you have any problem downloading picts,
	  change parameter to usleep() in camedia_put().

TODOS
	- More elegant error handling is needed.
	  (ctrl-C handling, error packets, and so forth)
	- There are some more known commands, however, we haven't implemented
	  them.  Implementation itself is trivial.
	  (deletion, taking picture, change modes, and so forth)
	- Automatic solution to timing problems.
	- D-500L/600L support. (need your input on how SHQ mode should be
	  handled)
	- Battery capacity check for safety.
	  We should not download the whole pictures in camera,
	  if battery capacity is less than 5%, 3%, or some value.

HISTORY
	2001/2/11
		kill -N for security reason.
	98/5/29
		success report for C-1000L
	98/1/18
		manpage
		-V (voice, for Sanyo DSC-V1 only); almost hidden option.
		(thanks to nrt@web.ad.jp)
		The file format is unknown to us. (looks to be .wav variant)
		we should make a check for model ID...
		battery capacity on status display. (thanks jkh@freebsd.org)
	97/12/31
		RCS -> CVS
		-I, -#, -P modes added (thanks)
		-d# (Dump mode, with length specified) is deprecated.
	97/12/10
		Agfa ePhoto307 support, by comment from  Leon Brooks
		<leonb@mon.ami.com.au>.
	97/10/17
		unsigned/signed char bug fix
		Thanks goes to Bernd Melchers <melchers@chemie.fu-berlin.de>
	97/8/15?
		camera attention command stabilization.
	97/8/3
		C-820L(D-320L) confirmation.  some timing stabilization.
	97/7/15
		redistribution ok
	97/7/3
		tiny fixes.
	97/6/28
		CP-500 confirmation.  tiny fixes.
	97/6/8
		115200bps stabilization.  Thanks goes to Thierry Bousch.
	97/4/18
		for Linux 2.0, don't use the variable named "baudrate".
	97/4/7
		for Linux 2.0, use B9600/B19200/... for cfsetspeed().
	97/3/2
		added -i and -N options.
	97/2/25 10:00
		bug fix: -a downloads first picture repeatedly (thanks riho-m)
	97/2/19
		cleanup fixes.
		38400bps, 57600bps seems to be stabilized.
		protocol document updates.
	97/2/18 20:30
		stabilization.
	97/2/18
		started the project.

ADDITIONAL READINGS
	ftp://ftp.average.org/pub/photopc/
	http://www.wsrcc.com/wolfgang/camera/

REDISTRIBUTION
	Freely redistributable, as long as everything is kept unmodified.
	(It is okey to redistribute patches separately.  However, I
	encourage you to contact the author for merging your patch into)

WARRANTY
	Absolutely no warranty.

REPORTING BUGS
	Please use one of the following methods:
	- via http://www.itojun.org/cgi-bin/gnats-send-pr
	- via e-mail to: itojun@itojun.org

AUTHOR
	Copyright(c) 1997, 1998 by Jun-ichiro Itoh.  All rights reserved.
	Jun-ichiro itojun Itoh <itojun@itojun.org>
