*** OSX Background Changer - Build 004 ***

Assembler: eko
Art by: Dragon (osx), Ogami (UT Planet)
Email: eko@planetunreal.com

*** SUMMARY ***
This is a modification for Unreal Tournament (all versions), Unreal Gold
v226 and Unreal 227 (Gold or Classic as long as Unreal Windows is active)
which changes the background on your game's desktop. It replaces the
default "Unreal Tournament", "Unreal Gold" or "Unreal OldUnreal Edition"
desktop with some included backgrounds, or ones you can make yourself.

The main MOD (osxBackgroundChanger) can accept a max of 256 .u files 
as additional backgrounds. Provided you have access to UCC.exe and can
create them.

Additional backgrounds were available at the [osX] Site: 
http://www.planetunreal.com/osx/changer/
and later, after the move to BeyondUnreal:
http://osx.beyondunreal.com/changer/

Both of these sites have since then perished and are available only in
the Internet Archive Wayback Machine but the downloads weren't that easy
to obtain. Therefore, this new distro of osxBackgroundChanger was made
that includes all of the backgrounds available, plus a few new ones.


*** BUGS ***
On my computer, 16 bit color doesn't show the backgrounds
as well as it should.  Switching to 32 bit solves the problem.
I think this is an issue with my NVIDIA card, but nonetheless, so you know.
Still, it looks fine.

IF it doesn't work for some reason,
trash the osxBackgroundChanger.ini file in the UT System folder
and change your UnrealTournament.ini entry back to root wndow.
(Details in the UNISTALLATION section)


*** FILE LIST AND LOCATIONS ***
Help\OSXBackground_README.txt   : This file.  Put it where you want.
Help\osxSDK                     : The kit for building your own backgrounds.
System\osxBackgroundChanger.u   : The mod.
System\osxBackgroundChanger.int : File which adds the mod to the mod menu.
System\osxBackground.u          : [osX] background file.
System\osxBackground.int        : [osX] background INT file.
System\osxDefaultBackground.u   : Default background file.
System\osxDefaultBackground.int : Default background INT file.
System\osxLogo.u                : [osX] logo background file.
System\osxLogo.int              : [osX] logo background INT file.
System\osxLogo2.u               : [osX] logo 2 background file.
System\osxLogo2.int             : [osX] logo 2 background INT file.
System\osxMorpheus.u            : Morpheus background file.
System\osxMorpheus.int          : Morpheus background INT file.
System\osxOldUnreal.u           : OldUnreal Edition background file. *NEW*
System\osxOldUnreal.int         : OldUnreal Edition background INT file. *NEW*
System\osxPeak.u                : Peak background file.
System\osxPeak.int              : Peak background INT file.
System\osxPhobos.u              : Phobos background file.
System\osxPhobos.int            : Phobos background INT file.
System\osxPowerdesk.u           : M4e Powerdesk background file.
System\osxPowerdesk.int         : M4e Powerdesk background INT file.
System\osxShaneC.u              : ShaneC UT background file.
System\osxShaneC.int            : ShaneC UT background INT file.
System\osxSkyCity.u             : Sky Cities background file.
System\osxSkyCity.int           : Sky Cities background INT file.
System\osxStation.u             : Space Station background file.
System\osxStation.int           : Space Station background INT file.
System\osxTrophy.u              : UT Trophy background file.
System\osxTrophy.int            : UT Trophy background INT file.
System\osxUBlue.u               : Unreal Blue background file.
System\osxUBlue.int             : Unreal Blue background INT file.
System\osxUBrown.u              : Unreal Brown background file.
System\osxUBrown.int            : Unreal Brown background INT file.
System\osxUGreen.u              : Unreal Green background file.
System\osxUGreen.int            : Unreal Green background INT file.
System\osxUnrealGold.u          : Unreal Gold background file. *NEW*
System\osxUnrealGold.int        : Unreal Gold background INT file. *NEW*
System\osxUTBlue.u              : Unreal Tournament Blue background file. *NEW*
System\osxUTBlue.int            : Unreal Tournament Blue background INT file. *NEW*
System\osxUTChaos.u             : Chaos UT background file. *NEW*
System\osxUTChaos.int           : Chaos UT background INT file. *NEW*
System\osxUTDay.u               : A New UT Day background file.
System\osxUTDay.int             : A New UT Day background INT file.
System\osxUTGray.u              : Unreal Tournament Gray background file. *NEW*
System\osxUTGray.int            : Unreal Tournament Gray background INT file. *NEW*
System\osxUTPBackground.u       : UT Planet background file.
System\osxUTPBackground.int     : UT Planet background INT file.
System\osxUTWhite.u             : UT White background file.
System\osxUTWhite.int           : UT White background INT file.
System\OSXBackgroundChanger.ini : File which gets created when you install the background.


