/* * DISTRHO Plugin Framework (DPF) * Copyright (C) 2012-2014 Filipe Coelho * * Permission to use, copy, modify, and/or distribute this software for any purpose with * or without fee is hereby granted, provided that the above copyright notice and this * permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD * TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN * NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ #ifndef DISTRHO_UI_HPP_INCLUDED #define DISTRHO_UI_HPP_INCLUDED #include "extra/d_leakdetector.hpp" #include "src/DistrhoPluginChecks.h" #if DISTRHO_UI_USE_NTK # include "../dgl/ntk/NtkWidget.hpp" typedef DGL::NtkWidget UIWidget; #elif DISTRHO_UI_USE_NANOVG # include "../dgl/NanoVG.hpp" typedef DGL::NanoWidget UIWidget; # else # include "../dgl/Widget.hpp" typedef DGL::Widget UIWidget; #endif START_NAMESPACE_DISTRHO // ----------------------------------------------------------------------- // UI class UI : public UIWidget { public: UI(); virtual ~UI(); // ------------------------------------------------------------------- // Host DSP State double d_getSampleRate() const noexcept; void d_editParameter(const uint32_t index, const bool started); void d_setParameterValue(const uint32_t index, const float value); #if DISTRHO_PLUGIN_WANT_STATE void d_setState(const char* const key, const char* const value); #endif #if DISTRHO_PLUGIN_IS_SYNTH void d_sendNote(const uint8_t channel, const uint8_t note, const uint8_t velocity); #endif // ------------------------------------------------------------------- // Host UI State void d_setSize(const uint width, const uint height); #if DISTRHO_PLUGIN_WANT_DIRECT_ACCESS // ------------------------------------------------------------------- // Direct DSP access - DO NOT USE THIS UNLESS STRICTLY NECESSARY!! void* d_getPluginInstancePointer() const noexcept; #endif protected: // ------------------------------------------------------------------- // Basic Information virtual const char* d_getName() const noexcept { return DISTRHO_PLUGIN_NAME; } virtual uint d_getWidth() const noexcept = 0; virtual uint d_getHeight() const noexcept = 0; // ------------------------------------------------------------------- // DSP Callbacks virtual void d_parameterChanged(uint32_t index, float value) = 0; #if DISTRHO_PLUGIN_WANT_PROGRAMS virtual void d_programChanged(uint32_t index) = 0; #endif #if DISTRHO_PLUGIN_WANT_STATE virtual void d_stateChanged(const char* key, const char* value) = 0; #endif // ------------------------------------------------------------------- // DSP Callbacks (optional) virtual void d_sampleRateChanged(double newSampleRate); // ------------------------------------------------------------------- // UI Callbacks (optional) virtual void d_uiIdle() {} virtual void d_uiReshape(int width, int height); // ------------------------------------------------------------------- private: struct PrivateData; PrivateData* const pData; friend class UIExporter; friend class UIExporterWindow; // these should not be used void setAbsoluteX(int) const noexcept {} void setAbsoluteY(int) const noexcept {} void setAbsolutePos(int, int) const noexcept {} void setAbsolutePos(const DGL::Point&) const noexcept {} void setNeedsFullViewport(bool) const noexcept {} DISTRHO_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR(UI) }; // ----------------------------------------------------------------------- // Create UI, entry point extern UI* createUI(); // ----------------------------------------------------------------------- END_NAMESPACE_DISTRHO #endif // DISTRHO_UI_HPP_INCLUDED