trunk/src/qsamplerChannel.h

// qsamplerChannel.h
//
/****************************************************************************
   Copyright (C) 2003-2005, 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

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

#ifndef __qsamplerChannel_h
#define __qsamplerChannel_h

#include <qobject.h>

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

#include "qsamplerOptions.h"

class qsamplerMainForm;


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

class qsamplerChannel
{
public:

    // Constructor.
    qsamplerChannel(qsamplerMainForm *pMainForm, int iChannelID = -1);
    // Default destructor.
    ~qsamplerChannel();

    // Main application options accessor.
    qsamplerOptions *options();

    // LSCP client descriptor accessor.
    lscp_client_t * client();

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

    // Sampler channel ID accessors.
    int      channelID();
    void     setChannelID(int iChannelID);
    
    // Readable channel name.
    QString  channelName();

    // Engine name property.
    QString& engineName();
    bool     loadEngine(const QString& sEngineName);
    
    // Instrument file and index.
    QString& instrumentFile();
    int      instrumentNr();
    QString& instrumentName();
    int      instrumentStatus();
    bool     loadInstrument(const QString& sInstrumentFile, int iInstrumentNr);
        // Special instrument file/name/number settler.
    bool     setInstrument(const QString& sInstrumentFile, int iInstrumentNr);

    // MIDI input driver (DEPRECATED).
    QString& midiDriver();
    bool     setMidiDriver(const QString& sMidiDriver);
    
    // MIDI input device.
    int      midiDevice();
    bool     setMidiDevice(int iMidiDevice);
    
    // MIDI input port.
    int      midiPort();
    bool     setMidiPort(int iMidiPort);
    
    // MIDI input channel.
    int      midiChannel();
    bool     setMidiChannel(int iMidiChannel);
    
    // Audio output driver (DEPRECATED).
    QString& audioDriver();
    bool     setAudioDriver(const QString& sAudioDriver);

    // Audio output device.
    int      audioDevice();
    bool     setAudioDevice(int iAudioDevice);
    
    // Sampler channel volume.
    float    volume();
    bool     setVolume(float fVolume);

    // Istrument name remapper.
    void     updateInstrumentName();

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

    // Reset channel method.
    bool     resetChannel();

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

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

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

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

        // 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:

    // Main application form reference.
    qsamplerMainForm *m_pMainForm;

    // 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;          // DEPRECATED.
    int     m_iMidiDevice;
    int     m_iMidiPort;
    int     m_iMidiChannel;
    QString m_sAudioDriver;         // DEPRECATED.
    int     m_iAudioDevice;
    float   m_fVolume;
};

#endif  // __qsamplerChannel_h


// end of qsamplerChannel.h
1	// qsamplerChannel.h
2	//
3	/****************************************************************************
4	Copyright (C) 2003-2005, 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
17	along with this program; if not, write to the Free Software
18	Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
19
20	*****************************************************************************/
21
22	#ifndef __qsamplerChannel_h
23	#define __qsamplerChannel_h
24
25	#include <qobject.h>
26
27	#include <lscp/client.h>
28	#include <lscp/device.h>
29
30	#include "qsamplerOptions.h"
31
32	class qsamplerMainForm;
33
34
35	//-------------------------------------------------------------------------
36	// qsamplerChannel - Sampler channel structure.
37	//
38
39	class qsamplerChannel
40	{
41	public:
42
43	// Constructor.
44	qsamplerChannel(qsamplerMainForm *pMainForm, int iChannelID = -1);
45	// Default destructor.
46	~qsamplerChannel();
47
48	// Main application options accessor.
49	qsamplerOptions *options();
50
51	// LSCP client descriptor accessor.
52	lscp_client_t * client();
53
54	// Add/remove sampler channel methods.
55	bool addChannel();
56	bool removeChannel();
57
58	// Sampler channel ID accessors.
59	int channelID();
60	void setChannelID(int iChannelID);
61
62	// Readable channel name.
63	QString channelName();
64
65	// Engine name property.
66	QString& engineName();
67	bool loadEngine(const QString& sEngineName);
68
69	// Instrument file and index.
70	QString& instrumentFile();
71	int instrumentNr();
72	QString& instrumentName();
73	int instrumentStatus();
74	bool loadInstrument(const QString& sInstrumentFile, int iInstrumentNr);
75	// Special instrument file/name/number settler.
76	bool setInstrument(const QString& sInstrumentFile, int iInstrumentNr);
77
78	// MIDI input driver (DEPRECATED).
79	QString& midiDriver();
80	bool setMidiDriver(const QString& sMidiDriver);
81
82	// MIDI input device.
83	int midiDevice();
84	bool setMidiDevice(int iMidiDevice);
85
86	// MIDI input port.
87	int midiPort();
88	bool setMidiPort(int iMidiPort);
89
90	// MIDI input channel.
91	int midiChannel();
92	bool setMidiChannel(int iMidiChannel);
93
94	// Audio output driver (DEPRECATED).
95	QString& audioDriver();
96	bool setAudioDriver(const QString& sAudioDriver);
97
98	// Audio output device.
99	int audioDevice();
100	bool setAudioDevice(int iAudioDevice);
101
102	// Sampler channel volume.
103	float volume();
104	bool setVolume(float fVolume);
105
106	// Istrument name remapper.
107	void updateInstrumentName();
108
109	// Channel info structure map executive.
110	bool updateChannelInfo();
111
112	// Reset channel method.
113	bool resetChannel();
114
115	// Channel setup dialog form.
116	bool channelSetup(QWidget *pParent);
117
118	// Message logging methods (brainlessly mapped to main form's).
119	void appendMessages (const QString & s);
120	void appendMessagesColor (const QString & s, const QString & c);
121	void appendMessagesText (const QString & s);
122	void appendMessagesError (const QString & s);
123	void appendMessagesClient (const QString & s);
124
125	// Context menu event handler.
126	void contextMenuEvent(QContextMenuEvent *pEvent);
127
128	// Common (invalid) name-helpers.
129	static QString noEngineName();
130	static QString noInstrumentName();
131
132	// Check whether a given file is an instrument file.
133	static bool isInstrumentFile (const QString& sInstrumentFile);
134
135	// Retrieve the available instrument name(s) of an instrument file (.gig).
136	static QString getInstrumentName (const QString& sInstrumentFile,
137	int iInstrumentNr, bool bInstrumentNames);
138	static QStringList getInstrumentList (const QString& sInstrumentFile,
139	bool bInstrumentNames);
140
141	private:
142
143	// Main application form reference.
144	qsamplerMainForm *m_pMainForm;
145
146	// Unique channel identifier.
147	int m_iChannelID;
148
149	// Sampler channel info map.
150	QString m_sEngineName;
151	QString m_sInstrumentName;
152	QString m_sInstrumentFile;
153	int m_iInstrumentNr;
154	int m_iInstrumentStatus;
155	QString m_sMidiDriver; // DEPRECATED.
156	int m_iMidiDevice;
157	int m_iMidiPort;
158	int m_iMidiChannel;
159	QString m_sAudioDriver; // DEPRECATED.
160	int m_iAudioDevice;
161	float m_fVolume;
162	};
163
164	#endif // __qsamplerChannel_h
165
166
167	// end of qsamplerChannel.h