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

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

WHAT DOES IT DO?

What Honey does is quite simple - it is a slide show of pictures created by
Phil Ware and Paul Lee which depict various Bible verses. The background
music is a MOD file by Kjetil Hoem which he kindly let me use.
                                       
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). 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.
                                       
BASIC KEYS

UP/DOWN arrows - increase/decrease time between each verse, default is
                 about 15 seconds
ESC            - quits
F1             - saves the current picture to disk in JPG format
F2             - saves the whole screen to disk in PCX format
F3 - F7        - play a game (see below)             
F10            - pauses on the current picture (F10 again unpauses)
ENTER/SPACE    - browse (see below)

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. (if
a picture has ^ before a number ie ^1 then you press alt plus the number - I
had to do this when I ran out of letters and numbers). Similarly, to browse
by verse press SPACEBAR.

PUZZLE

The latest addition to this program is a 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 - 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.

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 cool one.

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
file HONEY.D01 - this is a temporary file which is automatically created and
would almost double the zip size.

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.

Thanks to -

Phil Ware and Paul Lee for allowing me to use their pictures
Kjetil Hoem            for allowing me to use his MOD composition
DJ Delorie             for creating DJGPP (32 bit freeware C/C++)
Shawn Hargreaves       for creating the ALLEGRO Game Programming Library

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)

-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.
-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.
-n      No repitition of bible verses - still in random order but no verse is
        repeated until all have been seen
-bn     Begin with verse n, n being either the corresponding letter or number
        shown in BROWSE (space/enter)
-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
-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
-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 if you accidentally delete etc)

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. If you want the source please write to me, and
I'll happily give it to you, though it may be a bit tricky to use or
understand.

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