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) 2012-2017 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"
#include "../common/ResourceManager.h"
#include "common/AbstractInstrumentManager.h"
#include "common/InstrumentScriptVM.h"

#define CTRL_TABLE_IDX_AFTERTOUCH   128
#define CTRL_TABLE_IDX_PITCHBEND    129
#define CTRL_TABLE_SIZE             130

namespace LinuxSampler {

    class MidiKeyboardManagerBase;

    class AbstractEngineChannel: public EngineChannel, public InstrumentScriptConsumer {
        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;
            virtual MidiKeyboardManagerBase* GetMidiKeyboardManager() = 0;

            AudioOutputDevice* GetAudioOutputDeviceSafe();

            script_callback_id_t GetScriptCallbackID(const ScriptEvent* e) const {
                return pScript->pEvents->getID(e);
            }

            RTList<ScriptEvent>::Iterator ScriptCallbackByID(script_callback_id_t id) const {
                return pScript->pEvents->fromID(id);
            }

            void ScheduleResumeOfScriptCallback(RTList<ScriptEvent>::Iterator& itCallback, sched_time_t now, bool forever);

            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.
            struct _DelayedEvents {
                RTList<Event>*            pList; ///< Unsorted list where all delayed events are moved to and remain here until they're finally processed.
                Pool<ScheduledEvent>      schedulerNodes; ///< Nodes used to sort the delayed events (stored on pList) with time sorted queue.
                RTAVLTree<ScheduledEvent> queue; ///< Used to access the delayed events (from pList) in time sorted manner.

                _DelayedEvents() : pList(NULL), schedulerNodes(CONFIG_MAX_EVENTS_PER_FRAGMENT) {}

                inline void clear() {
                    if (pList) pList->clear();
                    schedulerNodes.clear();
                    queue.clear();
                }
            } delayedEvents;
            uint8_t                   ControllerTable[CTRL_TABLE_SIZE];     ///< 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
            InstrumentScript*         pScript;                  ///< Points to the real-time instrument script(s) to be executed, NULL if current instrument does not have an instrument script. Even though the underlying VM representation of the script is shared among multiple sampler channels, the InstrumentScript object here is not shared though, it exists for each sampler channel separately.

            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(bool bResetEngine);
            virtual void RemoveAllFxSends();

            void ImportEvents(uint Samples);
            virtual note_id_t ScheduleNoteMicroSec(const Event* pEvent, int delay) = 0;
            event_id_t ScheduleEventMicroSec(const Event* pEvent, int delay);
            void IgnoreEvent(event_id_t id);
            virtual void IgnoreNote(note_id_t id) = 0;
            void IgnoreEventByScriptID(const ScriptID& id);
            virtual uint AllNoteIDs(note_id_t* dstBuf, uint bufSize) = 0;

            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;
            }

            inline bool applyTranspose(Event* event);
    };

} // namespace LinuxSampler

#endif  /* __LS_ABSTRACTENGINECHANNEL_H__ */

