src/engines/AbstractEngineChannel.h

/***************************************************************************
 *                                                                         *
 *   LinuxSampler - modular, streaming capable sampler                     *
 *                                                                         *
 *   Copyright (C) 2003,2004 by Benno Senoner and Christian Schoenebeck    *
 *   Copyright (C) 2005-2008 Christian Schoenebeck                         *
 *   Copyright (C) 2009-2012 Christian Schoenebeck and Grigor Iliev        *
 *   Copyright (C) 2013-2014 Christian Schoenebeck and Andreas Persson     *
 *                                                                         *
 *   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 __LS_ABSTRACTENGINECHANNEL_H__
#define __LS_ABSTRACTENGINECHANNEL_H__

#include "EngineChannel.h"
#include "AbstractEngine.h"

#include "../common/Pool.h"
#include "../common/RingBuffer.h"

#define CTRL_TABLE_IDX_AFTERTOUCH   128
#define CTRL_TABLE_IDX_PITCHBEND    129

namespace LinuxSampler {

    class AbstractEngineChannel: public EngineChannel, public AbstractEngine::ScriptConsumer {
        public:
            // implementation of abstract methods derived from interface class 'LinuxSampler::EngineChannel'
            virtual void    PrepareLoadInstrument(const char* FileName, uint Instrument) OVERRIDE;
            virtual void    Reset() OVERRIDE;
            virtual void    SendNoteOn(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel) OVERRIDE;
            virtual void    SendNoteOn(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
            virtual void    SendNoteOff(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel) OVERRIDE;
            virtual void    SendNoteOff(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
            virtual void    SendPitchbend(int Pitch, uint8_t MidiChannel) OVERRIDE;
            virtual void    SendPitchbend(int Pitch, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
            virtual void    SendControlChange(uint8_t Controller, uint8_t Value, uint8_t MidiChannel) OVERRIDE;
            virtual void    SendControlChange(uint8_t Controller, uint8_t Value, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;            
            virtual void    SendChannelPressure(uint8_t Value, uint8_t MidiChannel) OVERRIDE;
            virtual void    SendChannelPressure(uint8_t Value, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
            virtual void    SendPolyphonicKeyPressure(uint8_t Key, uint8_t Value, uint8_t MidiChannel) OVERRIDE;
            virtual void    SendPolyphonicKeyPressure(uint8_t Key, uint8_t Value, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
            virtual bool    StatusChanged(bool bNewStatus = false) OVERRIDE;
            virtual float   Volume() OVERRIDE;
            virtual void    Volume(float f) OVERRIDE;
            virtual float   Pan() OVERRIDE;
            virtual void    Pan(float f) OVERRIDE;
            virtual uint    Channels() OVERRIDE;
            virtual AudioOutputDevice* GetAudioOutputDevice() OVERRIDE;
            virtual void    SetOutputChannel(uint EngineAudioChannel, uint AudioDeviceChannel) OVERRIDE;
            virtual int     OutputChannel(uint EngineAudioChannel) OVERRIDE;
            virtual void    Connect(MidiInputPort* pMidiPort) OVERRIDE;
            virtual void    Disconnect(MidiInputPort* pMidiPort) OVERRIDE;
            virtual void    DisconnectAllMidiInputPorts() OVERRIDE;
            virtual uint    GetMidiInputPortCount() OVERRIDE;
            virtual MidiInputPort* GetMidiInputPort(uint index) OVERRIDE;
            virtual midi_chan_t MidiChannel() OVERRIDE;
            virtual void    SetMidiChannel(midi_chan_t MidiChannel) OVERRIDE;
            virtual void    Connect(MidiInputPort* pMidiPort, midi_chan_t MidiChannel) OVERRIDE; // deprecated, may be removed
            virtual void    DisconnectMidiInputPort() OVERRIDE; // deprecated, may be removed
            virtual MidiInputPort* GetMidiInputPort() OVERRIDE; // deprecated, may be removed
            virtual String  InstrumentFileName() OVERRIDE;
            virtual String  InstrumentName() OVERRIDE;
            virtual int     InstrumentIndex() OVERRIDE;
            virtual int     InstrumentStatus() OVERRIDE;
            virtual Engine* GetEngine() OVERRIDE;
            virtual String  EngineName() OVERRIDE;
            virtual FxSend* AddFxSend(uint8_t MidiCtrl, String Name = "") throw (Exception) OVERRIDE;
            virtual FxSend* GetFxSend(uint FxSendIndex) OVERRIDE;
            virtual uint    GetFxSendCount() OVERRIDE;
            virtual void    RemoveFxSend(FxSend* pFxSend) OVERRIDE;
            virtual void    Connect(VirtualMidiDevice* pDevice) OVERRIDE;
            virtual void    Disconnect(VirtualMidiDevice* pDevice) OVERRIDE;

            // implementation of abstract methods derived from AbstractEngine::ScriptConsumer
            virtual void ResourceToBeUpdated(VMParserContext* pResource, void*& pUpdateArg) OVERRIDE {}
            virtual void ResourceUpdated(VMParserContext* pOldResource, VMParserContext* pNewResource, void* pUpdateArg) OVERRIDE {}
            virtual void OnResourceProgress(float fProgress) OVERRIDE {}

            virtual AbstractEngine::Format GetEngineFormat() = 0;

            AudioOutputDevice* GetAudioOutputDeviceSafe();
            void loadInstrumentScript(const String& text);
            void unloadCurrentInstrumentScript();

            friend class AbstractVoice;
            friend class AbstractEngine;
            template<class TV, class TRR, class TR, class TD, class TIM, class TI> friend class EngineBase;
            template<class EC, class R, class S, class D> friend class VoiceBase;

        //protected:
            AbstractEngineChannel();
            virtual ~AbstractEngineChannel();

            AbstractEngine*           pEngine;
            Mutex                     EngineMutex; ///< protects the Engine from access by the instrument loader thread when lscp is disconnecting
            Mutex                     MidiInputMutex; ///< Introduced when support for multiple MIDI inputs per engine channel was added: protects the MIDI event input ringbuffer on this engine channel to be accessed concurrently by multiple midi input threads. As alternative one might also move the ringbuffer from this engine channel to the individual MIDI ports/devices and let the sampler engine read the events from there instead of receiving them here.

        //protected:
            AudioChannel*             pChannelLeft;             ///< encapsulates the audio rendering buffer (left)
            AudioChannel*             pChannelRight;            ///< encapsulates the audio rendering buffer (right)
            int                       AudioDeviceChannelLeft;   ///< audio device channel number to which the left channel is connected to
            int                       AudioDeviceChannelRight;  ///< audio device channel number to which the right channel is connected to
            DoubleBuffer< ArrayList<MidiInputPort*> > midiInputs; ///< MIDI input ports on which this sampler engine channel shall listen to.
            midi_chan_t               midiChannel;              ///< MIDI channel(s) on which this engine channel listens to (on all MIDI input ports).
            RingBuffer<Event,false>*  pEventQueue;              ///< Input event queue.
            RTList<Event>*            pEvents;                  ///< All engine channel specific events for the current audio fragment.
            uint8_t                   ControllerTable[130];     ///< Reflects the current values (0-127) of all MIDI controllers for this engine / sampler channel. Number 128 is for channel pressure (mono aftertouch), 129 for pitch bend.
            String                    InstrumentFile;
            int                       InstrumentIdx;
            String                    InstrumentIdxName;
            int                       InstrumentStat;
            double                    GlobalVolume;             ///< Master volume factor set through the C++ API / LSCP (a value < 1.0 means attenuation, a value > 1.0 means amplification)
            double                    MidiVolume;               ///< Volume factor altered by MIDI CC#7 (a value < 1.0 means attenuation, a value > 1.0 means amplification)
            int                       Pitch;                    ///< Current (absolute) MIDI pitch value.
            float                     CurrentKeyDimension;      ///< Current value (0-1.0) for the keyboard dimension, altered by pressing a keyswitching key.
            bool                      PortamentoMode;           ///< in Portamento Mode we slide the pitch from the last note to the current note.
            float                     PortamentoTime;           ///< How long it will take to glide from the previous note to the current (in seconds)
            float                     PortamentoPos;            ///< Current position on the keyboard, that is integer and fractional part (only used if PortamentoMode is on)
            std::vector<FxSend*>      fxSends;
            int                       GlobalTranspose;          ///< amount of semi tones all notes should be transposed
            int                       iLastPanRequest;          ///< just for the return value of Pan(), so we don't have to make an injective function
            int                       iEngineIndexSelf;         ///< Reflects the index of this EngineChannel in the Engine's ArrayList.
            bool                      bStatusChanged;           ///< true in case an engine parameter has changed (e.g. new instrument, another volumet)
            uint32_t                  RoundRobinIndex;          ///< counter for round robin sample selection, incremented for each note on
            Pool<ScriptEvent>*        pScriptEvents;            ///< Pool of all available script execution instances. ScriptEvents available to be allocated from the Pool are currently unused / not executiong, whereas the ScriptEvents allocated on the list are currently suspended / have not finished execution yet.
            struct _Script {
                VMParserContext*      parserContext; ///< VM represenation of the currently loaded script or NULL if not script was loaded. Note that it is also not NULL if parser errors occurred!
                bool                  bHasValidScript; ///< True in case there is a valid script currently loaded, false if script processing shall be skipped.
                VMEventHandler*       handlerInit; ///< VM representation of script's initilization callback or NULL if current script did not define such an init handler.
                VMEventHandler*       handlerNote; ///< VM representation of script's MIDI note on callback or NULL if current script did not define such an event handler.
                VMEventHandler*       handlerRelease; ///< VM representation of script's MIDI note off callback or NULL if current script did not define such an event handler.
                VMEventHandler*       handlerController; ///< VM representation of script's MIDI controller callback or NULL if current script did not define such an event handler.
                _Script() {
                    parserContext = NULL;
                    bHasValidScript = false;
                    handlerInit = NULL;
                    handlerNote = NULL;
                    handlerRelease = NULL;
                    handlerController = NULL;
                }
            } script;

            SynchronizedConfig< ArrayList<VirtualMidiDevice*> > virtualMidiDevices;
            SynchronizedConfig< ArrayList<VirtualMidiDevice*> >::Reader virtualMidiDevicesReader_AudioThread;
            SynchronizedConfig< ArrayList<VirtualMidiDevice*> >::Reader virtualMidiDevicesReader_MidiThread;

            // specialization of RTList that doesn't require the pool
            // to be provided at construction time
            template<typename T>
            class LazyList : public RTList<T> {
            public:
                using RTList<T>::allocAppend;
                using RTList<T>::pPool;

                LazyList() : RTList<T>(0) { }
                typename RTList<T>::Iterator allocAppend(Pool<T>* pool) {
                    pPool = pool;
                    return allocAppend();
                }
            };
            
            typedef std::map<uint, LazyList<Event>*> ActiveKeyGroupMap;
            ActiveKeyGroupMap ActiveKeyGroups;      ///< Contains event queues for key groups, ordered by key group ID.

            virtual void ResetControllers();
            virtual void ResetInternal();
            virtual void RemoveAllFxSends();

            void ImportEvents(uint Samples);
            int  ScheduleEvent(const Event* pEvent, int delay); //TODO: delay not implemented yet
            void IgnoreEvent(int id);

            void AddGroup(uint group);
            void HandleKeyGroupConflicts(uint KeyGroup, Pool<Event>::Iterator& itNoteOnEvent);
            void ClearGroupEventLists();
            void DeleteGroupEventLists();

        private:
            /**
             * Returns @c true if there are 2 ore more MidiInputPorts connected
             * to this engine channel.
             *
             * This method is currently only used to prevent unnecessary
             * MidiInputMutex.Lock() if there is not more than 1 MIDI input on
             * this engine channel.
             */
            inline bool hasMultipleMIDIInputs() const {
                //FIXME: leaves tiny time frames open (shortly after 1->2 devices connected or 2->1 disconnected) which could lead to concurrency issue for the purpose described above, however in practice it "should" be acceptable
                return midiInputs.unsafeBack().size() > 1;
            }
    };

} // namespace LinuxSampler

