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





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.