Foundation-GOL Patch

This is a patch that fixes some minor and major issues in "Foundation GOLD"
which was the latest version in the Foundation series.

It is necessary that you installed a game from the full CD version (real or
virtual one doesn't matter) and apply the latest update called
"FoundationGold151.lha"

INSTALLATION:

case1: Use the installer script
or
case2: Manually copy ptplay.library and ptreplay.library to your LIBS: and also
manually patch via GPatch "FoundationPrefs" and "Foundation" binaries.


NOTE: Only "Foundation GOLD" with "FoundationGold151.lha" (an official bug-fix
update) applied is supported.


FAQ:

Q: What is that patch for?
A: To play that old classic game from 2000 with no limits on our AmigaOS4.

Q: How did you do that?
A: I disassembled binaries via IRA, found (with help from users on the EAB site)
how a mod player was done originally, and replaced it on a C-based AHI player.
   Frank Wille also was a good help with explaining some internal details of IRA
and assembler as a whole.
   Then I reassembled disassembled code back to working binary.

Q: How do you mix ASM from IRA and C-based object files?
A: Via Frank's VBCC (VASM, VC, and VLINK)

Q: How to set up a game so everything will works?

A: For making CD-Audio working you need image and .cue. Then you mount .cue via
diskimage.device
   Then you install cdplayer.library and CDDAPatch from os4depot. CDDAPatch can
be loaded from wbstartup all the time to avoid the hassle.
   Then in the FoundationPrefs, you choose for CD-ROM diskimage.device and your
unit (see it via RMB on the mounted icon on Workbench)
   (you can also check if tracks play via the Test/Stop button in the same
CD-ROM settings area)

   For AHI sounds just choose your AHI unit in FoundationPrefs (beware, they are
not very loud originally, that TODO to deal with).

   If you want fullscreen to be on your current screen mode (like 1920x1080x32
bit), then you had to use prefs:screen. I.e. you run Foundation,
   then L-Amiga+M go to prefs:screen, and insert their screen (and set it to be
on the screen mode you need). And you do that for 3 parts of
   the game: Intro, Menu, and Game itself.



HISTORY:

v.0.1:
		- Increased "Width" of the FoundationPreferences window, so buttons fit in the
preference window with any OS4 theme
		- Replaced internal game's mouse pointer on system's one: the original one
have issues like disappearing randomly (especially in fullscreen)
		- Added AHI-based player for a .mod files used for the title screens
(intro/menu/game-loading/etc). Originally they only work over
Paula/cia.resource.
		- Installation script!!!
		


TODO:

		- Make the volume of sounds when using AHI, louder. They are too low and
together with working CD-Audio they very silent.
		- To patch ASL-Requesters for Save/Load be "OS friendly" on the fullscreen as
well and not only in window mode
		- Maybe allow in the list of screen modes, not just a glut8 ones, but any
other ones as well to avoid prefs:screen usage?
		- To fix the "intro" movie: now it's too fast and too small.