Renderer.Measure (BandM signal & music)

java.lang.Object
- eu.bandm.mugraph.base.Renderer.Inner
- - eu.bandm.mugraph.base.Renderer.Measure

Enclosing class:

Renderer
```
public class Renderer.Measure
extends Renderer.Inner
```
Calculates and stores all horizontal layout information for ONE measure and ALL staffs.
1. "tp : Rational" nominal (/measure relative/logical/rhythmic/rational) music time points, introduced by TimedObject, by INTERNAL BarLine, or by TERMINAL MeasureMark. This includes the start time of the next measure.
2. "logical time point : int" = "tnum : int" = the same, nubering all tp which occur in this measure (in any voice), in ascending order by NUMBERS from 0(zero) to (size-1)
3. "colnum" = column num: may be one (1) or two(2) colnums per tnum, namely first for an auxiliary bar line at this time point, followed by the note/pause/event position. The "graphic contents of" a column are the contents PRECEDING this y coodinate on the paper.
4. "abstract pos : tnum->float" the initial distribution on the paper, abstract fraction (from 0.0 to 1.0). only based on the rhythm, not on the graphic contents. Needs some factor to become sensible.
5. "final pos : colnum->float" the paper positions of the columns, after the factor AND the constant "obstacles" have been integrated, in real world coordinate system "µ-meter". Is calculated in a very late step, by considering the whole NoteSystem=whole paper width and all measures therein.

Field Summary

Fields
Modifier and Type	Field and Description
`protected float[][]`	`allAdd` Contains constant distance for "pre-prended" objects; "[i][j]" starts "before column i" and ends "before column j".
`protected Parameters.Distances[]`	`allProp` Contains maximal values of best/minimal width of ALL TimedObjects at this tnum.
`protected float`	`bestEffect`
`protected float`	`bestFactor`
`protected float`	`bestWidth`
`java.util.List<java.lang.Float>`	`colnum2finalPos`
`(package private) int`	`count_cols`
`(package private) int`	`count_tps`
`protected Renderer.PointwiseLinear`	`effect2factor`
`protected Renderer.PointwiseLinear`	`factor2effect`
`protected java.util.Map<Renderer.Segment,java.lang.Integer>`	`firstIndex` Map every segment to the last and first element index falling into this measure.
`protected java.util.Map<Renderer.Segment,java.lang.Integer>`	`lastIndex` Map every segment to the last and first element index falling into this measure.
`protected float`	`minEffect`
`protected float`	`minFactor`
`protected float`	`minWidth`
`protected java.math.BigDecimal`	`number`
`protected float`	`realFactor`
`protected float`	`realLength`
`protected java.util.List<java.lang.Float>`	`tnum2abstractPos`
`protected java.util.List<Rational>`	`tnum2tp`
`protected java.util.Map<Rational,java.lang.Float>`	`tp2abstractPos`
`protected java.util.Map<Rational,java.lang.Integer>`	`tp2tnum`
`protected java.util.SortedSet<Rational>`	`tps` All Tps from all Segments, explicitly def'd in some TimedObject in this measure.

Constructor Summary

Constructors
Constructor and Description

Measure()

Constructors
Constructor and Description
`Measure()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`(package private) void`	`calculateRelativePositions()` Find a mapping from the measure relative time points (in Rational) to percentages of a graphical distance.
`(package private) void`	`calculateStretching(Renderer.NoteSystem noteSystem)` Collects all min distances and calculates best/min stretch factor, which would result in the best/min distances.
`int`	`findLatestElement(Staff staff, Rational limit)` returns the index of the latest and right-most element which is earlier or equal to the given time point "limit".
`int`	`findLatestStaffLines(Staff staff, Rational when)` Returns the index of the latest StaffLines element which is valid at the given time point "when".
`(package private) void`	`fixFactor(float factor)` Stores final layout result columns2finalpos.
`protected int`	`tp2col(Rational tp, boolean isBarLine)` 0/1 1/4 2/4 3/4 4/4 <--tp (b0/1) e0/1 e1/4 b2/4 e2/4 e3/4 b4/4=b0/1 <--barline or event 0 1 2 3 4 <--tnum 0 2 3 4 6 7(=8) <--colnum \| \| \| : \| \| \|\| \| x x : x x \|\| \| : \|\| allAdd: ----------[4][3] -----[3][3] -------------[3][2] --------------------[3][0] -----[2][2] ------------[2][0] ------[0][0]

Methods inherited from class eu.bandm.mugraph.base.Renderer.Inner
get_renderer

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - number
```
protected java.math.BigDecimal number
```
  - firstIndex
```
protected java.util.Map<Renderer.Segment,java.lang.Integer> firstIndex
```
    Map every segment to the last and first element index falling into this measure. lastIndex is EXCLUSIVE, is the index of the next MeasureMark.
  - lastIndex
```
protected java.util.Map<Renderer.Segment,java.lang.Integer> lastIndex
```
    Map every segment to the last and first element index falling into this measure. lastIndex is EXCLUSIVE, is the index of the next MeasureMark.
  - tps
```
protected java.util.SortedSet<Rational> tps
```
    All Tps from all Segments, explicitly def'd in some TimedObject in this measure.
  - tp2abstractPos
```
protected java.util.Map<Rational,java.lang.Float> tp2abstractPos
```
  - tnum2tp
```
protected java.util.List<Rational> tnum2tp
```
  - tp2tnum
```
protected java.util.Map<Rational,java.lang.Integer> tp2tnum
```
  - tnum2abstractPos
```
protected java.util.List<java.lang.Float> tnum2abstractPos
```
  - colnum2finalPos
```
public java.util.List<java.lang.Float> colnum2finalPos
```
  - count_tps
```
int count_tps
```
  - count_cols
```
int count_cols
```
  - allAdd
```
protected float[][] allAdd
```
    Contains constant distance for "pre-prended" objects; "[i][j]" starts "before column i" and ends "before column j". FIXME graphic unten andersrum!?!?! After allocation algorithm is completed, all values are "combed back" and only "[j][j]" stay relevant.
  - allProp
```
protected Parameters.Distances[] allProp
```
    Contains maximal values of best/minimal width of ALL TimedObjects at this tnum.
  - minFactor
```
protected float minFactor
```
  - bestFactor
```
protected float bestFactor
```
  - minWidth
```
protected float minWidth
```
  - bestWidth
```
protected float bestWidth
```
  - minEffect
```
protected float minEffect
```
  - bestEffect
```
protected float bestEffect
```
  - realLength
```
protected float realLength
```
  - realFactor
```
protected float realFactor
```
  - factor2effect
```
protected Renderer.PointwiseLinear factor2effect
```
  - effect2factor
```
protected Renderer.PointwiseLinear effect2factor
```
- Constructor Detail
  - Measure
```
public Measure()
```
- Method Detail
  - tp2col
```
protected int tp2col(Rational tp,
                     boolean isBarLine)
