                        -------------------------------
                                   HONEY v1.3     
                        Copyright 1997 by Michael Bevin
                        -------------------------------

This program is freeware, so please feel free to copy and distribute.

WHAT DOES IT DO?

Well, I'm not entirely sure what to call it anymore - it's basically a slide
show of pictures created by Phil Ware and Paul Lee which depict various Bible
verses, with background music by Kjetil Hoem. You can just watch it, or save
the pictures to disk and print them out or use them for a Windows wallpaper 
or whatever, or browse through the pictures, or even play one of the games it
comes with.
                                       
RUNNING IT

Type HONEY to run the main program, or TETRIS to auto-load the tetris game,
or PUZZLE for the puzzle game. The first time the program is run it will ask
you to enter the type of system you have and from what you enter attempt to
optimize itself for your computer. It will then take a while to create a data
file but this will only happen this one time so please be patient.
Note that this program is not a Windows screen saver as yet... I'm working on
it, but it can be run fine under Windows.

REQUIREMENTS

A SVGA card capable of 800x600 with 256 colours and a 386 (486 highly
recommended) are required, (if your computer was bought new from about 1991
on it should qualify). A soundcard is also useful if you want to hear the
music.

KEYS

UP/DOWN arrows    - increase/decrease time between each verse, normally about
                    15 seconds
ESC               - quits
F1                - help (displays this text file)
F2                - saves the whole screen to disk in PCX format
F3 - F7           - do a puzzle (see below)             
F8                - saves the current picture to disk in JPG format
F9                - toggles music on/off
F10               - pauses on the current picture (F10 again unpauses)
ALT 1 - 9         - play the classic game Tetris, starting at levels 1 - 9
ENTER/SPACE       - browse (see below)
A-Z, 0-9          - selects corresponding picture

BROWSING

You can browse the pictures within the program by pressing ENTER... you will
see 'thumbnails' ie previews of all the pictures, and can use the arrows,
PGUP & PGDN, or the letter/number corresponding the picture you want to view,
and press ENTER again when finished. Note that you can also press the letter
/ number corresponding to a picture at any time in the program to see it. For
the capital letters press SHIFT + letter.

PUZZLE

A recent addition to this program was the puzzle - press F3 - F7 within the
program and the current picture will be turned into a 3x3 - 7x7 piece puzzle,
which you then attempt to solve using the arrow keys. The program defaults to
having the arrows move the blank, some people seem to prefer having the
arrows moving the pieces around it (ie opposite directions ) - push S to
switch between these two options. All puzzles ARE possible to solve... if
you've played any of those little toy versions you shouldn't find it too hard.

TETRIS

If you've ever played one of the hundreds of tetris clones out there this
should be easy to grasp - the idea is to fill rows by moving and rotating the
falling blocks. Use the arrow keys, with the UP key rotating, or the numbers
on the numeric keypad (turn numlock off if they don't work) with UP or 5
rotating. My high score is 48,625 - see if you can beat it. You can start
Tetris either by pressing ALT 1 - ALT 9 (starting at levels 1 - 9) or by
typing TETRIS at DOS prompt (which will default to starting at level 1).

OTHER STUFF

If you know your way around these computers, theres a couple of other features
which you might like to try.

Firstly, typing HONEY /A causes the program to quickly (relatively) show
just a single picture - this is aimed at use when the computer starts up, by
inserting the command in AUTOEXEC.BAT. If you hold shift down when it runs
with this option it will not bother showing you the picture and quit
immediately.

Secondly, typing HONEY /W causes the program to create an 800x600 collage
type wallpaper suitable for a Windows background. You may like to run it a
couple of times until you get a really good one.

Also, instead of typing HONEY, you can also type PUZZLE or TETRIS in DOS to
run the puzzle or tetris straight off.

DISTRIBUTING

As I have said, this program is entirely free, and I encourage you to give it
to others. If you are re-zipping or similar, you do not need to include the
files HONEY.D01 and HONEY.D02 - these are temporary files which are
automatically created and would just make the zip bigger.

CONTACTING ME

E-mail -
   michael.bevin@stonebow.otago.ac.nz
or write to -
   Michael Bevin
   129 Signal Hill Road
   Dunedin
   New Zealand

Please write if you have any questions, suggestions, problems, bug-reports, or
any pictures which I could include in future versions etc.
If you'd like to send me some money it'd be happily accepted ;-), but this
program is entirely free, and you may copy and distribute it without
charge provided you don't change any of the program files.

