eu.bandm.music.entities

Class MetricTree.EssentialBracket

java.lang.Object

eu.bandm.music.entities.MetricTree.EssentialBracket

Enclosing class:

MetricTree

public static class MetricTree.EssentialBracket
extends Object

Realizes an n-tuplet-bracket which is necessary for the notation of some continuous sequence of nodes, because a new prime factor is introduced in the denominators of their durations. The meaning is:
multiply written duration (=note symbols) by proportion to get MEANT duration
divide MEANT DURATION by proportion to get WRITTEN symbol (=note symbol)
EssentialBrackets can come in different combinations, e.g.

  a)      ,---3---,     b)
           7/12                3/4
           /  |   \        /  |  \   \  
                         ,---3--,    ,-3-,
        1/6  1/6  1/4    1/6 1/6 1/4 1/6
       
  

In b) the brackets have to span two non-adjacent segments of child nodes. In a) the lower level brackets do NOT appear since the parent node requires a bracket for ITS OWN duration, which will be written anyhow.
FIXME LATER:

                           7/4
                 /         |               \
          ,----------------3--------------------,
           7/12         [y]7/12            7/12      
           /  |   \        /  |   \        /  |   \  
    [x] ,---3---,       ,---3---,       ,---3---,
        1/6  1/6  1/4   1/6  1/6  1/4   1/6  1/6  1/4
       
  

Here the triplet at [x] must be cancelled whenever ANY uncle node (like [y]) will be written (because this requires the broad bracket, which implies the narrow one.) NOT YET IMPLEMENTED FIXME
MetricTree.initialize() calls MetricTree.collectBrackets(), which adds the correct Bracket structure. The node where an EssentialBrackets starts points to this via .bracket. The end point is encoded in the EssentialBrackets as a time value, ("absolute", i.e. in the same scale as .start and .end of subtrees) and later monitored by the WriteOut.process().

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	complete whether the whole of the parent's duration is covered.
protected MetricTree	context
protected int	count Numbers of the child nodes in the sibling sequence where this EssentialBracket is defined.
protected int	endPos Numbers of the child nodes in the sibling sequence where this EssentialBracket is defined.
protected Rational	endTime
protected PrimeFactors	primes The new factors appearing here the first time (top-down).
protected Rational	proportion
protected int	startPos Numbers of the child nodes in the sibling sequence where this EssentialBracket is defined.

Constructor Summary

Constructors

Constructor and Description
EssentialBracket(MetricTree context, PrimeFactors primes, int startPos, int endPos) Prime factors give the proportion: if 1/d, then the 1 is replaced by the nearest_power_of_two: 1/3 -> 2/3, 1/7 = 8/7. Multiply written duration (=note symbols) by proportion n/d to get MEANT duration.

Method Summary

Modifier and Type	Method and Description
int	get_endPos()
PrimeFactors	get_primes()
int	get_startPos()
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

primes

protected final PrimeFactors primes

The new factors appearing here the first time (top-down).

startPos

protected final int startPos

Numbers of the child nodes in the sibling sequence where this EssentialBracket is defined.

endPos

protected final int endPos

Numbers of the child nodes in the sibling sequence where this EssentialBracket is defined.

count

protected final int count

Numbers of the child nodes in the sibling sequence where this EssentialBracket is defined.

proportion

protected final Rational proportion

endTime

protected final Rational endTime

context

protected final MetricTree context

complete

protected boolean complete

whether the whole of the parent's duration is covered.

Constructor Detail

EssentialBracket

public EssentialBracket(MetricTree context,
                        PrimeFactors primes,
                        int startPos,
                        int endPos)

Prime factors give the proportion: if 1/d, then the 1 is replaced by the nearest_power_of_two: 1/3 -> 2/3, 1/7 = 8/7.
Multiply written duration (=note symbols) by proportion n/d to get MEANT duration. So the front-end notation will show a bracket with "d:n" ("d instead of n") (As usual, startPos is inclusive, endPos is exclusive)

Method Detail

toString

public String toString()

Overrides:

toString in class Object

get_primes

public PrimeFactors get_primes()

get_startPos

public int get_startPos()

get_endPos

public int get_endPos()