```
```
                0/1    1/4         2/4    3/4       4/4      <--tp
         (b0/1) e0/1   e1/4   b2/4 e2/4   e3/4     b4/4=b0/1 <--barline or event
                0     1            2      3          4       <--tnum
                0     2      3     4      6       7(=8)      <--colnum
       |        |      |     :     |      |       ||
       |       x      x      :    x      x        ||
       |                     :                    ||  
 allAdd:
                        ----------[4][3] 
                        -----[3][3]           
                -------------[3][2]           
         --------------------[3][0]           
                -----[2][2]
         ------------[2][0]
         ------[0][0]
  
  
```
    ATTENTION ASSERT no spontanuous bar line before first event (at 0/1)!
  - calculateRelativePositions
```
void calculateRelativePositions()
```
    Find a mapping from the measure relative time points (in Rational) to percentages of a graphical distance. This is stored in tnum2abstractPos, and the last time point is (in logical time) the start of the next measure. Different strategies can be selected. (Currently FIXME only simple proportion, which is NOT optimal!) (LOGARITHMISCH wäre besser, siehe SKIZZEN FIXME) This first step of allocation is based ONLY on the time points and does not consider the contained symbols.
  - calculateStretching
```
void calculateStretching(Renderer.NoteSystem noteSystem)
```
    Collects all min distances and calculates best/min stretch factor, which would result in the best/min distances. Inserted pre-pended additional objects (mostly: clefs) are not included in this factor, but added a posteriori.
```
       |                   |    <- tnum2tp / Tps 
      ======            ======= <- TimedObject
            ---                 <- distances proportional
                   --  -        <- distances additiv
               PPPP  PP         <- Prepended/Postpended
  
```
    Each Tp is realized by TWO "columns" FIXME MEHR: ??? FIXME ALT ?? All timepoints have been collected in RunningPrefix.positions[segment].
    On the flight, the measure HEIGHTS are collected.
  - fixFactor
```
void fixFactor(float factor)
```
    Stores final layout result columns2finalpos. The found factor is mulitplie with the abstract positions, and AFTERWARDS the constant distances are added.
  - findLatestElement
```
public int findLatestElement(Staff staff,
                             Rational limit)
```
    returns the index of the latest and right-most element which is earlier or equal to the given time point "limit".
  - findLatestStaffLines
```
public int findLatestStaffLines(Staff staff,
                                Rational when)
```
    Returns the index of the latest StaffLines element which is valid at the given time point "when".

Class Renderer.Measure

Field Summary

Constructor Summary

Method Summary

Methods inherited from class eu.bandm.mugraph.base.Renderer.Inner

Methods inherited from class java.lang.Object

Field Detail

number

firstIndex

lastIndex

tps

tp2abstractPos

tnum2tp

tp2tnum

tnum2abstractPos

colnum2finalPos

count_tps

count_cols

allAdd

allProp

minFactor

bestFactor

minWidth

bestWidth

minEffect

bestEffect

realLength

realFactor

factor2effect

effect2factor

Constructor Detail

Measure

Method Detail

tp2col

calculateRelativePositions

calculateStretching

fixFactor

findLatestElement

findLatestStaffLines