MUSX Document Model
Loading...
Searching...
No Matches
musx::dom::others::StaffPlayData Class Reference

Defines playback routing, velocity control, and enablement for a staff's playback streams. More...

#include <Playback.h>

+ Inheritance diagram for musx::dom::others::StaffPlayData:

Classes

class  PlaybackSettings
 Defines the route and playback behavior for one staff playback stream. More...
 
class  VelocityControl
 Defines whether and how velocity control is applied to a playback stream. More...
 

Public Types

enum class  VelocityControlFunction { Absolute , Relative }
 Specifies how a playback stream's velocity-control level is applied. More...
 
- Public Types inherited from musx::dom::EnigmaBase
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

 StaffPlayData (const DocumentWeakPtr &document, Cmper partId, ShareMode shareMode, Cmper cmper)
 Constructor function.
 
- 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< IncigetInci () 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::EnigmaBase
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 SharedNodesgetUnlinkedNodes () 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 void integrityCheck (const std::shared_ptr< EnigmaBase > &ptrToThis)
 Performs a final consistency check after population.
 
virtual bool requireAllFields () const
 Returns true if all fields are required for valid input.
 
- Public Member Functions inherited from musx::dom::DocumentElement
virtual ~DocumentElement () noexcept(false)=default
 Virtual destructor for polymorphic behavior.
 
DocumentPtr getDocument () const
 Gets a reference to the Document.
 
Cmper getPartId () const
 Gets the part id associated with this instance.
 

Static Public Member Functions

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

Public Attributes

std::shared_ptr< PlaybackSettingschords
 Playback settings for chord symbols, if present.
 
std::shared_ptr< PlaybackSettingsmidiExpressions
 Playback settings for MIDI expressions, if present.
 
std::array< std::shared_ptr< PlaybackSettings >, MAX_LAYERSlayers
 Playback settings for each supported notation layer.
 

Static Public Attributes

static constexpr std::string_view XmlNodeName = "staffPlayData"
 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.
 
OthersBaseoperator= (const OthersBase &other)
 Assignment operator delegates to base, preserving OthersBase state.
 
OthersBaseoperator= (OthersBase &&other) noexcept
 Assignment operator delegates to base, preserving OthersBase state.
 
- Protected Member Functions inherited from musx::dom::EnigmaBase
 EnigmaBase (const DocumentWeakPtr &document, Cmper partId, ShareMode shareMode)
 Constructs the base class.
 
 EnigmaBase (const EnigmaBase &)=default
 explicit default copy constructor
 
 EnigmaBase (EnigmaBase &&) noexcept=default
 explicit default move constructor
 
EnigmaBaseoperator= (const EnigmaBase &)
 no-op copy assignment operator allows subclasses to copy their values.
 
EnigmaBaseoperator= (EnigmaBase &&) noexcept
 no-op move assignment operator allows subclasses to move their values.
 
- Protected Member Functions inherited from musx::dom::DocumentElement
 DocumentElement (const DocumentWeakPtr &document, Cmper partId)
 Constructs the document element.
 
 DocumentElement (const DocumentElement &)=default
 explicit default copy constructor
 
 DocumentElement (DocumentElement &&) noexcept=default
 explicit default move constructor
 
DocumentElementoperator= (const DocumentElement &)
 no-op copy assignment operator allows subclasses to copy their values.
 
DocumentElementoperator= (DocumentElement &&) noexcept
 no-op move assignment operator allows subclasses to move their values.
 

Detailed Description

Defines playback routing, velocity control, and enablement for a staff's playback streams.

The cmper is the staff ID. Separate settings are stored for chords, MIDI expressions, and each supported notation layer.

This class is identified by the XML node name "staffPlayData".

Member Enumeration Documentation

◆ VelocityControlFunction

Specifies how a playback stream's velocity-control level is applied.

Enumerator
Absolute 

Replaces the existing playback velocity with the configured level.

Relative 

Adjusts the existing playback velocity by the configured level.