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	capela	264	// qsamplerChannel.h
2			//
3			/****************************************************************************
4	capela	341	Copyright (C) 2003-2005, rncbc aka Rui Nuno Capela. All rights reserved.
5	capela	264
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	capela	295
54			// Add/remove sampler channel methods.
55			bool addChannel();
56			bool removeChannel();
57
58	capela	264	// Sampler channel ID accessors.
59			int channelID();
60			void setChannelID(int iChannelID);
61
62	capela	295	// Readable channel name.
63			QString channelName();
64
65	capela	264	// 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	capela	382	QString& instrumentName();
73	capela	264	int instrumentStatus();
74			bool loadInstrument(const QString& sInstrumentFile, int iInstrumentNr);
75	capela	388	// Special instrument file/name/number settler.
76			bool setInstrument(const QString& sInstrumentFile, int iInstrumentNr);
77	capela	344
78	capela	264	// 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	capela	371	// Istrument name remapper.
107			void updateInstrumentName();
108
109	capela	264	// Channel info structure map executive.
110	capela	303	bool updateChannelInfo();
111	capela	264
112			// Reset channel method.
113	capela	303	bool resetChannel();
114	capela	264
115	capela	303	// Channel setup dialog form.
116			bool channelSetup(QWidget *pParent);
117
118	capela	264	// Message logging methods (brainlessly mapped to main form's).
119	capela	303	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	capela	264
125	capela	303	// Context menu event handler.
126			void contextMenuEvent(QContextMenuEvent *pEvent);
127
128	capela	388	// 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	capela	299	// Retrieve the available instrument name(s) of an instrument file (.gig).
136	capela	388	static QString getInstrumentName (const QString& sInstrumentFile,
137	capela	344	int iInstrumentNr, bool bInstrumentNames);
138			static QStringList getInstrumentList (const QString& sInstrumentFile,
139			bool bInstrumentNames);
140	capela	299
141	capela	264	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	capela	344	QString m_sInstrumentName;
152	capela	264	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