****************************************************************************
*                            THE SAVIOUR PROJECT                           *
*                            +++++++++++++++++++                           *
*                                                                          *
*                              Copyright  Feb 2000                         *
*                 FREEWARE - Please feel free to distribute                *
****************************************************************************
                         
                                Version 1.02
                         
                                  Contents
      
                           1. Introduction
                           2. System Requirement
                           3. Installation
                           4. Troubleshooting
                           5. Project History
                           6. Freeware Text
                           7. Contact

****************************************************************************

                           1. Introduction
                           
  The Saviour Project is a multimedia presentation of the life and death of
Jesus Christ. It contains a specially written song, with lyrics, and a 
graphic sequence of images, to show the Biblical truth about Jesus. Lasting
for approximately six minutes, the graphics and music explain the life,
death, and resurrection of Jesus, and His relevance to us today.

****************************************************************************

                           2. System Requirements
                           
  To run the Saviour project, the following things need to be achieved.
     
               a) Recommend 486 or above processor. Will work on 386 or
                  possibly even lower, but may be terribly slow, depending
                  on graphics card capabilities! Sound card is recommended
                  but a no-sound option is available.
               
               b) You need to be running MS-DOS 5.0 or later. Windows 3.1
                  or Windows 95 should be shut down before running. Might
                  run on earlier versions of DOS, if they supply HIMEM.SYS
                  and EMM386.EXE.
                  
  The project does not run with sound directly under a Windows 95
  environment. On some machines, even shutting down and choosing "restart
  in MS-DOS mode" has not cleared the necessary memory. To make sure the
  project works correctly on Win95 systems, when you see the 'Starting
  Windows 95' text, when your computer boots, press 'F8' and choose the
  option for 'Command Prompt Only'

  If you somehow make it work under a DOS prompt, please tell me how! And
  also remember to turn your screensaver off, because if that triggers while
  everything is happening, it will be likely to crash!

                
               c) You need about 1meg of EMS ram.
               
  If you are unsure whether you have met this requirement, then from a DOS
prompt, type 'edit c:\config.sys'. (If the drive which your computer boots
from is not 'c:' then alter it, as necessary. You should be able to see 
lines resembling the following:

                       device=c:\windows\himem.sys
                       device=c:\windows\emm386.exe
                       
  The paths, ('c:\windows') may be different, depending on where Windows,
or DOS, are installed. If these lines do not exist, then choose file exit.
Now type 'dir /s /b emm386.exe' and make a note of the path for emm386.exe
when it appears. Do the same with: 'dir /s /b himem.sys'. Now repeat the
'edit c:\config.sys' command, and place the two 'device' lines shown, 
replacing the 'c:\windows\....' with the paths you made note of, at the 
beginning of the file. Choose File, Save, and then File, Exit. When you
reboot your computer, you will have the necessary memory settings.

***************************************************************************

                           3. Installation
                           
  To install the project, you need to unzip the zip file, which you have
already done, because you are reading this text which is inside it!
Run MSETUP.EXE, which will configure the sound. 

  NOTE: If you have a card which requires a driver to be SoundBlaster
compatible, then you should run this driver before running MSETUP. My sound
card is an Creative Soundblaster 16 PCI, and I have to run a file:
...../creative/ctsnd/dosdrv/sbinit beforehand, and this configures my sound
card to run as Address=220, IRQ=7, DMA=3. That's just an example though.

  Then run SAVIOUR.EXE, to run the project.

  Run SAVIOUR.EXE /F to run without time-locking. (Very fast on fast comp)
  
****************************************************************************

                           4. Troubleshooting
                           
  > 'UN-ABLE TO LOCK VIRTUAL DMA BUFFER'
  
  This error message occurs when I try to run the project from a Windows-95
dos prompt. As far as I am aware, it is not possible to run the project 
with sound whilst running Windows 95. You should restart your computer,
and press F8, as described in section 2b.

  > EMS MEMORY ERROR, or NOT ENOUGH RAM.

  Firstly, check section 2c, regarding setting up EMS memory. The project
also requires about 550k of base memory free. This will normally be fine,
but if you have large, or many TSRs running, or drivers such as CD-ROM
drivers, smartdrive, virus checkers, network drivers... etc... base
memory could be low.

  To fix this, choose step-by-step confirmation when you press F8 while
booting. (In Win 3/DOS, I think it's F8 or F5 to do this). Say 'NO' to
any windows drivers - basically say YES to HIMEM.SYS, EMM386, and anything
sound card related, and say NO to everything else. This should free your
base memory up quite a lot. Also make sure that you have a line,
'DOS=UMB,HIGH' in your config sys file.

  If you are still having problems, then you can mail me at the e-mail
  address at the bottom of this text file. (If you really have problems
  getting 550k of base memory, then running without sound will reduce
  it to about 520k, but it's nowhere near as good!)

  > SOUND CARD INITIALISATION ERROR

  i) Try running MSETUP.EXE again - you could try a lower version of the
  Soundblaster, or lower specs for the frequency or resolution of the
  sound. If you are having problems in finding out the address, interrupt
  and DMA channel for the sound card, then 'more autoexec.bat'. Look for
  a line which says something like 'set blaster=a220 i5 d1'. In this
  example, the address would be 220, the interrupt 5, and the DMA channel
  would be 1.

  ii) Does your sound card need a driver to make it soundblaster
  compatible? If so, make sure you have run this driver before you run
  MSETUP.EXE. You should have DOS drivers complete with your sound card,
  (if it is nice) and you can download them from many sites as well.
  
  iii) Still problems? For the moment, select 'No Sound' in MSETUP.EXE
  and mail me, and I'll do my best to help.
  
  > OTHER RUNTIME ERRORS WITH UNFRIENDLY NUMBERS
  
  Sorry! These are times where my code has gone wrong! Generally, these
  could be due to the following... (I've never seen any errors like this
  in the final version, but here are the possibilities)... Just to let
  you know, the project has been fully tested on a wide range of
  computers as well, so any problems are most likely to be configuration
  errors, concerning the system requirements.
  
  i) Not enough conventional (base) memory - see a bit earlier in this
  section. Runtime error 202/203 is the base memory problem, I think.
  
  ii) File not found - all the files should be in one directory, which
  is the same one that MSETUP and SAVIOUR are run from. This is
  Runtime Error 201.

  iii) Runtime Error 200 when running? This is the dreadful pascal bug
  that happens when running .EXEs on fast machines. It's to do with
  Pascal's 'crt' unit, where there is a routine that counts the number of
  cycles in a second - it overflows on really fast machines, and gets
  reset to zero. The error 200 happens when it later tries to divide by
  this number - hence the divide by zero error - I hope you found that
  interesting!

  ANYWAY, this should never happen again as this version patches the
  .EXE files so that they don't suffer from this anymore.
  
  iv) Other than that... I've never had any other errors coming out of
  it, and it's been tested on a large number of fairly bizarre machines!
  Generally the problems are to do with the synchronisation of the music
  and words, rather than actual errors. There should NEVER be any errors
  in my code, because there are no parameters that can cause errors!
  (Theoretically at least!)
  
