Sound Option Builder ----------------------------------- SOB allows complete control of how your phone responds to an incoming call. With SOB you can edit the script used by your phone when a call is received. This script, and the associated sound file (MP3 or WAV) results in sounds, vibrating, flashing LEDS, and so on. SOB includes 5 quick set buttons preprogrammed with some helpful ring scripts. Use these scripts as starting points to create your own unique ring scripts. With SOB you can even associate a different ring tone for each script you create. And you can preview your creations right in SOB. For those using application launchers such as UltimateLaunch, Throttle, rlToday, MortScript, etc, SOB includes features specifically designed for you. Shortcuts can be created in SOB that when used with a launcher, or the start menu, there is no limit to the number of combinations of scripts and ringtones you can make. See the Command Line section below for more information. Main Window ------------------------ Gray buttons - Click any of these buttons and the script will be applied and SOB will exit. Green buttons - Throughout SOB the green button is used to preview a ring. Blue buttons - Use the blue button to edit one of the 5 saved scripts. New menu - Start a new script. Close menu - Exit SOB. Preview Window ------------------------ The name of the script, the script, and the current ring tone will be shown. As the script is run, icons will appear as each function of the script is run. Click Stop to close the preview. SOB uses the FMOD Sound System, copyright © Firelight Technologies Pty, Ltd., 1994-2007. Edit Window ------------------------ Blue Arrow buttons - Use these to move the selected part of the script right or left. Red X button - Use this to delete the selected section of the script. + buttons - Use these to add to the script. These are explained below. Tone - This is the currently selected ring tone. Use the "..." button to select a different tone. Blue ShortCut button - Use this button to create a shortcut for any script/ring tone combination. Shortcuts are explained below. Save menu - Save your script into one of the 5 Quick Set positions. Cancel menu - Close the edit window. Save Window ------------------------ Choose a position from the list and give your new script a name. It will then appear on a Quick Set button every time you start SOB. ************************************************* Anatomy of a script A = Activate - Wakes the phone from sleep. R = Repeat - Repeat the script in a loop. Ususally placed at the end of the script. C = Set Volume - Valid settings are 0 to 255. 125 is about 50% volume. 255 is full volume. F = Flash - On certain phones this will cause the LEDs to flash. The number after the F tells the phone how many seconds to flash. P = Play - Play the ringtone. Leave this out for a silent ring. V = Vibrate - The number after the V tells the phone how many seconds to vibrate. W = Wait - The number after the W tells the phone how many seconds to wait. This creates pauses in the script. ************************************************* Command Line and Shortcuts SOB can quickly set one of the 5 saved Quick Set scripts through a command line parameter. Create a shortcut and a number between 1 and 5 and SOB will apply that script and exit. SOB has 5 Quick Set positions but that is not the maximum number of custom scripts you can have. On the Edit window there is a blue create shortcut button. Using this button you can create a shortcut that contains a script and ringtone. When the link is run, SOB applies the script and ringtone and exits. ************************************************* Known Issues Volume While the C setting (set volume) is supported in SOB, it does not have the ability to change the volume as of yet. Therefore, the Preview will not actually set the volume to your setting. This will be corrected in a future release. Flash Some phone models do not support LED flashing as it is implemented in SOB. This only affects the preview of scripts using F and should not cause an error. FMODce In order to play both WAV and MP3 files in the preview, SOB relies on the FMODce library from FMOD.org. This library is very large (440 kb). For those concerned about storage space, it is recommended that you install SOB to a storage card. Another alternative is to not install FMODce. If you elect to not install FMODce, SOB will function fine until you preview a script that contains a P command. SOB will then generate and error and exit. Landscape Landscape orientation is supported only when the device is in landscape mode before starting SOB. SOB will not recognize changes in orientation after it is running.