UnwiredtecDocumentation - RingtoneCreatorJavaPoly

2005-11-02 08:29:55

Comparison for /Ringtone Creator Java Poly of 2005-11-02 08:29:55 and 2006-01-24 02:07:22

Additions:

RingtoneConstants.OPTION_DISALLOW_INSTRUMENT_CHANGES

Forbid changing the instrument in the middle of the channel. Is necessary for Nokia Series 40 devices.

2005-11-02 08:24:36

Comparison for /Ringtone Creator Java Poly of 2005-11-02 08:24:36 and 2005-11-02 08:29:55

Additions:

Yamaha SMAF MA-2, Yamaha SMAF MA-3, Qualcomm CMX 3.X and 4.X, NTT DoCoMo MFi ringtones are mixed formats ringtones and are not listed here though they have all the features of polyphonic ringtones. To read more on them go here.

Deletions:

Yamaha SMAF MA-2, Yamaha SMAF MA-3, Qualcomm CMX 3.X and 4.X, NTT Do Co Mo? MFi ringtones are mixed formats ringtones and are not listed here though they have all the features of polyphonic ringtones. To read more on them go here.

2005-11-02 07:45:52

Comparison for /Ringtone Creator Java Poly of 2005-11-02 07:45:52 and 2005-11-02 08:24:36

Additions:

2005-11-02 07:44:19

Comparison for /Ringtone Creator Java Poly of 2005-11-02 07:44:19 and 2005-11-02 07:45:52

Additions:

See also information on mixed formats

2005-11-02 07:27:00

Comparison for /Ringtone Creator Java Poly of 2005-11-02 07:27:00 and 2005-11-02 07:44:19

Additions:

public Ringtone truncateChannels(int channelsCount, int allowedRhythmPolyphony);
public Ringtone truncateTracks(int polyphony, int[] tracks, int allowedRhythmPolyphony);
public int getPolyphonyLevel();
public Ringtone truncatePolyphonyLevel(int polyphony);
public Ringtone truncateParts(int maxCount);

Truncate the ringtone so that not more than maxCount parts is used

maxCount is the max part number

public int getTracksCount();

Get the number of tracks in the ringtone

public int getTrackNotesCount(int track);

Get the number of notes on the given track of the ringtone.
If there's no track with the given number 0 is returned.

public int getInstantPolyphony(int time);

Return the number of simultaneously sounding notes at the given time (in ms).
If time exceeds getDuration() value, return 0.

public Ringtone reducePolyphony(int channelCount, int maxPolyphony, int drumPolyphony);

Reduce number of channels of the ringtone to the given value.

channelCount is the number of channels to leave
maxPolyphony is the polyphony allowed
drumPolyphony is the drums polyphony

public Ringtone truncateTracks(int maxPolyphony);

Limit the ringtone so that

it's polyphony doesn't exceed maxPolyphony
the tracks are either the same as in the source ringtone or are not present in the target ringtone

Pay attention to MIP table if it's present. Otherwise use natural order of tracks.

maxPolyphony is the polyphony range

public Ringtone append(Ringtone appendedRingtone);

Appends ringtone to the end of current

appendedRingtone is the ringtone to be appended to this one

public void substituteInstrument(Instrument oldInstrument, Instrument newInstrument) throws Incorrect Instrument Exception?

Substitute all occurences of one instrument with the other.
Note that you can't substitute percussion instrument with the melodic or vice verse.
Only instruments of the same nature can be substituted.

oldInstrument id the old instrument to be replaced
newInstrument is the new instrument

public void substituteInstruments(Map instrumentSubstitution) throws Incorrect Instrument Exception?;

Substitute all occurences of the set of instruments with the instruments from the other set.
Note that you can't substitute percussion instrument with the melodic or vice verse.
Only instruments of the same nature can be substituted.

instrumentSubstitution sets the substitution elements (oldInstrument -> newInstrument)

Deletions:

public abstract Ringtone truncateChannels(int channelsCount, int allowedRhythmPolyphony);
public abstract Ringtone truncateTracks(int polyphony, int[] tracks, int allowedRhythmPolyphony);
public abstract int getPolyphonyLevel();
public abstract Ringtone truncatePolyphonyLevel(int polyphony);

2005-11-02 07:10:30

Comparison for /Ringtone Creator Java Poly of 2005-11-02 07:10:30 and 2005-11-02 07:27:00

Additions:

public abstract Ringtone truncateChannels(int channelsCount, int allowedRhythmPolyphony);

Truncate the ringtone leaving only first channelsCount mono channels by priority

channelsCount is the number of channels to leave
allowedRhythmPolyphony is the number of simultaneously playing notes allowed on rhytm(drum) channel

public Ringtone truncateChannels(int channelsCount);

Truncate the ringtone leaving only first channelsCount mono channels by priority. Treat rhythm channel as monophonic.

channelsCount is the number of channels to leave

public abstract Ringtone truncateTracks(int polyphony, int[] tracks, int allowedRhythmPolyphony);

Truncate the ringtone leaving only first channelsCount mono channels by priority given by tracks array

polyphony is the number of channels allowed, if equals -1 no polyphony restriction is used
allowedRhythmPolyphony is the number of simultaneously playing notes allowed on rhytm(drum) channel, if equals -1 there're no limitations
tracks is the priority of the tracks (only these tracks are used)

public Ringtone truncateTracks(int polyphony, int[] tracks);

Same as truncateTracks(polyphony, tracks, -1);

public Ringtone truncateTracks(int[] tracks);

Same as truncateTracks(-1, tracks, -1);

public Ringtone truncateTracks(int[] tracks, int allowedRhythmPolyphony);

Same as truncateTracks(-1, tracks, allowedRhythmPolyphony);

public abstract int getPolyphonyLevel();

Get the maximal number of notes played simultaneously in the ringtone (ringtone polyphony)

public abstract Ringtone truncatePolyphonyLevel(int polyphony);

Truncate the ringtone so that not more than polyphony notes are played simultaneously

polyphony is the max polyphony level

2005-11-02 07:07:07

Comparison for /Ringtone Creator Java Poly of 2005-11-02 07:07:07 and 2005-11-02 07:10:30

Additions:

||Sagem v2.1|.ems|unlimited[[*1]]||
(MIDI 0, MIDI 1, SP-MIDI)| RingtoneConstants.FORMAT_MIDI_0,
RingtoneConstants.FORMAT_MIDI_1,
RingtoneConstants.FORMAT_SPMIDI |
(CMX 1.X, CMX 2.X) | RingtoneConstants.FORMAT_CMX +

RingtoneConstants.OPTION_CMX_CMX1X,

RingtoneConstants.FORMAT_CMX +

RingtoneConstants.OPTION_CMX_CMX2X |

Deletions:

||Sagem v2.1|.ems|9|unlimited[[*1]]||
(MIDI 0, MIDI 1, SP-MIDI)| ##RingtoneConstants.FORMAT_MIDI_0,
RingtoneConstants.FORMAT_MIDI_1,
RingtoneConstants.FORMAT_SPMIDI,## |
(CMX 1.X, CMX 2.X) | RingtoneConstants.FORMAT_CMX+RingtoneConstants.OPTION_CMX_CMX1X,
RingtoneConstants.FORMAT_CMX+RingtoneConstants.OPTION_CMX_CMX2X |