metro

Class MetroTrack

java.lang.Object

metro.MetroTrack

All Implemented Interfaces:

EventListenable, MetroLock, MetroNamedTrack, MetroSyncTrack

Direct Known Subclasses:

PulsarTrack

public class MetroTrack
extends java.lang.Object
implements MetroLock, EventListenable, MetroSyncTrack, MetroNamedTrack

Author:

Ats Oka

Nested Class Summary

Nested classes/interfaces inherited from interface metro.EventListenable

EventListenable.Default, EventListenable.Listener

Field Summary

Fields

Modifier and Type	Field and Description
protected int	cursor
protected boolean	enabled
static java.lang.Object	EVENT_PREPARED
protected EventListenable	eventListenerable
protected int	lastAccumulatedLength
protected int	lastLengthInFrames
protected java.lang.Object	name Note that the String object which is stored in name field must be interned.
protected boolean	prepared
protected MetroSequence	sequence
protected java.util.Collection<java.lang.Object>	tags
protected int	totalCursor

Constructor Summary

Constructors

Constructor and Description
MetroTrack(Metro metro, java.lang.Object name, java.util.Collection<java.lang.Object> tags, MetroSequence sequence) Create a MetroTrack object with default synchronizing status.

Method Summary

Modifier and Type	Method and Description
void	addEventListener(java.lang.Object type, EventListenable.Listener listener)
protected void	checkBuffer(Metro metro, int barLengthInFrames)
protected void	clearBuffer()
void	clearEventListeners()
boolean	equals(java.lang.Object obj)
java.util.concurrent.BlockingQueue<metro.MetroEventBuffer>	getBuffers()
int	getCursor()
int	getLatestLengthInFrames()
java.lang.Object	getMetroLock()
java.lang.Object	getMetroTrackLock()
java.lang.Object	getName()
MetroSequence	getSequence()
double	getSyncOffset()
MetroSyncTrack	getSyncTrack()
MetroSyncType	getSyncType()
java.lang.Object	getTrackName()
double	getTrackPosition()
java.util.Collection<java.lang.Object>	getTrackTags()
int	hashCode()
void	invokeEventListener(java.lang.Object type)
boolean	isTrackEnabled()
protected void	progressCursor(int nframes, java.util.List<MetroMidiEvent> result)
void	removeEventListener(EventListenable.Listener listener)
void	removeGracefully()
void	setCursor(int cursor)
MetroTrack	setSyncStatus(MetroSyncType syncType, MetroSyncTrack syncTrack, double syncOffset)
void	setTrackEnabled(boolean enabled)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface metro.MetroSyncTrack

setSyncStatus

Field Detail

name

protected final java.lang.Object name

Note that the String object which is stored in name field must be interned.

tags

protected final java.util.Collection<java.lang.Object> tags

sequence

protected final MetroSequence sequence

prepared

protected transient boolean prepared

enabled

protected transient boolean enabled

totalCursor

protected transient int totalCursor

cursor

protected transient int cursor

lastLengthInFrames

protected transient int lastLengthInFrames

lastAccumulatedLength

protected transient int lastAccumulatedLength

EVENT_PREPARED

public static final java.lang.Object EVENT_PREPARED

eventListenerable

protected final EventListenable eventListenerable

Constructor Detail

MetroTrack

public MetroTrack(Metro metro,
                  java.lang.Object name,
                  java.util.Collection<java.lang.Object> tags,
                  MetroSequence sequence)

Create a MetroTrack object with default synchronizing status. This constructor is public but this is usually called only from Metro#createTrack(String, Collection, MetroSequence, MetroSyncType, MetroTrack, double) and users should not call this constructor directory. Though it is still left public for further hacking.

Parameters:

metro - Specifying the parent metro object.

name - Specifying the identifier of the track.

tags - Specifying the tag strings. This could be null and treated as an empty set.

sequence - Specifying the sequence object to play.

Method Detail

getName

public java.lang.Object getName()

Specified by:

getName in interface MetroNamedTrack

getCursor

public int getCursor()

Specified by:

getCursor in interface MetroSyncTrack

setCursor

public void setCursor(int cursor)

Specified by:

setCursor in interface MetroSyncTrack

getBuffers

public java.util.concurrent.BlockingQueue<metro.MetroEventBuffer> getBuffers()

clearEventListeners

public void clearEventListeners()

Specified by:

clearEventListeners in interface EventListenable

addEventListener

public void addEventListener(java.lang.Object type,
                             EventListenable.Listener listener)

Specified by:

addEventListener in interface EventListenable

removeEventListener

public void removeEventListener(EventListenable.Listener listener)

Specified by:

removeEventListener in interface EventListenable

invokeEventListener

public void invokeEventListener(java.lang.Object type)

Specified by:

invokeEventListener in interface EventListenable

getMetroTrackLock

public java.lang.Object getMetroTrackLock()

getMetroLock

public java.lang.Object getMetroLock()

Specified by:

getMetroLock in interface MetroLock

getSequence

public MetroSequence getSequence()

getTrackName

public java.lang.Object getTrackName()

getTrackTags

public java.util.Collection<java.lang.Object> getTrackTags()

isTrackEnabled

public boolean isTrackEnabled()

setTrackEnabled

public void setTrackEnabled(boolean enabled)

removeGracefully

public void removeGracefully()

getTrackPosition

public double getTrackPosition()

setSyncStatus

public MetroTrack setSyncStatus(MetroSyncType syncType,
                                MetroSyncTrack syncTrack,
                                double syncOffset)

Parameters:

syncType - Specifying the way to synchronize with the syncTrack object. See MetroSyncType

syncTrack - Specifying the track object to synchronize with.

syncOffset - Specifying the distance from the track object with which is synchronized.

Returns:

this object

getSyncType

public MetroSyncType getSyncType()

Specified by:

getSyncType in interface MetroSyncTrack

getSyncTrack

public MetroSyncTrack getSyncTrack()

Specified by:

getSyncTrack in interface MetroSyncTrack

getSyncOffset

public double getSyncOffset()

Specified by:

getSyncOffset in interface MetroSyncTrack

getLatestLengthInFrames

public int getLatestLengthInFrames()

Specified by:

getLatestLengthInFrames in interface MetroSyncTrack

progressCursor

protected void progressCursor(int nframes,
                              java.util.List<MetroMidiEvent> result)
                       throws org.jaudiolibs.jnajack.JackException

Throws:

org.jaudiolibs.jnajack.JackException

checkBuffer

protected void checkBuffer(Metro metro,
                           int barLengthInFrames)
                    throws org.jaudiolibs.jnajack.JackException

Throws:

org.jaudiolibs.jnajack.JackException

clearBuffer

protected void clearBuffer()

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object