#endif  /* __LS_ABSTRACTENGINECHANNEL_H__ */

1	/***************************************************************************
2	* *
3	* LinuxSampler - modular, streaming capable sampler *
4	* *
5	* Copyright (C) 2003,2004 by Benno Senoner and Christian Schoenebeck *
6	* Copyright (C) 2005-2008 Christian Schoenebeck *
7	* Copyright (C) 2009-2012 Christian Schoenebeck and Grigor Iliev *
8	* Copyright (C) 2013-2014 Christian Schoenebeck and Andreas Persson *
9	* *
10	* This program is free software; you can redistribute it and/or modify *
11	* it under the terms of the GNU General Public License as published by *
12	* the Free Software Foundation; either version 2 of the License, or *
13	* (at your option) any later version. *
14	* *
15	* This program is distributed in the hope that it will be useful, *
16	* but WITHOUT ANY WARRANTY; without even the implied warranty of *
17	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
18	* GNU General Public License for more details. *
19	* *
20	* You should have received a copy of the GNU General Public License *
21	* along with this program; if not, write to the Free Software *
22	* Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
23	* MA 02111-1307 USA *
24	***************************************************************************/
25
26	#ifndef __LS_ABSTRACTENGINECHANNEL_H__
27	#define __LS_ABSTRACTENGINECHANNEL_H__
28
29	#include "EngineChannel.h"
30	#include "AbstractEngine.h"
31
32	#include "../common/Pool.h"
33	#include "../common/RingBuffer.h"
34
35	#define CTRL_TABLE_IDX_AFTERTOUCH 128
36	#define CTRL_TABLE_IDX_PITCHBEND 129
37
38	namespace LinuxSampler {
39
40	class AbstractEngineChannel: public EngineChannel, public AbstractEngine::ScriptConsumer {
41	public:
42	// implementation of abstract methods derived from interface class 'LinuxSampler::EngineChannel'
43	virtual void PrepareLoadInstrument(const char* FileName, uint Instrument) OVERRIDE;
44	virtual void Reset() OVERRIDE;
45	virtual void SendNoteOn(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel) OVERRIDE;
46	virtual void SendNoteOn(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
47	virtual void SendNoteOff(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel) OVERRIDE;
48	virtual void SendNoteOff(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
49	virtual void SendPitchbend(int Pitch, uint8_t MidiChannel) OVERRIDE;
50	virtual void SendPitchbend(int Pitch, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
51	virtual void SendControlChange(uint8_t Controller, uint8_t Value, uint8_t MidiChannel) OVERRIDE;
52	virtual void SendControlChange(uint8_t Controller, uint8_t Value, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
53	virtual void SendChannelPressure(uint8_t Value, uint8_t MidiChannel) OVERRIDE;
54	virtual void SendChannelPressure(uint8_t Value, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
55	virtual void SendPolyphonicKeyPressure(uint8_t Key, uint8_t Value, uint8_t MidiChannel) OVERRIDE;
56	virtual void SendPolyphonicKeyPressure(uint8_t Key, uint8_t Value, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
57	virtual bool StatusChanged(bool bNewStatus = false) OVERRIDE;
58	virtual float Volume() OVERRIDE;
59	virtual void Volume(float f) OVERRIDE;
60	virtual float Pan() OVERRIDE;
61	virtual void Pan(float f) OVERRIDE;
62	virtual uint Channels() OVERRIDE;
63	virtual AudioOutputDevice* GetAudioOutputDevice() OVERRIDE;
64	virtual void SetOutputChannel(uint EngineAudioChannel, uint AudioDeviceChannel) OVERRIDE;
65	virtual int OutputChannel(uint EngineAudioChannel) OVERRIDE;
66	virtual void Connect(MidiInputPort* pMidiPort) OVERRIDE;
67	virtual void Disconnect(MidiInputPort* pMidiPort) OVERRIDE;
68	virtual void DisconnectAllMidiInputPorts() OVERRIDE;
69	virtual uint GetMidiInputPortCount() OVERRIDE;
70	virtual MidiInputPort* GetMidiInputPort(uint index) OVERRIDE;
71	virtual midi_chan_t MidiChannel() OVERRIDE;
72	virtual void SetMidiChannel(midi_chan_t MidiChannel) OVERRIDE;
73	virtual void Connect(MidiInputPort* pMidiPort, midi_chan_t MidiChannel) OVERRIDE; // deprecated, may be removed
74	virtual void DisconnectMidiInputPort() OVERRIDE; // deprecated, may be removed
75	virtual MidiInputPort* GetMidiInputPort() OVERRIDE; // deprecated, may be removed
76	virtual String InstrumentFileName() OVERRIDE;
77	virtual String InstrumentName() OVERRIDE;
78	virtual int InstrumentIndex() OVERRIDE;
79	virtual int InstrumentStatus() OVERRIDE;
80	virtual Engine* GetEngine() OVERRIDE;
81	virtual String EngineName() OVERRIDE;
82	virtual FxSend* AddFxSend(uint8_t MidiCtrl, String Name = "") throw (Exception) OVERRIDE;
83	virtual FxSend* GetFxSend(uint FxSendIndex) OVERRIDE;
84	virtual uint GetFxSendCount() OVERRIDE;
85	virtual void RemoveFxSend(FxSend* pFxSend) OVERRIDE;
86	virtual void Connect(VirtualMidiDevice* pDevice) OVERRIDE;
87	virtual void Disconnect(VirtualMidiDevice* pDevice) OVERRIDE;
88
89	// implementation of abstract methods derived from AbstractEngine::ScriptConsumer
90	virtual void ResourceToBeUpdated(VMParserContext* pResource, void*& pUpdateArg) OVERRIDE {}
91	virtual void ResourceUpdated(VMParserContext* pOldResource, VMParserContext* pNewResource, void* pUpdateArg) OVERRIDE {}
92	virtual void OnResourceProgress(float fProgress) OVERRIDE {}
93
94	virtual AbstractEngine::Format GetEngineFormat() = 0;
95
96	AudioOutputDevice* GetAudioOutputDeviceSafe();
97	void loadInstrumentScript(const String& text);
98	void unloadCurrentInstrumentScript();
99
100	friend class AbstractVoice;
101	friend class AbstractEngine;
102	template<class TV, class TRR, class TR, class TD, class TIM, class TI> friend class EngineBase;
103	template<class EC, class R, class S, class D> friend class VoiceBase;
104
105	//protected:
106	AbstractEngineChannel();
107	virtual ~AbstractEngineChannel();
108
109	AbstractEngine* pEngine;
110	Mutex EngineMutex; ///< protects the Engine from access by the instrument loader thread when lscp is disconnecting
111	Mutex MidiInputMutex; ///< Introduced when support for multiple MIDI inputs per engine channel was added: protects the MIDI event input ringbuffer on this engine channel to be accessed concurrently by multiple midi input threads. As alternative one might also move the ringbuffer from this engine channel to the individual MIDI ports/devices and let the sampler engine read the events from there instead of receiving them here.
112
113	//protected:
114	AudioChannel* pChannelLeft; ///< encapsulates the audio rendering buffer (left)
115	AudioChannel* pChannelRight; ///< encapsulates the audio rendering buffer (right)
116	int AudioDeviceChannelLeft; ///< audio device channel number to which the left channel is connected to
117	int AudioDeviceChannelRight; ///< audio device channel number to which the right channel is connected to
118	DoubleBuffer< ArrayList<MidiInputPort*> > midiInputs; ///< MIDI input ports on which this sampler engine channel shall listen to.
119	midi_chan_t midiChannel; ///< MIDI channel(s) on which this engine channel listens to (on all MIDI input ports).
120	RingBuffer<Event,false>* pEventQueue; ///< Input event queue.
121	RTList<Event>* pEvents; ///< All engine channel specific events for the current audio fragment.
122	uint8_t ControllerTable[130]; ///< Reflects the current values (0-127) of all MIDI controllers for this engine / sampler channel. Number 128 is for channel pressure (mono aftertouch), 129 for pitch bend.
123	String InstrumentFile;
124	int InstrumentIdx;
125	String InstrumentIdxName;
126	int InstrumentStat;
127	double GlobalVolume; ///< Master volume factor set through the C++ API / LSCP (a value < 1.0 means attenuation, a value > 1.0 means amplification)
128	double MidiVolume; ///< Volume factor altered by MIDI CC#7 (a value < 1.0 means attenuation, a value > 1.0 means amplification)
129	int Pitch; ///< Current (absolute) MIDI pitch value.
130	float CurrentKeyDimension; ///< Current value (0-1.0) for the keyboard dimension, altered by pressing a keyswitching key.
131	bool PortamentoMode; ///< in Portamento Mode we slide the pitch from the last note to the current note.
132	float PortamentoTime; ///< How long it will take to glide from the previous note to the current (in seconds)
133	float PortamentoPos; ///< Current position on the keyboard, that is integer and fractional part (only used if PortamentoMode is on)
134	std::vector<FxSend*> fxSends;
135	int GlobalTranspose; ///< amount of semi tones all notes should be transposed
136	int iLastPanRequest; ///< just for the return value of Pan(), so we don't have to make an injective function
137	int iEngineIndexSelf; ///< Reflects the index of this EngineChannel in the Engine's ArrayList.
138	bool bStatusChanged; ///< true in case an engine parameter has changed (e.g. new instrument, another volumet)
139	uint32_t RoundRobinIndex; ///< counter for round robin sample selection, incremented for each note on
140	Pool<ScriptEvent>* pScriptEvents; ///< Pool of all available script execution instances. ScriptEvents available to be allocated from the Pool are currently unused / not executiong, whereas the ScriptEvents allocated on the list are currently suspended / have not finished execution yet.
141	struct _Script {
142	VMParserContext* parserContext; ///< VM represenation of the currently loaded script or NULL if not script was loaded. Note that it is also not NULL if parser errors occurred!
143	bool bHasValidScript; ///< True in case there is a valid script currently loaded, false if script processing shall be skipped.
144	VMEventHandler* handlerInit; ///< VM representation of script's initilization callback or NULL if current script did not define such an init handler.
145	VMEventHandler* handlerNote; ///< VM representation of script's MIDI note on callback or NULL if current script did not define such an event handler.
146	VMEventHandler* handlerRelease; ///< VM representation of script's MIDI note off callback or NULL if current script did not define such an event handler.
147	VMEventHandler* handlerController; ///< VM representation of script's MIDI controller callback or NULL if current script did not define such an event handler.
148	_Script() {
149	parserContext = NULL;
150	bHasValidScript = false;
151	handlerInit = NULL;
152	handlerNote = NULL;
153	handlerRelease = NULL;
154	handlerController = NULL;
155	}
156	} script;
157
158	SynchronizedConfig< ArrayList<VirtualMidiDevice*> > virtualMidiDevices;
159	SynchronizedConfig< ArrayList<VirtualMidiDevice*> >::Reader virtualMidiDevicesReader_AudioThread;
160	SynchronizedConfig< ArrayList<VirtualMidiDevice*> >::Reader virtualMidiDevicesReader_MidiThread;
161
162	// specialization of RTList that doesn't require the pool
163	// to be provided at construction time
164	template<typename T>
165	class LazyList : public RTList<T> {
166	public:
167	using RTList<T>::allocAppend;
168	using RTList<T>::pPool;
169
170	LazyList() : RTList<T>(0) { }
171	typename RTList<T>::Iterator allocAppend(Pool<T>* pool) {
172	pPool = pool;
173	return allocAppend();
174	}
175	};
176
177	typedef std::map<uint, LazyList<Event>*> ActiveKeyGroupMap;
178	ActiveKeyGroupMap ActiveKeyGroups; ///< Contains event queues for key groups, ordered by key group ID.
179
180	virtual void ResetControllers();
181	virtual void ResetInternal();
182	virtual void RemoveAllFxSends();
183
184	void ImportEvents(uint Samples);
185	int ScheduleEvent(const Event* pEvent, int delay); //TODO: delay not implemented yet
186	void IgnoreEvent(int id);
187
188	void AddGroup(uint group);
189	void HandleKeyGroupConflicts(uint KeyGroup, Pool<Event>::Iterator& itNoteOnEvent);
190	void ClearGroupEventLists();
191	void DeleteGroupEventLists();
192
193	private:
194	/**
195	* Returns @c true if there are 2 ore more MidiInputPorts connected
196	* to this engine channel.
197	*
198	* This method is currently only used to prevent unnecessary
199	* MidiInputMutex.Lock() if there is not more than 1 MIDI input on
200	* this engine channel.
201	*/
202	inline bool hasMultipleMIDIInputs() const {
203	//FIXME: leaves tiny time frames open (shortly after 1->2 devices connected or 2->1 disconnected) which could lead to concurrency issue for the purpose described above, however in practice it "should" be acceptable
204	return midiInputs.unsafeBack().size() > 1;
205	}
206	};
207
208	} // namespace LinuxSampler
209
210	#endif /* __LS_ABSTRACTENGINECHANNEL_H__ */
211