eu.bandm.mugraph.base

Class Renderer

java.lang.Object

eu.bandm.mugraph.base.Renderer

public class Renderer
extends java.lang.Object

Data structure:

  Score                 NoteSystem                          NoteSystem  
                                  Measure     Measure                 Measure  
                                  tps, tp2abstractpos, tnum2finalPos,etc.
    Staff=Segment         RPrefix   first,last  first,last    RPrefix   first,last
    Staff=Segment         RPrefix   first,last  first,last    RPrefix   first,last
  

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	Renderer.Inner cf.
class	Renderer.Measure Calculates and stores all horizontal layout information for ONE measure and ALL staffs.
class	Renderer.NoteSystem Represents the sequence of measures, plus initial prefix, which fill one printable page width.
static class	Renderer.PointwiseLinear FIXME Abstrahieren !!
class	Renderer.RunningPrefix Store for the symbols standing at the beginning of a system, per Staff and NoteSystem.
class	Renderer.Segment Realizes the geometric data related to one particular Staff of the input Score.

Field Summary

Fields

Modifier and Type	Field and Description
static StaffLines	blankLines
protected static CheckedList<java.lang.Float>	clf_0
protected NoteHead	custos_notehead
static Extension	emptyExtension
Renderer.NoteSystem	firstSystem needed by Pager to start processing.
java.awt.Graphics2D	graphics2D Only needed for calculation of font metrics, see comment with constructor.
protected java.util.Map<MTree,java.lang.Integer>	levels
protected MTree	metricTree
protected MuLiMessageReceiver<XMLDocumentIdentifier>	msg
protected MTreeSpec	mt0
Parameters	params
Score	score
protected java.util.Map<Staff,Renderer.Segment>	segments Map all Score Staff objects to one Segment object, which will hold its graphic calculation results.

Constructor Summary

Constructors

Constructor and Description
Renderer(Score score, Parameters params, MuLiMessageReceiver<XMLDocumentIdentifier> msg, @Opt java.awt.Graphics2D graphics2D) ATTENTION graphics2D needed ONLY for text measurement.

Method Summary

Modifier and Type	Method and Description
(package private) void	assignLevels(MTree mt, int l)
int	calculateTextAdvance(java.lang.String text, int fontIndex, Location<XMLDocumentIdentifier> loc, int objIndex) Calculate the text width in pixels (=physical unit) (FONTSIZE WHERE??? FIXME)
void	execute() Calculates (a) width for all measures, (b) partitinoning of measures to accolades (=NoteSystem), and (c) heights of all staffs.
(package private) @Opt java.math.BigDecimal	findNextMeasureToRender()
java.awt.Color	resolveColor(int index, Location<XMLDocumentIdentifier> loc, int objIndex) Deliver (physical) Color value.
float	resolveSizeFactor(int logSize, Location<XMLDocumentIdentifier> loc, int objIndex) Deliver a (physical) size factor.

Methods inherited from class java.lang.Object

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

Field Detail

score

public final Score score

params

public final Parameters params

msg

protected MuLiMessageReceiver<XMLDocumentIdentifier> msg

graphics2D

public final java.awt.Graphics2D graphics2D

Only needed for calculation of font metrics, see comment with constructor.

firstSystem

public Renderer.NoteSystem firstSystem

needed by Pager to start processing. FIXME gettermethod?

clf_0

protected static final CheckedList<java.lang.Float> clf_0

blankLines

public static final StaffLines blankLines

custos_notehead

protected NoteHead custos_notehead

emptyExtension

public static final Extension emptyExtension

segments

protected java.util.Map<Staff,Renderer.Segment> segments

Map all Score Staff objects to one Segment object, which will hold its graphic calculation results. FIXME could be named "GStaff".

mt0

protected MTreeSpec mt0

metricTree

protected MTree metricTree

levels

protected java.util.Map<MTree,java.lang.Integer> levels

Constructor Detail

Renderer

public Renderer(Score score,
                Parameters params,
                MuLiMessageReceiver<XMLDocumentIdentifier> msg,
                @Opt
                @Opt java.awt.Graphics2D graphics2D)

ATTENTION graphics2D needed ONLY for text measurement. Needs only be present if text measurement is required. Needs to behave identical to the final rendering context only in this concern.

Method Detail

assignLevels

void assignLevels(MTree mt,
                  int l)

calculateTextAdvance

public int calculateTextAdvance(java.lang.String text,
                                int fontIndex,
                                Location<XMLDocumentIdentifier> loc,
                                int objIndex)

Calculate the text width in pixels (=physical unit) (FONTSIZE WHERE??? FIXME)

Parameters:

fontIndex - must be resolved against params.

loc - for error message only.

objIndex - for error message only.

findNextMeasureToRender

@Opt
@Opt java.math.BigDecimal findNextMeasureToRender()

Returns:

the lowest value of Renderer.Segment.nextMeasureNum in all Renderer.Segment objects.

resolveColor

public java.awt.Color resolveColor(int index,
                                   Location<XMLDocumentIdentifier> loc,
                                   int objIndex)

Deliver (physical) Color value.

Parameters:

colorIndex - must be resolved against params.

loc - for error message only.

objIndex - for error message only.

resolveSizeFactor

public float resolveSizeFactor(int logSize,
                               Location<XMLDocumentIdentifier> loc,
                               int objIndex)

Deliver a (physical) size factor.

Parameters:

logSize - must be resolved against params.

loc - for error message only.

objIndex - for error message only.

execute

public void execute()

Calculates (a) width for all measures, (b) partitinoning of measures to accolades (=NoteSystem), and (c) heights of all staffs.
(Assignment of accolades to pages is done in the subsequent step, by the Pager.)