Represents the definition of a Finale staff. More...

#include <Staff.h>

Inheritance diagram for musx::dom::others::Staff:

Classes
class	ChromaticTransposition
	Represents chromatic transposition details. More...

class	KeySigTransposition
	Represents key signature transposition details. More...

class	Transposition
	Encapsulates transposition options for a staff. More...

Public Types
enum class	AutoNumberingStyle { ArabicSuffix , RomanSuffix , OrdinalPrefix , AlphaSuffix , ArabicPrefix }
	Enum for auto-numbering style. Auto-numbering is based on instUuid. More...

enum class	StemDirection { Default , AlwaysUp , AlwaysDown }
	Enum for staff-level stem direction override. More...

enum class	NotationStyle { Standard , Percussion , Tablature }
	Enum for notation style.

enum class	HideMode { None , Cutaway , ScoreParts , Score }
	Enum for hide mode. More...

enum class	AlternateNotation { Normal , SlashBeats , Rhythmic , Blank , OneBarRepeat , TwoBarRepeat , BlankWithRests }
	Enum for alternate notation styles. More...

Public Types inherited from musx::dom::Base
enum class	ShareMode { All , Partial , None }
	Describes how this instance is shared between part and score. More...

using	SharedNodes = std::set< std::string >
	The container type for shared nodes.

Public Member Functions
	Staff (const DocumentWeakPtr &document, Cmper partId, ShareMode shareMode, Cmper cmper)
	Constructor function.

std::string	getFullName (util::EnigmaString::AccidentalStyle accidentalStyle=util::EnigmaString::AccidentalStyle::Ascii) const
	Returns the full staff name without Enigma tags. If the full name contains part-specific tags (rare), they are inserted for the score.

std::string	getAbbreviatedName (util::EnigmaString::AccidentalStyle accidentalStyle=util::EnigmaString::AccidentalStyle::Ascii) const
	Returns the abbreviated staff name without Enigma tags. If the abbreviated name contains part-specific tags (rare), they are inserted for the score.

MusxInstance< MultiStaffInstrumentGroup >	getMultiStaffInstGroup () const
	Returns the MultiStaffInstrumentGroup for this staff if it is part of one in the data. Otherwise nullptr.

MusxInstance< details::StaffGroup >	getMultiStaffInstVisualGroup () const
	Returns the details::StaffGroup for this staff if it is part of a multistaff instrument (as defined in Document::getInstruments).

util::EnigmaParsingContext	getFullInstrumentNameCtx (Cmper forPartId, bool preferStaffName=false) const
	Returns the parsing context for the full name.

util::EnigmaParsingContext	getAbbreviatedInstrumentNameCtx (Cmper forPartId, bool preferStaffName=false) const
	Returns the parsing context for the abbreviated name.

std::string	getFullInstrumentName (util::EnigmaString::AccidentalStyle accidentalStyle=util::EnigmaString::AccidentalStyle::Ascii, bool preferStaffName=false) const
	Returns the full instrument name for this staff without Enigma tags and with autonumbering (if any)

std::string	getAbbreviatedInstrumentName (util::EnigmaString::AccidentalStyle accidentalStyle=util::EnigmaString::AccidentalStyle::Ascii, bool preferStaffName=false) const
	Returns the abbreviated instrument name for this staff without Enigma tags and with autonumbering (if any)

MusxInstance< details::ShapeNoteBase >	getNoteShapes () const
	Returns the note shape record in effect for this staff instance.

MusxInstance< NamePositioning >	getFullNamePosition () const
	Returns the full name positioning in effect for this staff instance.

MusxInstance< NamePositioning >	getAbbreviatedNamePosition () const
	Returns the abbreviated name positioning in effect for this staff instance.

bool	showNamesForPart (Cmper partId) const
	Returns if names should be shown for the specified part.

std::pair< std::string, bool >	calcAutoNumberingAffix () const
	Calculate the auto numbering prefix or suffix, if needed.

std::string	addAutoNumbering (const std::string &plainName) const
	Add auto numbering as a prefix or suffix, if needed.

