UmsciExternalControlComponent.h

Go to the documentation of this file.

/* Copyright (c) 2026, Christian Ahrens
 *
 * This file is part of Umsci <https://github.com/ChristianAhrens/Umsci>
 *
 * This tool is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License version 3.0 as published
 * by the Free Software Foundation.
 *
 * This tool is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this tool; if not, write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */
 
#pragma once
 
#include <JuceHeader.h>
 
#include <MidiCommandRangeAssignment.h>
#include <MidiLearnerComponent.h>
 
 
class UmsciExternalControlComponent : public juce::Component
{
public:
    enum UpmixMidiParam
    {
        UpmixMidiParam_Rotation         = 0,  
        UpmixMidiParam_Translation      = 1,  
        UpmixMidiParam_HeightTranslation= 2,  
        UpmixMidiParam_AngleStretch     = 3,  
        UpmixMidiParam_OffsetX          = 4,  
        UpmixMidiParam_OffsetY          = 5,  
        UpmixMidiParam_COUNT            = 6
    };
 
    static const std::array<std::pair<float, float>, UpmixMidiParam_COUNT> s_paramRanges;
 
    static const juce::String s_paramLabels[UpmixMidiParam_COUNT];
 
    static const juce::String s_oscDefaultAddresses[UpmixMidiParam_COUNT];
 
public:
    UmsciExternalControlComponent();
    ~UmsciExternalControlComponent() override;
 
    //==============================================================================
    void resized() override;
 
    //==============================================================================
    // MIDI API
    void setMidiInputDeviceIdentifier(const juce::String& identifier);
    const juce::String& getMidiInputDeviceIdentifier() const;
    void setMidiAssi(UpmixMidiParam param, const JUCEAppBasics::MidiCommandRangeAssignment& assi);
    const JUCEAppBasics::MidiCommandRangeAssignment& getMidiAssi(UpmixMidiParam param) const;
 
    std::function<void(const juce::String&)> onMidiInputDeviceChanged;
    std::function<void(UpmixMidiParam, JUCEAppBasics::MidiCommandRangeAssignment)> onMidiAssiChanged;
 
    //==============================================================================
    // OSC API
    void setOscInputPort(int port);
    int  getOscInputPort() const;
    void setOscAddr(UpmixMidiParam param, const juce::String& address);
    juce::String getOscAddr(UpmixMidiParam param) const;
 
    std::function<void(int)> onOscInputPortChanged;
    std::function<void(UpmixMidiParam, juce::String)> onOscAddrChanged;
 
private:
    class MidiTab;
    class OscTab;
 
    std::unique_ptr<juce::TabbedComponent> m_tabs;
    MidiTab* m_midiTab = nullptr;  
    OscTab*  m_oscTab  = nullptr;  
 
    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR(UmsciExternalControlComponent)
};