*** OSX Background Changer SDK***

By: eko

*** SUMMARY ***
This document will show you how to create your very own
backgrounds for use with the osxBackgroundChanger MOD.


*** FILE LIST ***
creatingyourown.txt : This file.  You're reading it.
template.psd : 1024x768 photoshop file with guides for your image.
slice for UT.atn : Photoshop actions file for automating the slicing process.
osxMyBackground.int : Template INT for having your backgrounds work.
osxMyBackground/Classes/osxMyBackground.uc : UScript file which allows you to build
	a .u file with UCC.exe for use with the osxBackgroundChanger.
osxMyBackground/Textures/ : Folder where your background textures will go for them
	to be imported into the .u file by the UScript file.  (Currently, there are
	some placeholder images there... if you build a .u file with those, you 
	will have a nice star background you created.)


*** GETTING IT ALL TO WORK ***
-- This section is Under Construction - I'll clean it up one day --
1. Create a 1024x768 background you like.
2. Copy and paste that image into the photoshop "template.psd" file.
3. Import the Photoshop Actions file "slice for UT" into photoshop.
4. Run the "Slice for UT" action on your image.
5. You will still have to downsample the resulting slices to 256 colors max.  Photoshop did not produce good results.  So, I use photoshop to slice and IrfanView or GraphicConverter to downsample.
OR
6. Manually slice the image yourself if you don't have photoshop. (Tedious!
   The image must be in PCX format and a max of 256 colors.
   The image must be chopped up into 256x256 pixel slices. With a numbering scheme as follows:
   11 (top left) 12 (right below it), 13 (bottom left).
   Then so on with the rest of the image, 21, 22, 23 - 31, 32, 33, 41, 42, 43.
   After you make your slices, (if not already done) downsample them to 256 colors
   with "IrfanView", a PC app that oddly enough, produced better results than the
   Photoshop indexed color downsample.  "Graphic Converter" on the Mac also produced good results.
   Your resulting images should be named:  11.pcx, 12.pcx, 13.pcx, etc...
7. Create a copy of the osxMyBackground folder somewhere (don't use the original, leave that as the template)
8. Rename the folder to what you want your package to be named. 
   (I suggest starting all the new package names with "osx", that way, they will all group together nicely.)
9. Get rid of the images in the "Textures" folder and replace them with the one's you just created.
10. Open the osxMyBackground.uc file in the "Classes" folder with a text editor and make the following changes:
	On the line that reads "class MyBackground expands osxChanger;", change "osxMyBackground" to
	the name that you gave your folder.
	Change all instances of "myBG" to a name you want.  (myBG1 would be fine...)  If you 
	decide to make more backgrounds later, just change the name accordingly (myBG2, for example).
11. Save the document, and rename it so that it matches the name you gave your folder.
    Now you are ready to compile.
12. Move the folder with the "Classes" and "Textures" in it (yes, the one you renamed)
    to the TOP level of your UT folder.
13. Open up your UnrealTournament.ini folder and add the following lines at the end of the
    "[Editor.EditorEngine]" section:
    [Editor.EditorEngine]
    ...
    ...
    ...
    EditPackages=osxBackgroundChanger
    EditPackages=osxMyBackground (replacing "osxMyBackground" with the name you gave your folder)
    NOTE!  osxBackgroundChanger.u MUST be installed in your UT System folder for this to work.
14. Save and close your UnrealTournament.ini folder and launch a DOS prompt.
15. cd (change directory) to your UnrealTournament/System directory in the DOS prompt.
16. Type "ucc make" into the DOS prompt.
17. If UCC.exe is installed (it should be), then it will begin compiling the default packages
    eventually compiling the one you just added to the EditPackages line.
18. If you get an error, open up the "UCC.log" file in the UT/System folder and see if you can
    track it down.
19. If all goes well, you will have an "osxMyPackage.u" file waiting for you in the UT/System folder.
20. Leave the newly created .u file in the UT/System folder.
21. Make a copy of the "osxMyBackground.int" (renaming it so that it matches your folder and the new
    .u file you made) file and move it to the UT/System folder.  (Obviously, don't change the .int
    extension on it!)
22. Open up this file in a text editor and make the following changes.
    [public]
    Object=(Name=osxMyBackground.osxMyBackground,Class=Class,MetaClass=osxBackgroundChanger.osxChanger, Description="My Background")
    Change the "osxMyBackground" (both instances) so that it matches your other files you've been changing
    the names for.  The Description can be anything you like.
23. Your new background should be ready for use with the osxBackgroundChanger.  Congrats!




*** CREDITS ***
usaar33 came up with this scheme for creating backgrounds with his FANTASTIC mod,
OldSkoolAMPD.  All credit goes to him from whom I pretty much ripped all the
ideas for the changeable backgrounds.

----------------------

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.
