Bubble Trouble Xª 1.0.1 READ ME-------------------------------Copyright © 1995-2003 Alex Metcalf/David Wareing and Ambrosia Software, Inc.Some game music Copyright ©Ê1993-1994 Yannis BrownTitle music and some game music Copyright ©Ê1996 Matt SwobodaRezLib library v1.1.12 Copyright © 2000-2003 Ian Ollmann, Ph.D. All rights reserved.WELCOME TO BUBBLE TROUBLE X!We hope you enjoy the game, now fully up to date and native on OS X. Please read the following file before you play, as it answers some frequently asked questions and also includes some useful tidbits of info.Have fun!Alex Metcalf, David WareingBubble Trouble authorsREQUIREMENTSPowerPC MacintoshMac OS 8.6 or laterFor Mac OS 8 and 9 users (most users will have these requirements automatically):     ¥ CarbonLib 1.0.4 or later     ¥ QuickTime (for decoding some game JPEGs)     ¥ Sound Manager 3.3 or later (should be part of recent QuickTime releases)     ¥ 10.5MB (10500k) free memory     ¥ Optional: InputSprocket (v1.7 or later) for game pads, joysticks, etc.For OS X:     ¥ The very latest version of OS X (10.2.5 at time of writing) is          highly recommended. Each version gets faster and more stable.* If you do not meet these system requirements, please download Bubble Trouble 1.0.1, which only requires a 68020 or later (68k machine), 3100k (3.1MB) memory, and System 7.0 or later.PAUSING AND ENDING THE GAMEUse the 'Caps Lock' key (sometimes labelled with a picture of an extended up arrow, on the left of your keyboard) to pause the game.To end a game, unpause it and press 'Escape' (or hold escape for a second if you have that option turned on in the preferences).WHERE CAN I GO FOR MORE COOL BUBBLE TROUBLE STUFF?Check out the Bubble Trouble web site at:http://www.AmbrosiaSW.com/games/bt/HIGH SCORES FOR EACH USERIn OS X, Bubble Trouble stores its preferences in the current user's personal area, so each OS X user has a unique set of Bubble Trouble high scores (and their own registration information).CAN I TRANSFER MY HIGH SCORES FROM BUBBLE TROUBLE TO BUBBLE TROUBLE X?Several gameplay elements have been improved (scoring alternations, multiplier awards), and the preferences files are different, so unfortunately you can't. It's a chance for a fresh start to let you get to the top of the high scores list once again!HOW DO I ERASE THE HIGH SCORES?To reset the high scores to their defaults, hold down the option key while clicking 'Scores' on the main screen.WHY DOES MY SCORE SAY "CUSTOM LEVELS" IN THE HIGH SCORES?Any high scores that are gained from using a custom levels file are identified with the words 'custom levels' next to the name. This is so that anyone playing the pure, unaltered levels can't have their high score sneakily beaten by someone who uses the editor to make a large collection of much easier custom levels! Note that your score is marked as a custom score if any of the levels have been changed, not just the ones you actually got to during your game.To remove this marking from future scores, delete the 'BT Custom Levels' file. Note that deleting this file will delete any custom levels you have made; if you want to keep them, simply move the custom levels file to another folder instead, or rename the file.Note: do not attempt to move or delete the custom levels file when either Bubble Trouble X or the Bubble Trouble editor is open.SCREEN CODEThe main code for switching the screen resolutions/depths and doing screen fades is done through the excellent RezLib library (version 1.1.12) by Ian Ollmann (iano@cco.caltech.edu). This library is built into the Bubble Trouble application, so you do not need to worry about installing it.FULL SCREEN MODEBy default, Bubble Trouble runs 'in a window', reflecting its suitability for the Mac OS X environment.If you have a screen that supports multiple resolutions, Bubble Trouble has an option for attempting to resize your screen to 640x480 for a full screen gaming experience (you may also set the screen size manually before you run the game). You can turn the resizing on in the preferences once Bubble Trouble is open. If this feature causes any problems, hold down the Shift key when opening Bubble Trouble to override this feature.WHY DOES THE GAME PAUSE MOMENTARILY WHEN I VIEW THE SCORES, PLAY A LEVEL, OR QUIT THE GAME?Some of the large background pictures are compressed JPEG images, and they must be decompressed before drawn in all their (millions of colours, if available) glory. This may take literally a second or two on some OS 8/9 Macs. OS X users should notice no significant pause at all.ARE THERE ANY CHEATS FOR THE GAME?No. Absolutely not. None whatsoever. No five letter codes you can type when the game is paused. Nope. (Well, actually, there are twenty five cheats and easter eggs you get with five letter codes...)HOW DO I MAKE THE GAME RUN FASTER?Mac OS X users: Bubble Trouble does everything 'the official way' in OS X, making it not only extremely compatible with a wide variety of Mac configurations (we hope!) but much more likely to be stable for many future Mac OS X updates. It thus also takes advantage of any graphics acceleration your Mac has.As Macs get faster and OS X is optimised further, many or all of the following steps to help increase speed will become unnecessary.¥ Mac OS X (suggestion: attempt these in this order):     - Pause any other applications that may be doing above-average processing,          such as music players, graphics apps, and tools doing software downloading.     - Quit any 'Classic' applications that are using a lot of CPU time.          Run the "CPU Monitor" program in the Utilities folder of Applications          and use its display while quitting applications to identify applications          that are causing CPU usage to max out at 100%. An application that looks          idle can often be written in such a way as to still 'hog' your Mac!     - Turn on the 'switch depth for speed' option in the preferences,          or manually switch your monitor to thousands of colours before opening          Bubble Trouble.     - Turn off the 'bubbles' and 'stars' options in the preferences. Heck, it's          not as pretty, but the game's still as addictive.¥ Mac OS 8 and 9:     - Pause any other applications that may be doing above-average processing,          such as music players and tools doing software downloading.     - Turn on the 'switch depth for speed' option in the preferences,          or manually switch your monitor to 256 colours if your          monitor supports it.     - Try using the 'QuickerDraw' option in the preferences. This          bypasses a few Mac OS safeguards, but can be 10 times faster          or more. This option, together with 256 colours as described          above, should be more than suitable for every Mac that meets          the basic game requirements.Note that due to a new music format in this version of Bubble Trouble, turning off the music will have little effect on game performance.HELP! I'VE TURNED ON RESOLUTION SWITCHING / QUICKERDRAW AND BUBBLE TROUBLE NOW HAS PROBLEMS.If your Mac is incompatible with QuickerDraw custom drawing code in Bubble Trouble (OS 8/9 only), or the resolution or depth switching option is causing you a problem (any system), simply hold down the Shift key when opening Bubble Trouble. All three of these options will be turned off for you; you can always turn them on again in the preferences at a later date.CAN I MAKE MY OWN GRAPHICS, SOUNDS, AND LEVELS FOR BUBBLE TROUBLE?Yes. Once you are registered you will be able to use the level editor to make your own sets of levels, and these levels will be put into a file called "BT Custom Levels" which are yours to freely distribute; anyone else who has a registered version of Bubble Trouble X can put that file in their Bubble Trouble folder and it will be used automatically. See the editor read me file for more information.If you have skills in editing resources of files, you may also make your own sound resources collection, which will be automatically loaded if you have a file called "BT Custom Sounds", and your own sprites which will automatically load if you have a file "BT Custom Sprites". You will need to ensure that your sounds ('snd ' resources) and sprites ('cicn' resources) have the same ID numbers as those in the original file. Note that a user must play Bubble Trouble in 'QuickDraw' mode for the sprites to be used, as the QuickerDraw option (OS 8 and 9 only) uses specially compiled sprites to speed up the drawing.I'VE GIVEN MY CUSTOM LEVELS/SPRITES/SOUNDS FILE TO A FRIEND, AND IT ISN'T WORKING. WHY?Only registered users of Bubble Trouble X may use the custom levels files. The custom file must be called "BT Custom Levels", "BT Custom Sprites", or "BT Custom Sounds" as appropriate, and the file(s) must be in the same folder as the Bubble Trouble X application, not in the BT Data folder. The files are only 'noticed' when the game is opening and loading, so if you add the files while the game is open you must quit and re-open the game.CAN I USE JOYSTICKS OR GAMEPADS WITH BUBBLE TROUBLE?Bubble Trouble supports InputSprocket (version 1.7 or later required) for OS 8 and 9, and many input devices support InputSprocket. For OS X, if your input device does not automatically provide key presses, you may wish to investigate a product called USB Overdrive at:http://usboverdrive.com/(The USB Overdrive product and web site is not connected with Bubble Trouble in any way).WHY IS THE GAME SO MUCH BIGGER TO DOWNLOAD THAN THE OLD VERSION?The music in Bubble Trouble is now in sound resources, and not in MOD music files. Sound resources may be more compatible with future OS versions and take much less processing power to play. However, they are essentially sound recordings, so each music track takes roughly 1.5MB of disk space, and there are five tracks included in the game. In addition, some of the graphics have been improved to look great in millions of colours.TECHNICAL STUFFBubble Trouble was written in C using the excellent Metrowerks CodeWarrior Pro 7 environment and has been compiled as a Carbon application. Alex Metcalf develops in Mid Wales, UK, and David Wareing develops in Adelaide, South Australia. Bubble Trouble uses the Ambrosia Sound Tool for fast multi-channel audio and the Ambrosia Registration Tool, and RezLib by Ian Ollmann for screen resolution and depth switching. Bubble Trouble is published by Ambrosia Software, Inc. in New York state, USA.CONTACTING THE MUSIC AUTHORSMusic exported from MOD format with PlayerPRO v4.5.1 by Antoine Rosset (rossetantoine@bluewin.ch).Music for levels 1-3 ('Bongalonga') and 7-9/title music ('Chunga-babe!'):Copyright ©Ê1993-94 Yannis Brownyannis@bkroom.apana.org.auMusic for levels 4-6 and 10-12 (custom written for Bubble Trouble):Copyright © 1996 Matt Swoboda (Smash/Io)mah196@easynet.co.ukVERSION HISTORYBT X - Version 1.0.1 - April 2003  ¥ Changed startup so if screen fades can't be used it defaults to wipes,      rather than quitting with an error  ¥ Fixed bug with Jaguar where screen could flash indefinitely if game was switched to      background when playing in full screen or with 'switch depth for speed' option on  ¥ Updated resolution switching code, which should make it more compatible with newer systems  ¥ Several smaller bug fixes and changesBT X - Version 1.0.0 - May 2002  ¥ Carbon version, native for OS X, friendly CPU usage  ¥ 'In a window' mode added for both OS 8/9 and OS X  ¥ Bubble Trouble guide included  ¥ Level editor included    - High scores gained from custom levels clearly marked  ¥ InputSprocket support added for OS 8/9  ¥ Improved full screen and depth switching features  ¥ Smoooooother animation on OS X  ¥ 'Reasons to register' graphic added  ¥ Title screen music added  ¥ 32-bit background and title graphics  ¥ Multiplier bonuses now given instantly and flashed  ¥ Diamond bonuses now ramp up better in points  ¥ More compatible graphics drawing  ¥ Fixed menu stars / menu buttons bug  ¥ Fixed cropped 'Credits' button  ¥ Many more easter eggs and hidden features!BT - Version 1.0.1 - March 1997  ¥ Contest edition.BT - Version 1.0 - October 1996  ¥ Initial public release. Was it really that long ago?