Music classification helpers for Finale symbol extraction. More...

Classes
struct	ArticulationClassification
	Result returned by articulation classification. More...

struct	BarlineClassification
	Result returned by barline classification. More...

struct	ChordAssignmentClassification
	Classification paired with the Finale chord assignment that produced it. More...

struct	ChordSuffixClassification
	Classified logical strings reconstructed from Finale chord-suffix elements. More...

struct	ChordSymbolClassification
	Target-neutral musical and display semantics of a Finale chord assignment. More...

struct	ClefClassification
	Result returned by clef classification. More...

struct	EntryNoteheadClassification
	Result returned by chord-level notehead-pattern classification. More...

struct	ExpressionAssignmentClassification
	Classification paired with the Finale measure-expression assignment that produced it. More...

struct	ExpressionAssignmentGroup
	The assignments Finale created together from one staff list, or a lone assignment as a group of one. More...

struct	ExpressionClassification
	Exporter-neutral semantic classification of one Finale expression. More...

struct	FormattedText
	Document-independent classification of a formatted Enigma text. More...

struct	Gap
	One classified feature omitted, in whole or in part, from a conversion target. More...

struct	GapAnchor
	Stable target object identity and optional location within that object. More...

class	GapCollector
	Collects typed conversion gaps for inspection or later serialization. More...

struct	GapPlacement
	One place the target document would draw a feature that is reported once. More...

struct	GlyphStyle
	Visual style encoded by the source glyph variant. More...

struct	JumpClassification
	Classification of a Finale text repeat assignment. More...

struct	KeyboardPedalClassification
	A keyboard-pedal marking recognized in Finale text or in a custom line's text. More...

struct	LyricWordExtension
	Result returned by lyric word-extension classification. More...

struct	NoteheadClassification
	Result returned by notehead classification. More...

struct	OctaveMarkingClassification
	An octave-displacement marking ("8va", "15mb", the SMuFL ottava glyphs, etc.) recognized in Finale text. More...

struct	PlaybackOnly
	Marker payload: the anchored object sounds in the source without being drawn, and the target cannot hide it. More...

struct	PseudoTie
	A source shape used as a stand-in for a laissez-vibrer tie or tie end. More...

struct	SmartShapeClassification
	Result returned by smart-shape classification. More...

Typedefs
using	ArticulationValue = std::variant< std::monostate, articulation::ArticulationMarks, articulation::TechniqueMark, articulation::HarmonMute, articulation::PluckedDamp, articulation::StringMute, articulation::Tremolo, articulation::Fermata, articulation::BreathMark, articulation::Caesura, articulation::Arpeggio, articulation::Ornament, articulation::AccordionRegistration, articulation::VerticalEntryBracket, articulation::Parenthesis, PseudoTie, articulation::OtherMark >
	Variant payload for articulation classification.

using	ExpressionCategoryType = musx::dom::others::MarkingCategory::CategoryType
	Finale marking-category type used while classifying expressions.

using	ExpressionValue = std::variant< std::monostate, dynamics::Mark, expression::Fermata, expression::BreathMark, articulation::StringMute, articulation::AccordionRegistration, expression::HarpDiagram, keyboardpedal::Type, PseudoTie, expression::NonArpeggio, expression::TempoText, expression::MetronomeMark, expression::TempoAlteration, expression::TechniqueText, expression::RehearsalMark, expression::MultimeasureRestNumber, expression::MeasureRepeatCount, expression::GenericText, expression::Error, expression::Suppress >
	Semantic payload associated with an ExpressionClassification.

using	GapPayload = std::variant< ChordSymbolClassification, NoteheadClassification, ExpressionClassification, FormattedText, PlaybackOnly, SmartShapeClassification, LyricWordExtension >

using	SmartShapeValue = std::variant< std::monostate, smartshape::Ottava, smartshape::Crescendo, smartshape::Decrescendo, smartshape::Slur, smartshape::ArpeggiatedTie, PseudoTie, smartshape::NonArpeggio, smartshape::KeyboardPedal, smartshape::TrillLine, smartshape::VibratoLine, smartshape::Glissando, smartshape::GeneralLine >
	The semantic payload of a classified smart shape.

