diff DPF-Prymula-audioplugins/dpf/distrho/DistrhoStandaloneUtils.hpp @ 3:84e66ea83026

DPF-Prymula-audioplugins-0.231015-2
author prymula <prymula76@outlook.com>
date Mon, 16 Oct 2023 21:53:34 +0200
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/DPF-Prymula-audioplugins/dpf/distrho/DistrhoStandaloneUtils.hpp	Mon Oct 16 21:53:34 2023 +0200
@@ -0,0 +1,99 @@
+/*
+ * DISTRHO Plugin Framework (DPF)
+ * Copyright (C) 2012-2022 Filipe Coelho <falktx@falktx.com>
+ *
+ * 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_STANDALONE_UTILS_HPP_INCLUDED
+#define DISTRHO_STANDALONE_UTILS_HPP_INCLUDED
+
+#include "src/DistrhoDefines.h"
+
+START_NAMESPACE_DISTRHO
+
+/* ------------------------------------------------------------------------------------------------------------
+ * Standalone plugin related utilities */
+
+/**
+   @defgroup StandalonePluginRelatedUtilities Plugin related utilities
+
+   When the plugin is running as standalone and JACK is not available, a native audio handling is in place.
+   It is a very simple handling, auto-connecting to the default audio interface for outputs.
+
+   !!EXPERIMENTAL!!
+
+   Still under development and testing.
+
+   @{
+ */
+
+/**
+   Check if the current standalone is using native audio methods.
+   If this function returns false, you MUST NOT use any other function from this group.
+*/
+bool isUsingNativeAudio() noexcept;
+
+/**
+   Check if the current standalone supports audio input.
+*/
+bool supportsAudioInput();
+
+/**
+   Check if the current standalone supports dynamic buffer size changes.
+*/
+bool supportsBufferSizeChanges();
+
+/**
+   Check if the current standalone supports MIDI.
+*/
+bool supportsMIDI();
+
+/**
+   Check if the current standalone has audio input enabled.
+*/
+bool isAudioInputEnabled();
+
+/**
+   Check if the current standalone has MIDI enabled.
+*/
+bool isMIDIEnabled();
+
+/**
+   Get the current buffer size.
+*/
+uint getBufferSize();
+
+/**
+   Request permissions to use audio input.
+   Only valid to call if audio input is supported but not currently enabled.
+*/
+bool requestAudioInput();
+
+/**
+   Request change to a new buffer size.
+*/
+bool requestBufferSizeChange(uint newBufferSize);
+
+/**
+   Request permissions to use MIDI.
+   Only valid to call if MIDI is supported but not currently enabled.
+*/
+bool requestMIDI();
+
+/** @} */
+
+// -----------------------------------------------------------------------------------------------------------
+
+END_NAMESPACE_DISTRHO
+
+#endif // DISTRHO_STANDALONE_UTILS_HPP_INCLUDED