Package eu.bandm.music.applications.tabstaff

Class TablatureGraphics

java.lang.Object

eu.bandm.music.applications.tabstaff.TablatureGraphics

public class TablatureGraphics
extends Object

Generates a tablature-style graphic representation of a tabstaff score. Each instance is a one-shot device: construct an instance and invoke showInteractiveGraphic() and writeToFile(String) (repeatedly).

The real work is done by DisplayTablature.
(Experimental state: Currently only the very first measure is rendered, which must be in 4-4 meter, between timepoints 0/1 to 1/1.)
This code uses the SVG library JSVG by Jonathan Sevy. It needs version jsvg_1.2_beta_2, see the JSVG homepage.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) final Tabstaff.Configuration	configuration
(package private) @Opt DisplayTablature	displayTablature	Created when initializing the graphic conversion.
(package private) Tabstaff.SubArea	initialAreaSelection	For drawing the staves use the very first clef event
(package private) final SimpleMessage.Sender<XMLDocumentIdentifier>	msg
protected final MSplitter	mSplitter	PROVIS one and only metric splitter currently in use.
static final MTreeSpec	MTREE_4_4	PROVIS only metric currently supported.
(package private) final Tabstaff	score
(package private) MSplitter.Result	splitResultLeft	Created when initializing the graphic conversion.
(package private) MSplitter.Result	splitResultRight	Created when initializing the graphic conversion.
(package private) final Map<Tp,Set<Event>>	sumLeftHand	All events played by the left hand, sorted by time points.
(package private) final Map<Tp,Set<Event>>	sumRightHand	All events played by the left hand, sorted by time points.

Constructor Summary

Constructors

Constructor	Description
TablatureGraphics(Tabstaff score, SimpleMessage.Sender<XMLDocumentIdentifier> msg, Tabstaff.Configuration configuration)

Method Summary

Modifier and Type	Method	Description
protected static boolean	mergeIsEmpty(Map<Tp,Set<Event>> map)
protected void	prepareGraphics()	Common calculations for print and interactive graphics.
void	showInteractiveGraphic()	Generate a tablature graphic and show it in an interactive window.
protected MSplitter.Result	splitOneHand(Map<Tp,Set<Event>> map)	Calculate the metric split result for one set of events, which contains all events in one hand in the first measure.
void	sumUpHands_2()	Merge all left- and right-hand events into one single set each.
void	writeToFile(String filename)

Methods inherited from class java.lang.Object

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

Field Details

msg

final SimpleMessage.Sender<XMLDocumentIdentifier> msg

score

final Tabstaff score

configuration

final Tabstaff.Configuration configuration

sumRightHand

final Map<Tp,Set<Event>> sumRightHand

All events played by the left hand, sorted by time points. Since this data is needed for tablature-style notation, all events with no hands specified are put here or into sumLeftHand by default.

sumLeftHand

final Map<Tp,Set<Event>> sumLeftHand

All events played by the left hand, sorted by time points. Since this data is needed for tablature-style notation, all events with no hands specified are put here or into sumRightHand by default.

displayTablature

@Opt
@Opt DisplayTablature displayTablature

Created when initializing the graphic conversion. Re-used for interactive graphics and file graphics.

splitResultLeft

@Opt
MSplitter.Result splitResultLeft

Created when initializing the graphic conversion. Re-used for interactive graphics and file graphics.

splitResultRight

@Opt
MSplitter.Result splitResultRight

Created when initializing the graphic conversion. Re-used for interactive graphics and file graphics.

initialAreaSelection

@Opt
Tabstaff.SubArea initialAreaSelection

For drawing the staves use the very first clef event

MTREE_4_4

public static final MTreeSpec MTREE_4_4

PROVIS only metric currently supported.

mSplitter

protected final MSplitter mSplitter

PROVIS one and only metric splitter currently in use.

Constructor Details

TablatureGraphics

TablatureGraphics(Tabstaff score,
 SimpleMessage.Sender<XMLDocumentIdentifier> msg,
 Tabstaff.Configuration configuration)

Method Details

prepareGraphics

protected void prepareGraphics()

Common calculations for print and interactive graphics.

sumUpHands_2

public void sumUpHands_2()

Merge all left- and right-hand events into one single set each. Note with unspecified hand are treated as RIGHT hand. This will be used to generate one voice each, with multiple "note heads". Pauses are ignored, unless there are ONLY pauses at this time point. A B C % % D E % ------------------------------------------- A Da Bd CE c %

mergeIsEmpty

protected static boolean mergeIsEmpty(Map<Tp,Set<Event>> map)

splitOneHand

@Opt
protected MSplitter.Result splitOneHand(Map<Tp,Set<Event>> map)

Calculate the metric split result for one set of events, which contains all events in one hand in the first measure.

showInteractiveGraphic

public void showInteractiveGraphic()

Generate a tablature graphic and show it in an interactive window.

writeToFile

public void writeToFile(String filename)