2
$Id: readme.dos,v 1.8 1999/03/22 06:16:24 lightner Exp $
6
Copyright (c) 1997,1998 Eugene G. Crosser
7
Copyright (c) 1998,1999 Bruce D. Lightner (DOS/Windows support)
9
You may distribute and/or use for any purpose modified or unmodified
10
copies of this software if you preserve the copyright notice above.
12
THIS SOFTWARE IS PROVIDED AS IS AND COME WITH NO WARRANTY OF ANY
13
KIND, EITHER EXPRESSED OR IMPLIED. IN NO EVENT WILL THE
14
COPYRIGHT HOLDER BE LIABLE FOR ANY DAMAGES RESULTING FROM THE
20
Revision 1.8 1999/03/22 06:16:24 lightner
23
Revision 1.6 1999/01/17 13:33:48 crosser
26
Revision 1.5 1998/10/18 13:18:27 crosser
27
Put RCS logs and I.D. into the source
29
Revision 1.4 1998/08/09 17:02:22 crosser
30
notes about the port speed and TZ variable
32
Revision 1.3 1998/08/01 13:12:41 lightner
33
*** empty log message ***
35
Revision 1.2 1998/02/28 09:20:41 lightner
36
no more file size limit
38
Revision 1.1 1998/02/06 00:17:16 lightner
45
This is a 16-bit MS-DOS version of Eugene G. Crosser's "photopc" digital
46
camera software. This software is known to work with Agfa, Epson and
47
Olympus cameras with 80x86-based PC's, laptops, and "palmtops" (e.g.,
48
HP200LX) running MS-DOS.
50
The software has been found to run at the camera's fastest serial port
51
speed (i.e., 115200 baud) on newer PCs. However, a reduced serial port
52
speed (using the -s command line option) may be needed for proper
53
operation on older PCs and laptops (and with most "palmtops", due to
54
their slow processors). Note that the program's default serial port
57
Note that due to the camera design, negotiation always starts at 19200
58
baud, so if your serial port only runs up to 9600, it won't work even
59
despite 9600 is a valid communication speed for the program.
61
The MS-DOS version also will run in a command window (i.e., "MS-DOS
62
Prompt") under Windows 95 and Windows NT (but often times only at
63
reduced serial port rates).
65
This MS-DOS version was compiled under Borland International's 16-bit
66
80x86 compiler, Turbo C++ Version 3.00, using the "small" memory model.
67
Refer to the makefile "makefile.dos" for compile instructions.
69
Pay close attention on the `TZ' environment variable definition. If
70
this variable is not set, or set improperly, MS/DOS makes very strange
71
assumtion about your timezone, and result of setting and displaying
72
of the camera internal clock may be unpredictable.
76
The MS-DOS code has been modified to support >64K byte images (using
77
#define LOW_MEMORY). This was achieved by changing the program's logic
78
to write image data to the disk file in 2048-byte chunks, as the data is
79
being read from the camera. The other versions of the software (i.e.,
80
Unix/Windows) write the image to disk only after the entire image has
81
been read from the camera (into a large in-memory buffer).
83
The serial I/O package used by the MS-DOS version of "photopc.exe"
84
supports serial ports COM1, COM2, COM3, and COM4, assuming the standard
85
IRQ assignments (i.e., COM1 and COM3 use IRQ4 and COM2 and COM4 use
88
The "photopc.exe" program installs an interrupt handler for the serial
89
port at IRQ3 or IRQ4. This handler is removed on program exit, or if
90
the user terminates the program with ^C or control-break. Other
91
abnormal exits (e.g., hard disk I/O errors) may leave the the handler
92
installed...which is sure to cause problems!
94
This software makes use of a serial I/O package (comio.c) taken from a
95
public-domain SIMTEL archive named "cvt100.zip" (VT100, A Simple VT100
96
Emulator in Turbo C 1.5 by Jerry Joplin), which was somehow derived from
97
Kermit. These routines do not take advantage of the serial port queues
98
available in modern PC chipsets (i.e., 16550 UARTS).
100
Refer to the file "README" for more information.
102
Please consult the following URL for the latest softweare information:
104
http://www.average.com/digicam/
106
Trademarks are properties of their respective respected owners.
108
Bruce D. Lightner (lightner@lightner.net) Sat Jul 25 17:37:40 pdt 1998