com.corajr.loom

Class LEvent

java.lang.Object

com.corajr.loom.LEvent

public class LEvent
extends Object

An Event has a start, an end, and a value. The start and end are expressed as fractions of a cycle, and the value is constant during that time. (For "events" that vary over time, use a ContinuousPattern.)

Author:

corajr

Constructor Summary

Constructors

Constructor and Description
LEvent(Interval interval, double value)
LEvent(Interval interval, double value, LEvent parentEvent)

Method Summary

Modifier and Type	Method and Description
boolean	containedBy(Interval queryInterval) Returns true if the event's start is less than or equal to the query interval's end, and the event's end is after the query interval starts.
boolean	equals(Object obj)
static LEvent	evt(BigFraction duration, double value)
static LEvent	evt(double duration, double value)
Interval	getInterval() Gets the interval of the event.
LEvent	getParentEvent() Gets the event that "spawned" this event, e.g.
double	getValue() Gets the value of the event.
static LEvent	note(double duration, MidiTools.Note note)
static LEvent	rest(BigFraction duration)
static LEvent	rest(double duration)
static LEvent[]	seq(LEvent... events) Sequences events one after another.
String	toString()

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

LEvent

public LEvent(Interval interval,
              double value)

LEvent

public LEvent(Interval interval,
              double value,
              LEvent parentEvent)

Method Detail

getInterval

public Interval getInterval()

Gets the interval of the event.

Returns:

the interval during which this event is active

getValue

public double getValue()

Gets the value of the event.

Returns:

the value of the event, a number between 0.0 and 1.0 inclusive

getParentEvent

public LEvent getParentEvent()

Gets the event that "spawned" this event, e.g. in case this event has been split by an EventRewriter or an EventBoundaryProxy.

Returns:

the parent event

containedBy

public boolean containedBy(Interval queryInterval)

Returns true if the event's start is less than or equal to the query interval's end, and the event's end is after the query interval starts. For example: if the event goes from 0 to 1 and the query interval is 0.99 to 1.0, containedBy will return true. If the query interval is instead 1.0 to 1.01, it will return false.

Parameters:

queryInterval -

Returns:

whether the event falls within the interval

note

public static LEvent note(double duration,
                          MidiTools.Note note)

rest

public static LEvent rest(double duration)

rest

public static LEvent rest(BigFraction duration)

evt

public static LEvent evt(double duration,
                         double value)

evt

public static LEvent evt(BigFraction duration,
                         double value)

seq

public static LEvent[] seq(LEvent... events)

Sequences events one after another. For example, given two events that last from 0 to 1, the output will have one event from 0 to 1 and another from 1 to 2.

Parameters:

events - the original events, each with a time interval of 0 to `duration`

Returns:

the sequenced events

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object