javax.microedition.amms.control
Interface EffectOrderControl

All Superinterfaces:

Control

public interface EffectOrderControl
extends Control

EffectOrderControl is an interface designed to specify the order of effects represented by EffectControls. It is intended that an EffectOrderControl might be exposed by Players, EffectModules, MediaProcessors, MIDIChannelControls and by the GlobalManager.

Effects with a smaller order are processed first.

If an EffectOrderControl is not used, the default ordering of effects will be used. The default ordering is implementation specific.

Since:

BlackBerry API 5.0.0

Method Summary
int	getEffectOrder(EffectControl effect)
EffectControl[]	getEffectOrders()
int	setEffectOrder(EffectControl effect, int order) Sets the order of the effect in the effect chain.

Method Detail

setEffectOrder

int setEffectOrder(EffectControl effect,
                   int order)

Sets the order of the effect in the effect chain. If the implementation does not allow a certain ordering of the effects, it may reorder the effects as it sees fit.

Parameters:

effect - the effect whose order is to be set

order - @return the actual order of the effect that was set the desired position of the effect in the effect chain. The range is the whole Integer range.

Throws:

IllegalArgumentException - if the effect cannot be fetched from this class or if the effect is null

Since:

BlackBerry API 5.0.0

getEffectOrder

int getEffectOrder(EffectControl effect)

Parameters:

effect - a value ranged to the whole Integer range, smaller values meaning earlier effects the effect whose order is queried

Returns:

processing chain.

Throws:

IllegalArgumentException - if the effect cannot be fetched from this class or if the effect is null

Since:

BlackBerry API 5.0.0

getEffectOrders

EffectControl[] getEffectOrders()

Returns:

processing chain.

an array of EffectControls in the their current order where the first item in the array means the effect that is processed first

Since:

BlackBerry API 5.0.0