Package eu.bandm.music.entities

All fundamental entities for modeling music.

See: Description

Interface Summary

Interface	Description
Dodekaid<T>	Interface for all structures which can be set in the "four modi" like usual for a dodecaphonic "Reihe", which are retrograde, invers and inverse retrograde.
DurationIndication	Encodes the mere fact that the implementing type is some kind of duration information.
Invertible<T>	Interface for all scalar types which can be "inverted" by exchanging "up" and "down", like musical intervals, etc.
MetrumIndication	Encodes the fact that the implementing type is some kind of metrum information.
PitchIndication	Encodes the mere fact that the implementing type is some kind of pitch information.
Tuning<P extends PitchIndication>

Class Summary

Class	Description
Accidental	Represents accidentals, used for key indications and for pitches, when combined with white keys.
Artikulation	Catalog of commonly used articulations in CWN.
BarRelativeRationalPosition	Models the position in a measure, relative to the starting time of the measure (which is the timepoint of the barline at its beginning).
Clef	Realizes the clefs which indicate line-to-pitch reference point.
ClefUsage	A ClefUsage combines a clef form, the line number on which it is positioned, and possibly an additional octave displacement.
Color_rgb_8	A very simple color type, sufficient for merely informational text markup, etc.
Duration_calendaric	Durations in the "calendaric" scale, meaning hours, minutes, seconds and decimal fractions of seconds.
Euler2	Representation of pitch classes or interval classes in the Euler net.
Euler3	Representation of pitch classes or interval classes in the Euler net, extended by octaves.
FunctionalGender	The two basic genders of functional theory ("major" vs.
FunctionalInterval	The distance of two pitches or pitch classes in functional music theory.
FunctionalKey	Indicates a tonal key (/"Tonart"/"diatonics") in tonal theory.
FunctionalPitch	A pitch indication which combines standard octave register information and functional pitch classes modulo octave.
FunctionalPitchModOctave	A pitch class mod octave which combines a "natural" note name [dt "Stammton"], given as an instance of WhiteKeyModOctave, with an alteration (normally in the range -2 to +2).
InterpolationKind	Cf.
Keyboard	Models the mapping of Functional Pitches to a standard Keyboard structure.
LanguageConstants	Constant keys used to indicate (synthetic) languages.
MCover	Represents an "Initial Cover" of MetricTree nodes = a set of nodes which realizes a given rhythm.
MCover.Parameters_approximate	The parameters when MCover works in "binary approximation mode", which divides only by two(2) until the approximation is better than the given thresholds.
MCover.Parameters_divide	The parameters when MCover works in "auto-division mode", which inserts new alternatives of child nodes whenever necessary.
MeasureCollector<M extends MetrumIndication>	Calculates the notational durations and start points of all measures in a given TimeScape.
MetricConsumer	Consumes a prefix of a list of QualifiedRational by using a MSplitter, returns its result and additionally information about the rest sequence.
MetrumName	Simple version of a name for a metrum, consisting of two integers only, arranged and interpreted as if a Rational number >0.
MetrumSpecs	Combines the data structures and evaluation rules for the metric specs in a "main/metric voice" (normally called "M") and local alternatives for a particular (sounding) voice.
MetrumSpecs.Name
MixedNoteheadAddendum	Catalog of mixed addenda to single notes, common in CWN.
MKinds	OFFENSICHTLICH NOCH NICHT FERTIG !?!? FIXME Wrapper for a top-level MetricTree plus a short-name for score construction plus possibly different back-end encodings.
MKinds.MKind
MSplitter	Delivers a notation for rhythms, interpreted in a particular metric structure and notation style.
MSplitter.Parameters	The parameters for the post-processing of found covers.
MStackingPlanner	Realize a strategy when a complex denominator of a proportion (of an event duration) requires the stacking of possibly more than one new essential brackets.
MTree	Each instance has been created from a MTreeSpec by MTree.install(MTreeSpec,MTree.Parameters).
MTree_<M extends MTree_<M>>	Abstract superclass for MTree and MTreeSpec.
MTree.EssentialBracket	Models a proportional bracket, spanning note heads, which is unavoidable due to the prime factors of the denominators of the duration values.
MTree.Parameters	Parameters for the automated insertion of essential brackets and for the selection of beams, beamlets and flags.
MTreeCollector<M>	Constructs different mappings into MTreeSpecs and provides the retrievel methods: map "names for meters" at a particular time point to an MTreeSpec.
MTreeSpec	A specification for an MTree, as constructed by a user.
OctaveRegister	The classical naming for pitch registers: Each such register has the width of one octave, and extends from a note called "c" upto, but excluding, the next higher note called "c" again.
Ornament	Abstract class for ornaments = shortcuts which replace one notated note with a certain sequence of played faster notes.
Ornament_JSB_klavierbuechlein	Catalog of commonly used ornaments.
Ornament_KdF_special	Catalog of ornaments, special for "die Kunst der Fuge".
OrnamentUsage<O extends Ornament>	Class reprenting the convetional usage of an ornaments = placing it at a notehead together with at most two additional accidentals, a lower and an upper one.
Partwise	CURRENTLY only used in BarRelativeRationalPosition !?!?! FIXME
PcSet	Abstract sets of pitch classes and pc intervals.
PitchAndOctave<O extends Entity & Comparable<O>,C extends Entity & PitchIndication & Comparable<C>>	A pitch indication which combines some octave register information and some pitch class modulo octave.
PitchModOctave<E extends PitchModOctave>	Abstract class for pitch information, modulo octave register, aka "pitch class".
QualifiedRational	Realizes Rational X Bboolean.
RandomStructs	Wrapper class for generating random-based data structures frequently needed in algorithmic (music) composition.
RationalDuration	Implements the fundamental duration domain in CWN, namely durations expressed by rational numbers.
RationalDuration.DottedBaseDuration	Convenience class which allows to retrieve base value, effective value, dot count, dots as a text string, etc.
RunningOctaveCollector<P extends PitchModOctave & Comparable<P>>	Collects and distributes the octave information over a sequence of incomplete pitch information.
StemEnd	Realisation of one junction point between stem and beams.
Tempo	Tempo indication, relating a metric duration to a physical duration.
TwelveToneFunctionalRepresentation	A map from the integers 0 to 11 to some Functional Pitch classes employed for representing twelve tone pitch classes in some abrbitrary but consistent way, merely for notation.
WhiteKeyModOctave	A specialization of PitchModOctave which represents only the "white keys" of the keyboard.

Enum Summary

Enum	Description
IntervalDirection

Exception Summary

Exception	Description
MCover.MetricNotHitException	Thrown iff neither of both automated synthesis modes is active.

Package eu.bandm.music.entities Description

All fundamental entities for modeling music. The collection firstly follows Common Western Notation (CWN), and covers meter, rhythms, tempo, note symbols, pitches, articulation, intensity, etc. But also more modern and abstract concepts are realized, e.g. colors and dB.
Most data models are based on the concept of Entity. Therefore they define immediately a subclass fo Translet.Parser and most of them collect the discrete values in an instance of EntityCatalog (supporting multi-lingual naming).