readme


************************************************************************
     THIS DIRECTORY CONTAINS OBSOLETE PHOTOPC SOFTWARE!!!!!!!!!!!!!
            (patched photopc version 2.2 for Agfa users)
************************************************************************

/*
	Copyright (c) 1997,1998 Eugene G. Crosser
	Copyright (c) 1998 Bruce D. Lightner (DOS/Windows support)

	You may do virtually what you wish with this software, as long
	as the explicit reference to its original author is retained.

	THIS SOFTWARE IS PROVIDED AS IS AND COME WITH NO WARRANTY OF ANY
	KIND, EITHER EXPRESSED OR IMPLIED.  IN NO EVENT WILL THE
	COPYRIGHT HOLDER BE LIABLE FOR ANY DAMAGES RESULTING FROM THE
	USE OF THIS SOFTWARE.
*/

This is a library and a command-line frontend to manipulate digital
still cameras based on Fujitsu chipset and Siarra Imaging firmware.  The
program is known to work with Agfa, Epson and Olympus cameras.  Should
also work with Sanyo, but this is untested.

The cameras typically come with software for Windows and for Mac, and no
description of the protocol.  With this tool, they are managable from a
UNIX box.  Bruce D. Lightner <lightner@metaflow.com> has added support
for Win32 and DOS platforms.  Note that the program does not have any
GUI, it is plain command-line even on Windows.

I tried it under Linux/x86, FreeBSD and Solaris 2.5.1/SPARC, and it
should be straightforward for other UNIX systems.  Read the top of
Makefile and edit OPTS according to your system.  For Windows and DOS,
use Makefile.win and Makefile.dos respectively; no modification should
be needed.

Generally, UNIX system requirements are:
- ANSI C compiler
- select() system call
- POSIX termios
- presence of a 16bit integer type
- `callout' serial device (AKA `without modem control').

First of all, edit the top portion of Makefile to suit your system.

Typing `make' will result in building the library and executables in the
current directory.  `make install' will install the executables and
manual pages.  `make install.lib' will install the library and the .h
file.

The executable parameters are rather clear (hopefully).  Running
`photopc -h | more' will print the list of options and commands.  If you
are going to use the library for your own application and need the docs,
tell me and I will write them.

Included file `protocol.htm' contains description of the protocol used
by the camera.

`usage.htm' is a "casual" user's guide, full description is in the man
pages.

If you run the program on a DOS box, you may want a JPEG viewer; I've
been told that a good free viewer `LXPIC' can be found at
http://home.t-online.de/home/stefan.peichl.

Many commands are not implemented, esp. those specific for newer models.
If you know how to get live picture etc., please let me know.

I can be contacted at <crosser@average.org>, fresh version of this tool
(if any) is at ftp://ftp.average.org/pub/photopc/, related information
is at http://www.average.org/digicam/.  The same code accompanied by
Win32 and DOS executables and archived in .zip format can be found at
http://www.metaflow.com/lightner/bruce/photopc/

Thanks to Jeff Tranter for contributing a man page and a few bugfixes,
Bruce Lightner for Windows support and other people who helped me to
track down problems and learn more about the protocol.

Trademarks are properties of their respective respected owners.

Back