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

Represents a musical chromatic interval. More...

#include <CommonClasses.h>

+ Inheritance diagram for mnx::Interval:

Public Member Functions

 Interval (const std::shared_ptr< json > &root, json_pointer pointer)
 Constructor for existing NoteValue instances.
 
 Interval (Base &parent, std::string_view key, int staffDistance, int halfSteps)
 Creates a new Barline class as a child of a JSON element.
 
 MNX_REQUIRED_PROPERTY (int, halfSteps)
 the number of 12-EDO chromatic halfsteps in the interval (negative is down)
 
 MNX_REQUIRED_PROPERTY (int, staffDistance)
 the number of diatonic steps in the interval (negative is down)
 
- 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.
 
- 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 >
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 ArrayElementObject::container.)
 
json_pointer pointer () const
 Returns the json_pointer for this node.
 
Document document () const
 Returns the document root.
 

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 musical chromatic interval.

Constructor & Destructor Documentation

◆ Interval()

mnx::Interval::Interval ( Base parent,
std::string_view  key,
int  staffDistance,
int  halfSteps 
)
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.
staffDistanceThe number of diatonic steps in the interval (negative is down)
halfStepsThe number of 12-EDO chromatic halfsteps in the interval (negative is down)