The bible verse pictures can all be found at the Heartlight website -
   http://www.heartlight.org/
as well as heaps of other Christian related material, and the pictures
are being updated weekly.

I have a homepage of my own devoted to this and other programs I have made -
   http://www.geocities.com/SiliconValley/Vista/9582/

THANKS TO

Phil Ware and Paul Lee for letting me use their pictures
Kjetil Hoem            for letting me use his MOD composition
DJ Delorie             for DJGPP (32 bit freeware C/C++)
Shawn Hargreaves       for the ALLEGRO Game Programming Library
Andrew Deren           whose Tetris code I used

God bless you :-)

    o  \ o / _ o       __|   \ /    |__      o _ \ o /  o
   /|\   |    /\  ___\o  \o   |   o/   o/__  /\    |   /|\
   / \  / \  | \ /)  |   ( \ /o\ / )   |  (\ / |  / \  / \

      "Hallelujah!  For our Lord God Almighty reigns.
           Let us rejoice and be glad
           and give him glory!"
                   -- Revelation 19:6-7


---------------
TECHNICAL STUFF - please ignore unless you feel technically inclined
---------------

Command line options are as follows: (either - or /, doesn't matter. 
                                      Work when loading files HONEY,
                                      TETRIS & PUZZLE)
-a      Shows only one picture, fading out after about 2 seconds or when a
        key is pressed - I use this in autoexec.bat to show me a picture on
        startup. It will also look better quality than within the program.
        When run, if you hold down shift it will exit quickly before showing
        the picture - this is handy when I have it autoexec.bat and I'm in a
        hurry etc. Uses 640x480 screen mode.
-bn     Begin with verse n, n being either the corresponding letter or number
        shown in BROWSE (space/enter), put a ^ character before the verse if
        it is one of the capatilized ones.
-dnnnnn Select screen card nnnnn - use this if the program does not work
        at first -> the program normally automatically attempts to detect
        which of these is your screen is... if none of these work try and
        get UNIVBE...
        VESA1         - use the VESA 1.x driver
        VESA2B        - use the VBE 2.0 driver
        CIRRUS64      - use the Cirrus 64xx driver
        CIRRUS54      - use the Cirrus 54xx driver
        S3            - use the S3 driver
        TRIDENT       - use the Trident driver
        ET3000        - use the Tseng ET3000 driver
        ET4000        - use the Tseng ET4000 driver
-mnnnnn Play MOD/S3M/XM/ULT/UNI/MTM/MED/669/FAR/DSM file nnnnn instead of
        the default
        Use -m0 to disable the background music
-n      No repitition of bible verses - still in random order but no verse is
        repeated until all have been seen
-p      Do a puzzle
-q      Quick exit - turns off credits screen (which is on by default)
-s      Runs setup so you can re-enter your computer type (and re-create
        HONEY.D01 & HONEY.D02 if you accidentally delete etc)
-t      Play Tetris
-w      Creates a 'collage' type 800x600 .bmp of the pictures for use as a
        Windows wallpaper. Usually takes a couple of goes before you get a
        really good looking one.

This program was written in DJGPP using the Allegro game programming
library, as well as a JPEG loading library and an adaptation of the
MIKMOD library for DJGPP. The file HONEY.C contains the main source file -
while you won't be able to get this working (most likely) as it requires
the original data file which is included with it at compilation time plus
modifications I made to the libraries, hopefully it will prove useful to
some people. Please write to me if you want to understand how something
works etc.

                  -------> That's all folks! <-------
