DIGGER DD DPM
David E. Down - Gonksoftware

Warranty Information: This version of Digger, including its documentation,
comes with absolutely no warranty, so use them at your own risk! I can not be
held responsible for anything resulting from anyone else's use of Digger or
its documentation.

Note! This document is explains the differences between my version of Digger
and AJ's version of Digger that it was based upon. For General Gameplay
Information, please refer to AJ's documentation of Digger - DIGGER.TXT.

The files in the DIGPROT.ZIP archive are as followS:
CWSDPMI.EXE
	The protected mode server, this is required to run Digger outside of Windows
  or any other OS that uses DPMI.
DIGGER.EXE
  The game itself.
DIGGER._C
  The default low-resolution graphics data (the original CGA graphics from
  Windmill).
DIGGER._V
  The High Resolution Graphics (the VGA graphics from AJ's real mode version of
  Digger).
DIGGER._CE
  Similar to DIGGER._V, but it has been anti-aliased down for low resolution
  usage.
DIGGER._VE
  This graphics file will be available at some time in the future. Do not use
  the /VE switch at the command line, nor enter high-resolution mode from low
  resolution that was specified by /CE via using Digger Options. Otherwise the
  program will halt with an error.
The graphics files are compressed by Allegro's PACKFILE format (but are
automatically uncompressed into memory when they are loaded by Digger).


TWO PLAYER SIMULTANEOUS MODE
You can get into two player simultaneous mode by two methods. The new one is
by pressing '2' at the title screen, but you can still use AJ's method of
adding the /2 switch after DIGGER at the command line.

Do you only have one Game Controller? No problem! The program will happily
allow Player One to use the Game Controller, & the other to use the Player
Two's keyboard controls.


GAUNTLET MODE
You can access Gauntlet mode by pressing 'G' at the title screen.

When you access Gauntlet Mode, you are required to enter a time limit. Enter
the time limit, then press ENTER. If you have made a mistake in entering
Gauntlet Mode for any reason, just press ESC. 


GAME CONTROLLERS
To enable game controller support, you must add /J switch at the command line.
You only need to do this once or after you change the change the game
controller configuration on your system.

The player controls on the keyboard are disabled when game controllers are
being used, except for player 2's keyboard controls in two player simultaneous
mode when there is only one controller configured.

One player mode: Player one must use Game Controller one.

Old-style two player mode: Regardless how many Game Controller that you have
configured with Digger, each player is required to use Game Controller one
to control the player (digger).

Two player simultaneous mode: Player one must use Game Controller one. Player
two must use Game Controller two, or, when there is only one Game Controller
configured, player two's keyboard controls.

To play the game with Game Controllers, you must press Fire on Game Controller
one. Pressing fire on Game Controller two will not start the game unless the
game is in Two Player Simultaneous mode. I intentionally put that in. Pressing
a key on the keyboard will not allow any Game Controllers to be used in the
game that has been started.

Use the /J: to specify what game controller that you have attached to the
hardware.
0. Autodetect Game Controller (Note! Only types 1, 8 or 9 will only be picked
by auto-detection)
1. Normal Two Button Analog Joystick
2. Two Analog Joysticks
3. Four Button Analog Joystick
4. Six Button Analog Joystick
5. Eight Button Analog Joystick
6. Flightstick Pro or compatible
7. Logitech Wingman Extreme
8. Microsoft Sidewinder
9. Gravis Gamepad Pro
10. SNES control pad being connected to LPT1.
11. SNES control pad being connected to LPT2.
12. SNES control pad being connected to LPT3.
13. Logitech Wingman Warrior
999. No Game Controller Device.

Note: If you use controllers whose numbers are particularly in the range of 3
to 7 plus 13, the program will not exploit the advanced features of those
controllers, plus you may have to go through additional calibration steps then
required. It is recommended that you should treat these controllers as standard
analog joysticks for the purposes of Digger (i.e. use the /J:1 option). Also, I
have not tested out each ontroller that the Allegro library supports.

With joysticks with more than 2 buttons, you should be aware that only the
primary two buttons will work.


SPECIAL KEYS AT THE HALL OF FAME
Note: Excluding the keys ESC & 'N', all other keys are currently specific to my
version of Digger.

