Understanding libmei

The ODD meta-schema language makes use of some grouping mechanisms to allow elements with similar functions to inherit similar attributes. For example, both the note and rest elements would need identical attributes for dealing with rhythmic values, while only note would need attributes for dealing with pitch values.

In LibMEI, these attribute groups are expressed as "mixins." Mixins on elements allow programmatic access to attribute getters, setters, and deleters. Let's look at a simple example. For this section we will refer to our doxygen documentation, just so you can get a feel for how it is organized.

mei::Note has a large number of mixins associated with it. Let's look first at the PitchMixIn. This class defines four methods:

MeiAttribute * 	getPname ()
void 	setPname (std::string _pname)
bool 	hasPname ()
void 	removePname ()

This is made available as a "Public Member" of the mei::Note class. Each mixin class is instantiated when the MeiElement class is instantiated. For this example, our mei::Note class has the following constructor (truncated for clarity):

mei::Note::Note() :
    MeiElement("note"),
    /* other mixins */
    m_Pitch(this),
    /* other mixins */
{
}

And the corresponding header declaration (also truncated):

class MEI_EXPORT Note : public MeiElement {
    public:
        Note();
        Note(const Note& other);
        virtual ~Note();
        /* other methods and mixins */
        PitchMixIn    m_Pitch;
        /* other methods and mixins */
};