UnwiredtecDocumentation : SoundEngineInstallation

Installation

USE comes in the form of a .jar file (jar extension stands for Java ARchive) and is usually called use-plugin.jar.

Java library or Web application

The Sound Engine can be used in your Java applications if you do the following steps:

Put the use-plugin.jar file into your CLASSPATH.
Set the rtc.dls.bank.path environment variable to match the location of your DLS or SF2 file (fully qualified name).

That's it. You can now write something like this:

Ringtone rt = Ringtone.openRingtone(RingtoneConstants.FORMAT_MIDI, "c:/ringtones/ringtone.mid");
rt.saveRingtone(RingtoneConstants.FORMAT_WAVE + RingtoneConstants.OPTION_FREQUENCY_22050, rt);

Please make sure to populate these environmental variables in your web application since the Sound Engine library can't access the servlet context.
If the sound bank was specified but the file can't be parsed or doesn't exist, during conversion the BankNotFoundException exception will be thrown. If the bank isn't specified at all, the BankNotSpecifiedException exception will be thrown. Both these exceptions are unchecked.

GUI Converter

Here's the sequence of steps you need to perform in order to make USE work with your copy of Ringtone Creator:

Make sure you have a DLS or SF2 sound bank on your computer. Write down the path to it. If you're using Windows and want to use the default sound bank (gm.dls), please navigate to: WINDOWS\system32\drivers and make sure this file is in there. If it's not – you may need to reinstall Windows.
Copy the use-plugin.jar into the same folder where you put the Ringtone Creator executable:

Start Ringtone Creator and open the Options dialog window. You should see a new panel – Plugins. Click on it.

Depending on your configuration and the plugins you've purchased from us, the number of plugins listed in this panel may vary.
Now it's time to configure the plugin. Click the Configure button corresponding to the Sound Engine plugin. Use the Browse button for choosing the DLS or SF2 sound bank you plan to use.

You can play with the bitrate and bits per sample parameters to adjust the sound quality.
Click OK. You can now convert note-based and mixed ringtones into PCM

Please note that in order to save ringtones in MP3, AMR NB/WB or CMX formats you need to have the appropriate codecs installed and configured.