ClefIndex	calcClefIndexAt (MeasCmper measureId, Edu position, bool forWrittenPitch=false) const
	Returns the clef in this staff at the specified location.

ClefIndex	calcFirstClefIndex (bool forWrittenPitch=false) const
	Returns the first clef in this staff.

int	calcNumberOfStafflines () const
	Calculates the number of staff lines on this staff.

int	calcMiddleStaffPosition () const
	Calculates the middle staff position. For staves with even numbers of lines, it is the middle space.

Evpu	calcBaselineZeroPosition () const
	Calculates the baseline zero position for this staff, relative to the reference line, before any displacements are applied.

template<typename BaselineType , std::enable_if_t< std::is_base_of< details::BaselineNoInci, BaselineType >::value, int > = 0>
Evpu	calcBaselinePosition (SystemCmper systemId) const
	Returns the baseline position for the staff at the given system. The staff should be the staff at the beginning of the system.

template<typename BaselineType , std::enable_if_t< std::is_base_of< details::Baseline, BaselineType >::value &&!std::is_base_of< details::BaselineNoInci, BaselineType >::value, int > = 0>
Evpu	calcBaselinePosition (SystemCmper systemId, Cmper lyricNumber) const
	Returns the baseline position for the staff at the given system. The staff should be the staff at the beginning of the system.

std::vector< LyricsLineInfo >	createLyricsLineInfo (SystemCmper systemId) const
	Creates a vector of LyricsLineInfo for the current requested part.

int	calcTopLinePosition () const
	Calculates the position of the top staff line, relative to the reference line.

int	calcBottomLinePosition () const
	Calculates the position of the top staff line, relative to the reference line.

bool	hasInstrumentAssigned () const
	Return true if this staff has an instrument assigned.

std::pair< int, int >	calcTranspositionInterval () const
	Calculates the transposition interval for this staff or staff composite.

MusxInstanceList< PartDefinition >	getContainingParts (bool includeScore=true) const
	Gets a list of all parts that contain this staff.

MusxInstance< PartDefinition >	firstContainingPart () const
	Finds the first part that contains this staff, not including the score.

bool	calcAlternateNotationHidesEntries (LayerIndex forLayerIndex) const
	Returns true if the given layer is hidden by alternate notation.

void	integrityCheck (const std::shared_ptr< Base > &ptrToThis) override
	Allows a class to determine if it has been properly contructed by the factory and fix issues that it can, such as creating default instances of contained classes.

Public Member Functions inherited from musx::dom::OthersBase
	OthersBase (const OthersBase &)=default
	explicit default copy constructor

	OthersBase (OthersBase &&) noexcept=default
	explicit default move constructor

Cmper	getCmper () const
	Gets the `cmper` key value.

std::optional< Inci >	getInci () const
	Gets the optional array index (`inci`).

Cmper	getRequestedPartId () const
	If this instance was retrieved from an object pool, it contains the part ID that was used to retrieve it. If this value is different than getSourcePartId, then this instance is a copy of the pool instance.

Public Member Functions inherited from musx::dom::Base
virtual	~Base () noexcept(false)=default
	Virtual destructor for polymorphic behavior.

DocumentPtr	getDocument () const
	Gets a reference to the Document.

Cmper	getSourcePartId () const
	Gets the source partId for this instance. If an instance is fully shared with the score, the source is SCORE_PARTID. If an instance is partially shared or non shared, the source is the ID of the part that sourced it.

ShareMode	getShareMode () const
	Gets the sharing mode for this instance.

const SharedNodes &	getUnlinkedNodes () const
	Gets the unlinked nodes for this instance. (Only populated for `ShareMode::Partial`)

void	addUnlinkedNode (const std::string &nodeName)
	Adds a shared node for this instance.

virtual bool	requireAllFields () const
	Specifies if the parser should alert (print or throw) when an unknown xml tag is found for this class.

Static Public Member Functions
static void	calcAllAutoNumberValues (const DocumentPtr &document)
	Get the auto-numbering value for this staff, if applicable.

