Lists the order of sharps by pitch class index (0..6 = C..B) in a custom key signature. Note that while sharps are numbered from 1-7, this table is indexed 0-6. More...
#include <Others.h>
Inheritance diagram for musx::dom::others::AcciOrderSharps:
Public Member Functions | |
| OthersArray (const DocumentWeakPtr &document, Cmper partId, ShareMode shareMode, Cmper cmper) | |
| Constructor function. | |
| Public Member Functions inherited from musx::dom::OthersArray< unsigned, 7 > | |
| OthersArray (const DocumentWeakPtr &document, Cmper partId, ShareMode shareMode, Cmper cmper) | |
| Constructor function. | |
| void | integrityCheck () override |
| Override of Base::integrityCheck. | |
| Public Member Functions inherited from musx::dom::OthersBase | |
| Cmper | getCmper () const |
Gets the cmper key value. | |
| std::optional< Inci > | getInci () const |
Gets the optional array index (inci). | |
| Public Member Functions inherited from musx::dom::Base | |
| virtual | ~Base () noexcept(false)=default |
| Virtual destructor for polymorphic behavior. | |
| DocumentPtr | getDocument () const |
| Gets a reference to the Document. | |
| Cmper | getPartId () const |
| Gets the partId for this instance (or 0 for score) | |
| std::shared_ptr< others::PartDefinition > | getPartDefinition () const |
| Gets the others::PartDefinition corresponding to getPartId. | |
| ShareMode | getShareMode () const |
| Gets the sharing mode for this instance. | |
| const SharedNodes & | getUnlinkedNodes () const |
Gets the unlinked nodes for this instance. (Only populated for ShareMode::Partial) | |
| void | addUnlinkedNode (const std::string &nodeName) |
| Adds a shared node for this instance. | |
| virtual bool | requireAllFields () const |
| Specifies if the parser should alert (print or throw) when an unknown xml tag is found for this class. | |
Static Public Member Functions | |
| static const xml::XmlElementArray< AcciOrderSharps > & | xmlMappingArray () |
| Required for musx::factory::FieldPopulator. | |
Static Public Attributes | |
| static constexpr std::string_view | XmlNodeName = "acciOrderSharps" |
| The XML node name for this type. | |
Additional Inherited Members | |
| Public Types inherited from musx::dom::Base | |
| enum class | ShareMode { All , Partial , None } |
| Describes how this instance is shared between part and score. More... | |
| using | SharedNodes = std::set< std::string > |
| The container type for shared nodes. | |
| Public Attributes inherited from musx::dom::OthersArray< unsigned, 7 > | |
| std::vector< unsigned > | values |
| Protected Member Functions inherited from musx::dom::OthersBase | |
| OthersBase (const DocumentWeakPtr &document, Cmper partId, ShareMode shareMode, Cmper cmper, std::optional< Inci > inci=std::nullopt) | |
| Constructs an OthersBase object. | |
| Protected Member Functions inherited from musx::dom::Base | |
| Base (const DocumentWeakPtr &document, Cmper partId, ShareMode shareMode) | |
| Constructs the base class and enforces the static constexpr XmlNodeName. | |
| Base & | operator= (const Base &) |
| assignment constructor: m_unlinkedNodes is intentionally omitted | |
Detailed Description
Lists the order of sharps by pitch class index (0..6 = C..B) in a custom key signature. Note that while sharps are numbered from 1-7, this table is indexed 0-6.
AcciOrderSharps is required for non-linear key signatures. It specifies the order of pitch class indices for corresponding sharps and flats in AcciAmountSharps, which can be mixed in any order. The first zero value in the AcciAmountSharps table terminates the sequence of sharps or flats, and the rest of the values here are meaningless.
AcciOrderSharps is also useful with microtone systems that use standard key signatures. Typically linear modes in 12-EDO will not have this table, but larer EDOs will need to supply an AcciAmountFlats table, and this should have values that correspond.
The cmper is the value returned by KeySignature::getKeyMode. The built-in major and minor cmpers (0 and 1) ignore this table, and it should not be present for those values. (However, with Finale anything is possible.)
This class is identified by the XML node name "acciAmountFlats".