Enumerations
enum class	ExpressionType { GenericText , Dynamic , Fermata , BreathMark , StringMute , AccordionRegistration , HarpDiagram , KeyboardPedal , PseudoTie , NonArpeggio , TempoMark , MetronomeMark , TempoAlteration , TechniqueText , RehearsalMark , MultimeasureRestNumber , MeasureRepeatCount , Error , Suppress }
	Exporter-neutral semantic classes for Finale/MUSX text expressions. More...

enum class	ClassificationBasis { FinaleCategory , Heuristic , FinaleCategoryConfirmed , FinaleCategoryCorrected , FallbackToGenericText }
	Diagnostic reason for the selected expression classification. More...

enum class	ExpressionScope { Unassigned , Staff , TopStaff , BottomStaff }
	Where a Finale measure-expression assignment draws its expression. More...

enum class	GapExtent { Complete , Partial }
	How much of the feature the conversion target lacks. More...

Functions
ArticulationClassification	classifyArticulation (const musx::dom::MusxInstance< musx::dom::details::ArticulationAssign > &assignment, const musx::dom::EntryInfoPtr &entryInfo)
	Classifies an articulation assignment for an entry.

ArticulationClassification	classifyArticulationSymbol (const musx::dom::MusxInstance< musx::dom::FontInfo > &fontInfo, char32_t symbol)
	Classifies an articulation symbol from a font and character code.

BarlineClassification	classifyBarline (const musx::dom::MusxInstance< musx::dom::others::Staff > &staff, const musx::dom::MusxInstance< musx::dom::others::Measure > &measure, bool isFinalMeasure, const musx::dom::MusxInstance< musx::dom::options::BarlineOptions > &barlineOptions)
	Classifies the effective right barline for a Finale measure in staff context.

ChordSuffixClassification	classifyChordSuffix (const musx::dom::MusxInstanceList< musx::dom::others::ChordSuffixElement > &suffix)
	Reconstructs a Finale chord suffix as Unicode text, resolving SMuFL and known legacy-font glyphs.

ChordSuffixClassification	classifyChordSuffix ()
	Classifies a Finale chord with no displayed suffix as a major triad.

std::optional< ChordSymbolClassification >	classifyChordSymbol (const musx::dom::MusxInstance< musx::dom::details::ChordAssign > &assignment, const musx::dom::MusxInstance< musx::dom::KeySignature > &keySignature, musx::dom::KeySignature::KeyContext keyContext)
	Classifies a Finale chord assignment using the effective key signature.

std::vector< ChordAssignmentClassification >	classifyChordAssignments (const musx::dom::MusxInstanceList< musx::dom::details::ChordAssign > &assignments, const musx::dom::MusxInstance< musx::dom::KeySignature > &keySignature, musx::dom::KeySignature::KeyContext keyContext)
	Classifies a list of Finale chord assignments, normally one staff's assignments in one measure.

musx::dom::MusxInstance< musx::dom::FontInfo >	singleVisibleFont (const musx::util::EnigmaParsingContext &textContext)
	Returns the common effective font of all nonempty visible text chunks.

ClefClassification	classifyClef (const musx::dom::MusxInstance< musx::dom::options::ClefOptions::ClefDef > &clefDef, const musx::dom::MusxInstance< musx::dom::others::Staff > &staff=nullptr)
	Classifies a Finale clef definition, optionally in the context of a staff.

std::optional< dynamics::Mark >	classifyDynamicRun (const musx::util::EnigmaTextChunk &chunk)
	Classifies a source text chunk as a single plain dynamic mark.

dynamics::Composition	dynamicComposition (dynamics::Dynamic dynamic)
	Decomposes a dynamic into its constituent parts.

dynamics::Composition	dynamicCompositionFromLetters (std::string_view letters)
	Decomposes dynamic letters such as "sffz" into their constituent parts, whether or not the spelling is one that dynamics::Dynamic enumerates.

dynamics::Dynamic	dynamicFromLevel (dynamics::Level level)
	Returns the dynamics::Dynamic that names a level, so that a level can be passed to the functions keyed on dynamics::Dynamic.

