mnx::part::DynamicRelative Class Reference

Relative dynamics (e.g., più f) More...

#include <Dynamics.h>

Inheritance diagram for mnx::part::DynamicRelative:

Classes
struct	Required
	initializer class for DynamicRelative More...

Public Member Functions
	DynamicRelative (const std::shared_ptr< json > &root, json_pointer pointer)
	Constructor for existing Space objects.
	DynamicRelative (Base &parent, std::string_view key, DynamicRelativeValue relativeValue, const FractionValue &position)
	Creates a new Space class as a child of a JSON element.
	operator Required () const
	Implicit conversion back to Required.
	MNX_REQUIRED_PROPERTY (DynamicRelativeValue, relativeValue)
	Whether the dynamic is relatively softer or louder.
Public Member Functions inherited from mnx::part::DynamicGroupBase
std::string_view	defaultType () const override
	DynamicGroupBase (const std::shared_ptr< json > &root, json_pointer pointer)
	Constructor for existing Space objects.
	DynamicGroupBase (Base &parent, std::string_view key, const FractionValue &position)
	Creates a new Space class as a child of a JSON element.
	MNX_OPTIONAL_PROPERTY (DynamicValue, attackValue)
	MNX_OPTIONAL_CHILD (Array< std::string >, glyphs)
	MNX_OPTIONAL_PROPERTY_WITH_DEFAULT (MultiStaffOrientation, orient, MultiStaffOrientation::Auto)
	positioning of the dynamic relative to its part staves
	MNX_REQUIRED_CHILD (RhythmicPosition, position,(const FractionValue &, position))
	The rhythmic position of the dynamic within the measure.
	MNX_OPTIONAL_PROPERTY (std::string, prefix)
	Text preceding the dynamics representation, e.g., "più".
	MNX_OPTIONAL_PROPERTY (int, staff)
	The staff (within the part) this dynamic applies to.
	MNX_OPTIONAL_PROPERTY (std::string, suffix)
	Text following the dynamics representation, e.g., "subito".
	MNX_OPTIONAL_PROPERTY (DynamicValue, value)
	The value of the dynamic. Currently the MNX spec allows any string here.
	MNX_OPTIONAL_PROPERTY (std::string, voice)
	Optionally specify the voice this dynamic applies to.
bool	calcHasImmediateText () const
	Calculates if this dynamic has immediate text. If this value returns false, then it should be a hairpin with no preceding dynamic.
Public Member Functions inherited from mnx::ContentObject< DynamicGroupBase >
	MNX_OPTIONAL_PROPERTY_WITH_DEFAULT (std::string, type, std::string(defaultType()))
	determines our type in the JSON
T	get () const
	Constructs an object of type T if its type matches the JSON 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 object that owns the content array this element belongs to wrapped as the specified template type.
	Object ()
	Constructor fresh document or detached instance.
	Object (const std::shared_ptr< json > &root, json_pointer pointer)
	Wraps an Object class around an existing JSON object node.
	Object (Base &parent, std::string_view key)
	Creates a new Object class as a child of a JSON node.
Public Member Functions inherited from mnx::Object
	Object ()
	Constructor fresh document or detached instance.
	Object (const std::shared_ptr< json > &root, json_pointer pointer)
	Wraps an Object class around an existing JSON object node.
	Object (Base &parent, std::string_view key)
	Creates a new Object class as a child of a JSON node.
	MNX_OPTIONAL_PROPERTY (std::string, _c)
	An optional comment. This serves a similar function as XML or HTML comments.
	MNX_OPTIONAL_CHILD (Object, _x)
	Vendor-defined dictionary.
	MNX_OPTIONAL_PROPERTY (std::string, id)
	Uniquely identifies the object.
void	setExtension (const std::string_view key, const json &value)
	Sets a vendor extension value in _x, creating _x when needed.
std::optional< json >	getExtension (const std::string_view key) const
	Gets a vendor extension value from _x.
void	clearExtension (const std::string_view key)
	Removes a vendor extension value from _x, if it exists.
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) const
	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 , typename Scope = scope::Default>
std::optional< T >	getEnclosingElement () const
	Returns the enclosing array element for this instance. If T is a type that can be nested (e.g. ContentObject), the highest level instance is returned. (To get the lowest level immediate container, use ContentObject::container.)
json_pointer	pointer () const
	Returns the json_pointer for this node.
Document	document () const
	Returns the document root.
bool	empty () const
	Returns true if the object is empty.

Static Public Member Functions
static Required	make (DynamicRelativeValue relativeValue, const FractionValue &position)
	Create a Required instance for DynamicRelative.

Static Public Attributes
static constexpr std::string_view	ContentTypeValue = "relative"
	type value that identifies the type of dynamic

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, std::string_view key)
	Construct a Base reference as a child inside a parent node.
template<typename T >
T	getChild (std::string_view key) const
	Retrieves and validates a required child node.
template<typename T >
T	setChild (std::string_view key, const T &value)
	Sets a child node.
template<typename T >
std::optional< T >	getOptionalChild (std::string_view key) const
	Retrieves an optional child node.

Detailed Description

Relative dynamics (e.g., più f)

Constructor & Destructor Documentation

DynamicRelative()

mnx::part::DynamicRelative::DynamicRelative ( Base &  parent, std::string_view  key, DynamicRelativeValue  relativeValue, const FractionValue &  position  )

inline

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

Parameters

parent	The parent class instance.
key	The JSON key to use for embedding in parent.
relativeValue	The relative change of the dynamic
position	The position within the measure