MNX Document Model
Loading...
Searching...
No Matches
mnx::NoteValue Class Reference

Represents a symbolic note value (not necessarily a duration) More...

#include <CommonClasses.h>

+ Inheritance diagram for mnx::NoteValue:

Classes

struct  Required
 initializer class for NoteValue More...
 

Public Member Functions

 NoteValue (const std::shared_ptr< json > &root, json_pointer pointer)
 Constructor for existing NoteValue instances.
 
 NoteValue (Base &parent, std::string_view key, NoteValueBase base, unsigned dots=0)
 Creates a new Barline class as a child of a JSON element.
 
 operator Required () const
 Implicit conversion back to Required.
 
 operator FractionValue () const
 Convert the note value to a Fraction base where a quarter note is 1/4.
 
 MNX_REQUIRED_PROPERTY (NoteValueBase, base)
 the type ("base") of note
 
 MNX_OPTIONAL_PROPERTY_WITH_DEFAULT (unsigned, dots, 0)
 the number of dots
 
unsigned calcNumberOfFlags () const
 Calculates the number of flags or beams required by this note value.
 
- 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, 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 &key, const json &value)
 Sets a vendor extension value in _x, creating _x when needed.
 
std::optional< jsongetExtension (const std::string &key) const
 Gets a vendor extension value from _x.
 
- Public Member Functions inherited from mnx::Base
 Base (const Base &src)
 Copy constructor.
 
 Base (Base &&src) noexcept
 Move constructor.
 
Baseoperator= (const Base &src)
 Copy assignment operator.
 
Baseoperator= (Base &&src)
 Move assignment operator.
 
std::string dump (int indents=-1) const
 Dumps the branch to a string. Useful in debugging.
 
template<typename 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.
 

Static Public Member Functions

static Required make (NoteValueBase base, unsigned dots=0)
 Create a Required instance for NoteValue.
 

Additional Inherited Members

- Protected Member Functions inherited from mnx::Base
jsonref () const
 Convert this node for retrieval.
 
jsonref ()
 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 >
getChild (std::string_view key) const
 Retrieves and validates a required child node.
 
template<typename 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

Represents a symbolic note value (not necessarily a duration)

Constructor & Destructor Documentation

◆ NoteValue()

mnx::NoteValue::NoteValue ( Base parent,
std::string_view  key,
NoteValueBase  base,
unsigned  dots = 0 
)
inline

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

Parameters
parentThe parent class instance
keyThe JSON key to use for embedding in parent.
baseThe note value base to initialize
dotsThe number of dots to initialize