mnx::sequence::Event Class Reference

Represents a musical event within a sequence. More...

#include <Sequence.h>

Inheritance diagram for mnx::sequence::Event:

Public Member Functions
	Event (const std::shared_ptr< json > &root, json_pointer pointer)
	Constructor for existing Event objects.
	Event (Base &parent, const std::string_view &key, std::optional< NoteValue::Initializer > noteValue=std::nullopt)
	Creates a new Event class as a child of a JSON element.
	MNX_OPTIONAL_CHILD (NoteValue, duration)
	Symbolic duration of the event.
	MNX_OPTIONAL_PROPERTY (std::string, id)
	Identifying string for the event.
	MNX_OPTIONAL_CHILD (EventLyrics, lyrics)
	The lyric syllables on this event.
	MNX_OPTIONAL_CHILD (EventMarkings, markings)
	Articulation markings on this event.
	MNX_OPTIONAL_PROPERTY_WITH_DEFAULT (bool, measure, false)
	Whether this event is a whole-measure event.
	MNX_OPTIONAL_CHILD (Array< Note >, notes)
	MNX_OPTIONAL_CHILD (Rest, rest)
	indicates this event is a rest.
	MNX_OPTIONAL_CHILD (Array< Slur >, slurs)
	The slurs that start on this event.
	MNX_OPTIONAL_PROPERTY (int, staff)
	Staff number override (e.g., for cross-staff events.)
	MNX_OPTIONAL_PROPERTY (StemDirection, stemDirection)
	Forced stem direction.
std::optional< Note >	findNote (const std::string &noteId) const
	Finds a note in the event by its ID.
bool	isGrace () const
	Returns true if this event is part of a grace note sequence.
Sequence	getSequence () const
	Returns the Sequence instance for this event.
Public Member Functions inherited from mnx::ContentObject
	MNX_OPTIONAL_PROPERTY_WITH_DEFAULT (std::string, type, std::string(ContentTypeValueDefault))
	determines our type in the JSON
template<typename T , std::enable_if_t< std::is_base_of_v< ContentObject, T >, int > = 0>
T	get () const
	Retrieve an element as a specific type.
Public Member Functions inherited from mnx::ArrayElementObject
size_t	calcArrayIndex () const
	Calculates the array index of the current instance within the array.
template<typename ContainerType >
ContainerType	container () const
	Returns the container of the array this element belongs to wrapped as the specified template type.
	Object (const std::shared_ptr< json > &root, json_pointer pointer)
	Wraps an Object class around an existing JSON object node.
	Object (Base &parent, const std::string_view &key)
	Creates a new Object class as a child of a JSON node.
Public Member Functions inherited from mnx::Object
	Object (const std::shared_ptr< json > &root, json_pointer pointer)
	Wraps an Object class around an existing JSON object node.
	Object (Base &parent, const std::string_view &key)
	Creates a new Object class as a child of a JSON node.
Public Member Functions inherited from mnx::Base
	Base (const Base &src)
	Copy constructor.
	Base (Base &&src) noexcept
	Move constructor.
Base &	operator= (const Base &src)
	Copy assignment operator.
Base &	operator= (Base &&src)
	Move assignment operator.
std::string	dump (int indents=-1)
	Dumps the branch to a string. Useful in debugging.
template<typename T >
T	parent () const
	Returns the parent object for this node.
template<typename T >
std::optional< T >	getEnclosingElement () const
	Returns the enclosing array element for this instance.
json_pointer	pointer () const
	Returns the json_pointer for this node.

Static Public Attributes
static constexpr std::string_view	ContentTypeValue = ContentObject::ContentTypeValueDefault
	type value that identifies the type within the content array

Additional Inherited Members
Protected Member Functions inherited from mnx::Base
json &	ref () const
	Convert this node for retrieval.
json &	ref ()
	Access the JSON node for modification.
const std::shared_ptr< json > &	root () const
	Returns the root.
	Base (const std::shared_ptr< json > &root, json_pointer pointer)
	Wrap a Base instance around a specific JSON reference using a json_pointer.
	Base (json &&jsonRef, Base &parent, const std::string_view &key)
	Construct a Base reference as a child inside a parent node.
template<typename T >
T	getChild (const std::string_view &key) const
	Retrieves and validates a required child node.
template<typename T >
T	setChild (const std::string_view &key, const T &value)
	Sets a child node.
template<typename T >
std::optional< T >	getOptionalChild (const std::string_view &key) const
	Retrieves an optional child node.
Static Protected Attributes inherited from mnx::ContentObject
static constexpr std::string_view	ContentTypeValueDefault = "event"
	default type value that identifies the type within the content array

Detailed Description

Represents a musical event within a sequence.

Constructor & Destructor Documentation

Event()

mnx::sequence::Event::Event ( Base &  parent, const std::string_view &  key, std::optional< NoteValue::Initializer >  noteValue = std::nullopt  )

inline

Creates a new Event class as a child of a JSON element.

Parameters

parent	The parent class instance
key	The JSON key to use for embedding in parent.
noteValue	The note value. If omitted, the event is set to full measure.

Member Function Documentation

findNote()

std::optional< sequence::Note > mnx::sequence::Event::findNote

(

const std::string &

noteId

)

const

Finds a note in the event by its ID.

Parameters

noteId

The note ID to find

Returns

The note if found, otherwise std::nullopt;

getSequence()

Sequence mnx::sequence::Event::getSequence

(

)

const

Returns the Sequence instance for this event.

Exceptions

std::logic_error

if the json pointer does not contain a sequence (should be impossible)

MNX_OPTIONAL_CHILD() [1/2]

mnx::sequence::Event::MNX_OPTIONAL_CHILD	(	Array< Note >	,
		notes
	)

Note array

MNX_OPTIONAL_CHILD() [2/2]

mnx::sequence::Event::MNX_OPTIONAL_CHILD	(	Rest	,
		rest
	)

indicates this event is a rest.

Todo:

orient