~ubuntu-branches/ubuntu/trusty/photopc/trusty

« back to all changes in this revision

Viewing changes to readme.dos

  • Committer: Bazaar Package Importer
  • Author(s): John Goerzen
  • Date: 2000-09-04 12:34:52 UTC
  • Revision ID: james.westby@ubuntu.com-20000904123452-8kkxsbtmm1opsnlw
Tags: upstream-3.04
ImportĀ upstreamĀ versionĀ 3.04

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
/*
 
2
        $Id: readme.dos,v 1.8 1999/03/22 06:16:24 lightner Exp $
 
3
*/
 
4
 
 
5
/*
 
6
        Copyright (c) 1997,1998 Eugene G. Crosser
 
7
        Copyright (c) 1998,1999 Bruce D. Lightner (DOS/Windows support)
 
8
 
 
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.
 
11
 
 
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
 
15
        USE OF THIS SOFTWARE.
 
16
*/
 
17
 
 
18
/*
 
19
        $Log: readme.dos,v $
 
20
        Revision 1.8  1999/03/22 06:16:24  lightner
 
21
        Fix typo
 
22
 
 
23
        Revision 1.6  1999/01/17 13:33:48  crosser
 
24
        change copyright info
 
25
 
 
26
        Revision 1.5  1998/10/18 13:18:27  crosser
 
27
        Put RCS logs and I.D. into the source
 
28
 
 
29
        Revision 1.4  1998/08/09 17:02:22  crosser
 
30
        notes about the port speed and TZ variable
 
31
        
 
32
        Revision 1.3  1998/08/01 13:12:41  lightner
 
33
        *** empty log message ***
 
34
        
 
35
        Revision 1.2  1998/02/28 09:20:41  lightner
 
36
        no more file size limit
 
37
        
 
38
        Revision 1.1  1998/02/06 00:17:16  lightner
 
39
        Initial revision
 
40
        
 
41
*/
 
42
 
 
43
README.DOS
 
44
 
 
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.  
 
49
 
 
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
 
55
speed is 115200 baud.
 
56
 
 
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.
 
60
 
 
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).
 
64
 
 
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.
 
68
 
 
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.
 
73
 
 
74
LIMITATIONS: 
 
75
 
 
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).
 
82
 
 
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
 
86
IRQ3).
 
87
 
 
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!
 
93
 
 
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).
 
99
 
 
100
Refer to the file "README" for more information.
 
101
 
 
102
Please consult the following URL for the latest softweare information:
 
103
 
 
104
       http://www.average.com/digicam/
 
105
 
 
106
Trademarks are properties of their respective respected owners.
 
107
 
 
108
Bruce D. Lightner (lightner@lightner.net)   Sat Jul 25 17:37:40 pdt 1998