/[svn]/linuxsampler/trunk/src/engines/EngineChannel.h
ViewVC logotype

Annotation of /linuxsampler/trunk/src/engines/EngineChannel.h

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1789 - (hide annotations) (download) (as text)
Sat Nov 1 19:01:27 2008 UTC (15 years, 5 months ago) by iliev
File MIME type: text/x-c++hdr
File size: 14010 byte(s)
* notification events for stream/voice count statistics are now sent
  only when there are actual changes
* use atomic_t for stream/voice count statistics

1 schoenebeck 889 /***************************************************************************
2     * *
3 schoenebeck 1686 * Copyright (C) 2005 - 2008 Christian Schoenebeck *
4 schoenebeck 889 * *
5     * This program is free software; you can redistribute it and/or modify *
6     * it under the terms of the GNU General Public License as published by *
7     * the Free Software Foundation; either version 2 of the License, or *
8     * (at your option) any later version. *
9     * *
10     * This program is distributed in the hope that it will be useful, *
11     * but WITHOUT ANY WARRANTY; without even the implied warranty of *
12     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
13     * GNU General Public License for more details. *
14     * *
15     * You should have received a copy of the GNU General Public License *
16     * along with this program; if not, write to the Free Software *
17     * Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
18     * MA 02111-1307 USA *
19     ***************************************************************************/
20    
21     #ifndef __LS_ENGINECHANNEL_H__
22     #define __LS_ENGINECHANNEL_H__
23    
24 iliev 1130 #include "../EventListeners.h"
25 iliev 1789 #include "../common/atomic.h"
26 schoenebeck 889 #include "../drivers/audio/AudioOutputDevice.h"
27     #include "../drivers/midi/midi.h"
28     #include "../drivers/midi/MidiInputDevice.h"
29     #include "../drivers/midi/MidiInputPort.h"
30 schoenebeck 1686 #include "../drivers/midi/VirtualMidiDevice.h"
31 schoenebeck 889 #include "Engine.h"
32 schoenebeck 1001 #include "FxSend.h"
33 schoenebeck 889
34     namespace LinuxSampler {
35    
36     // just symbol prototyping
37 iliev 1761 class Sampler;
38     class SamplerChannel;
39 schoenebeck 889 class AudioOutputDevice;
40     class MidiInputPort;
41 schoenebeck 1001 class FxSend;
42 schoenebeck 889
43 schoenebeck 1001
44 schoenebeck 889 /** @brief Channel Interface for LinuxSampler Sampler Engines
45     *
46     * Every sampler engine can be used on several sampler channels and
47     * usually the same Engine instance is used on multiple sampler
48     * channels. For this every sampler engine must also implement a class
49     * which handles all channel dependant parameters and channel
50     * dependant execution code.
51     *
52     * This abstract base interface class defines all mandatory methods
53     * which have to be implemented by all engine channel implementations.
54     */
55     class EngineChannel {
56     public:
57    
58     /////////////////////////////////////////////////////////////////
59     // abstract methods
60     // (these have to be implemented by the descendant)
61    
62     virtual void PrepareLoadInstrument(const char* FileName, uint Instrument) = 0;
63     virtual void LoadInstrument() = 0;
64     virtual void Reset() = 0;
65     virtual void SendNoteOn(uint8_t Key, uint8_t Velocity) = 0;
66 schoenebeck 906 virtual void SendNoteOn(uint8_t Key, uint8_t Velocity, int32_t FragmentPos) = 0;
67 schoenebeck 889 virtual void SendNoteOff(uint8_t Key, uint8_t Velocity) = 0;
68 schoenebeck 906 virtual void SendNoteOff(uint8_t Key, uint8_t Velocity, int32_t FragmentPos) = 0;
69 schoenebeck 889 virtual void SendPitchbend(int Pitch) = 0;
70 schoenebeck 906 virtual void SendPitchbend(int Pitch, int32_t FragmentPos) = 0;
71 schoenebeck 889 virtual void SendControlChange(uint8_t Controller, uint8_t Value) = 0;
72 schoenebeck 906 virtual void SendControlChange(uint8_t Controller, uint8_t Value, int32_t FragmentPos) = 0;
73 schoenebeck 889 virtual bool StatusChanged(bool bNewStatus = false) = 0;
74     virtual float Volume() = 0;
75     virtual void Volume(float f) = 0;
76 schoenebeck 1723 virtual float Pan() = 0;
77     virtual void Pan(float f) = 0;
78 schoenebeck 889 virtual uint Channels() = 0;
79     virtual void Connect(AudioOutputDevice* pAudioOut) = 0;
80     virtual void DisconnectAudioOutputDevice() = 0;
81 schoenebeck 1001 virtual AudioOutputDevice* GetAudioOutputDevice() = 0;
82 schoenebeck 889 virtual void SetOutputChannel(uint EngineAudioChannel, uint AudioDeviceChannel) = 0;
83     virtual int OutputChannel(uint EngineAudioChannel) = 0;
84     virtual void Connect(MidiInputPort* pMidiPort, midi_chan_t MidiChannel) = 0;
85     virtual void DisconnectMidiInputPort() = 0;
86     virtual MidiInputPort* GetMidiInputPort() = 0;
87     virtual midi_chan_t MidiChannel() = 0;
88     virtual String InstrumentFileName() = 0;
89     virtual String InstrumentName() = 0;
90     virtual int InstrumentIndex() = 0;
91     virtual int InstrumentStatus() = 0;
92     virtual Engine* GetEngine() = 0;
93     virtual String EngineName() = 0;
94 schoenebeck 1001 virtual FxSend* AddFxSend(uint8_t MidiCtrl, String Name = "") throw (Exception) = 0;
95     virtual FxSend* GetFxSend(uint FxSendIndex) = 0;
96     virtual uint GetFxSendCount() = 0;
97     virtual void RemoveFxSend(FxSend* pFxSend) = 0;
98 schoenebeck 1686 virtual void Connect(VirtualMidiDevice* pDevice) = 0;
99     virtual void Disconnect(VirtualMidiDevice* pDevice) = 0;
100 schoenebeck 889
101 schoenebeck 1001
102     /////////////////////////////////////////////////////////////////
103     // normal methods
104     // (usually not to be overridden by descendant)
105    
106 schoenebeck 889 /**
107     * Sets the mute state of this channel.
108     *
109     * @param state - specifies the mute state of this sampler channel.
110     * @throws Exception - if state does not contain valid
111     * value.
112     */
113     void SetMute(int state) throw (Exception);
114    
115     /**
116     * Determines whether this channel is muted.
117     *
118     * @returns 1 if the channel is muted, 0 if the channel is not muted
119     * and -1 if the channel is muted because of presence of at least
120     * one solo channel.
121     */
122     int GetMute();
123    
124     /**
125     * Sets the solo state of this channel.
126     *
127     * @param solo - specifies whether this is a solo channel.
128     */
129     void SetSolo(bool solo);
130    
131     /**
132     * Determines whether this is a solo channel.
133     *
134     * @returns true if this is a solo channel, false otherwise.
135     */
136     bool GetSolo();
137    
138 schoenebeck 947 /**
139     * Returns current MIDI program (change) number of this
140     * EngineChannel.
141     */
142     uint8_t GetMidiProgram();
143    
144     /**
145     * Change EngineChannel's MIDI program.
146     */
147     void SetMidiProgram(uint8_t Program);
148    
149     /**
150     * Returns current MIDI bank MSB (coarse) number of this
151     * EngineChannel.
152     */
153     uint8_t GetMidiBankMsb();
154    
155     /**
156     * Change current MIDI bank MSB (coarse) number of this
157     * EngineChannel.
158     */
159     void SetMidiBankMsb(uint8_t BankMSB);
160    
161     /**
162     * Returns current MIDI bank LSB (fine) number of this
163     * EngineChannel.
164     */
165     uint8_t GetMidiBankLsb();
166    
167     /**
168     * Change current MIDI bank LSB (fine) number of this
169     * EngineChannel.
170     */
171     void SetMidiBankLsb(uint8_t BankLSB);
172    
173 schoenebeck 973 /**
174     * Returns true if this EngineChannel is using no MIDI
175     * instrument map at all, that is if it will ignore all MIDI
176     * program change messages.
177     *
178     * @see UsesDefaultMidiInstrumentMap()
179     * @see GetMidiInstrumentMap()
180     */
181     bool UsesNoMidiInstrumentMap();
182    
183     /**
184     * Returns true if this EngineChannel is using the default MIDI
185     * instrument map for handling MIDI program changes.
186     *
187     * @see UsesNoMidiInstrumentMap()
188     * @see GetMidiInstrumentMap()
189     */
190     bool UsesDefaultMidiInstrumentMap();
191    
192     /**
193     * Returns ID of the MIDI instrument map currently used by this
194     * EngineChannel to handle MIDI program changes. You should
195     * always call @c UsesNoMidiInstrumentMap() and
196     * @c UsesDefaultMidiInstrumentMap() before calling this method
197     * to check if this EngineChannel is probably using the default
198     * map or no map at all, because in these two particular cases
199     * this method would throw an exception!
200     *
201     * @throws Exception - if EngineChannel is set to no map at all
202     * or is set to the default map
203     * @see UsesNoMidiInstrumentMap()
204     * @see UsesDefaultMidiInstrumentMap()
205     */
206     int GetMidiInstrumentMap() throw (Exception);
207    
208     /**
209     * Let this EngineChannel use no MIDI instrument map at all,
210     * that is to let it ignore all MIDI program change messages.
211     *
212     * @see SetMidiInstrumentMapToDefault()
213     * @see SetMidiInstrumentMap()
214     */
215     void SetMidiInstrumentMapToNone();
216    
217     /**
218     * Let this EngineChannel use the default MIDI instrument map to
219     * handle MIDI program changes.
220     *
221     * @see SetMidiInstrumentMapToNone()
222     * @see SetMidiInstrumentMap()
223     */
224     void SetMidiInstrumentMapToDefault();
225    
226     /**
227     * Set a specific MIDI instrument map this EngineChannel should
228     * use to handle MIDI program changes.
229     *
230     * @see SetMidiInstrumentMapToNone()
231     * @see SetMidiInstrumentMapToDefault()
232     *
233     * @throws Exception - in case given map does not exist
234     */
235     void SetMidiInstrumentMap(int MidiMap) throw (Exception);
236    
237 schoenebeck 1041 /**
238     * Set MIDI Registered Parameter Number (RPN) Controller
239     * (upper 8 bits / coarse).
240     */
241     void SetMidiRpnControllerMsb(uint8_t CtrlMSB);
242    
243     /**
244     * Set MIDI Registered Parameter Number (RPN) Controller
245     * (lower 8 bits / fine).
246     */
247     void SetMidiRpnControllerLsb(uint8_t CtrlLSB);
248    
249     /**
250 schoenebeck 1044 * Reset to no RPN controller currently selected.
251     */
252     void ResetMidiRpnController();
253 iliev 1130
254     /**
255     * Registers the specified listener to be notified when the number
256     * of effect sends on this channel is changed.
257     */
258     void AddFxSendCountListener(FxSendCountListener* l);
259 schoenebeck 1044
260     /**
261 iliev 1130 * Removes the specified listener.
262     */
263     void RemoveFxSendCountListener(FxSendCountListener* l);
264    
265     /**
266     * Removes all listeners.
267     */
268     void RemoveAllFxSendCountListeners();
269    
270     /**
271 schoenebeck 1041 * Get currently selected MIDI Registered Parameter Number
272     * (RPN) Controller, this method will return the already merged
273     * value (MSB and LSB value).
274 schoenebeck 1044 *
275     * @e WARNING: you have to call @c ResetMidiRpnController()
276     * after using this value, otherwise all subsequent MIDI CC #6
277     * (Data) messages are interpreted as RPN controller value
278     * messages.
279     *
280     * @returns currently selected RPN controller number, a negative
281     * value if no RPN controller currently selected
282 schoenebeck 1041 */
283     int GetMidiRpnController();
284    
285 iliev 1297 /**
286     * Gets the current number of active voices.
287     */
288     uint GetVoiceCount();
289    
290     /**
291     * Sets the current number of active voices.
292     */
293     void SetVoiceCount(uint Voices);
294    
295     /**
296     * Gets the current number of active disk streams.
297     */
298     uint GetDiskStreamCount();
299    
300     /**
301     * Sets the current number of active disk streams.
302     */
303     void SetDiskStreamCount(uint Streams);
304    
305 iliev 1761 SamplerChannel* GetSamplerChannel();
306    
307     void SetSamplerChannel(SamplerChannel* pChannel);
308 schoenebeck 889
309 iliev 1761 /** Returns the sampler to which this channel belongs */
310     Sampler* GetSampler();
311    
312 schoenebeck 889 protected:
313 schoenebeck 906 EngineChannel();
314 schoenebeck 889 virtual ~EngineChannel() {}; // MUST only be destroyed by EngineChannelFactory
315 iliev 1130
316     /**
317     * Notifies listeners that the number of effect sends
318     * on a this channel is changed.
319     * @param ChannelId The numerical ID of the sampler channel.
320     * @param NewCount The new number of sampler channels.
321     */
322     void fireFxSendCountChanged(int ChannelId, int NewCount);
323    
324 schoenebeck 889 friend class EngineChannelFactory;
325    
326     private:
327 schoenebeck 947 int iMute;
328     bool bSolo;
329     uint8_t uiMidiProgram;
330     uint8_t uiMidiBankMsb;
331     uint8_t uiMidiBankLsb;
332 schoenebeck 1041 uint8_t uiMidiRpnMsb; ///< MIDI Registered Parameter Number (upper 8 bits / coarse)
333     uint8_t uiMidiRpnLsb; ///< MIDI Registered Parameter Number (lower 8 bits / fine)
334 schoenebeck 973 bool bMidiBankMsbReceived;
335     bool bMidiBankLsbReceived;
336     bool bProgramChangeReceived;
337 schoenebeck 1044 bool bMidiRpnReceived;
338 schoenebeck 973 int iMidiInstrumentMap;
339 iliev 1789 atomic_t voiceCount;
340     atomic_t diskStreamCount;
341 iliev 1761 SamplerChannel* pSamplerChannel;
342 iliev 1130 ListenerList<FxSendCountListener*> llFxSendCountListeners;
343 schoenebeck 889 };
344    
345     } // namespace LinuxSampler
346    
347     #endif // __LS_ENGINECHANNEL_H__

  ViewVC Help
Powered by ViewVC