Installing the FMOD Ex Library

Download the FMOD Ex SDK for your target platform(s) from the FMOD Website and install or extract the SDK files to your hard drive. Navigate to the install directory and locate the shared libraries in the /api/lib/ subdirectory.

Note: These classes are qualified to work only with the FMOD Ex 4.12 stable release branches. If a future FMOD Ex releases breaks backward compatibility with these classes please check the developer.chaoticbox.com website for updates.

Mac OS X Mach-O (Universal, Intel & PowerPC)

FMOD Ex is distributed as a universal binary dynamic library (dylib) suitable for both PowerPC and Intel targets. Although REALbasic declares work directly with the dylib format, there are issues resolving the library path for debug vs. release builds. For this reason, a Mac OS X Framework Tool project is included in this distribution that can be used to re-package the library into a more reasonable framework format. This tool uses the lipo command line tool available in Mac OS X 10.4 and higher to create an FMODEx.framework from the dylib found in the FMOD Ex SDK. To create the framework, build and run the Mac OS X Framework Tool, then drag and drop the libfmodex.dylib from the FMOD Ex SDK into the edit field and hit the Save Framework button. If you wish to support only PowerPC or only Intel targets click on the appropriate radio button prior to saving the framework.

For debugging purposes the FMODEx.framework should be placed either in the global ./Library/Frameworks/ directory, or in the user path: ./Users/YourUserName/Library/Frameworks/. For release builds, place a copy of the framework inside your application bundle: AppName.app/Contents/Frameworks/.

Windows

Locate the fmodex.dll dynamic library in the FMOD Ex SDK. Place a copy of this dll in the same folder as your REALbasic project file or in an appropriate global system path. This library will need to be installed along side your application executable when distributing release builds.

Linux

Install the FMOD Ex SDK and locate the libfmodex.so symbolic link and the related dynamic library (which has the current version number appended). Place copies of these items in the same folder as your REALbasic project file or in an appropriate global system path such as /lib or /usr/lib. This library will need to be installed along side your application executable when distributing release builds.

Installing the FMOD Ex Audio Classes

To use the FMOD Ex Audio Classes in your REALbasic project simply drag the "FMOD Ex" folder included in the download archive into the IDE's Project tab.