std::string	dynamicCanonicalText (dynamics::Dynamic dynamic)
	Returns the canonical text spelling for a dynamic.

std::vector< std::string >	dynamicCanonicalGlyphs (dynamics::Dynamic dynamic)
	Returns canonical SMuFL glyph names for a dynamic.

std::vector< std::string >	dynamicCanonicalLetterGlyphs (dynamics::Dynamic dynamic)
	Returns canonical per-letter SMuFL glyph names for a dynamic.

std::vector< std::string >	dynamicLettersToLetterGlyphs (std::string_view letters)
	Returns per-letter SMuFL glyph names for recognized dynamic letters, omitting other characters.

std::string	dynamicGlyphsToLetters (const std::vector< std::string > &glyphs)
	Returns the dynamic letters represented by known dynamic glyph names.

EntryNoteheadClassification	classifyEntryNoteheads (const musx::dom::EntryInfoPtr &entry)
	Classifies chord-level notehead patterns (e.g.

bool	isFloatingScope (ExpressionScope scope)
	True for the scopes that float to a system edge rather than naming a staff.

ExpressionScope	classifyExpressionScope (const musx::dom::MusxInstance< musx::dom::others::MeasureExprAssign > &assignment)
	Determines where a Finale measure-expression assignment draws its expression.

ExpressionClassification	classifyExpression (const musx::dom::MusxInstance< musx::dom::others::MeasureExprAssign > &assignment)
	Classifies the expression referenced by a Finale measure-expression assignment.

std::vector< ExpressionAssignmentGroup >	groupExpressionAssignments (const musx::dom::MusxInstanceList< musx::dom::others::MeasureExprAssign > &assignments)
	Groups one measure's assignments by Finale staff group and classifies each group once.

std::vector< ExpressionAssignmentClassification >	classifyExpressionAssignments (const musx::dom::MusxInstanceList< musx::dom::others::MeasureExprAssign > &assignments)
	Classifies a list of Finale measure-expression assignments.

ExpressionClassification	classifyExpression (const musx::dom::MusxInstance< musx::dom::others::TextExpressionDef > &def, const musx::dom::MusxInstance< musx::dom::others::MeasureExprAssign > &assignment={})
	Classifies a Finale text-expression definition.

ExpressionClassification	classifyExpression (const musx::dom::MusxInstance< musx::dom::others::ShapeExpressionDef > &def, const musx::dom::MusxInstance< musx::dom::others::MeasureExprAssign > &assignment={})
	Classifies a Finale shape-expression definition.

FormattedText	classifyFormattedText (const musx::util::EnigmaParsingContext &text)
	Classifies a formatted Enigma text.

std::optional< smartshape::GeneralLine >	classifyGeneralLine (const musx::dom::MusxInstance< musx::dom::others::SmartShapeCustomLine > &customLine)
	Describes a custom line style as a smartshape::GeneralLine.

std::optional< smartshape::GeneralLine >	classifyGeneralLine (const musx::dom::MusxInstance< musx::dom::others::SmartShape > &shape)
	Describes a line-type smart shape (built-in or custom) as a smartshape::GeneralLine.

std::optional< smartshape::GeneralLine >	classifyGeneralLineAppearance (const musx::dom::MusxInstance< musx::dom::others::SmartShape > &shape)
	Describes a line-type smart shape's appearance, ignoring how it is attached.

JumpClassification	classifyJump (const musx::dom::MusxInstance< musx::dom::others::TextRepeatDef > &def)
	Classifies a Finale text repeat definition by text/glyph only.

JumpClassification	classifyJump (const musx::dom::MusxInstance< musx::dom::others::TextRepeatAssign > &assignment)
	Classifies a Finale text repeat assignment by both visible text/glyph and playback behavior.

std::optional< KeyboardPedalClassification >	classifyKeyboardPedal (std::string_view text)
	Classifies plain text as a keyboard-pedal marking.

std::optional< KeyboardPedalClassification >	classifyKeyboardPedal (const musx::util::EnigmaParsingContext &textContext)
	Classifies Finale text as a keyboard-pedal marking, resolving SMuFL pedal glyphs.

LyricWordExtension	classifyLyricWordExtension (const musx::dom::MusxInstance< musx::dom::details::LyricAssign > &assignment)
	Classifies the word extension of one lyric syllable assignment.

NoteheadClassification	classifyNoteheadSymbol (const musx::dom::MusxInstance< musx::dom::FontInfo > &fontInfo, char32_t symbol)
	Classifies a notehead symbol from a font and character code.

NoteheadClassification	classifyNotehead (const musx::dom::NoteInfoPtr &note)
	Classifies the effective notehead for a note, resolving the note's font/character via #musx::dom::NoteInfoPtr::calcNoteheadInfo.

std::optional< OctaveMarkingClassification >	classifyOctaveMarking (std::string_view text)
	Classifies plain text as an octave-displacement marking.

std::optional< OctaveMarkingClassification >	classifyOctaveMarking (const musx::util::EnigmaParsingContext &textContext)
	Classifies Finale text as an octave-displacement marking, resolving SMuFL ottava glyphs (including parenthesized and letter-composed forms).

SmartShapeClassification	classifySmartShape (const musx::dom::MusxInstance< musx::dom::others::SmartShape > &shape)
	Classifies a smart shape's meaning.

std::optional< smartshape::KeyboardPedal >	classifyKeyboardPedalCustomLine (const musx::dom::MusxInstance< musx::dom::others::SmartShapeCustomLine > &customLine)
	Classifies a custom line style as keyboard pedaling.

Detailed Description

Music classification helpers for Finale symbol extraction.

Typedef Documentation

◆ SmartShapeValue

using denigma::classify::SmartShapeValue = typedef std::variant<std::monostate, smartshape::Ottava, smartshape::Crescendo, smartshape::Decrescendo, smartshape::Slur, smartshape::ArpeggiatedTie, PseudoTie, smartshape::NonArpeggio, smartshape::KeyboardPedal, smartshape::TrillLine, smartshape::VibratoLine, smartshape::Glissando, smartshape::GeneralLine>

The semantic payload of a classified smart shape.

std::monostate means the shape was not classified: it is invalid, or its type carries no semantics Denigma models. A smartshape::GeneralLine is the fallback for a line-type shape that no more specific classification claimed.

Enumeration Type Documentation

◆ ClassificationBasis

enum class denigma::classify::ClassificationBasis

strong

Diagnostic reason for the selected expression classification.

Enumerator
FinaleCategory	Classification follows the assigned Finale category.
Heuristic	Classification was inferred without a usable Finale category.
FinaleCategoryConfirmed	Content analysis confirmed the assigned Finale category.
FinaleCategoryCorrected	Content analysis overrode the assigned Finale category.
FallbackToGenericText	No specialized classification matched the expression.

◆ ExpressionScope

enum class denigma::classify::ExpressionScope

strong

Where a Finale measure-expression assignment draws its expression.

Staff-list membership is orthogonal to the scope: a staff list produces one assignment per staff it names, each with its own scope, and the members share a Finale staff group. See ExpressionAssignmentGroup.

Enumerator
Unassigned	Classified from a definition alone; no assignment says where it is drawn.
Staff	Drawn on the one staff it is assigned to.
TopStaff	Floating assignment drawn on the top staff of every system.
BottomStaff	Floating assignment drawn on the bottom staff of every system.

◆ ExpressionType

enum class denigma::classify::ExpressionType

strong

Exporter-neutral semantic classes for Finale/MUSX text expressions.

Enumerator
GenericText	Text with no more specific recognized semantic.
Dynamic	A dynamic mark.
Fermata	A fermata symbol.
BreathMark	A breath-mark symbol.
StringMute	A string-mute on/off symbol.
AccordionRegistration	An accordion-registration glyph or combining glyph sequence.
HarpDiagram	A harp-pedal diagram.
KeyboardPedal	A keyboard-pedal marking.
PseudoTie	A shape expression used as a stand-in for a tie.
NonArpeggio	A shape expression used as a non-arpeggio sign.
TempoMark	A tempo indication.
MetronomeMark	A standalone metronome-note equation.
TempoAlteration	A relative tempo alteration.
TechniqueText	Text identifying a performance technique.
RehearsalMark	A rehearsal mark.
MultimeasureRestNumber	A numeric label for a multimeasure rest.
MeasureRepeatCount	A count of the iterations of a measure repeat.
Error	An expression that could not be classified because of invalid source data.
Suppress	An expression that should not be exported.

◆ GapExtent

enum class denigma::classify::GapExtent

strong

How much of the feature the conversion target lacks.

Enumerator
Complete	Nothing in the target stands for the feature.
Partial	The anchored object stands for the feature but lost the reported payload.

Function Documentation

◆ classifyChordAssignments()

std::vector< ChordAssignmentClassification > denigma::classify::classifyChordAssignments	(	const musx::dom::MusxInstanceList< musx::dom::details::ChordAssign > &	assignments,
		const musx::dom::MusxInstance< musx::dom::KeySignature > &	keySignature,
		musx::dom::KeySignature::KeyContext	keyContext
	)

Classifies a list of Finale chord assignments, normally one staff's assignments in one measure.

Parameters

assignments	Source assignments to classify.
keySignature	The effective key signature for the assignments' measure and staff.
keyContext	Whether pitches are spelled as written or as sounding.

Returns: One assignment/classification pair for each input assignment, in input order.

Exceptions

std::invalid_argument if keySignature is null.

◆ classifyChordSuffix()

ChordSuffixClassification denigma::classify::classifyChordSuffix ( const musx::dom::MusxInstanceList< musx::dom::others::ChordSuffixElement > & suffix )

Reconstructs a Finale chord suffix as Unicode text, resolving SMuFL and known legacy-font glyphs.

Parameters

suffix The chord suffix elements, normally from details::ChordAssign::getChordSuffix.

◆ classifyChordSymbol()

std::optional< ChordSymbolClassification > denigma::classify::classifyChordSymbol	(	const musx::dom::MusxInstance< musx::dom::details::ChordAssign > &	assignment,
		const musx::dom::MusxInstance< musx::dom::KeySignature > &	keySignature,
		musx::dom::KeySignature::KeyContext	keyContext
	)

Classifies a Finale chord assignment using the effective key signature.

Returns: The classification, or std::nullopt when assignment or keySignature is null.

◆ classifyDynamicRun()

std::optional< dynamics::Mark > denigma::classify::classifyDynamicRun ( const musx::util::EnigmaTextChunk & chunk )

Classifies a source text chunk as a single plain dynamic mark.

Recognition is driven by the text and its glyphs alone: a marking is a dynamic because it is spelled as one, not because Finale files it under the Dynamics category.

◆ classifyEntryNoteheads()

EntryNoteheadClassification denigma::classify::classifyEntryNoteheads ( const musx::dom::EntryInfoPtr & entry )

Classifies chord-level notehead patterns (e.g.

artificial harmonics) for an entry.

This does not replace per-note notehead classification (classifyNotehead); it identifies additional structure across the notes of a chord. std::monostate means no such pattern was found, in which case each note's notehead should still be classified individually via classifyNotehead.

◆ classifyExpression() [1/3]

ExpressionClassification denigma::classify::classifyExpression ( const musx::dom::MusxInstance< musx::dom::others::MeasureExprAssign > & assignment )

Classifies the expression referenced by a Finale measure-expression assignment.

Parameters

assignment Source assignment whose expression definition is resolved and classified.

Returns: Exporter-neutral expression classification.

◆ classifyExpression() [2/3]

ExpressionClassification denigma::classify::classifyExpression	(	const musx::dom::MusxInstance< musx::dom::others::ShapeExpressionDef > &	def,
		const musx::dom::MusxInstance< musx::dom::others::MeasureExprAssign > &	assignment = `{}`
	)

Classifies a Finale shape-expression definition.

Parameters

def	Source shape-expression definition.
assignment	Optional assignment providing placement and category context.

Returns: Exporter-neutral expression classification.

◆ classifyExpression() [3/3]

ExpressionClassification denigma::classify::classifyExpression	(	const musx::dom::MusxInstance< musx::dom::others::TextExpressionDef > &	def,
		const musx::dom::MusxInstance< musx::dom::others::MeasureExprAssign > &	assignment = `{}`
	)

Classifies a Finale text-expression definition.

Parameters

def	Source text-expression definition.
assignment	Optional assignment providing placement and category context.

Returns: Exporter-neutral expression classification.

◆ classifyExpressionAssignments()

std::vector< ExpressionAssignmentClassification > denigma::classify::classifyExpressionAssignments ( const musx::dom::MusxInstanceList< musx::dom::others::MeasureExprAssign > & assignments )

Classifies a list of Finale measure-expression assignments.

Every member of a staff-list group receives the group's classification (see groupExpressionAssignments) with its own ExpressionClassification::scope. Unlike the grouping function, this one keeps assignments not shown in the requested part.

Parameters

assignments Source assignments to classify.

Returns: One assignment/classification pair for each input assignment, in input order.

◆ classifyFormattedText()

FormattedText denigma::classify::classifyFormattedText ( const musx::util::EnigmaParsingContext & text )

Classifies a formatted Enigma text.

Parameters

text	Parsing context of the source text.

◆ classifyGeneralLine() [1/2]

std::optional< smartshape::GeneralLine > denigma::classify::classifyGeneralLine ( const musx::dom::MusxInstance< musx::dom::others::SmartShape > & shape )

Describes a line-type smart shape (built-in or custom) as a smartshape::GeneralLine.

Entry-attached shapes are never classified as general lines: they carry specific meanings and are classified separately.

Returns: std::nullopt when the shape is entry-attached, is not a line type, or its custom line style cannot be resolved.

◆ classifyGeneralLine() [2/2]

std::optional< smartshape::GeneralLine > denigma::classify::classifyGeneralLine ( const musx::dom::MusxInstance< musx::dom::others::SmartShapeCustomLine > & customLine )

Describes a custom line style as a smartshape::GeneralLine.

Returns: std::nullopt when customLine is null.

◆ classifyGeneralLineAppearance()

std::optional< smartshape::GeneralLine > denigma::classify::classifyGeneralLineAppearance ( const musx::dom::MusxInstance< musx::dom::others::SmartShape > & shape )

Describes a line-type smart shape's appearance, ignoring how it is attached.

Unlike classifyGeneralLine, this accepts an entry-attached shape, and it resolves the line style of the shape types that keep their appearance in a musx::dom::others::SmartShapeCustomLine rather than in the shape type itself. It answers only what the line looks like; the caller owns what the line means.

Returns: std::nullopt when the shape is null, is not a line type, or its line style cannot be resolved.

◆ classifyKeyboardPedal() [1/2]

std::optional< KeyboardPedalClassification > denigma::classify::classifyKeyboardPedal ( const musx::util::EnigmaParsingContext & textContext )

Classifies Finale text as a keyboard-pedal marking, resolving SMuFL pedal glyphs.

This form additionally recognizes the glyph-only markings that have no spelled-out equivalent, such as the half-pedal, notched-release, and pedal-line hook glyphs. Hidden text chunks are ignored.

Returns: std::nullopt when textContext is empty or is not a recognized marking.

◆ classifyKeyboardPedal() [2/2]

std::optional< KeyboardPedalClassification > denigma::classify::classifyKeyboardPedal ( std::string_view text )

Classifies plain text as a keyboard-pedal marking.

Recognizes the spelled-out markings ("Ped.", "sost.", "una corda", "senza Ped.", the release star), the Roman-numeral and numeric pedal identifiers ("Ped. II"), and the usual qualifiers ("sempre", "simile", "ad lib.", "con"). Punctuation and letter case are ignored.

Returns: std::nullopt when text is not a recognized marking.

◆ classifyKeyboardPedalCustomLine()

std::optional< smartshape::KeyboardPedal > denigma::classify::classifyKeyboardPedalCustomLine ( const musx::dom::MusxInstance< musx::dom::others::SmartShapeCustomLine > & customLine )

Classifies a custom line style as keyboard pedaling.

This is the line-style half of classifySmartShape's keyboard-pedal path, exposed for callers that have a line style but no shape.

Returns: std::nullopt when customLine is null or names no pedal marking in either its texts or its caps.

◆ classifyLyricWordExtension()

LyricWordExtension denigma::classify::classifyLyricWordExtension ( const musx::dom::MusxInstance< musx::dom::details::LyricAssign > & assignment )

Classifies the word extension of one lyric syllable assignment.

Parameters

assignment The syllable assignment to classify.

Returns: The classification, with LyricWordExtension::kind set to lyric::WordExtensionKind::None when the syllable has no word extension.

◆ classifyOctaveMarking()

std::optional< OctaveMarkingClassification > denigma::classify::classifyOctaveMarking ( std::string_view text )

Classifies plain text as an octave-displacement marking.

Only unmistakable spellings are recognized (e.g., "8va", "8vb", "15ma", "22mb", "8va bassa"). A bare ASCII number is never classified.

◆ classifySmartShape()

SmartShapeClassification denigma::classify::classifySmartShape ( const musx::dom::MusxInstance< musx::dom::others::SmartShape > & shape )

Classifies a smart shape's meaning.

An invalid shape, or one whose type Denigma does not model, yields a classification whose value is std::monostate.

◆ dynamicComposition()

dynamics::Composition denigma::classify::dynamicComposition ( dynamics::Dynamic dynamic )

Decomposes a dynamic into its constituent parts.

Returns an empty dynamics::Composition for dynamics::Dynamic::None and dynamics::Dynamic::Other, whose spelling is not known from the enumerator alone; use dynamicCompositionFromLetters or dynamics::Mark::composition for those.

◆ dynamicCompositionFromLetters()

dynamics::Composition denigma::classify::dynamicCompositionFromLetters ( std::string_view letters )

Decomposes dynamic letters such as "sffz" into their constituent parts, whether or not the spelling is one that dynamics::Dynamic enumerates.

Returns an empty dynamics::Composition if the letters do not spell a dynamic.

◆ dynamicFromLevel()

dynamics::Dynamic denigma::classify::dynamicFromLevel ( dynamics::Level level )

Returns the dynamics::Dynamic that names a level, so that a level can be passed to the functions keyed on dynamics::Dynamic.

Returns dynamics::Dynamic::None for Level::None.

◆ groupExpressionAssignments()

std::vector< ExpressionAssignmentGroup > denigma::classify::groupExpressionAssignments ( const musx::dom::MusxInstanceList< musx::dom::others::MeasureExprAssign > & assignments )

Groups one measure's assignments by Finale staff group and classifies each group once.

Assignments not shown in the requested score or part are left out, so a part sees only the members it draws. Hidden assignments are kept, because Finale still plays them; a caller that draws decides from the primary member's hidden flag. Groups are returned in order of their primary member.

Parameters

assignments One measure's assignments, as read for the requested score or part.

◆ singleVisibleFont()

musx::dom::MusxInstance< musx::dom::FontInfo > denigma::classify::singleVisibleFont ( const musx::util::EnigmaParsingContext & textContext )

Returns the common effective font of all nonempty visible text chunks.

Returns: The common font, or null when there is no visible text, a chunk has no font, or the visible chunks do not all use the same typeface, size, and effects.

Classes

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

◆ SmartShapeValue

Enumeration Type Documentation

◆ ClassificationBasis

◆ ExpressionScope

◆ ExpressionType

◆ GapExtent

Function Documentation

◆ classifyChordAssignments()

◆ classifyChordSuffix()

◆ classifyChordSymbol()

◆ classifyDynamicRun()

◆ classifyEntryNoteheads()

◆ classifyExpression() [1/3]

◆ classifyExpression() [2/3]

◆ classifyExpression() [3/3]

◆ classifyExpressionAssignments()

◆ classifyFormattedText()

◆ classifyGeneralLine() [1/2]

◆ classifyGeneralLine() [2/2]

◆ classifyGeneralLineAppearance()

◆ classifyKeyboardPedal() [1/2]

◆ classifyKeyboardPedal() [2/2]

◆ classifyKeyboardPedalCustomLine()

◆ classifyLyricWordExtension()

◆ classifyOctaveMarking()

◆ classifySmartShape()

◆ dynamicComposition()

◆ dynamicCompositionFromLetters()

◆ dynamicFromLevel()

◆ groupExpressionAssignments()

◆ singleVisibleFont()