****************************************************************************

                           5. Project History
                          
  The music, lyrics, graphics, words, and everything were put together 
between August 12th and October 4th, 1997. The project was first released
on a free floppy disk, and was distributed to students at Fresher's fayres
in Imperial College London, and the University of London Union fayres. It
was designed as a boot disk, which would set up the slightly awkward EMS
settings described earlier -  sorry about those - and then install itself
with a menu. Packaged with it was a game called Smudgelet's Maze,
originally written in March 1996. The limitations of disk space made the
project quite 'concise' in its coding, and picture use, but in the end it
fitted the disk comfortably! The disk was written for a group of Christians
called CSA - Christian Student Action, also known as Campus Crusade for
Christ, and Agap.

  Maybe someday I'll upload Smudgelet's Maze to cdrom.com ?!

  In this project, the aim is really to give people a clear view about Jesus,
that He is real, alive and can make a difference in our lives TODAY, if we
invite Him in. The stories you may have read or heard about His life, aren't
just myth, or events from a past age. The Bible lays out what Jesus did for
YOU, so what He did is both relevant, and personal, to YOU, as a named
person.
 

  Version 1.01:  added better synchronise between the video and music.
Faster machines than my old 486 DX-40, had some black gaps that needed
removal, and some of the effects were out of sync. The solution isn't great -
it sometimes makes a slightly jerky strobe-like effect, so the option is
there to turn it off, if you prefer it the way it was.

  Version 1.02: on fast machines, a nasty bug happened in pascal, resulting
in all .EXE files run on a P166 or above (roughly), exited very untidily with
Runtime Error 200. Sorry if you got this! This has now been patched in this
release. I'd hoped to make a number of other improvements, but sadly they all
went wrong and I ran out of memory... hope to fix it properly soon.


****************************************************************************
                       
                            6. Freeware
                            
  FIRSTLY... this software is COMPLETLEY freeware; please DO distribute it,
keeping all of the code, pictures, music, text, etc. in this original form.
You MAY provide a contact address as well, which can be put in this file,
provided the text here already remains unchanged, or as a seperate file.
This is for follow-up use, so if a viewer you have given this to would like 
to contact you instead of me, than that is fine!

     - The music, words, and coding is copyright, by the author.
     - The MOD player used is the MIDAS SOUND SYSTEM, which you can
       download from most major ftp sites.
     - The pictures... the photos of Jesus were taken from the Jesus video,
       which is copyright, Christian Student Action. (a.k.a. Agape).
     - The monochrome pictures were published by Odhams, in about 1950. I
       have attempted to follow up this to obtain full permission, but
       Odhams do not seem to exist any more, and I have been unable to
       get information on them. Any information on this is welcome. Advice
       from the National Book Trust suggested that as the project is free,
       a message such as this is sufficient to cover copyright liability!
     - The picture of the father and baby's hands, is copyright, 
       His People Christian Ministries.
     - All other pictures used are from freeware sources.

  Permission for all images was willingly obtained where possible, and this
project is a tool which all of the involved groups have used, and encourage
the free use of it.


****************************************************************************
 
                           7. Contact
                           
                    E-mail me at w.hinsley@ic.ac.uk.
                The website: http://www.doc.ic.ac.uk/~wrh1/

  Please feel free to contact me with technical difficulties, criticism,
encouragement, or any comments whatsoever about the content of this project,
        suggestions for future projects.... absolutely anything!

****************************************************************************

Final notices.... thanks to everyone who has encouraged, inspired, motivated,
criticised, and generally helped me through about seven weeks of programming
this project; without you it probably would never have got off the ground.
That includes everyone I've talked to about it, everyone I've shown it to in
whatever state... in fact, everyone! And also, most of all, thanks to the One 
who this disk is about, for the time, energy and inspiration to write it. I
hope that you, the viewer, will learn something new about Him, no matter
where you are in life.

Special thanks to Lars, for much encouragement through trying to use this in
an excellent way - and for pushing me to keep it up to date and working.
Stench will also get the update treatment over the next week or two.
                                                                
                                                                --------------
                                                                  Wes Hinsley
                                                                     Feb 00


****************************************************************************

27th February 2000

****************************************************************************