ESC 	This only works in standard game play mode, but not in Gauntlet or Two
Player Simultaneous. This toggles between one player or two players.
1 	This puts the game in one player mode.
2 	This puts the game in two player mode, toggling between alternating or
simultaneous if already in a two player mode.
G 	This enters or exits Gauntlet Mode. When entering Gauntlet Mode, a screen
requesting for a time limit will appear.
N 	Same as ESC.
Ctrl+K 	This redefines the basic game controls of the keyboard. To redefine the
keys for both players, the game must be in Two Player Simultaneous mode.


KEYBOARD MODE
To start the game, you must press any key on the keyboard, provided that it is
not a special feature key such as ESC, G, N, 1, 2 or CTRL+K.

The default player two controls are only ideal of users with one supported
joystick, or with using unsupported joysticks with keyboard keypress emulators.
You can reconfigure the keyboard, to reconfigure the keyobard controls, you
must type DIGGER /K at the command line, or press that CTRL+K. 

Note! To define the controls for both players, you must specify the /2 switch,
or set the game into two player simultaneous mode (by pressing '2' once or
twice) before pressing CTRL+K. To define all the keys including the non-player
specific keys. You can only do that at the command line, by entering: DIGGER
/KA. You must include /2 as well if you do want to refine the player two's
keys.


AUDIO
Note the command line switch that specifies the sound card is different from
AJ's original versions.
/A: <sound_device_number>, <sfx_wave_type>, <music_wave_type>, <playback_mode>

Sound Device Numbers:
0. Auto detect sound card
1. Soundblaster autodetect.
2. Soundblaster 1.0
3. Soundblaster 1.5
4. Soundblaster 2.0
5. Soundblaster Pro
6. Soundblaster 16
7. ESS Audiodrive
8. Ensoniq Soundscape
999. No digital audio sound card

Wave Types:
0. Default
1. Square Wave (default for sfx)
2. Sawtooth (default for music)
3. Sine
4. Triangle
5. +/- square of sine times
6. +/- square root of sine
7. Pulse Wave (ratio 1 to 3)

Playback mode: Not implemented: Set this as zero.

Warning! The program may crash, lack audio, or halt with an "Unable to
initialize the sound device" message if you attempt to use the incorrect sound
device selection. This problem may occur when trying to autodetect the sound
device on some system configurations. Use the 999 option if all else fails.

For the Soundblaster cards, you may need to set the BLASTER environment
variable before running Digger. Also, the program now saves the sound card
selection into the DIGGER.INI file, when you specify an override at the command
line. Also the command line switches /Q & /M do not disable the sound device.

Note! I do not have all the sound devices that the program supports, thus I
have not tested the program with them. Due to the way that the program handles
the sound effects, I assume that DMA utilized sound devices without any
auto-initialized DMA such as Soundblasters with DSPs 1.0 & 1.5 will not
produce satisfactory sound effects, thus I do not recommend the use of those
sound devices with this program.


VIDEO MODES
Low Resolution Mode:
This mode displays the Digger original graphics in four colours, or the 256
(almost) colour graphics that is based on the AJ 16 VGA mode of digger (not
yet implemented).

High Resolution Mode:
Note: The High Resolution Mode of Digger uses a double buffering system. This
double buffering system adds an overhead of less than 256K. The low resolution
mode of Digger does not have double buffering system.

If your system configuration does not somewhat supports 640x400 resolution, the
game's 640x400 image will automatically appear as centered within a 640x480
graphics mode with black bars at the top and bottom. If you are having problems
with the 640x400 mode or you would like to use the 640x400 in 640x480 mode, you
can enforce the 640x400 in 640x480 mode by adding /VX to the command line.

Note: Do not confuse the new /V switch with the /V switch in real mode Digger
that synchronized the timing with the screen's vertical refresh. The protected
mode version of Digger uses this switch to specify VGA modes (/V for VGA, /VE
for enhanced VGA, /VX for 640x480 mode).


CUSTOM GRAPHICS FILES
When Custom Graphics files will become available, they can be accessed by
specifying the /D: switch. Just include the filename after it.


QUESTIONS AND ANSWERS
Q: Help! The Game Controllers do not work!
A:
1.  Did you start the game by pressing a key on the keyboard instead of
    pressing a Game Controller button? If so, then the game will read from the
    keyboard instead of the Game Controllers.
2.  Have you select the correct Game Controller type at the Command Line?
3.	Are the Game Controllers correctly connected?
4.	Are you using a supported Digital Game Controller in Windows 95 / 98?
    i.  Try forcing Digger to recognize it as an Analog Controller. Ensure that
        the Game Controller is set up correctly in Windows 95 / 98.
    ii. Try running Digger as native DOS.