template<typename SubType >
static void	calcAllRuntimeValues (const DocumentPtr &document)
	Populate runtime values for all staves or staffstyles, such as percussion map Id if any.

static ClefIndex	calcFirstClefIndex (const DocumentPtr &document, Cmper partId, StaffCmper staffCmper)
	Returns the first clef in the specified staff in the document.

static const xml::XmlElementArray< Staff > &	xmlMappingArray ()
	Required for musx::factory::FieldPopulator.

Public Attributes
NotationStyle	notationStyle {}
	Standard, percussion, or tablature.

std::shared_ptr< FontInfo >	noteFont
	The custom font to use for noteheads. Guaranteed non-null by integrityCheck if useNoteFont is `true`.

bool	useNoteShapes {}
	Indicates that note shapes should be used. It is ignored is no staff- or staffstyle-specific note shapes exist.

bool	useNoteFont {}
	Indicates if noteFont should be used.

ClefIndex	defaultClef {}
	Index of default clef for the staff.

ClefIndex	transposedClef {}
	Index of transposed clef for the staff. Only used if Transposition::setToClef is true.

std::optional< int >	staffLines {}
	Number of lines in the staff (if no custom staff)

std::optional< std::vector< int > >	customStaff
	A list of stafflines from 0..26 where a standard 5-line staff is values 11, 12, 13, 14, 15.

Evpu	lineSpace {}
	Distance between staff lines.

std::string	instUuid
	Unique identifier for the type of instrument.

int	capoPos {}
	"Capo Position" (Tablature Staff Attributes)

int	lowestFret {}
	"Default Lowest Fret" (Tablature Staff Attributes)

bool	floatKeys {}
	"Independent Key Signature"

bool	floatTime {}
	"Independent Time Signature"

bool	blineBreak {}
	"Break Barlines Between Staves"

bool	rbarBreak {}
	"Break Repeat Barlines Between Staves"

bool	hasStyles {}
	Indicates that this staff has staff style assignments.

bool	showNameInParts {}
	"Display Staff Name in Parts" (xml node is `<showNameParts>`)

bool	showNoteColors {}
	"Color Noteheads" (Score Manager)

std::shared_ptr< Transposition >	transposition
	Transposition details, if non-null.

bool	hideNameInScore {}
	Inverse of "Display Staff Name in Score" (xml node is `<hideStfNameInScore>`)

Evpu	botBarlineOffset {}
	Offset for the bottom barline.

AlternateNotation	altNotation {}
	Alternate notation on the staff.

LayerIndex	altLayer {}
	Alternate notation Apply To Layer index (0..3)

bool	altHideArtics {}
	Hide Articulations in alternate notation (in Apply-To Layer)

bool	altHideLyrics {}
	Hide Lyrics in alternate notation (in Apply-To Layer)

bool	altHideSmartShapes {}
	Hide Smart Shapes (in Apply-To layer: probably only affects entry-attached shapes)

bool	altRhythmStemsUp {}
	Show stems up in alternate Rhythmic Notation mode.

bool	altSlashDots {}
	Show dots on beat slashes in compound meter.

bool	altHideOtherNotes {}
	Hide notes in other layers in alternate notation.

bool	altHideOtherArtics {}
	Hide articulations in other layers in alternate notation.

bool	altHideExpressions {}
	Hide Expressions in alternate notation (in Apply-To Layer)

bool	altHideOtherLyrics {}
	Hide lyrics in other layers in alternate notation.

bool	altHideOtherSmartShapes {}
	Hide Smart Shapes in other layers in alternate notation.

bool	altHideOtherExpressions {}
	Hide Expressions in other layers in alternate notation.

bool	hideRepeatBottomDot {}
	Inverse of "Bottom Repeat Dot" in Staff Setup dialog.

bool	flatBeams {}
	"Flat Beams"

bool	hideFretboards {}
	Inverse of "Display Fretboards".

bool	blankMeasure {}
	Inverse of "Display Rests in Empty Measures".

