Add Plugin Pin Connector

include/AudioData.h

@@ -0,0 +1,111 @@
+/*
+ * AudioData.h - Audio data types
+ *
+ * Copyright (c) 2024 Dalton Messmer <messmer.dalton/at/gmail.com>
+ *
+ * This file is part of LMMS - https://lmms.io
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This program 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
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public
+ * License along with this program (see COPYING); if not, write to the
+ * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301 USA.
+ *
+ */
+
+#ifndef LMMS_AUDIO_DATA_H
+#define LMMS_AUDIO_DATA_H
+
+#include <type_traits>
+
+#include "lmms_basics.h"
+
+namespace lmms
+{
+
+//! Conventions for passing audio data
+enum class AudioDataLayout
+{
+	/*
+	 * Given:
+	 *   - N == Frame count
+	 *   - C == Number of channels
+	 *   - i == Sample index, where 0 <= i < N
+	 *   - `samples` has the type sample_t*
+	 *   - `samples` size == N * C
+	 */
+
+	/**
+	 * Layout where the samples for each channel are interleaved.
+	 * i.e. "LRLRLRLR"
+	 *
+	 * Samples for individual channels can be accessed like this:
+	 * - Channel #0 samples: samples[C*i]
+	 * - Channel #1 samples: samples[C*i + 1]
+	 * - Channel #2 samples: samples[C*i + 2]
+	 * - Channel #3 samples: samples[C*i + 3]
+	 * - ...
+	 */
+	Interleaved,
+
+	/**
+	 * Layout where all samples for a particular channel are grouped together.
+	 * i.e. "LLLLRRRR"
+	 *
+	 * Samples for individual channels can be accessed like this:
+	 * - Channel #0 samples: samples[i]
+	 * - Channel #1 samples: samples[1*N + i]
+	 * - Channel #2 samples: samples[2*N + i]
+	 * - Channel #3 samples: samples[3*N + i]
+	 * - ...
+	 */
+	Split
+};
+
+
+/**
+ * An alias for an unbounded floating point array.
+ *
+ * Can be used as a replacement for `float*` parameters when you want to document the
+ * data layout of the audio data.
+ */
+template<AudioDataLayout layout, typename T, std::enable_if_t<std::is_floating_point_v<T>, bool> = true>
+using AudioDataPtr = T*;
+
+template<typename T>
+using SplitAudioDataPtr = AudioDataPtr<AudioDataLayout::Split, T>;
+
+template<typename T>
+using InterleavedAudioDataPtr = AudioDataPtr<AudioDataLayout::Interleaved, T>;
+
+
+/**
+ * A simple (samples, size) pair for storing audio data of a particular layout.
+ * All data is contiguous in memory.
+ *
+ * NOTE: More information is still needed to correctly interpret this audio data:
+ * - For Split layout, the frame count is needed
+ * - For Interleaved layout, the channel count is needed
+ */
+template<AudioDataLayout layout, typename T, std::enable_if_t<std::is_floating_point_v<T>, bool> = true>
+using AudioData = Span<T>;
+
+template<typename T>
+using SplitAudioData = AudioData<AudioDataLayout::Split, T>;
+
+template<typename T>
+using InterleavedAudioData = AudioData<AudioDataLayout::Interleaved, T>;
+
+
+} // namespace lmms
+
+#endif // LMMS_AUDIO_DATA_H

include/PluginPinConnector.h

