Package eu.bandm.music.entities

Class BarRelativeRationalPosition

java.lang.Object

eu.bandm.music.entities.BarRelativeRationalPosition

public class BarRelativeRationalPosition
extends Object

Models the position in a measure, relative to the starting time of the measure (which is the timepoint of the barline at its beginning). CURRENTLY NOT YET USED ANYWHERE !?!?!? FIXME

Field Summary

Fields

Modifier and Type	Field	Description
protected final BigDecimal	barnum	The number of the measure in which the this time position lies.
protected final Map<BigDecimal,Rational>	barnum2startpos	Maps measure numbers / bar line numberings to rational durations.
protected final Rational	offset	The offset of this time position after the initial barline.

Constructor Summary

Constructors

Constructor	Description
BarRelativeRationalPosition(Map<BigDecimal,Rational> barnum2startpos, BigDecimal barnum, Rational offset)	Models the position in a measure, relative to its left side measure bar.

Method Summary

Modifier and Type	Method	Description
BigDecimal	get_barnum()	Return the (nominal) number of the measure.
Rational	get_offset()	Return the offset to the measure start.
protected static BarRelativeRationalPosition	rat2rel(SortedMap<Rational,BigDecimal> startpos2barnum, SortedMap<BigDecimal,Rational> barnum2startpos, Rational rat)	Find the lowest measure containing the Rational value, and convert this into a BarRelativeRationalPosition.
static InvertibleFunction<Rational,BarRelativeRationalPosition>	ratonal2relative(SortedMap<BigDecimal,Rational> barnum2startpos, SortedMap<Rational,BigDecimal> startpos2barnum)	Combine both directions of vonversion into one object.
protected Rational	rel2rat()	Return the absolute position as given by index and the map barnum2startpos of measure starting poins.

Methods inherited from class java.lang.Object

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

Field Details

barnum2startpos

protected final Map<BigDecimal,Rational> barnum2startpos

Maps measure numbers / bar line numberings to rational durations.

barnum

protected final BigDecimal barnum

The number of the measure in which the this time position lies.

offset

protected final Rational offset

The offset of this time position after the initial barline.

Constructor Details

BarRelativeRationalPosition

public BarRelativeRationalPosition(Map<BigDecimal,Rational> barnum2startpos,
 BigDecimal barnum,
 Rational offset)

Models the position in a measure, relative to its left side measure bar. A map from measure numbers to the starting points of the corresponding measures must be provided explicitly, when creating. This map must not be complete, but cover the explicitly given measure number.

Method Details

get_offset

public Rational get_offset()

Return the offset to the measure start.

get_barnum

public BigDecimal get_barnum()

Return the (nominal) number of the measure.

rel2rat

protected Rational rel2rat()

Return the absolute position as given by index and the map barnum2startpos of measure starting poins.

rat2rel

protected static BarRelativeRationalPosition rat2rel(SortedMap<Rational,BigDecimal> startpos2barnum,
 SortedMap<BigDecimal,Rational> barnum2startpos,
 Rational rat)

Find the lowest measure containing the Rational value, and convert this into a BarRelativeRationalPosition. Maps for both directions must be provided.

Throws:

IllegalArgumentException - if Rational not found in map, i.e. lies before the startpoint of the earliest measure.

ratonal2relative

public static InvertibleFunction<Rational,BarRelativeRationalPosition> ratonal2relative(SortedMap<BigDecimal,Rational> barnum2startpos,
 SortedMap<Rational,BigDecimal> startpos2barnum)

Combine both directions of vonversion into one object. Invertible functions are those for which holds: "invert o apply = apply o invert = identity"