Class ChordSequence

java.lang.Object

java.util.AbstractCollection<CLI_ChordSymbol>

java.util.AbstractSet<CLI_ChordSymbol>

java.util.TreeSet<CLI_ChordSymbol>

org.jjazz.rhythmmusicgeneration.api.ChordSequence

All Implemented Interfaces:

Serializable, Cloneable, Comparable<ChordSequence>, Iterable<CLI_ChordSymbol>, Collection<CLI_ChordSymbol>, NavigableSet<CLI_ChordSymbol>, SequencedCollection<CLI_ChordSymbol>, SequencedSet<CLI_ChordSymbol>, Set<CLI_ChordSymbol>, SortedSet<CLI_ChordSymbol>

Direct Known Subclasses:

SimpleChordSequence, SongChordSequence

public class ChordSequence
extends TreeSet<CLI_ChordSymbol>
implements Comparable<ChordSequence>, Cloneable

A convenience class to analyze and manipulate a suite of chord symbols extracted from a ChordLeadSheet, possibly with different TimeSignatures.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
ChordSequence(IntRange barRange)	Construct a chord sequence for the specified bar range.

Method Summary

Modifier and Type	Method	Description
ChordSequence	clone()
int	compareTo(ChordSequence cSeq)	Comparison is only based on startBar.
boolean	equals(Object obj)
final IntRange	getBarRange()
CLI_ChordSymbol	getChordSymbol(Position pos)	Get the CLI_ChordSymbol from this ChordSequence which is active at the specified position.
CLI_ChordSymbol	getFirstAfter(Position posFrom, boolean inclusive, Predicate<CLI_ChordSymbol> tester)	Get the first matching chord symbol whose position is after (or equal, if inclusive is true) posFrom.
CLI_ChordSymbol	getLastBefore(Position posTo, boolean inclusive, Predicate<CLI_ChordSymbol> tester)	Get the last matching chord symbol whose position is before (or equal, if inclusive is true) posTo.
final boolean	hasChordAtBeginning()
int	hashCode()
boolean	removeRedundantStandardChords()	Remove successive identical "standard" chord symbols.
ChordSequence	subSequence(IntRange subRange, boolean addInitChordSymbol)	A new sub-sequence from this sequence.
String	toString()

Methods inherited from class TreeSet

add, addAll, addFirst, addLast, ceiling, clear, comparator, contains, descendingIterator, descendingSet, first, floor, headSet, headSet, higher, isEmpty, iterator, last, lower, pollFirst, pollLast, remove, size, spliterator, subSet, subSet, tailSet, tailSet

Methods inherited from class AbstractSet

removeAll

Methods inherited from class AbstractCollection

containsAll, retainAll, toArray, toArray

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface Iterable

forEach

Methods inherited from interface NavigableSet

removeFirst, removeLast, reversed

Methods inherited from interface Set

containsAll, removeAll, retainAll, toArray, toArray

Methods inherited from interface SortedSet

getFirst, getLast

Constructor Details

ChordSequence

public ChordSequence(IntRange barRange)

Construct a chord sequence for the specified bar range.

Parameters:

barRange -

Method Details

clone

public ChordSequence clone()

Overrides:

clone in class TreeSet<CLI_ChordSymbol>

Returns:

A shallow copy (CLI_ChordSymbols are not cloned).

getBarRange

public final IntRange getBarRange()

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<CLI_ChordSymbol>

Specified by:

hashCode in interface Set<CLI_ChordSymbol>

Overrides:

hashCode in class AbstractSet<CLI_ChordSymbol>

equals

public boolean equals(Object obj)

Specified by:

equals in interface Collection<CLI_ChordSymbol>

Specified by:

equals in interface Set<CLI_ChordSymbol>

Overrides:

equals in class AbstractSet<CLI_ChordSymbol>

getChordSymbol

public CLI_ChordSymbol getChordSymbol(Position pos)

Get the CLI_ChordSymbol from this ChordSequence which is active at the specified position.

Parameters:

pos -

Returns:

Can be null

subSequence

public ChordSequence subSequence(IntRange subRange,
 boolean addInitChordSymbol)

A new sub-sequence from this sequence.

Parameters:

subRange - The range of the sub-sequence.

addInitChordSymbol - If true, try to add an init chordsymbol if the resulting subsequence does not have one: reuse the last chord symbol before subRange.from if any

Returns:

Throws:

IllegalArgumentException - If subRange is not contained in this ChordSequence bar range

getFirstAfter

public CLI_ChordSymbol getFirstAfter(Position posFrom,
 boolean inclusive,
 Predicate<CLI_ChordSymbol> tester)

Get the first matching chord symbol whose position is after (or equal, if inclusive is true) posFrom.

Parameters:

posFrom -

inclusive -

tester -

Returns:

getLastBefore

public CLI_ChordSymbol getLastBefore(Position posTo,
 boolean inclusive,
 Predicate<CLI_ChordSymbol> tester)

Get the last matching chord symbol whose position is before (or equal, if inclusive is true) posTo.

Parameters:

posTo -

inclusive -

tester -

Returns:

hasChordAtBeginning

public final boolean hasChordAtBeginning()

Returns:

True if there is a chord on bar=startBar, beat=0.

removeRedundantStandardChords

public boolean removeRedundantStandardChords()

Remove successive identical "standard" chord symbols.

Returns:

True if chord sequence was modified

See Also:

• ExtChordSymbol.isStandard()

compareTo

public int compareTo(ChordSequence cSeq)

Comparison is only based on startBar.

Specified by:

compareTo in interface Comparable<ChordSequence>

Parameters:

cSeq -

Returns:

toString

public String toString()

Overrides:

toString in class AbstractCollection<CLI_ChordSymbol>