1	iliev	2012	/***************************************************************************
2			* *
3			* LinuxSampler - modular, streaming capable sampler *
4			* *
5			* Copyright (C) 2003,2004 by Benno Senoner and Christian Schoenebeck *
6	persson	2114	* Copyright (C) 2005-2008 Christian Schoenebeck *
7	persson	2317	* Copyright (C) 2009-2012 Christian Schoenebeck and Grigor Iliev *
8	schoenebeck	3073	* Copyright (C) 2012-2017 Christian Schoenebeck and Andreas Persson *
9	iliev	2012	* *
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	persson	2114	#define __LS_ABSTRACTENGINECHANNEL_H__
28	iliev	2012
29			#include "EngineChannel.h"
30			#include "AbstractEngine.h"
31
32			#include "../common/Pool.h"
33			#include "../common/RingBuffer.h"
34	schoenebeck	2611	#include "../common/ResourceManager.h"
35			#include "common/AbstractInstrumentManager.h"
36			#include "common/InstrumentScriptVM.h"
37	iliev	2012
38	schoenebeck	2594	#define CTRL_TABLE_IDX_AFTERTOUCH 128
39			#define CTRL_TABLE_IDX_PITCHBEND 129
40	schoenebeck	3095	#define CTRL_TABLE_SIZE 130
41	schoenebeck	2594
42	iliev	2012	namespace LinuxSampler {
43
44	schoenebeck	2613	class MidiKeyboardManagerBase;
45
46	schoenebeck	2611	class AbstractEngineChannel: public EngineChannel, public InstrumentScriptConsumer {
47	iliev	2012	public:
48			// implementation of abstract methods derived from interface class 'LinuxSampler::EngineChannel'
49	schoenebeck	2434	virtual void PrepareLoadInstrument(const char* FileName, uint Instrument) OVERRIDE;
50			virtual void Reset() OVERRIDE;
51			virtual void SendNoteOn(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel) OVERRIDE;
52			virtual void SendNoteOn(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
53			virtual void SendNoteOff(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel) OVERRIDE;
54			virtual void SendNoteOff(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
55			virtual void SendPitchbend(int Pitch, uint8_t MidiChannel) OVERRIDE;
56			virtual void SendPitchbend(int Pitch, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
57			virtual void SendControlChange(uint8_t Controller, uint8_t Value, uint8_t MidiChannel) OVERRIDE;
58	schoenebeck	2559	virtual void SendControlChange(uint8_t Controller, uint8_t Value, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
59			virtual void SendChannelPressure(uint8_t Value, uint8_t MidiChannel) OVERRIDE;
60			virtual void SendChannelPressure(uint8_t Value, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
61			virtual void SendPolyphonicKeyPressure(uint8_t Key, uint8_t Value, uint8_t MidiChannel) OVERRIDE;
62			virtual void SendPolyphonicKeyPressure(uint8_t Key, uint8_t Value, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
63	schoenebeck	2434	virtual bool StatusChanged(bool bNewStatus = false) OVERRIDE;
64			virtual float Volume() OVERRIDE;
65			virtual void Volume(float f) OVERRIDE;
66			virtual float Pan() OVERRIDE;
67			virtual void Pan(float f) OVERRIDE;
68			virtual uint Channels() OVERRIDE;
69			virtual AudioOutputDevice* GetAudioOutputDevice() OVERRIDE;
70			virtual void SetOutputChannel(uint EngineAudioChannel, uint AudioDeviceChannel) OVERRIDE;
71			virtual int OutputChannel(uint EngineAudioChannel) OVERRIDE;
72	schoenebeck	2500	virtual void Connect(MidiInputPort* pMidiPort) OVERRIDE;
73			virtual void Disconnect(MidiInputPort* pMidiPort) OVERRIDE;
74			virtual void DisconnectAllMidiInputPorts() OVERRIDE;
75			virtual uint GetMidiInputPortCount() OVERRIDE;
76			virtual MidiInputPort* GetMidiInputPort(uint index) OVERRIDE;
77	schoenebeck	2434	virtual midi_chan_t MidiChannel() OVERRIDE;
78	schoenebeck	2500	virtual void SetMidiChannel(midi_chan_t MidiChannel) OVERRIDE;
79			virtual void Connect(MidiInputPort* pMidiPort, midi_chan_t MidiChannel) OVERRIDE; // deprecated, may be removed
80			virtual void DisconnectMidiInputPort() OVERRIDE; // deprecated, may be removed
81			virtual MidiInputPort* GetMidiInputPort() OVERRIDE; // deprecated, may be removed
82	schoenebeck	2434	virtual String InstrumentFileName() OVERRIDE;
83			virtual String InstrumentName() OVERRIDE;
84			virtual int InstrumentIndex() OVERRIDE;
85			virtual int InstrumentStatus() OVERRIDE;
86			virtual Engine* GetEngine() OVERRIDE;
87			virtual String EngineName() OVERRIDE;
88			virtual FxSend* AddFxSend(uint8_t MidiCtrl, String Name = "") throw (Exception) OVERRIDE;
89			virtual FxSend* GetFxSend(uint FxSendIndex) OVERRIDE;
90			virtual uint GetFxSendCount() OVERRIDE;
91			virtual void RemoveFxSend(FxSend* pFxSend) OVERRIDE;
92			virtual void Connect(VirtualMidiDevice* pDevice) OVERRIDE;
93			virtual void Disconnect(VirtualMidiDevice* pDevice) OVERRIDE;
94	iliev	2012
95	schoenebeck	2594	// implementation of abstract methods derived from AbstractEngine::ScriptConsumer
96			virtual void ResourceToBeUpdated(VMParserContext* pResource, void*& pUpdateArg) OVERRIDE {}
97			virtual void ResourceUpdated(VMParserContext* pOldResource, VMParserContext* pNewResource, void* pUpdateArg) OVERRIDE {}
98			virtual void OnResourceProgress(float fProgress) OVERRIDE {}
99	iliev	2012
100			virtual AbstractEngine::Format GetEngineFormat() = 0;
101	schoenebeck	2613	virtual MidiKeyboardManagerBase* GetMidiKeyboardManager() = 0;
102	iliev	2012
103	persson	2326	AudioOutputDevice* GetAudioOutputDeviceSafe();
104
105	schoenebeck	2948	script_callback_id_t GetScriptCallbackID(const ScriptEvent* e) const {
106			return pScript->pEvents->getID(e);
107			}
108
109			RTList<ScriptEvent>::Iterator ScriptCallbackByID(script_callback_id_t id) const {
110			return pScript->pEvents->fromID(id);
111			}
112
113			void ScheduleResumeOfScriptCallback(RTList<ScriptEvent>::Iterator& itCallback, sched_time_t now, bool forever);
114
115	iliev	2015	friend class AbstractVoice;
116	iliev	2012	friend class AbstractEngine;
117			template<class TV, class TRR, class TR, class TD, class TIM, class TI> friend class EngineBase;
118	iliev	2015	template<class EC, class R, class S, class D> friend class VoiceBase;
119	iliev	2012
120	schoenebeck	2594	//protected:
121	iliev	2012	AbstractEngineChannel();
122			virtual ~AbstractEngineChannel();
123
124			AbstractEngine* pEngine;
125	persson	2326	Mutex EngineMutex; ///< protects the Engine from access by the instrument loader thread when lscp is disconnecting
126	schoenebeck	2500	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.
127	persson	2326
128	schoenebeck	2594	//protected:
129	iliev	2012	AudioChannel* pChannelLeft; ///< encapsulates the audio rendering buffer (left)
130			AudioChannel* pChannelRight; ///< encapsulates the audio rendering buffer (right)
131			int AudioDeviceChannelLeft; ///< audio device channel number to which the left channel is connected to
132			int AudioDeviceChannelRight; ///< audio device channel number to which the right channel is connected to
133	schoenebeck	2500	DoubleBuffer< ArrayList<MidiInputPort*> > midiInputs; ///< MIDI input ports on which this sampler engine channel shall listen to.
134			midi_chan_t midiChannel; ///< MIDI channel(s) on which this engine channel listens to (on all MIDI input ports).
135	iliev	2012	RingBuffer<Event,false>* pEventQueue; ///< Input event queue.
136			RTList<Event>* pEvents; ///< All engine channel specific events for the current audio fragment.
137	schoenebeck	2871	struct _DelayedEvents {
138			RTList<Event>* pList; ///< Unsorted list where all delayed events are moved to and remain here until they're finally processed.
139			Pool<ScheduledEvent> schedulerNodes; ///< Nodes used to sort the delayed events (stored on pList) with time sorted queue.
140			RTAVLTree<ScheduledEvent> queue; ///< Used to access the delayed events (from pList) in time sorted manner.
141
142			_DelayedEvents() : pList(NULL), schedulerNodes(CONFIG_MAX_EVENTS_PER_FRAGMENT) {}
143
144			inline void clear() {
145			if (pList) pList->clear();
146			schedulerNodes.clear();
147			queue.clear();
148			}
149			} delayedEvents;
150	schoenebeck	3095	uint8_t ControllerTable[CTRL_TABLE_SIZE]; ///< 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.
151	iliev	2012	String InstrumentFile;
152			int InstrumentIdx;
153			String InstrumentIdxName;
154			int InstrumentStat;
155			double GlobalVolume; ///< Master volume factor set through the C++ API / LSCP (a value < 1.0 means attenuation, a value > 1.0 means amplification)
156			double MidiVolume; ///< Volume factor altered by MIDI CC#7 (a value < 1.0 means attenuation, a value > 1.0 means amplification)
157			int Pitch; ///< Current (absolute) MIDI pitch value.
158			float CurrentKeyDimension; ///< Current value (0-1.0) for the keyboard dimension, altered by pressing a keyswitching key.
159			bool PortamentoMode; ///< in Portamento Mode we slide the pitch from the last note to the current note.
160			float PortamentoTime; ///< How long it will take to glide from the previous note to the current (in seconds)
161			float PortamentoPos; ///< Current position on the keyboard, that is integer and fractional part (only used if PortamentoMode is on)
162			std::vector<FxSend*> fxSends;
163			int GlobalTranspose; ///< amount of semi tones all notes should be transposed
164			int iLastPanRequest; ///< just for the return value of Pan(), so we don't have to make an injective function
165			int iEngineIndexSelf; ///< Reflects the index of this EngineChannel in the Engine's ArrayList.
166			bool bStatusChanged; ///< true in case an engine parameter has changed (e.g. new instrument, another volumet)
167	persson	2043	uint32_t RoundRobinIndex; ///< counter for round robin sample selection, incremented for each note on
168	schoenebeck	2630	InstrumentScript* pScript; ///< Points to the real-time instrument script(s) to be executed, NULL if current instrument does not have an instrument script. Even though the underlying VM representation of the script is shared among multiple sampler channels, the InstrumentScript object here is not shared though, it exists for each sampler channel separately.
169	iliev	2012
170			SynchronizedConfig< ArrayList<VirtualMidiDevice*> > virtualMidiDevices;
171			SynchronizedConfig< ArrayList<VirtualMidiDevice*> >::Reader virtualMidiDevicesReader_AudioThread;
172			SynchronizedConfig< ArrayList<VirtualMidiDevice*> >::Reader virtualMidiDevicesReader_MidiThread;
173
174	persson	2127	// specialization of RTList that doesn't require the pool
175			// to be provided at construction time
176			template<typename T>
177			class LazyList : public RTList<T> {
178			public:
179			using RTList<T>::allocAppend;
180			using RTList<T>::pPool;
181	persson	2114
182	persson	2127	LazyList() : RTList<T>(0) { }
183			typename RTList<T>::Iterator allocAppend(Pool<T>* pool) {
184			pPool = pool;
185			return allocAppend();
186			}
187			};
188
189			typedef std::map<uint, LazyList<Event>*> ActiveKeyGroupMap;
190			ActiveKeyGroupMap ActiveKeyGroups; ///< Contains event queues for key groups, ordered by key group ID.
191
192	iliev	2012	virtual void ResetControllers();
193	schoenebeck	2871	virtual void ResetInternal(bool bResetEngine);
194	iliev	2012	virtual void RemoveAllFxSends();
195
196			void ImportEvents(uint Samples);
197	schoenebeck	2879	virtual note_id_t ScheduleNoteMicroSec(const Event* pEvent, int delay) = 0;
198			event_id_t ScheduleEventMicroSec(const Event* pEvent, int delay);
199			void IgnoreEvent(event_id_t id);
200	schoenebeck	2884	virtual void IgnoreNote(note_id_t id) = 0;
201	schoenebeck	2879	void IgnoreEventByScriptID(const ScriptID& id);
202	schoenebeck	3073	virtual uint AllNoteIDs(note_id_t* dstBuf, uint bufSize) = 0;
203	persson	2114
204			void AddGroup(uint group);
205			void HandleKeyGroupConflicts(uint KeyGroup, Pool<Event>::Iterator& itNoteOnEvent);
206			void ClearGroupEventLists();
207			void DeleteGroupEventLists();
208	schoenebeck	2500
209			private:
210			/**
211			* Returns @c true if there are 2 ore more MidiInputPorts connected
212			* to this engine channel.
213			*
214			* This method is currently only used to prevent unnecessary
215			* MidiInputMutex.Lock() if there is not more than 1 MIDI input on
216			* this engine channel.
217			*/
218			inline bool hasMultipleMIDIInputs() const {
219			//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
220			return midiInputs.unsafeBack().size() > 1;
221			}
222	schoenebeck	2879
223			inline bool applyTranspose(Event* event);
224	iliev	2012	};
225
226			} // namespace LinuxSampler
227
228	persson	2114	#endif /* __LS_ABSTRACTENGINECHANNEL_H__ */
229	iliev	2012