bool	hideRepeatTopDot {}
	Inverse of "Top Repeat Dot" in Staff Setup dialog.

bool	hideLyrics {}
	Inverse of "Display Lyrics".

bool	noOptimize {}
	Inverse of "Allow Hiding When Empty".

Evpu	topBarlineOffset {}
	Offset for the top barline.

bool	hideMeasNums {}
	Inverse of "Display Measure Numbers".

bool	hideRepeats {}
	Inverse of "Display Endings and Text Repeats".

bool	hideBarlines {}
	Inverse of "Display Barlines".

bool	hideRptBars {}
	Inverse of "Display Repeat Bars".

bool	hideKeySigs {}
	Inverse of "Display Key Signatures".

bool	hideTimeSigs {}
	Inverse of "Display Time Signatures in Score".

bool	hideClefs {}
	Inverse of "Display Clefs".

bool	hideStaffLines {}
	Inverse of "Display Staff Lines".

bool	hideChords {}
	Inverse of "Display Chords".

bool	noKey {}
	"Ignore Key Signatures"

Evpu	dwRestOffset {}
	Offset for downstem rests.

Evpu	wRestOffset {}
	Offset for whole rests.

Evpu	hRestOffset {}
	Offset for half rests.

Evpu	otherRestOffset {}
	Offset for other rests.

bool	hideRests {}
	Inverse of "Display Rests".

bool	hideTies {}
	Inverse of "Display Ties".

bool	hideDots {}
	Inverse of "Display Augmentation Dots".

int	stemReversal {}
	Stem reversal value.

Cmper	fullNameTextId {}
	Full name TextBlock ID. (xml node is `<fullName>`)

Cmper	abbrvNameTextId {}
	Abbreviated name TextBlock ID. (xml node is `<abbrvName>`)

Evpu	botRepeatDotOff {}
	Offset for bottom repeat dots.

Evpu	topRepeatDotOff {}
	Offset for top repeat dots.

Efix	vertTabNumOff {}
	Vertical offset for tab number. (Tablature Staff Attributes)

bool	showTabClefAllSys {}
	Inverse of "Show Clef Only On First Measure" (Tablature Staff Attributes)

bool	useTabLetters {}
	"Use Letters" (Tablature Staff Attributes)

bool	breakTabLinesAtNotes {}
	"Break Tablature Lines At Numbers" (Tablature Staff Attributes)

bool	hideTuplets {}
	Inverse of "Show Tuplets" (Tablature Staff Attributes)

Cmper	fretInstId {}
	Cmper of FretInstrument for TAB strings. (Tablature Staff Attributes)

bool	hideStems {}
	Inverse of "Display Stems".

StemDirection	stemDirection {}
	stem direction for staff (xml node is `<stemDir>`)

bool	hideBeams {}
	Inverse of "Show Beams".

bool	stemStartFromStaff {}

bool	stemsFixedEnd {}
	"Use Vertical Offset For Beam End Of Stems (Offset From Staff)"

bool	stemsFixedStart {}
	"Use Vertical Offset For Notehead End Of Stems"

Efix	horzStemOffUp {}
	Horizontal Stem Offsets: Up Stem.

Efix	horzStemOffDown {}
	Horizontal Stem Offsets: Down Stem.

Efix	vertStemStartOffUp {}
	Vertical Stem Offsets For Notehead End: Up Stem.

Efix	vertStemStartOffDown {}
	Vertical Stem Offsets For Notehead End: Down Stem.

Efix	vertStemEndOffUp {}
	Vertical Stem Offsets For Stem End: Up Stem.

Efix	vertStemEndOffDown {}
	Vertical Stem Offsets For Stem End: Down Stem.

HideMode	hideMode {}
	"Force Hide Staff" option

bool	redisplayLayerAccis {}
	"Redisplay Accidentals in Other Layers Within Measures"

bool	hideTimeSigsInParts {}
	Inverse of "Display Time Signatures in Parts".

