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

Diff of /linuxsampler/trunk/src/engines/AbstractEngineChannel.h

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 2317 by persson, Sun Feb 19 12:13:19 2012 UTC revision 2500 by schoenebeck, Fri Jan 10 12:20:05 2014 UTC
# Line 5  Line 5 
5   *   Copyright (C) 2003,2004 by Benno Senoner and Christian Schoenebeck    *   *   Copyright (C) 2003,2004 by Benno Senoner and Christian Schoenebeck    *
6   *   Copyright (C) 2005-2008 Christian Schoenebeck                         *   *   Copyright (C) 2005-2008 Christian Schoenebeck                         *
7   *   Copyright (C) 2009-2012 Christian Schoenebeck and Grigor Iliev        *   *   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  *   *   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  *   *   it under the terms of the GNU General Public License as published by  *
# Line 36  namespace LinuxSampler { Line 37  namespace LinuxSampler {
37      class AbstractEngineChannel: public EngineChannel {      class AbstractEngineChannel: public EngineChannel {
38          public:          public:
39              // implementation of abstract methods derived from interface class 'LinuxSampler::EngineChannel'              // implementation of abstract methods derived from interface class 'LinuxSampler::EngineChannel'
40              virtual void    PrepareLoadInstrument(const char* FileName, uint Instrument);              virtual void    PrepareLoadInstrument(const char* FileName, uint Instrument) OVERRIDE;
41              virtual void    Reset();              virtual void    Reset() OVERRIDE;
42              virtual void    SendNoteOn(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel);              virtual void    SendNoteOn(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel) OVERRIDE;
43              virtual void    SendNoteOn(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel, int32_t FragmentPos);              virtual void    SendNoteOn(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
44              virtual void    SendNoteOff(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel);              virtual void    SendNoteOff(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel) OVERRIDE;
45              virtual void    SendNoteOff(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel, int32_t FragmentPos);              virtual void    SendNoteOff(uint8_t Key, uint8_t Velocity, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
46              virtual void    SendPitchbend(int Pitch, uint8_t MidiChannel);              virtual void    SendPitchbend(int Pitch, uint8_t MidiChannel) OVERRIDE;
47              virtual void    SendPitchbend(int Pitch, uint8_t MidiChannel, int32_t FragmentPos);              virtual void    SendPitchbend(int Pitch, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
48              virtual void    SendControlChange(uint8_t Controller, uint8_t Value, uint8_t MidiChannel);              virtual void    SendControlChange(uint8_t Controller, uint8_t Value, uint8_t MidiChannel) OVERRIDE;
49              virtual void    SendControlChange(uint8_t Controller, uint8_t Value, uint8_t MidiChannel, int32_t FragmentPos);              virtual void    SendControlChange(uint8_t Controller, uint8_t Value, uint8_t MidiChannel, int32_t FragmentPos) OVERRIDE;
50              virtual bool    StatusChanged(bool bNewStatus = false);              virtual bool    StatusChanged(bool bNewStatus = false) OVERRIDE;
51              virtual float   Volume();              virtual float   Volume() OVERRIDE;
52              virtual void    Volume(float f);              virtual void    Volume(float f) OVERRIDE;
53              virtual float   Pan();              virtual float   Pan() OVERRIDE;
54              virtual void    Pan(float f);              virtual void    Pan(float f) OVERRIDE;
55              virtual uint    Channels();              virtual uint    Channels() OVERRIDE;
56              virtual AudioOutputDevice* GetAudioOutputDevice();              virtual AudioOutputDevice* GetAudioOutputDevice() OVERRIDE;
57              virtual void    SetOutputChannel(uint EngineAudioChannel, uint AudioDeviceChannel);              virtual void    SetOutputChannel(uint EngineAudioChannel, uint AudioDeviceChannel) OVERRIDE;
58              virtual int     OutputChannel(uint EngineAudioChannel);              virtual int     OutputChannel(uint EngineAudioChannel) OVERRIDE;
59              virtual void    Connect(MidiInputPort* pMidiPort, midi_chan_t MidiChannel);              virtual void    Connect(MidiInputPort* pMidiPort) OVERRIDE;
60              virtual void    DisconnectMidiInputPort();              virtual void    Disconnect(MidiInputPort* pMidiPort) OVERRIDE;
61              virtual MidiInputPort* GetMidiInputPort();              virtual void    DisconnectAllMidiInputPorts() OVERRIDE;
62              virtual midi_chan_t MidiChannel();              virtual uint    GetMidiInputPortCount() OVERRIDE;
63              virtual String  InstrumentFileName();              virtual MidiInputPort* GetMidiInputPort(uint index) OVERRIDE;
64              virtual String  InstrumentName();              virtual midi_chan_t MidiChannel() OVERRIDE;
65              virtual int     InstrumentIndex();              virtual void    SetMidiChannel(midi_chan_t MidiChannel) OVERRIDE;
66              virtual int     InstrumentStatus();              virtual void    Connect(MidiInputPort* pMidiPort, midi_chan_t MidiChannel) OVERRIDE; // deprecated, may be removed
67              virtual LinuxSampler::Engine* GetEngine();              virtual void    DisconnectMidiInputPort() OVERRIDE; // deprecated, may be removed
68              virtual String  EngineName();              virtual MidiInputPort* GetMidiInputPort() OVERRIDE; // deprecated, may be removed
69              virtual FxSend* AddFxSend(uint8_t MidiCtrl, String Name = "") throw (Exception);              virtual String  InstrumentFileName() OVERRIDE;
70              virtual FxSend* GetFxSend(uint FxSendIndex);              virtual String  InstrumentName() OVERRIDE;
71              virtual uint    GetFxSendCount();              virtual int     InstrumentIndex() OVERRIDE;
72              virtual void    RemoveFxSend(FxSend* pFxSend);              virtual int     InstrumentStatus() OVERRIDE;
73              virtual void    Connect(VirtualMidiDevice* pDevice);              virtual Engine* GetEngine() OVERRIDE;
74              virtual void    Disconnect(VirtualMidiDevice* pDevice);              virtual String  EngineName() OVERRIDE;
75                virtual FxSend* AddFxSend(uint8_t MidiCtrl, String Name = "") throw (Exception) OVERRIDE;
76                virtual FxSend* GetFxSend(uint FxSendIndex) OVERRIDE;
77                virtual uint    GetFxSendCount() OVERRIDE;
78                virtual void    RemoveFxSend(FxSend* pFxSend) OVERRIDE;
79                virtual void    Connect(VirtualMidiDevice* pDevice) OVERRIDE;
80                virtual void    Disconnect(VirtualMidiDevice* pDevice) OVERRIDE;
81    
82    
83              virtual AbstractEngine::Format GetEngineFormat() = 0;              virtual AbstractEngine::Format GetEngineFormat() = 0;
84    
85                AudioOutputDevice* GetAudioOutputDeviceSafe();
86    
87              friend class AbstractVoice;              friend class AbstractVoice;
88              friend class AbstractEngine;              friend class AbstractEngine;
89              template<class TV, class TRR, class TR, class TD, class TIM, class TI> friend class EngineBase;              template<class TV, class TRR, class TR, class TD, class TIM, class TI> friend class EngineBase;
# Line 85  namespace LinuxSampler { Line 94  namespace LinuxSampler {
94              virtual ~AbstractEngineChannel();              virtual ~AbstractEngineChannel();
95    
96              AbstractEngine*           pEngine;              AbstractEngine*           pEngine;
97          public: // TODO: should be protected              Mutex                     EngineMutex; ///< protects the Engine from access by the instrument loader thread when lscp is disconnecting
98                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.
99    
100            protected:
101              AudioChannel*             pChannelLeft;             ///< encapsulates the audio rendering buffer (left)              AudioChannel*             pChannelLeft;             ///< encapsulates the audio rendering buffer (left)
102              AudioChannel*             pChannelRight;            ///< encapsulates the audio rendering buffer (right)              AudioChannel*             pChannelRight;            ///< encapsulates the audio rendering buffer (right)
         protected:  
103              int                       AudioDeviceChannelLeft;   ///< audio device channel number to which the left channel is connected to              int                       AudioDeviceChannelLeft;   ///< audio device channel number to which the left channel is connected to
104              int                       AudioDeviceChannelRight;  ///< audio device channel number to which the right channel is connected to              int                       AudioDeviceChannelRight;  ///< audio device channel number to which the right channel is connected to
105              MidiInputPort*            pMidiInputPort;           ///< Points to the connected MIDI input port or NULL if none assigned.              DoubleBuffer< ArrayList<MidiInputPort*> > midiInputs; ///< MIDI input ports on which this sampler engine channel shall listen to.
106              midi_chan_t               midiChannel;              ///< MIDI channel(s) on which this engine channel listens to.              midi_chan_t               midiChannel;              ///< MIDI channel(s) on which this engine channel listens to (on all MIDI input ports).
107              RingBuffer<Event,false>*  pEventQueue;              ///< Input event queue.              RingBuffer<Event,false>*  pEventQueue;              ///< Input event queue.
108              RTList<Event>*            pEvents;                  ///< All engine channel specific events for the current audio fragment.              RTList<Event>*            pEvents;                  ///< All engine channel specific events for the current audio fragment.
109              uint8_t                   ControllerTable[129];     ///< Reflects the current values (0-127) of all MIDI controllers for this engine / sampler channel. Number 128 is for channel pressure (mono aftertouch).              uint8_t                   ControllerTable[129];     ///< Reflects the current values (0-127) of all MIDI controllers for this engine / sampler channel. Number 128 is for channel pressure (mono aftertouch).
# Line 102  namespace LinuxSampler { Line 113  namespace LinuxSampler {
113              int                       InstrumentStat;              int                       InstrumentStat;
114              double                    GlobalVolume;             ///< Master volume factor set through the C++ API / LSCP (a value < 1.0 means attenuation, a value > 1.0 means amplification)              double                    GlobalVolume;             ///< Master volume factor set through the C++ API / LSCP (a value < 1.0 means attenuation, a value > 1.0 means amplification)
115              double                    MidiVolume;               ///< Volume factor altered by MIDI CC#7 (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)
             float                     GlobalPanLeft;  
             float                     GlobalPanRight;  
116              int                       Pitch;                    ///< Current (absolute) MIDI pitch value.              int                       Pitch;                    ///< Current (absolute) MIDI pitch value.
117              float                     CurrentKeyDimension;      ///< Current value (0-1.0) for the keyboard dimension, altered by pressing a keyswitching key.              float                     CurrentKeyDimension;      ///< Current value (0-1.0) for the keyboard dimension, altered by pressing a keyswitching key.
118              bool                      PortamentoMode;           ///< in Portamento Mode we slide the pitch from the last note to the current note.              bool                      PortamentoMode;           ///< in Portamento Mode we slide the pitch from the last note to the current note.
# Line 148  namespace LinuxSampler { Line 157  namespace LinuxSampler {
157              void HandleKeyGroupConflicts(uint KeyGroup, Pool<Event>::Iterator& itNoteOnEvent);              void HandleKeyGroupConflicts(uint KeyGroup, Pool<Event>::Iterator& itNoteOnEvent);
158              void ClearGroupEventLists();              void ClearGroupEventLists();
159              void DeleteGroupEventLists();              void DeleteGroupEventLists();
160    
161            private:
162                /**
163                 * Returns @c true if there are 2 ore more MidiInputPorts connected
164                 * to this engine channel.
165                 *
166                 * This method is currently only used to prevent unnecessary
167                 * MidiInputMutex.Lock() if there is not more than 1 MIDI input on
168                 * this engine channel.
169                 */
170                inline bool hasMultipleMIDIInputs() const {
171                    //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
172                    return midiInputs.unsafeBack().size() > 1;
173                }
174      };      };
175    
176  } // namespace LinuxSampler  } // namespace LinuxSampler
Legend:
Removed from v.2317  
changed lines
  Added in v.2500
  ViewVC Help
Powered by ViewVC