tracktion_MidiExpression.h

Go to the documentation of this file.

 /*
    ,--.                     ,--.     ,--.  ,--.
  ,-'  '-.,--.--.,--,--.,---.|  |,-.,-'  '-.`--' ,---. ,--,--,      Copyright 2024
  '-.  .-'|  .--' ,-.  | .--'|     /'-.  .-',--.| .-. ||      \   Tracktion Software
    |  |  |  |  \ '-'  \ `--.|  \  \  |  |  |  |' '-' '|  ||  |       Corporation
    `---' `--'   `--`--'`---'`--'`--' `---' `--' `---' `--''--'    www.tracktion.com
 
    Tracktion Engine uses a GPL/commercial licence - see LICENCE.md for details.
*/
 
namespace tracktion { inline namespace engine
{
 
struct MidiExpression
{
    static bool noteHasExpression (const juce::ValueTree& noteState) noexcept
    {
        jassert (noteState.hasType (IDs::NOTE));
        return noteState.getNumChildren() > 0;
    }
 
    static bool noteHasExpression (const juce::ValueTree& noteState, const juce::Identifier& type) noexcept
    {
        jassert (noteState.hasType (IDs::NOTE));
 
        return noteState.getChildWithName (type).isValid();
    }
 
    static bool listHasExpression (const MidiList& midiList) noexcept;
 
    static bool isExpression (const juce::Identifier& type) noexcept
    {
        return type == IDs::PITCHBEND || type == IDs::PRESSURE || type == IDs::TIMBRE;
    }
 
    static juce::ValueTree createAndAddExpressionToNote (juce::ValueTree& noteState, const juce::Identifier& expressionType,
                                                         BeatPosition beat, float value, juce::UndoManager* um)
    {
        jassert (noteState.hasType (IDs::NOTE));
        jassert (isExpression (expressionType));
 
        juce::ValueTree expression (expressionType);
        MidiExpression exp (expression);
        exp.setBeatPosition (beat, um);
        exp.setValue (value, um);
        noteState.addChild (expression, -1, nullptr);
 
        return expression;
    }
 
    //==============================================================================
    MidiExpression (const juce::ValueTree& v)
        : state (v)
    {
        jassert (! v[IDs::b].isString());
        jassert (! v[IDs::v].isString());
        jassert (isExpression (v.getType()));
    }
 
    BeatPosition getBeatPosition() const noexcept     { return BeatPosition::fromBeats (static_cast<double> (state[IDs::b])); }
 
    void setBeatPosition (BeatPosition newBeat, juce::UndoManager* um)
    {
        state.setProperty (IDs::b, newBeat.inBeats(), um);
    }
 
    float getValue() const noexcept             { return state[IDs::v]; }
 
    void setValue (float newValue, juce::UndoManager* um)
    {
        if (state.hasType (IDs::PRESSURE) || state.hasType (IDs::TIMBRE))
            jassert (juce::isPositiveAndNotGreaterThan (newValue, 1.0f));
 
        state.setProperty (IDs::v, newValue, um);
    }
 
    juce::ValueTree state;
};
 
}} // namespace tracktion { inline namespace engine