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

Represents a positioned clef for the measure. More...

#include <Part.h>

+ Inheritance diagram for mnx::part::PositionedClef:

Classes

struct  Required
 initializer class for PositionedClef More...
 

Public Member Functions

 PositionedClef (const std::shared_ptr< json > &root, json_pointer pointer)
 Constructor for existing PositionedClef instances.
 
 PositionedClef (Base &parent, std::string_view key, ClefSign clefSign, int staffPosition, OttavaAmountOrZero octaveAdjustment=OttavaAmountOrZero::NoTransposition)
 Creates a new PositionedClef class as a child of a JSON element.
 
 operator Required () const
 Implicit conversion back to Required.
 
 MNX_REQUIRED_CHILD (Clef, clef,(ClefSign, clefSign),(int, staffPosition),(OttavaAmountOrZero, octaveAdjustment))
 the beats per minute of this tempo marking
 
 MNX_OPTIONAL_CHILD (RhythmicPosition, position,(const FractionValue &, position))
 location within the measure of the tempo marking
 
 MNX_OPTIONAL_PROPERTY_WITH_DEFAULT (int, staff, 1)
 the staff number (for multistaff parts)
 
- 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 (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 (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 (ClefSign clefSign, int staffPosition, OttavaAmountOrZero octaveAdjustment=OttavaAmountOrZero::NoTransposition)
 Create a Required instance for PositionedClef.
 

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 positioned clef for the measure.

Constructor & Destructor Documentation

◆ PositionedClef()

mnx::part::PositionedClef::PositionedClef ( Base parent,
std::string_view  key,
ClefSign  clefSign,
int  staffPosition,
OttavaAmountOrZero  octaveAdjustment = OttavaAmountOrZero::NoTransposition 
)
inline

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

Parameters
parentThe parent class instance
keyThe JSON key to use for embedding in parent.
clefSignThe type of clef symbol
staffPositionStaff position offset from center of staff
octaveAdjustmentOptional octave adjustment