@@ -0,0 +1,156 @@
+/*
+ * PluginPinConnector.h - Specifies how to route audio channels
+ *                        in and out of a plugin.
+ *
+ * Copyright (c) 2024 Dalton Messmer <messmer.dalton/at/gmail.com>
+ *
+ * This file is part of LMMS - https://lmms.io
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This program 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
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public
+ * License along with this program (see COPYING); if not, write to the
+ * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301 USA.
+ *
+ */
+
+#ifndef LMMS_PLUGIN_PIN_CONNECTOR_H
+#define LMMS_PLUGIN_PIN_CONNECTOR_H
+
+#include <vector>
+
+#include "AutomatableModel.h"
+#include "lmms_export.h"
+#include "SampleFrame.h"
+#include "SerializingObject.h"
+
+class QWidget;
+
+namespace lmms
+{
+
+namespace gui
+{
+
+class PluginPinConnectorView;
+
+} // namespace gui
+
+//! Configuration for audio channel routing in/out of plugin
+class LMMS_EXPORT PluginPinConnector
+	: public Model
+	, public SerializingObject
+{
+	Q_OBJECT
+
+public:
+	//! [track channel][plugin channel]
+	using PinMap = std::vector<std::vector<BoolModel*>>;
+
+	//! A plugin's input or output connections and other info
+	struct Matrix
+	{
+		PinMap pins;
+		int channelCount = 0;
+		std::vector<QString> channelNames; //!< optional
+
+		// TODO: Channel groupings, port configurations, ...
+
+		auto channelName(int channel) const -> QString;
+
+		auto enabled(std::uint8_t trackChannel, unsigned pluginChannel) const -> bool
+		{
+			return pins[trackChannel][pluginChannel]->value();
+		}
+	};
+
+	PluginPinConnector(Model* parent = nullptr);
+	PluginPinConnector(int pluginChannelCountIn, int pluginChannelCountOut, Model* parent = nullptr);
+
+	/**
+	 * Getters
+	 */
+	auto in() const -> const Matrix& { return m_in; };
+	auto out() const -> const Matrix& { return m_out; };
+	auto trackChannelCount() const -> std::size_t { return s_totalTrackChannels; }
+	auto trackChannelsUsed() const -> unsigned int { return m_trackChannelsUsed; }
+
+	/**
+	 * Setters
+	 */
+	void setPluginChannelCounts(int inCount, int outCount);
+	void setPluginChannelCountIn(int inCount);
+	void setPluginChannelCountOut(int outCount);
+
+	void setDefaultConnections();
+
+	/*
+	 * Routes audio from LMMS track channels to plugin inputs according to the plugin pin connector configuration.
+	 *
+	 * Iterates through each output channel, mixing together all input audio routed to the output channel.
+	 * If no audio is routed to an output channel, the output channel's buffer is zeroed.
+	 *
+	 * `frames` : number of frames in each `in`/`out` audio buffer
+	 * `in`     : track channels from LMMS core (currently just the main track channel pair)
+	 * `out`    : plugin input channels in Split form
+	 */
+	void routeToPlugin(f_cnt_t frames, CoreAudioData in, SplitAudioData<sample_t> out);
+
+	/*
+	 * Routes audio from plugin outputs to LMMS track channels according to the plugin pin connector configuration.
+	 *
+	 * Iterates through each output channel, mixing together all input audio routed to the output channel.
+	 * If no audio is routed to an output channel, `inOut` remains unchanged for audio bypass.
+	 *
+	 * `frames`  : number of frames in each `in`/`out` audio buffer
+	 * `in`      : plugin output channels in Split form
+	 * `inOut`   : track channels from/to LMMS core (inplace processing)
+	 */
+	void routeFromPlugin(f_cnt_t frames, SplitAudioData<const sample_t> in, CoreAudioDataMut inOut);
+
+
+	/**
+	 * SerializingObject implementation
+	 */
+	void saveSettings(QDomDocument& doc, QDomElement& elem) override;
+	void loadSettings(const QDomElement& elem) override;
+	auto nodeName() const -> QString override { return "pins"; }
+
+	auto instantiateView(QWidget* parent = nullptr) -> gui::PluginPinConnectorView*;
+	auto getChannelCountText() const -> QString;
+
+	static constexpr std::size_t MaxTrackChannels = 256; // TODO: Move somewhere else
+
+public slots:
+	void setTrackChannelCount(int count);
+
+private:
+	static void saveSettings(const Matrix& matrix, QDomDocument& doc, QDomElement& elem);
+	static void loadSettings(const QDomElement& elem, Matrix& matrix);
+
+	void setPluginChannelCount(int newCount, bool isInput, Matrix& matrix);
+
+	Matrix m_in;  //!< LMMS --> Plugin
+	Matrix m_out; //!< Plugin --> LMMS
+
+	//! TODO: Move this somewhere else; Will be >= 2 once there is support for adding new track channels
+	static constexpr std::size_t s_totalTrackChannels = DEFAULT_CHANNELS;
+
+	//! This value is <= to the total number of track channels (currently always 2)
+	unsigned int m_trackChannelsUsed = DEFAULT_CHANNELS;
+
+	// TODO: When full routing is added, get LMMS channel counts from bus or router class
+};
+
+} // namespace lmms
+
+#endif // LMMS_PLUGIN_PIN_CONNECTOR_H

include/PluginPinConnectorView.h

@@ -0,0 +1,82 @@
+/*
+ * PluginPinConnectorView.h - Displays pin connectors
+ *
+ * Copyright (c) 2024 Dalton Messmer <messmer.dalton/at/gmail.com>
+ *
+ * This file is part of LMMS - https://lmms.io
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This program 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
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public
+ * License along with this program (see COPYING); if not, write to the
+ * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301 USA.
+ *
+ */
+
+#ifndef LMMS_GUI_PLUGIN_PIN_CONNECTOR_VIEW_H
+#define LMMS_GUI_PLUGIN_PIN_CONNECTOR_VIEW_H
+
+#include <QWidget>
+
+#include "embed.h"
+#include "lmms_export.h"
+#include "ModelView.h"
+
+class QPixmap;
+//class QScrollArea;
+
+namespace lmms
+{
+
+class BoolModel;
+class PluginPinConnector;
+
+namespace gui
+{
+
+class SubWindow;
+
+class LMMS_EXPORT PluginPinConnectorView
+	: public QWidget
+	, public ModelView
+{
+	Q_OBJECT
+
+public:
+	PluginPinConnectorView(PluginPinConnector* model, QWidget* parent);
+
+	auto sizeHint() const -> QSize override;
+	auto minimumSizeHint() const -> QSize override;
+
+	void toggleVisibility();
+	void closeWindow();
+
+protected:
+	void paintEvent(QPaintEvent* pe) override;
+
+private:
+	class MatrixView;
+
+	void updateGeometry();
+
+	SubWindow* m_subWindow = nullptr;
+	//QScrollArea* m_scrollArea = nullptr;
+
+	MatrixView* m_inView = nullptr;
+	MatrixView* m_outView = nullptr;
+};
+
+} // namespace gui
+
+} // namespace lmms
+
+#endif // LMMS_GUI_PLUGIN_PIN_CONNECTOR_VIEW_H