trunk/src/qsamplerChannel.h

// qsamplerChannel.h
//
/****************************************************************************
   Copyright (C) 2004-2007, rncbc aka Rui Nuno Capela. All rights reserved.

   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; if not, write to the Free Software Foundation, Inc.,
   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

*****************************************************************************/

#ifndef __qsamplerChannel_h
#define __qsamplerChannel_h

#include <QTableWidgetItem>
#include <QAbstractTableModel>
#include <QMetaType>
#include <QItemDelegate>
#include <QFontMetrics>
#include <QModelIndex>
#include <QSize>

#include <lscp/client.h>
#include <lscp/device.h>

#include "qsamplerOptions.h"

class qsamplerDevice;


// Typedef'd QMap.
typedef QMap<int, int> qsamplerChannelRoutingMap;


//-------------------------------------------------------------------------
// qsamplerChannel - Sampler channel structure.
//

class qsamplerChannel
{
public:

        // Constructor.
        qsamplerChannel(int iChannelID = -1);
        // Default destructor.
        ~qsamplerChannel();

        // Add/remove sampler channel methods.
        bool     addChannel();
        bool     removeChannel();

        // Sampler channel ID accessors.
        int      channelID() const;
        void     setChannelID(int iChannelID);

        // Readable channel name.
        QString  channelName() const;

        // Engine name property.
        const QString& engineName() const;
        bool     loadEngine(const QString& sEngineName);

        // Instrument file and index.
        const QString& instrumentFile() const;
        int      instrumentNr() const;
        const QString& instrumentName() const;
        int      instrumentStatus() const;

        // Instrument file loader.
        bool     loadInstrument(const QString& sInstrumentFile, int iInstrumentNr);
        // Special instrument file/name/number settler.
        bool     setInstrument(const QString& sInstrumentFile, int iInstrumentNr);

        // MIDI input driver (DEPRECATED).
        const QString& midiDriver() const;
        bool     setMidiDriver(const QString& sMidiDriver);

        // MIDI input device.
        int      midiDevice() const;
        bool     setMidiDevice(int iMidiDevice);

        // MIDI input port.
        int      midiPort() const;
        bool     setMidiPort(int iMidiPort);

        // MIDI input channel.
        int      midiChannel() const;
        bool     setMidiChannel(int iMidiChannel);

        // MIDI instrument map.
        int      midiMap() const;
        bool     setMidiMap(int iMidiMap);

        // Audio output driver (DEPRECATED).
        const QString& audioDriver() const;
        bool     setAudioDriver(const QString& sAudioDriver);

        // Audio output device.
        int      audioDevice() const;
        bool     setAudioDevice(int iAudioDevice);

        // Sampler channel volume.
        float    volume() const;
        bool     setVolume(float fVolume);

        // Sampler channel mute state.
        bool     channelMute() const;
        bool     setChannelMute(bool bMute);

        // Sampler channel solo state.
        bool     channelSolo() const;
        bool     setChannelSolo(bool bSolo);

        // Audio routing accessors.
        int      audioChannel(int iAudioOut) const;
        bool     setAudioChannel(int iAudioOut, int iAudioIn);
        // The audio routing map itself.
        const qsamplerChannelRoutingMap& audioRouting() const;

        // Istrument name remapper.
        void     updateInstrumentName();

        // Channel info structure map executive.
        bool     updateChannelInfo();

        // Channel setup dialog form.
        bool     channelSetup(QWidget *pParent);

        // Reset channel method.
        bool     channelReset();

        // Spawn instrument editor method.
        bool     editChannel();

        // Message logging methods (brainlessly mapped to main form's).
        void     appendMessages       (const QString & s) const;
        void     appendMessagesColor  (const QString & s, const QString & c) const;
        void     appendMessagesText   (const QString & s) const;
        void     appendMessagesError  (const QString & s) const;
        void     appendMessagesClient (const QString & s) const;

        // Context menu event handler.
        void contextMenuEvent(QContextMenuEvent *pEvent);

        // Common (invalid) name-helpers.
        static QString noEngineName();
        static QString noInstrumentName();
        static QString loadingInstrument();

        // Check whether a given file is an instrument file.
        static bool isInstrumentFile (const QString& sInstrumentFile);