5.	Are you using a unsupported Digital Game Controller?
    i.  See if it has an analog / digital switch. Switch it to analog then use
        it as an analog controller.
    ii. Read the game controller manual & see it has information about DOS
        support. This DOS support might appear in Windows 95 / 98 multitasking
        shell.
    iii.Otherwise, you are out of luck. You might have to look on the Internet
        for information about emulators or something.

I do not have these annoying Windows 95 / 98 specific game controllers, so some
of the above information are guesses on what to do. 


Q: Why does Digger say that it is having trouble loading DIGGER._VE and then
   halts?
A: You may had recently tried to load Digger with the /VE switch. To solve
   this, you must specify the /V, /C or /CE switch at the command line. This
   will tell Digger to amend the configuration file to do not try loading the
   non-existant enhanced graphics files.
   You might have tried changing the graphics resolution within Digger Options,
   you must either rerun the program. If you do desire to change between
   resolution modes of Digger when using enhanced low resolution graphics, type
   DIGGER /C /D:DIGGER._CE at the command line.
   Also for the above, you can edit the DIGGER.INI file. Add or change this
   line within the [Graphics] section of this file: Enh_High_Res = DIGGER._V

Q: How do I change Player Two's controls in Simultaneous mode?
A: Specify the /2 switch with the /K switch at the command line. After the
   keyboard redefiniton, the game will be Simultaneous mode. Also, at the Hall
   of Fame, place the game in Two Player Simultaneous Mode, then press CTRL+K.

Q: How do I return to the default settings in Digger?
A: Delete the DIGGER.INI file, but you may have to reconfigure your sound, game
   controlling and graphics devices.

Q: Player two has to use the keyboard when there are two Game Controllers being
   connected?
A: Make sure that you are using two Controllers of the same type. You can not
   use a Controller type A for player one with Controller type B for player
   two. Make sure that the two controllers are properly connected in the manner
   that they are supposed to be connected. If you are using two analog Game
   Controllers of any type being connected with a Y-adaptor or something, you
   must specify the /J:2 instead of /J, or /J: with a number in between 3 to 7.
   Although analog game controllers with more than 2 buttons can be connected
   with a Y-adaptor, but only two buttons on each Controller. It is technically
   impossible to use any the advanced features of these analog controllers
   whilst they are being contected to a Y-adaptor. There may be some Game
   Controller configurations that only permits one controller to be used during
   the execution of Digger.

Q: How can I design a SNESpad adaptor for the LPT port?
A: Get the schematics from http://snespad.emulationworld.com. I have not tested
   the schematics for the SNES control pad adaptor. Although I do know an
   actual SNES.


KNOWN BUGS
DD DPM Digger does not support flashing at the screen that states "Enter your
Initials".
Analog Joystick driver requires to be recalibrated everytime at the start of
the program. (I found that out through testing) This is bug in the Allegro game
programming library, not in the actual code of Digger. I will debug it if I
have the chance.
The low resolution file: DIGGER._CE will cause problems with DIGGER's firing on
DD DPM 19990428 or earlier, due to the bug in the low resolution collusion
test.
Some command line switches do not function correctly, mostly the ones that do
not appear as Options in the Digger Option menu.
I think that the SNES pad driver will not allow both keyboard and game
controller to the used at the same time in two player simultaneous mode, I have
discovered this when I was reading the Allegro code.

THINGS TO DO:
Place in an option for "revert to defaults" to default in the Digger Option
menu. Currently, the command line switches tends to change the configuration
file.
Revise the graphics format by using RIFF, then combine all Digger graphics
files into one file. Warning! The future versions of Digger may not support the
older style Graphics files, when they support RIFF.

Other Notes!
This program uses DJGPP libraries (http://www.delorie), and Allegro Game
Programming Library (http://www.talula.demon.co.uk/allegro). This program
contains software that was developed by the University of California, Berkeley
and its contributors.

Digger Offical Site: http://www.digger.org
My Personal Site: http://members.tripod.com/~faerymonarch
My E-mail adress: faeries@mpx.com.au

Notable (plus some not so notable) change since DD DPM 19990511:
Configuration menu has been added with seven options. To access it, press F6.
Able to specify playback speed of each Digger Recorder File.
Low resolution graphics file DIGGER._CE has been added. To access it, include
/CE command line switch at the command line.
Corrected low resolution collusion test that was discovered during the
development of DIGGER._CE file.


Any questions or comments relating to this version of Digger but not to Real
Mode Digger should be directed to "faeries@mpx.com.au".
