com.soundhelix.misc

Class Track

java.lang.Object

com.soundhelix.misc.Track

public class Track
extends Object

Represents a track. A track consists of an arbitrary number of sequences and a type. The type can either be MELODIC, which means that the sequences contain melodic notes which are subject for transposition, or it can be RHYTHMIC, which means the sequences contain rhythm notes which must never be transposed. For example, for drum machines, RHYTHMIC must be used, because each pitch of a sequence selects a drum sample to play (c' might be the base drum, c#' might be the snare and so on) rather than a frequency of a tone to play. Only a whole track can be assigned to an instrument, so all contained sequences use the same instrument for playback. If different instruments are needed, the sequences must each be put into a track individually. The assignment of a whole track to an instrument is also the reason why it doesn't make sense to individually assign the types to sequences. If you have an instrument where part of the keys should use RHYTHMIC, the others should use MELODIC, you should split these off into two different tracks and assign them to the same MIDI channel for playback.

Author:

Thomas Schuerger (thomas@schuerger.com)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Track.TrackType The possible track types.

Constructor Summary

Constructors

Constructor and Description
Track(Track.TrackType type) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	add(LFOSequence sequence, String name) Adds the given sequence to this track.
void	add(Sequence sequence) Adds the given sequence to this track.
Sequence	get(int index) Returns the sequence with the given index.
LFOSequence	getLFOSequence(String name) Returns the LFO sequence with the given name.
Track.TrackType	getType() Returns the track's type.
Iterator<Sequence>	iterator() Provides an iterator that iterates over all Sequences of this Track in the order they have been added.
void	scaleVelocity(int velocity) Scales the volume of the track by a factor of velocity/maxVelocity.
int	size() Returns the number of sequences this track contains.
void	transpose(int halftones) Transposes all sequences of this track up by the given number of halftones.

Methods inherited from class java.lang.Object

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

Constructor Detail

Track

public Track(Track.TrackType type)

Constructor.

Parameters:

type - the type

Method Detail

add

public void add(Sequence sequence)

Adds the given sequence to this track.

Parameters:

sequence - the sequence to add

add

public void add(LFOSequence sequence,
       String name)

Adds the given sequence to this track.

Parameters:

sequence - the sequence to add

name - the LFO name

getLFOSequence

public LFOSequence getLFOSequence(String name)

Returns the LFO sequence with the given name. IF no such LFO sequence exists, null is returned.

Parameters:

name - the LFO sequence name.

Returns:

the LFO sequence or null

size

public int size()

Returns the number of sequences this track contains.

Returns:

the number of sequences

getType

public Track.TrackType getType()

Returns the track's type.

Returns:

the type

get

public Sequence get(int index)

Returns the sequence with the given index.

Parameters:

index - the index

Returns:

the sequence

iterator

public Iterator<Sequence> iterator()

Provides an iterator that iterates over all Sequences of this Track in the order they have been added.

Returns:

the iterator

transpose

public void transpose(int halftones)

Transposes all sequences of this track up by the given number of halftones. If the number of halftones is not zero, the track type must not be RHYTHMIC.

Parameters:

halftones - the number of halftones (positive or negative)

scaleVelocity

public void scaleVelocity(int velocity)

Scales the volume of the track by a factor of velocity/maxVelocity.

Parameters:

velocity - the velocity