*** INSTALLATION ***
Run the UMOD.
For the zip installtion, Move the .u and .int files into the game's System folder.
Then start up the game and select the osxBackgroundChanger menu item from the MOD menu.

It is no longer necessary to restart the game for custom backgrounds to become
active. (Thanks to usaar33).  The desktop will simply reload itself and you can
freely scroll through the backgrounds as long as the MOD is active.  
Same goes for removing custom backgrounds, it is no longer necessary to restart.


*** UNISTALLATION ***
To completely remove the mod, there are two things you need to do.

First, unistall any background you have active from within the MOD 
by pressing the uninstall button.

Then delete the original files you installed from your game's System folder.
(That's why I give you a file list... in case you forget!)

IMPORTANT!!
The installation CHANGES the rootwindow entry in your
UNREAL.INI or UNREALTOURNAMENT.INI file.  So to completely remove the package,
you HAVE TO press the uninstall button in the MOD 
BEFORE you remove the packages and the int files!!

If you forgot to press the uninstall button, or you just want to make sure
you did it right, open up your UNREAL.INI UNREALTOURNAMENT.INI and look for this:

The line changed is the following:

[UTMenu.UTConsole] (UT) or [UMenu.UnrealConsole] (U1 227) or [UPak.UPakConsole] (U1 226)
...
RootWindow=osxBackgroundChanger.osxRootWindow
...

So if you remove the package before pressing uninstall, you have to
change this line back to the original which is:

[UTMenu.UTConsole] (UT) or [UMenu.UnrealConsole] (U1 227) or [UPak.UPakConsole] (U1 226)
...
RootWindow=UMenu.UMenuRootWindow
...



*** CREDITS ***
I ripped the code for doing this straight from the UT Infiltration 2.75 installation,
and the OldSkool AMP modification for UT.
I used the portions of the code which they came up with to change backgrounds,
and engineered it so that they work together.
usaar33 was who came up with the plug-in idea...
what a stroke of genius, if you ask me.  His oldSkool mod has had an option
to replace backgrounds for a while...  but, of course is part of the oldSkool package,
while this is a stand-alone solution.
All of the code (besides some MINOR modifications and a reworking of calls),
was done by usaar33, and Beppo of the Infiltration team.  
I can really take no credit for this being an original idea, or for writing any code.
I basically cut and pasted, and spent a LOT of time trying to get it all to work.  Period.

The magnificent osX logo was done by Dragon, who produces fantastic artwork.
All I did was take the logo he made for me and put it in the osx background
for this distribution.  Email Dragon: infdragon@flashcom.net


*** CREATING YOUR OWN ***
If you want to make your own backgrounds which will work with
the osxBackgroundChanger... check in the osxSDK folder in the UT Help folder.
Lots of goodies to keep you busy in there!
----------------------

UNREAL and UNREAL TOURNAMENT(c)1998 Epic Megagames, Inc.  All Rights Reserved.  
Distributed by GT Interactive Software, Inc. under license.  UNREAL, UNREAL 
TOURNAMENT and their respective logos are registered trademarks of Epic Megagames, 
Inc. All other trademarks and trade names are properties of their respective owners.
