(Hugo Copyright 1996/7/8 by Kent Tessman
 Random Acorn bits Copyright 1997/8 by Colin Turnbull)

Acorn Hugo
==========

(BROKEN RESOURCES? Read about 'htrans' below!)

There are three main binaries provided herein, HC, HD, and HE. These are,
in order, the compiler, debugger, and engine for Hugo. For proper
details on Hugo, refer to ftp://ftp.gmd.de/if-archive/programming/hugo.

Doubleclicking on the Hugo application opens the Games directory. Put
Hugo games files (HEX files) and attending resource files in here, settype
them correctly (ie HEX or HugoRES), before running them.

After the application has been seen, all the binaries should be available
at the command line, so compiling games separately should be easily
possible, once the appropriate files structure has been set up. Again, see
the Hugo docs for details.

Required resources and mode setup
=================================

The game engine presently requires two modules:
  ColourTrans
  SpriteExtend
If your machine doesn't come supplied with appropriate versions of
these modules (RiscOS 3.6 and above certainly do), find some and
locate them in your Systems folder. For reference, versions which
are known to work are ColourTrans 1.65, and SpriteExtend 1.04.
These are required for pretty graphic support, but hopefully this
requirement will be lifted soon.

To specify nice modes for Acorn Hugo Engine to use, set the variable
Hugo$ModeSpec in the !Run file. For RiscPCs this can be of the form Xnnn
Ynnn etc. (just like the ModeSelector), or just a simple number (eg. 12).
For Arcs, it should be just a mode number.

eg. Set Hugo$ModeSpec X640 Y512 C4 F100         (nice if you can manage it!)
    Set Hugo$ModeSpec 12                        (The default)
    

Note: Dodgy 'C' specifier alert! Rather than Cnnn specifying the
number of colours required (eg C32k), use the following number:
2 - 16 colours
3 - 256 colours
4 - 32,000 colours
5 - true colour.
(So the mode specifier below indicates 32k colours.)

In the absence of (a working) mode specifier, Acorn Hugo Engine will
default to the bog-standard mode 12 (which it used to use).

Hugo Debugger DOES NOT use this mode specifier! It _always_ uses mode 12. For
'technical reasons' (Kent's, as it happens) HD keeps four copies of the
screen memory, which would become excessive for larger/deeper modes.

HTRANS
======

RiscOS's builtin jpeg decoding routines don't presently work with
Progressive JPEGs, whilst these are valid in Hugo files. To get around this
there is a utility supplied called 'htrans' which converts all jpegs in a
hugo resource file into non-progressive format (and as an added bonus
reduces the size of jpegs.) It's a simple commandline utility, executed as

htrans -outfile <outname> <inname>
(eg htrans -outfile gbdata gbtemp)

THE END
=======

That's it folks! If it fails to work on your machine, or you need to
contact me, try email to ct@comlab.ox.ac.uk.

I'm giving up porting Hugo now, so feel free to take over the task and
do it properly (things missing include pretty fonts, proper desktop
windows, sounds/music, and much more).

regards, ct
September 1998