AutoNumberingStyle	autoNumbering {}
	Autonumbering style if useAutoNumbering is true. (xml node is `<autoNum>`)

bool	useAutoNumbering {}
	Whether names should be auto-numbered. (xml node is `<useAutoNum>`)

bool	hideKeySigsShowAccis {}
	"Hide Key Signature and Show Accidentals" transposition option.

Cmper	noteShapesId {}

bool	noteShapesFromStyle {}
	True if noteShapesId is for a staff style. (Determines which note shapes class to retrieve.)

Cmper	fullNamePosId {}

bool	fullNamePosFromStyle {}

Cmper	abrvNamePosId {}

bool	abrvNamePosFromStyle {}

Cmper	multiStaffInstId {}

std::optional< int >	autoNumberValue
	Calculated autonumbering value. It is computed by calcAllAutoNumberValues.

std::optional< Cmper >	percussionMapId
	Calculated percussion map Id for a percussion staff. (Populated by in calcAllRuntimeValues.)

Static Public Attributes
static constexpr std::string_view	XmlNodeName = "staffSpec"
	The XML node name for this type.

Additional Inherited Members
Protected Member Functions inherited from musx::dom::OthersBase
	OthersBase (const DocumentWeakPtr &document, Cmper partId, ShareMode shareMode, Cmper cmper, std::optional< Inci > inci=std::nullopt)
	Constructs an OthersBase object.

OthersBase &	operator= (const OthersBase &other)
	Assignment operator delegates to base, preserving OthersBase state.

OthersBase &	operator= (OthersBase &&other) noexcept
	Assignment operator delegates to base, preserving OthersBase state.

Protected Member Functions inherited from musx::dom::Base
	Base (const DocumentWeakPtr &document, Cmper partId, ShareMode shareMode)
	Constructs the base class.

	Base (const Base &)=default
	explicit default copy constructor

	Base (Base &&) noexcept=default
	explicit default move constructor

Base &	operator= (const Base &)
	no-op copy assignment operator allows subclasses to copy their values.

Base &	operator= (Base &&) noexcept
	no-op move assignment operator allows subclasses to move their values.

Detailed Description

Represents the definition of a Finale staff.

The cmper is the staff ID. This class is identified by the XML node name "staffSpec".

Member Enumeration Documentation

◆ AlternateNotation

enum class musx::dom::others::Staff::AlternateNotation

strong

Enum for alternate notation styles.

Enumerator
Normal	Normal Notation (default)
SlashBeats	Slash Notation (on beats)
Rhythmic	Rhythmic Notation.
Blank	Blank Notation.
OneBarRepeat	One Bar Repeat(s)
TwoBarRepeat	Two Bar Repeat(s)
BlankWithRests	Blank Notation with Rests.

◆ AutoNumberingStyle

enum class musx::dom::others::Staff::AutoNumberingStyle

strong

Enum for auto-numbering style. Auto-numbering is based on instUuid.

Enumerator
ArabicSuffix	Arabic numeral suffix (default). May not appear in xml.
RomanSuffix	Roman numeral suffix.
OrdinalPrefix	Ordinal number prefix: 1st 2nd 3rd, ...
AlphaSuffix	Alphabetic suffix.
ArabicPrefix	Arabic numeral prefix (with dot): 1. 2. 3. ...

◆ HideMode

enum class musx::dom::others::Staff::HideMode

strong

Enum for hide mode.

Enumerator
None	Do not hide.
Cutaway	Cutaway score.
ScoreParts	Collapse in score and parts.
Score	Collapse in score only.

◆ StemDirection

enum class musx::dom::others::Staff::StemDirection

strong

Enum for staff-level stem direction override.

Enumerator
Default	the default (may not occur in xml)
AlwaysUp	stems are always up on this staff
AlwaysDown	stems are always down on this staff

Member Function Documentation

◆ addAutoNumbering()

std::string musx::dom::others::Staff::addAutoNumbering ( const std::string & plainName ) const

Add auto numbering as a prefix or suffix, if needed.

Parameters