        // Retrieve the available instrument name(s) of an instrument file (.gig).
        static QString getInstrumentName (const QString& sInstrumentFile,
                                                        int iInstrumentNr, bool bInstrumentNames);
        static QStringList getInstrumentList (const QString& sInstrumentFile,
                                                        bool bInstrumentNames);

private:

        // Unique channel identifier.
        int     m_iChannelID;

        // Sampler channel info map.
        QString m_sEngineName;
        QString m_sInstrumentName;
        QString m_sInstrumentFile;
        int     m_iInstrumentNr;
        int     m_iInstrumentStatus;
        QString m_sMidiDriver;
        int     m_iMidiDevice;
        int     m_iMidiPort;
        int     m_iMidiChannel;
        int     m_iMidiMap;
        QString m_sAudioDriver;
        int     m_iAudioDevice;
        float   m_fVolume;
        bool    m_bMute;
        bool    m_bSolo;

        // The audio routing mapping.
        qsamplerChannelRoutingMap m_audioRouting;
};


//-------------------------------------------------------------------------
// qsamplerChannelRoutingTable - Channel routing table widget.
//

#if 0
class qsamplerChannelRoutingTable : public QTable
{
        Q_OBJECT

public:

        // Constructor.
        qsamplerChannelRoutingTable(QWidget *pParent = 0, const char *pszName = 0);
        // Default destructor.
        ~qsamplerChannelRoutingTable();

        // Common parameter table renderer.
        void refresh(qsamplerDevice *pDevice,
                const qsamplerChannelRoutingMap& routing);

        // Commit any pending editing.
        void flush();
};
#endif

struct ChannelRoutingItem {
    QStringList options;
    int         selection;
};

// so we can use it i.e. through QVariant
Q_DECLARE_METATYPE(ChannelRoutingItem)

class ChannelRoutingModel : public QAbstractTableModel {
        Q_OBJECT
    public:
        ChannelRoutingModel(QObject* parent = 0);

        // overridden methods from subclass(es)
        int rowCount(const QModelIndex &parent) const;
        int columnCount(const QModelIndex &parent) const;
        QVariant data(const QModelIndex &index, int role) const;
        QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const;

    public slots:
        void refresh(qsamplerDevice *pDevice, const qsamplerChannelRoutingMap& routing);

    private:
        qsamplerDevice* pDevice;
        qsamplerChannelRoutingMap routing;
};

class ChannelRoutingDelegate : public QItemDelegate {
        Q_OBJECT
    public:
        ChannelRoutingDelegate(QObject* parent = 0);

        QWidget* createEditor(QWidget* parent, const QStyleOptionViewItem& option,
                              const QModelIndex& index) const;

        void setEditorData(QWidget* editor, const QModelIndex& index) const;
        void setModelData(QWidget* editor, QAbstractItemModel* model,
                          const QModelIndex& index) const;

        void updateEditorGeometry(QWidget* editor,
            const QStyleOptionViewItem& option, const QModelIndex& index) const;
};


//-------------------------------------------------------------------------
// qsamplerChannelRoutingComboBox - Custom combo box for routing table.
//

/*
class qsamplerChannelRoutingComboBox : public QTableWidgetItem
{
public:

        // Constructor.
        qsamplerChannelRoutingComboBox(QTableWidget *pTable,
                const QStringList& list, const QPixmap& pixmap);

        // Public accessors.
        void setCurrentItem(int iCurrentItem);
        int currentItem() const;

protected:

        // Virtual implemetations.
        QWidget *createEditor() const;
        void setContentFromEditor(QWidget *pWidget);

private:

        // Initial value holders
        QStringList m_list;
        int m_iCurrentItem;
};
*/

#endif  // __qsamplerChannel_h


