Miscellaneous Operations
public byte[][] split(String format, int numberOfMessages) throws RingtoneConvertException
This method returns an array of byte arrays. Each byte array contains data for a separate short message. It's extremely useful if you wish to convert a ringtone into an EMS/SMS format and send it in several messages instead of just one. In this case, you specify the ringtone format and a maximum number of messages to fit this ringtone in. It might happen that if you tell Ringtone Creator to return 3 messages, it returns only 2 or 1 because the ringtone is too short to fit three messages. Always check the size of the output
public int getTrackNotesCount(int track);
Get the number of notes on each track. For PCM ringtones this number is always 0.
public void setSongVolume(int songVolume);
Set the song volume. This value ranges from 0 (silence) to 127 (maximum).
public void setSongVolume(String volumeString) throws IllegalArgumentException
Set the song volume. This is a very advanced method allowing adjusting ringtone volume in points (0..127, see above for description), percents or dB.
Example 4.3. Change ringtone volume
public Ringtone fade(int fadeTime);
Sometimes it's necessary to add a “fade” effect to a ringtone so that when you truncate a ringtone, it doesn't end right away but the volume is decreased to zero instead. It's very important for creating ringtone previews. fadeTime is a number of milliseconds necessary for making a fade.
Example 4.4. Fading sound
public Ringtone append(Ringtone appendedRingtone);
Appends one ringtone to the end of the other. It's useful for marking audio content. (NB. For PCM ringtones only)