plainName The name (full or abbreviated) to which to add the auto numbering

Returns: Auto numbered name.

◆ calcAllAutoNumberValues()

void musx::dom::others::Staff::calcAllAutoNumberValues ( const DocumentPtr & document )

static

Get the auto-numbering value for this staff, if applicable.

Calculates autoNumberValue for every staff based on the occurrences of the instrument UUID and in each staff instance. If numbering is not applicable (e.g., auto numbering is disabled, the UUID is empty, or there is only one instance), autoNumberValue has no value.

This function is called by the DocumentFactory when the document is created.

◆ calcAllRuntimeValues()

template<typename SubType >

void musx::dom::others::Staff::calcAllRuntimeValues ( const DocumentPtr & document )

static

Populate runtime values for all staves or staffstyles, such as percussion map Id if any.

This function is called by the DocumentFactory when the document is created.

◆ calcAlternateNotationHidesEntries()

bool musx::dom::others::Staff::calcAlternateNotationHidesEntries ( LayerIndex forLayerIndex ) const

Returns true if the given layer is hidden by alternate notation.

Parameters

forLayerIndex 0-based layer index (0..3)

◆ calcAutoNumberingAffix()

std::pair< std::string, bool > musx::dom::others::Staff::calcAutoNumberingAffix ( ) const

Calculate the auto numbering prefix or suffix, if needed.

Returns

A std::pair containing

A std::string that is either the prefix or suffix.
A bool that if true indicates the string is a prefix and if false a suffix.

◆ calcBaselinePosition() [1/2]

template<typename BaselineType , std::enable_if_t< std::is_base_of< details::BaselineNoInci, BaselineType >::value, int > = 0>

Evpu musx::dom::others::Staff::calcBaselinePosition ( SystemCmper systemId ) const

inline

Returns the baseline position for the staff at the given system. The staff should be the staff at the beginning of the system.

Template Parameters

BaselineType The type of baseline. (details::BaselineChords, details::BaselineExpressionsAbove, etc.: not the BaselineSystem variants)

Parameters

systemId The system Cmper for which to get the per-system baseline offset. Use BASE_SYSTEM_ID for Scroll View values.

Returns: The accumulated position of the baseline, relative to the staff's reference line.

◆ calcBaselinePosition() [2/2]

template<typename BaselineType , std::enable_if_t< std::is_base_of< details::Baseline, BaselineType >::value &&!std::is_base_of< details::BaselineNoInci, BaselineType >::value, int > = 0>

Evpu musx::dom::others::Staff::calcBaselinePosition	(	SystemCmper	systemId,
		Cmper	lyricNumber
	)		const

inline

Returns the baseline position for the staff at the given system. The staff should be the staff at the beginning of the system.

Template Parameters

BaselineType The type of baseline. (details::BaselineChords, details::BaselineExpressionsAbove, etc.: not the BaselineSystem variants)

Parameters

systemId	The system Cmper for which to get the per-system baseline offset. Use BASE_SYSTEM_ID for Scroll View values.
lyricNumber	The Cmper of the lyric text block to find.

Returns: The accumulated position of the baseline, relative to the staff's reference line.

◆ calcBaselineZeroPosition()

Evpu musx::dom::others::Staff::calcBaselineZeroPosition ( ) const

Calculates the baseline zero position for this staff, relative to the reference line, before any displacements are applied.

This function reproduces Finale’s observed behavior but may yield inaccurate results in unusual configurations of custom staff lines. In the most common cases, Finale defines the baseline zero position as the midpoint between the reference line and the bottom staff line, which is the value computed by this function.

◆ calcClefIndexAt()

ClefIndex musx::dom::others::Staff::calcClefIndexAt	(	MeasCmper	measureId,
		Edu	position,
		bool	forWrittenPitch = `false`
	)		const

Returns the clef in this staff at the specified location.

Parameters

measureId	The measure of the location
position	The Edu elapsed time with the measure
forWrittenPitch	If true, return the transposing clef if there is one

◆ calcFirstClefIndex()