// end of qsamplerChannel.h
1	// qsamplerChannel.h
2	//
3	/****************************************************************************
4	Copyright (C) 2004-2007, rncbc aka Rui Nuno Capela. All rights reserved.
5
6	This program is free software; you can redistribute it and/or
7	modify it under the terms of the GNU General Public License
8	as published by the Free Software Foundation; either version 2
9	of the License, or (at your option) any later version.
10
11	This program is distributed in the hope that it will be useful,
12	but WITHOUT ANY WARRANTY; without even the implied warranty of
13	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14	GNU General Public License for more details.
15
16	You should have received a copy of the GNU General Public License along
17	with this program; if not, write to the Free Software Foundation, Inc.,
18	51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
19
20	*****************************************************************************/
21
22	#ifndef __qsamplerChannel_h
23	#define __qsamplerChannel_h
24
25	#include <QTableWidgetItem>
26	#include <QAbstractTableModel>
27	#include <QMetaType>
28	#include <QItemDelegate>
29	#include <QFontMetrics>
30	#include <QModelIndex>
31	#include <QSize>
32
33	#include <lscp/client.h>
34	#include <lscp/device.h>
35
36	#include "qsamplerOptions.h"
37
38	class qsamplerDevice;
39
40
41	// Typedef'd QMap.
42	typedef QMap<int, int> qsamplerChannelRoutingMap;
43
44
45	//-------------------------------------------------------------------------
46	// qsamplerChannel - Sampler channel structure.
47	//
48
49	class qsamplerChannel
50	{
51	public:
52
53	// Constructor.
54	qsamplerChannel(int iChannelID = -1);
55	// Default destructor.
56	~qsamplerChannel();
57
58	// Add/remove sampler channel methods.
59	bool addChannel();
60	bool removeChannel();
61
62	// Sampler channel ID accessors.
63	int channelID() const;
64	void setChannelID(int iChannelID);
65
66	// Readable channel name.
67	QString channelName() const;
68
69	// Engine name property.
70	const QString& engineName() const;
71	bool loadEngine(const QString& sEngineName);
72
73	// Instrument file and index.
74	const QString& instrumentFile() const;
75	int instrumentNr() const;
76	const QString& instrumentName() const;
77	int instrumentStatus() const;
78
79	// Instrument file loader.
80	bool loadInstrument(const QString& sInstrumentFile, int iInstrumentNr);
81	// Special instrument file/name/number settler.
82	bool setInstrument(const QString& sInstrumentFile, int iInstrumentNr);
83
84	// MIDI input driver (DEPRECATED).
85	const QString& midiDriver() const;
86	bool setMidiDriver(const QString& sMidiDriver);
87
88	// MIDI input device.
89	int midiDevice() const;
90	bool setMidiDevice(int iMidiDevice);
91
92	// MIDI input port.
93	int midiPort() const;
94	bool setMidiPort(int iMidiPort);
95
96	// MIDI input channel.
97	int midiChannel() const;
98	bool setMidiChannel(int iMidiChannel);
99
100	// MIDI instrument map.
101	int midiMap() const;
102	bool setMidiMap(int iMidiMap);
103
104	// Audio output driver (DEPRECATED).
105	const QString& audioDriver() const;
106	bool setAudioDriver(const QString& sAudioDriver);
107
108	// Audio output device.
109	int audioDevice() const;
110	bool setAudioDevice(int iAudioDevice);
111
112	// Sampler channel volume.
113	float volume() const;
114	bool setVolume(float fVolume);
115
116	// Sampler channel mute state.
117	bool channelMute() const;
118	bool setChannelMute(bool bMute);
119
120	// Sampler channel solo state.
121	bool channelSolo() const;
122	bool setChannelSolo(bool bSolo);
123
124	// Audio routing accessors.
125	int audioChannel(int iAudioOut) const;
126	bool setAudioChannel(int iAudioOut, int iAudioIn);
127	// The audio routing map itself.
128	const qsamplerChannelRoutingMap& audioRouting() const;
129
130	// Istrument name remapper.
131	void updateInstrumentName();
132
133	// Channel info structure map executive.
134	bool updateChannelInfo();
135
136	// Channel setup dialog form.
137	bool channelSetup(QWidget *pParent);
138
139	// Reset channel method.
140	bool channelReset();
141
142	// Spawn instrument editor method.
143	bool editChannel();
144
145	// Message logging methods (brainlessly mapped to main form's).
146	void appendMessages (const QString & s) const;
147	void appendMessagesColor (const QString & s, const QString & c) const;
148	void appendMessagesText (const QString & s) const;
149	void appendMessagesError (const QString & s) const;
150	void appendMessagesClient (const QString & s) const;
151
152	// Context menu event handler.
153	void contextMenuEvent(QContextMenuEvent *pEvent);
154
155	// Common (invalid) name-helpers.
156	static QString noEngineName();
157	static QString noInstrumentName();
158	static QString loadingInstrument();
159
160	// Check whether a given file is an instrument file.
161	static bool isInstrumentFile (const QString& sInstrumentFile);
162
163	// Retrieve the available instrument name(s) of an instrument file (.gig).
164	static QString getInstrumentName (const QString& sInstrumentFile,
165	int iInstrumentNr, bool bInstrumentNames);
166	static QStringList getInstrumentList (const QString& sInstrumentFile,
167	bool bInstrumentNames);
168
169	private:
170
171	// Unique channel identifier.
172	int m_iChannelID;
173
174	// Sampler channel info map.
175	QString m_sEngineName;
176	QString m_sInstrumentName;
177	QString m_sInstrumentFile;
178	int m_iInstrumentNr;
179	int m_iInstrumentStatus;
180	QString m_sMidiDriver;
181	int m_iMidiDevice;
182	int m_iMidiPort;
183	int m_iMidiChannel;
184	int m_iMidiMap;
185	QString m_sAudioDriver;
186	int m_iAudioDevice;
187	float m_fVolume;
188	bool m_bMute;
189	bool m_bSolo;
190
191	// The audio routing mapping.
192	qsamplerChannelRoutingMap m_audioRouting;
193	};
194
195
196	//-------------------------------------------------------------------------
197	// qsamplerChannelRoutingTable - Channel routing table widget.
198	//
199
200	#if 0
201	class qsamplerChannelRoutingTable : public QTable
202	{
203	Q_OBJECT
204
205	public:
206
207	// Constructor.
208	qsamplerChannelRoutingTable(QWidget pParent = 0, const char pszName = 0);
209	// Default destructor.
210	~qsamplerChannelRoutingTable();
211
212	// Common parameter table renderer.
213	void refresh(qsamplerDevice *pDevice,
214	const qsamplerChannelRoutingMap& routing);
215
216	// Commit any pending editing.
217	void flush();
218	};
219	#endif
220
221	struct ChannelRoutingItem {
222	QStringList options;
223	int selection;
224	};
225
226	// so we can use it i.e. through QVariant
227	Q_DECLARE_METATYPE(ChannelRoutingItem)
228
229	class ChannelRoutingModel : public QAbstractTableModel {
230	Q_OBJECT
231	public:
232	ChannelRoutingModel(QObject* parent = 0);
233
234	// overridden methods from subclass(es)
235	int rowCount(const QModelIndex &parent) const;
236	int columnCount(const QModelIndex &parent) const;
237	QVariant data(const QModelIndex &index, int role) const;
238	QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const;
239
240	public slots:
241	void refresh(qsamplerDevice *pDevice, const qsamplerChannelRoutingMap& routing);
242
243	private:
244	qsamplerDevice* pDevice;
245	qsamplerChannelRoutingMap routing;
246	};
247
248	class ChannelRoutingDelegate : public QItemDelegate {
249	Q_OBJECT
250	public:
251	ChannelRoutingDelegate(QObject* parent = 0);
252
253	QWidget* createEditor(QWidget* parent, const QStyleOptionViewItem& option,
254	const QModelIndex& index) const;
255
256	void setEditorData(QWidget* editor, const QModelIndex& index) const;
257	void setModelData(QWidget* editor, QAbstractItemModel* model,
258	const QModelIndex& index) const;
259
260	void updateEditorGeometry(QWidget* editor,
261	const QStyleOptionViewItem& option, const QModelIndex& index) const;
262	};
263
264
265	//-------------------------------------------------------------------------
266	// qsamplerChannelRoutingComboBox - Custom combo box for routing table.
267	//
268
269	/*
270	class qsamplerChannelRoutingComboBox : public QTableWidgetItem
271	{
272	public:
273
274	// Constructor.
275	qsamplerChannelRoutingComboBox(QTableWidget *pTable,
276	const QStringList& list, const QPixmap& pixmap);
277
278	// Public accessors.
279	void setCurrentItem(int iCurrentItem);
280	int currentItem() const;
281
282	protected:
283
284	// Virtual implemetations.
285	QWidget *createEditor() const;
286	void setContentFromEditor(QWidget *pWidget);
287
288	private:
289
290	// Initial value holders
291	QStringList m_list;
292	int m_iCurrentItem;
293	};
294	*/
295
296	#endif // __qsamplerChannel_h
297
298
299	// end of qsamplerChannel.h