ej.microui.event.generator

Class States

java.lang.Object

ej.microui.event.EventGenerator

ej.microui.event.generator.States

public class States
extends EventGenerator

A states event generator is usually associated to a group of physical devices holding a position (switch, rotary wheel encoder, ...) and allows to generate events relating to them. This class generates Event.STATE events and allows to retrieve for each state its current value. Each instance can manage at most 256 states and each state can have a value between 0 and 255.
A state has a unique ID between 0 and getNumberOfStates()-1

Constructor Summary

Constructors

Constructor and Description
States(int[] nbValues, int[] initialValues) Creates a states generator.

Method Summary

Modifier and Type	Method and Description
int	getCurrentValue(int stateID) Gets the current value of the given state.
int	getEventType() Gets the event type associated with the event generator.
int	getNumberOfStates() Gets the number of states managed by this instance.
int	getNumberOfValues(int stateID) Gets the total number of values for the given state.
static int	getStateID(int event) Gets the state's ID held by the state event.
static int	getStateValue(int event) Gets the state's value held by the state event.
void	send(int stateID, int value) Stores the given state value and sends a MicroUI Event.STATE to the States's listener.

Methods inherited from class ej.microui.event.EventGenerator

addToSystemPool, get, get, get, getEventHandler, getID, getList, removeFromSystemPool, sendEvent, setEventHandler

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

States

public States(int[] nbValues,
              int[] initialValues)

Creates a states generator.

Parameters:

nbValues - number of values for each state.

initialValues - initial value for each state.

Throws:

java.lang.NullPointerException - if one of the parameters is null.

java.lang.IllegalArgumentException - if both arrays don't have the same length.

java.lang.IndexOutOfBoundsException - if arrays length is greater than 255.

java.lang.IndexOutOfBoundsException - if nbValues[i] < 0 or nbValues[i] > 255.

java.lang.IndexOutOfBoundsException - if initialValues[i] < 0 or initialValues[i] >= nbValues[i].

Method Detail

getStateID

public static int getStateID(int event)

Gets the state's ID held by the state event.

Parameters:

event - the state event to decode.

Returns:

id between 0 and 255.

getStateValue

public static int getStateValue(int event)

Gets the state's value held by the state event.

Parameters:

event - the state event to decode.

Returns:

value between 0 and 255.

getEventType

public int getEventType()

Gets the event type associated with the event generator.

Specified by:

getEventType in class EventGenerator

Returns:

the event type.

getNumberOfValues

public int getNumberOfValues(int stateID)

Gets the total number of values for the given state.

Parameters:

stateID - the state identifier value.

Returns:

the total number of values for the given state.

Throws:

java.lang.IndexOutOfBoundsException - when stateID is out of [0,getNumberOfStates()-1].

getCurrentValue

public int getCurrentValue(int stateID)

Gets the current value of the given state.

Parameters:

stateID - the state identifier value.

Returns:

a number between 0 and getNumberOfValues(int)-1.

Throws:

java.lang.IndexOutOfBoundsException - when stateID is out of [0,getNumberOfStates()-1].

getNumberOfStates

public int getNumberOfStates()

Gets the number of states managed by this instance.

Returns:

the number of states managed by this instance.

send

public void send(int stateID,
                 int value)

Stores the given state value and sends a MicroUI Event.STATE to the States's listener.

Parameters:

stateID - the state identifier value.

value - the new state value

Throws:

java.lang.IndexOutOfBoundsException - when stateID is out of [0,getNumberOfStates()-1].

java.lang.IndexOutOfBoundsException - when value is out of [0,getNumberOfValues(int)-1].