[Last modified by Christopher Martin on 6 June 2020.]


INSTALLATION NOTES
------------------

1.  This is a complete version 1.56 alpha 15 of !Thump, based on modifications by
    Christopher Martin and David Pitt to the original 1.49 sources by Rick
    Hudson. If upgrading, rename or remove the previous installation before
    installing this version. Do not simply drop this application over the top of
    the previous one in case obsolete files/folders remain or are not upgraded.

2.  If upgrading from an older version, I suggest that you delete the files in
    the Thump cache folder. The cache folder will be opened by the following
    *command (unless you have made changes to Thump's !Run file, in which case
    you will probably know enough to find the cache folder for yourself):

	*filer_opendir <Wimp$ScrapDir>.Thump

    If in any doubt, run Thump so it appears on the iconbar, then immediately
    quit it (before using it to display any images or folders) and run this
    *command:

	*filer_opendir <Thump$CacheDir>

    Delete the contents of this folder before using this version of Thump in
    earnest for the first time.

3.  This version of Thump will, by default, use a RamDisc (if present) as a very
    fast scrap folder. If you have a RamDisc configured but want Thump to leave
    it alone, comment out the first command in Obeyfile <!Thump.!Run>.

4.  It is best if either !Spr2Png or !Png2Spr has been seen by the Filer before Thump
    sees any PNG images. Thump prefers Spr2Png. One easy way to ensure this is to have
    !Spr2Png (or !Png2Spr) in the same directory as !Thump. The !Spr2Png application
    is available at <http://old-www.moreofthesa.me.uk/progs.graphics.html>.
    Users of newer hardware, please note: You may need to also download an updated build
    of the png2spr program from <http://www.mw-software.com/software/spr2png/png2spr009.zip>
    and install it inside your !Spr2Png application folder.

5.  Thump uses the ArtWorks modules to deal with ArtWorks files and will look
    for them in ArtWorks or the free AWViewer. The free 32-bit AWViewer is at
    <http://www.mw-software.com/software/awmodules/awrender.html> and should be
    installed in !Boot.Resources.


KNOWN ISSUES
------------

At time of writing, according to ArtWorks developer Martin Wuerthner, sprites
cannot be rendered from high (top bit set) addresses due to limitations in
GSpriteExtend. This situation has been found to occur on 512MB machines using
dynamic areas. Failures of ArtWorks' GSpriteExtend, GDraw or AWRender modules
will cause Thump to display a blank or inaccurate image. Until these modules'
high-memory problems are resolved, on machines with more than 256MB RAM, I
recommend changing "-maxda=64" to "-maxda=0" in the last line of Thump's !Run
file. Unfortunately, on older machines with a limit of 26MB in the wimpslot,
this will have the side-effect of limiting the images Thump can display to
whatever can fit within the 26MB.

JPEG files will be handled by RISCOS if the SpriteExtend module supports it.
This is mostly preferable to calling a utility like djpeg or jpegtrans to
convert a JPEG to sprite as earlier releases of Thump used to do. Unfortunately,
there is a rarely seen but catastrophic bug in some versions of SpriteExtend's
JPEG handler. This will cause Thump to display a blank image, and !ERROR in
thumbnail views.

Recent work was undertaken to resolve bugs detected by modules ZeroPain and
StopClose0. There may be more such bugs to be discovered and resolved.


SOURCE CODE AVAILABILITY
------------------------

Rick Hudson released version 1.47 of Thump under the GPL. In accordance with
that licence, the full sources for !Thump are available through the Thump SVN
repository at <http://www.riscos.info/index.php/Source_repositories_overview>.
Thanks are due to Adam Richardson for launching the SVN repository.

To build !Thump from the sources, you will also need:
  The C/C++ compiler suite from ROOL or Castle. It should also be possible to
   rebuild from scratch with GCC 4, but this has not been fully tested at time
   of writing. Some issues have been found with different versions of GCC.
  OSLib which is available from <http://ro-oslib.sourceforge.net/>.
  Rink which is available from <http://compton.nu/riscos/rink/>.

To rebuild Thump, first install the full contents of this release into a folder.
Run the <SetLibs> obey file. Run <RickLib.Makefile> to ensure that the support
library is up to date. Finally, run <!Thump.Source.Makefile> to rebuild
<!Thump.!RunImage> and all its modules.