ClefIndex musx::dom::others::Staff::calcFirstClefIndex	(	const DocumentPtr &	document,
		Cmper	partId,
		StaffCmper	staffCmper
	)

static

Returns the first clef in the specified staff in the document.

Parameters

document	the document to search
partId	the linked part to search
staffCmper	the staff cmper to search

◆ calcTranspositionInterval()

std::pair< int, int > musx::dom::others::Staff::calcTranspositionInterval ( ) const

Calculates the transposition interval for this staff or staff composite.

Returns

A pair of int containing

the diatonic displacement interval (positive up, negative down)
the alteration in chromatic halfsteps Downward intervals reverse the sign of the chromatic alteration.

◆ createLyricsLineInfo()

std::vector< LyricsLineInfo > musx::dom::others::Staff::createLyricsLineInfo ( SystemCmper systemId ) const

Creates a vector of LyricsLineInfo for the current requested part.

Parameters

systemId The system for which to create the lyrics line information/

Returns: Lyrics line information in order by descending baseline position (relative to this staff's reference line).

◆ firstContainingPart()

MusxInstance< PartDefinition > musx::dom::others::Staff::firstContainingPart ( ) const

Finds the first part that contains this staff, not including the score.

Returns: The first part that contains this staff or nullptr if none.

◆ getAbbreviatedInstrumentName()

std::string musx::dom::others::Staff::getAbbreviatedInstrumentName	(	util::EnigmaString::AccidentalStyle	accidentalStyle = `util::EnigmaString::AccidentalStyle::Ascii`,
		bool	preferStaffName = `false`
	)		const

Returns the abbreviated instrument name for this staff without Enigma tags and with autonumbering (if any)

Note: Ordinal prefix numbering is currently supported only for English.

Parameters

accidentalStyle	The style for accidental subsitution in names like "Clarinet in Bb".
preferStaffName	When true, use the staff name if there is one (rather than the multi-instrument group name)

◆ getAbbreviatedInstrumentNameCtx()

util::EnigmaParsingContext musx::dom::others::Staff::getAbbreviatedInstrumentNameCtx	(	Cmper	forPartId,
		bool	preferStaffName = `false`
	)		const

Returns the parsing context for the abbreviated name.

Parameters

forPartId	The part id to use for partname and page inserts
preferStaffName	When true, use the staff name if there is one (rather than the multi-instrument group name)

◆ getAbbreviatedName()

std::string musx::dom::others::Staff::getAbbreviatedName ( util::EnigmaString::AccidentalStyle accidentalStyle = util::EnigmaString::AccidentalStyle::Ascii ) const

Returns the abbreviated staff name without Enigma tags. If the abbreviated name contains part-specific tags (rare), they are inserted for the score.

Parameters

accidentalStyle The style for accidental subsitution in names like "Clarinet in Bb".

◆ getContainingParts()

MusxInstanceList< PartDefinition > musx::dom::others::Staff::getContainingParts ( bool includeScore = true ) const

Gets a list of all parts that contain this staff.

Parameters

includeScore If true, include the score in the list. (Defaults to true)

◆ getFullInstrumentName()

std::string musx::dom::others::Staff::getFullInstrumentName	(	util::EnigmaString::AccidentalStyle	accidentalStyle = `util::EnigmaString::AccidentalStyle::Ascii`,
		bool	preferStaffName = `false`
	)		const

Returns the full instrument name for this staff without Enigma tags and with autonumbering (if any)

Note: Ordinal prefix numbering is currently supported only for English.

Parameters

accidentalStyle	The style for accidental subsitution in names like "Clarinet in Bb".
preferStaffName	When true, use the staff name if there is one (rather than the multi-instrument group name)

◆ getFullInstrumentNameCtx()

util::EnigmaParsingContext musx::dom::others::Staff::getFullInstrumentNameCtx	(	Cmper	forPartId,
		bool	preferStaffName = `false`
	)		const

Returns the parsing context for the full name.

Parameters

forPartId	The part id to use for partname and page inserts
preferStaffName	When true, use the staff name if there is one (rather than the multi-instrument group name)

◆ getFullName()

std::string musx::dom::others::Staff::getFullName ( util::EnigmaString::AccidentalStyle accidentalStyle = util::EnigmaString::AccidentalStyle::Ascii ) const

Returns the full staff name without Enigma tags. If the full name contains part-specific tags (rare), they are inserted for the score.

Parameters

accidentalStyle The style for accidental subsitution in names like "Clarinet in Bb".

◆ integrityCheck()

void musx::dom::others::Staff::integrityCheck ( const std::shared_ptr< Base > & ptrToThis )

inlineoverridevirtual

Allows a class to determine if it has been properly contructed by the factory and fix issues that it can, such as creating default instances of contained classes.

The default implementation should always be called inside an overridden implementation.

Parameters

ptrToThis This instance in a shared_ptr. (Avoids need for shared_from_this.)

Exceptions

musx::dom::integrity_error if there is a problem.

Reimplemented from musx::dom::Base.

Reimplemented in musx::dom::others::StaffStyle.

Member Data Documentation

◆ abrvNamePosFromStyle

bool musx::dom::others::Staff::abrvNamePosFromStyle {}

True if abrvNamePosId is for a staff style. (Determines which abrv name pos class to retrieve.) Populated by in calcAllRuntimeValues.

◆ abrvNamePosId

Cmper musx::dom::others::Staff::abrvNamePosId {}

Calculated cmper for abbreviated name position id. If not overridden by a staff style, it is the same as the staff cmper or zero if default. (Populated by in calcAllRuntimeValues.)

◆ fullNamePosFromStyle

bool musx::dom::others::Staff::fullNamePosFromStyle {}

True if fullNamePosId is for a staff style. (Determines which full name pos class to retrieve.) Populated by in calcAllRuntimeValues.

◆ fullNamePosId

Cmper musx::dom::others::Staff::fullNamePosId {}

Calculated cmper for full name position id. If not overridden by a staff style, it is the same as the staff cmper or zero if default. (Populated by in calcAllRuntimeValues.)

◆ multiStaffInstId

Cmper musx::dom::others::Staff::multiStaffInstId {}

Calculated cmper for MultiStaffInstrumentGroup, if any. This value is not in the xml. It is set by the factory with the Resolver function for MultiStaffInstrumentGroup.

◆ noteShapesId

Cmper musx::dom::others::Staff::noteShapesId {}

Calculated cmper for note shapes. If not overridden by a staff style, it is the same as the staff cmper or zero if default. (Populated by in calcAllRuntimeValues.)

◆ stemStartFromStaff

bool musx::dom::others::Staff::stemStartFromStaff {}

Vertical offset location for notehead end of stems.

Offset from notehead: false
Offset from staff: true

Classes

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ AlternateNotation

◆ AutoNumberingStyle

◆ HideMode

◆ StemDirection

Member Function Documentation

◆ addAutoNumbering()

◆ calcAllAutoNumberValues()

◆ calcAllRuntimeValues()

◆ calcAlternateNotationHidesEntries()

◆ calcAutoNumberingAffix()

◆ calcBaselinePosition() [1/2]

◆ calcBaselinePosition() [2/2]

◆ calcBaselineZeroPosition()

◆ calcClefIndexAt()

◆ calcFirstClefIndex()

◆ calcTranspositionInterval()

◆ createLyricsLineInfo()

◆ firstContainingPart()

◆ getAbbreviatedInstrumentName()

◆ getAbbreviatedInstrumentNameCtx()

◆ getAbbreviatedName()

◆ getContainingParts()

◆ getFullInstrumentName()

◆ getFullInstrumentNameCtx()

◆ getFullName()

◆ integrityCheck()

Member Data Documentation

◆ abrvNamePosFromStyle

◆ abrvNamePosId

◆ fullNamePosFromStyle

◆ fullNamePosId

◆ multiStaffInstId

◆ noteShapesId

◆ stemStartFromStaff