         __________________________________________________________
        |                                                          |
        |  LL      LL              OO      OO                      |
        |  LLLL  LLLL    %%%%%%    OOOO    OO            ======    |
        |  LL  LL  LL  %%      %%  OO  OO  OO  888888  ==      ==  |
        |  LL      LL  %%      %%  OO    OOOO    88    ==          |
        |  LL      LL  %%%%%%%%%%  OO      OO    88    ==      ==  |
        |              %%      %%                88      ======    |
        |                                      888888              |
        |                                                          |
        |              ======              %%%%%%%%%%              |
        |                ==    LL      LL  %%                      |
        |  88      88    ==    LLLL    LL  %%%%%%%%%%  OOOOOOOO    |
        |  8888  8888    ==    LL  LL  LL  %%          OO      OO  |
        |  88  88  88  ======  LL    LLLL  %%%%%%%%%%  OOOOOOOO    |
        |  88      88          LL      LL              OO  OO      |
        |  88      88                                  OO    OOOO  |
        |__________________________________________________________|


Written by Darren Salt, 1997-1999
Based on source for Manic Miner PC by Andy Noble
Music by Matt Simmonds
TimPlayer and 16-bit sound code by Andr Timmermans


Requirements
------------

Manic Miner will run on anything from the Acorn Archimedes onwards, running
in either 26 or 32 bit addressing modes. At the time of writing this includes
the latest ARMv8 featured on the Raspberry Pi educational computer.

It uses either mode 13 (320x256) or mode 49 (320x480). The Archimedes includes
these in its internal mode definitions, for the Risc PC and later they will
need to appear in the MDF for your current monitor.

For the in game sound track you'll need TimPlayer installed in !System.

A universal !Boot is assumed, your Manic Miner high scores will be saved in
your user Choices for next time you play.


Boring legal bit
----------------

This game is FREEWARE.

The original game is  1983 BUG-BYTE Ltd and SOFTWARE PROJECTS Ltd.

You are free to copy this program and its associated files, provided that
they remain intact and that you do not charge for the privilege, except to
cover materials/duplication costs (ie. NO PROFIT).

Permission must, however, be obtained if you wish to use this game on a cover
disk or CD.

This program is supplied "as is"; I cannot accept responsibility for any
problems which it may cause.


Instructions
------------

For those of you who have never played Manic Miner before, all you have to do
is collect the keys to open the exit, which will then start pulsing, then to
reach that exit before your air runs out. Sounds easy? Just give it a try...

Manic Miner installs itself on the icon bar. You can click Select to play, or
Adjust to set the options (which are the same as on the options page in the
game). There's the obligatory menu, with these options and 'Quit'.

From the loading screen (recognise it?) press any key to get to the title
screen.

On the title screen:
  F1      The options page: ABOUT and game SPEED, LEVELS, MUSIC, MODE setup.
  RETURN  Start the game.
  F12     Return to the desktop.

(If you leave the keyboard alone, the game will go into demo mode.)

In Game:
  Left            Q E T U O [
  Right           W R Y I P ]
  Jump            Shift Z X C V B N M , . / Shift Space
                  (and '\' if it's to the left of Z)
  Pause           A S D F G
  Music toggle    H J K L
  Abandon game    Escape
  Desktop         F12

(When you click Select on the Manic Miner icon or select "Resume", the game
will resume in paused mode.)

One joystick (in port 0) is supported via Joystick_Read.

Volume control: keypad + and -.

Oh, BTW, there's a cheat mode or two...


Sound support
-------------

The music is based on the original Manic Miner and has some of the same
qualities ;-) and you even get to hear the original, er, collection of beeps.

The sound effects are similar to the original Spectrum version. The samples
are all 8 bit due to their MMPC origins; mm-samp8 uses VIDC logarithmic 
encoding and mm-samp16 uses linear signed.


Modes
-----

Below are some sample mode timings if your MDF is missing them. Monitors vary
considerably in their abilities, so you may need to use !MakeModes to edit
them to suit. For example, increasing the pixel rate and adding some borders
would at least allow the image to be displayed, albeit in a letterbox.

    # 320 x 256 (70Hz)
    startmode
    mode_name:320 x 256
    x_res:320
    y_res:256
    pixel_rate:12587
    h_timings:42,14,12,320,12,0
    v_timings:2,106,0,256,0,85
    sync_pol:2
    endmode

    # 320 x 480 (70Hz)
    startmode
    mode_name:320 x 480
    x_res:320
    y_res:480
    pixel_rate:16200
    h_timings:24,40,16,320,16,32
    v_timings:3,28,0,480,0,9
    sync_pol:3
    endmode


Default settings
----------------

Some of these depend on your machine specification. Archimedes will select
the lower resolution graphics and lower quality sound for example, whereas
a StrongARM Risc PC will opt for higher grades.


Contact
-------

This version:   http://www.riscos.info/index.php/Manic

TimPlayer:      http://www.riscos-digitalcd.net/digitalcd/modules/timplayer.htm

Manic Miner PC: http://retrospec.sgn.net/game/mm
