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

Diff of /linuxsampler/trunk/src/engines/gig/Engine.h

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

revision 285 by schoenebeck, Thu Oct 14 21:31:26 2004 UTC revision 475 by schoenebeck, Thu Mar 17 23:56:56 2005 UTC
# Line 3  Line 3 
3   *   LinuxSampler - modular, streaming capable sampler                     *   *   LinuxSampler - modular, streaming capable sampler                     *
4   *                                                                         *   *                                                                         *
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 Christian Schoenebeck                              *
7   *                                                                         *   *                                                                         *
8   *   This program is free software; you can redistribute it and/or modify  *   *   This program is free software; you can redistribute it and/or modify  *
9   *   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 31  Line 32 
32    
33  #include <map>  #include <map>
34    
35    #include "EngineGlobals.h"
36  #include "../../common/RingBuffer.h"  #include "../../common/RingBuffer.h"
37  #include "../../common/Pool.h"  #include "../../common/Pool.h"
38    #include "../../common/ArrayList.h"
39  #include "../../common/ConditionServer.h"  #include "../../common/ConditionServer.h"
40  #include "../common/Engine.h"  #include "../common/Engine.h"
41  #include "../common/Event.h"  #include "../common/Event.h"
42  #include "../common/BiquadFilter.h"  #include "../common/BiquadFilter.h"
43  #include "../../lib/fileloader/libgig/gig.h"  #include "../../lib/fileloader/libgig/gig.h"
 #include "InstrumentResourceManager.h"  
44  #include "../../network/lscp.h"  #include "../../network/lscp.h"
45    #include "EngineChannel.h"
46    
47  #define PITCHBEND_SEMITONES             12  // identifier of this sampler engine
48  #define MAX_AUDIO_VOICES                128  #define LS_GIG_ENGINE_NAME "GigEngine"
 #define SYSEX_BUFFER_SIZE               2048  // 2kB  
 #define VOICE_STEAL_ALGORITHM           voice_steal_algo_oldestkey  ///< @see voice_steal_algo_t for available voice stealing algorithms  
49    
50  namespace LinuxSampler { namespace gig {  namespace LinuxSampler { namespace gig {
51    
     using std::map;  
   
52      // just symbol prototyping      // just symbol prototyping
53      class Voice;      class Voice;
54      class DiskThread;      class DiskThread;
55      class InstrumentResourceManager;      class InstrumentResourceManager;
56        class midi_key_info_t;
57        class EngineChannel;
58    
59      /**      /**
60       * Sampler engine for the Gigasampler format.       * Sampler engine for the Gigasampler format.
61       */       */
62      class Engine : public LinuxSampler::Engine, public InstrumentConsumer {      class Engine : public LinuxSampler::Engine {
63          public:          public:
             // types  
             enum voice_steal_algo_t {  
                 voice_steal_algo_none,  
                 voice_steal_algo_keymask,  
                 voice_steal_algo_oldestkey  
             };  
   
64              // methods              // methods
65              Engine();              Engine();
66             ~Engine();             ~Engine();
67                void Connect(AudioOutputDevice* pAudioOut);
68    
69              // abstract methods derived from class 'LinuxSampler::Engine'              // implementation of abstract methods derived from class 'LinuxSampler::Engine'
70              virtual void   LoadInstrument(const char* FileName, uint Instrument);              virtual int    RenderAudio(uint Samples);
71                virtual void   SendSysex(void* pData, uint Size);
72              virtual void   Reset();              virtual void   Reset();
73              virtual void   Enable();              virtual void   Enable();
74              virtual void   Disable();              virtual void   Disable();
             virtual void   SendNoteOn(uint8_t Key, uint8_t Velocity);  
             virtual void   SendNoteOff(uint8_t Key, uint8_t Velocity);  
             virtual void   SendPitchbend(int Pitch);  
             virtual void   SendControlChange(uint8_t Controller, uint8_t Value);  
             virtual void   SendSysex(void* pData, uint Size);  
             virtual float  Volume();  
             virtual void   Volume(float f);  
             virtual uint   Channels();  
             virtual void   Connect(AudioOutputDevice* pAudioOut);  
             virtual void   DisconnectAudioOutputDevice();  
             virtual void   SetOutputChannel(uint EngineAudioChannel, uint AudioDeviceChannel);  
             virtual int    OutputChannel(uint EngineAudioChannel);  
             virtual int    RenderAudio(uint Samples);  
75              virtual uint   VoiceCount();              virtual uint   VoiceCount();
76              virtual uint   VoiceCountMax();              virtual uint   VoiceCountMax();
77              virtual bool   DiskStreamSupported();              virtual bool   DiskStreamSupported();
# Line 99  namespace LinuxSampler { namespace gig { Line 82  namespace LinuxSampler { namespace gig {
82              virtual String Description();              virtual String Description();
83              virtual String Version();              virtual String Version();
84              virtual String EngineName();              virtual String EngineName();
             virtual String InstrumentFileName();  
             virtual int    InstrumentIndex();  
             virtual int    InstrumentStatus();  
   
             // abstract methods derived from interface class 'InstrumentConsumer'  
             virtual void ResourceToBeUpdated(::gig::Instrument* pResource, void*& pUpdateArg);  
             virtual void ResourceUpdated(::gig::Instrument* pOldResource, ::gig::Instrument* pNewResource, void* pUpdateArg);  
         protected:  
             struct midi_key_info_t {  
                 RTList<Voice>*  pActiveVoices;  ///< Contains the active voices associated with the MIDI key.  
                 bool            KeyPressed;     ///< Is true if the respective MIDI key is currently pressed.  
                 bool            Active;         ///< If the key contains active voices.  
                 bool            ReleaseTrigger; ///< If we have to launch release triggered voice(s) when the key is released  
                 Pool<uint>::Iterator itSelf;         ///< hack to allow fast deallocation of the key from the list of active keys  
                 RTList<Event>*  pEvents;        ///< Key specific events (only Note-on, Note-off and sustain pedal currently)  
             };  
85    
86              static InstrumentResourceManager Instruments;          //protected:
87                static InstrumentResourceManager instruments;
88    
89              AudioOutputDevice*      pAudioOutputDevice;              AudioOutputDevice*      pAudioOutputDevice;
             float*                  pOutputLeft;           ///< Audio output channel buffer (left)  
             float*                  pOutputRight;          ///< Audio output channel 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  
90              uint                    SampleRate;            ///< Sample rate of the engines output audio signal (in Hz)              uint                    SampleRate;            ///< Sample rate of the engines output audio signal (in Hz)
91              uint                    MaxSamplesPerCycle;    ///< Size of each audio output buffer              uint                    MaxSamplesPerCycle;    ///< Size of each audio output buffer
92              DiskThread*             pDiskThread;              DiskThread*             pDiskThread;
93              uint8_t                 ControllerTable[128];  ///< Reflects the current values (0-127) of all MIDI controllers for this engine / sampler channel.              RingBuffer<Event>*      pEventQueue;           ///< Input event queue for engine global events (e.g. SysEx messages).
             RingBuffer<Event>*      pEventQueue;           ///< Input event queue.  
             RingBuffer<uint8_t>*    pSysexBuffer;          ///< Input buffer for MIDI system exclusive messages.  
             midi_key_info_t         pMIDIKeyInfo[128];     ///< Contains all active voices sorted by MIDI key number and other informations to the respective MIDI key  
94              Pool<Voice>*            pVoicePool;            ///< Contains all voices that can be activated.              Pool<Voice>*            pVoicePool;            ///< Contains all voices that can be activated.
             Pool<uint>*             pActiveKeys;           ///< Holds all keys in it's allocation list with active voices.  
             Pool<Event>*            pEventPool;            ///< Contains all Event objects that can be used.  
95              EventGenerator*         pEventGenerator;              EventGenerator*         pEventGenerator;
96              RTList<Event>*          pVoiceStealingQueue;   ///< All voice-launching events which had to be postponed due to free voice shortage.              RTList<Event>*          pVoiceStealingQueue;   ///< All voice-launching events which had to be postponed due to free voice shortage.
97              RTList<Event>*          pEvents;               ///< All events for the current audio fragment.              RTList<Event>*          pGlobalEvents;         ///< All engine global events for the current audio fragment (usually only SysEx messages).
98              RTList<Event>*          pCCEvents;             ///< All control change events for the current audio fragment.              Pool<Event>*            pEventPool;            ///< Contains all Event objects that can be used.
99              RTList<Event>*          pSynthesisEvents[Event::destination_count];     ///< Events directly affecting synthesis parameter (like pitch, volume and filter).              RingBuffer<uint8_t>*    pSysexBuffer;          ///< Input buffer for MIDI system exclusive messages.
100              float*                  pSynthesisParameters[Event::destination_count]; ///< Matrix with final synthesis parameters for the current audio fragment which will be used in the main synthesis loop.              float*                  pSynthesisParameters[Event::destination_count]; ///< Matrix with final synthesis parameters for the current audio fragment which will be used in the main synthesis loop.
101              biquad_param_t*         pBasicFilterParameters; ///< Biquad parameters of the basic bandpass filter.              biquad_param_t*         pBasicFilterParameters; ///< Biquad parameters of the basic bandpass filter.
102              biquad_param_t*         pMainFilterParameters;  ///< Main biquad parameters of the individual filter (lowpass / bandpass / highpass).              biquad_param_t*         pMainFilterParameters;  ///< Main biquad parameters of the individual filter (lowpass / bandpass / highpass).
103              map<uint,uint*>         ActiveKeyGroups;        ///< Contains active keys (in case they belong to a key group) ordered by key group ID.              int                     ActiveVoiceCount;      ///< number of currently active voices (this value will be returned for public calls)
104              RIFF::File*             pRIFF;              int                     ActiveVoiceCountTemp;  ///< number of currently active voices (for internal usage, will be used for incrementation)
             ::gig::File*            pGig;  
             ::gig::Instrument*      pInstrument;  
             bool                    SustainPedal;          ///< true if sustain pedal is down  
             double                  GlobalVolume;          ///< overall volume (a value < 1.0 means attenuation, a value > 1.0 means amplification)  
             int                     Pitch;                 ///< Current (absolute) MIDI pitch value.  
             int                     ActiveVoiceCount;      ///< number of currently active voices  
105              int                     ActiveVoiceCountMax;   ///< the maximum voice usage since application start              int                     ActiveVoiceCountMax;   ///< the maximum voice usage since application start
106                int                     VoiceTheftsLeft;       ///< We only allow MAX_AUDIO_VOICES voices to be stolen per audio fragment, we use this variable to ensure this limit.
107                RTList<Voice>::Iterator itLastStolenVoice;     ///< Only for voice stealing: points to the last voice which was theft in current audio fragment, NULL otherwise.
108                RTList<uint>::Iterator  iuiLastStolenKey;      ///< Only for voice stealing: key number of last key on which the last voice was theft in current audio fragment, NULL otherwise.
109                EngineChannel*          pLastStolenChannel;    ///< Only for voice stealing: points to the engine channel on which the previous voice was stolen in this audio fragment.
110              bool                    SuspensionRequested;              bool                    SuspensionRequested;
111              ConditionServer         EngineDisabled;              ConditionServer         EngineDisabled;
             String                  InstrumentFile;  
             int                     InstrumentIdx;  
             int                     InstrumentStat;  
112              int8_t                  ScaleTuning[12];       ///< contains optional detune factors (-64..+63 cents) for all 12 semitones of an octave              int8_t                  ScaleTuning[12];       ///< contains optional detune factors (-64..+63 cents) for all 12 semitones of an octave
113              RTList<Voice>::Iterator itLastStolenVoice;      ///< Only for voice stealing: points to the last voice which was theft in current audio fragment, NULL otherwise.              int                     MaxFadeOutPos;         ///< The last position in an audio fragment to allow an instant fade out (e.g. for voice stealing) without leading to clicks.
114              RTList<uint>::Iterator  iuiLastStolenKey;      ///< Only for voice stealing: key number of last key on which the last voice was theft in current audio fragment, NULL otherwise.              uint32_t                RandomSeed;            ///< State of the random number generator used by the random dimension.
             int                     MaxFadeOutPos;         ///< The last position in an audio fragment to allow a instant fade out (e.g. for voice stealing) without leading to clicks.  
115    
116              void ProcessNoteOn(Pool<Event>::Iterator& itNoteOnEvent);              void ProcessEvents(EngineChannel* pEngineChannel, uint Samples);
117              void ProcessNoteOff(Pool<Event>::Iterator& itNoteOffEvent);              void RenderActiveVoices(EngineChannel* pEngineChannel, uint Samples);
118              void ProcessPitchbend(Pool<Event>::Iterator& itPitchbendEvent);              void RenderStolenVoices(uint Samples);
119              void ProcessControlChange(Pool<Event>::Iterator& itControlChangeEvent);              void PostProcess(EngineChannel* pEngineChannel);
120                void ClearEventLists();
121                void ImportEvents(uint Samples);
122                void ProcessNoteOn(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent);
123                void ProcessNoteOff(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOffEvent);
124                void ProcessPitchbend(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itPitchbendEvent);
125                void ProcessControlChange(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itControlChangeEvent);
126              void ProcessSysex(Pool<Event>::Iterator& itSysexEvent);              void ProcessSysex(Pool<Event>::Iterator& itSysexEvent);
127              Pool<Voice>::Iterator LaunchVoice(Pool<Event>::Iterator& itNoteOnEvent, int iLayer = 0, bool ReleaseTriggerVoice = false, bool VoiceStealing = true);              Pool<Voice>::Iterator LaunchVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent, int iLayer, bool ReleaseTriggerVoice, bool VoiceStealing);
128              void StealVoice(Pool<Event>::Iterator& itNoteOnEvent);              int  StealVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent);
129              void FreeVoice(Pool<Voice>::Iterator& itVoice);              void FreeVoice(EngineChannel* pEngineChannel, Pool<Voice>::Iterator& itVoice);
130                void FreeKey(EngineChannel* pEngineChannel, midi_key_info_t* pKey);
131              void ResetSynthesisParameters(Event::destination_t dst, float val);              void ResetSynthesisParameters(Event::destination_t dst, float val);
132              void ResetInternal();              void ResetInternal();
133    
134                static Engine* AcquireEngine(LinuxSampler::gig::EngineChannel* pChannel, AudioOutputDevice* pDevice);
135                static void    FreeEngine(LinuxSampler::gig::EngineChannel* pChannel, AudioOutputDevice* pDevice);
136    
137                void DisableAndLock(); // FIXME: should at least be protected
138    
139              friend class Voice;              friend class Voice;
140              friend class EGADSR;              friend class EGADSR;
141              friend class EGDecay;              friend class EGDecay;
142              friend class VCAManipulator;              friend class VCAManipulator;
143              friend class VCFCManipulator;              friend class VCFCManipulator;
144              friend class VCOManipulator;              friend class VCOManipulator;
             friend class InstrumentResourceManager;  
145          private:          private:
146              void    DisableAndLock();              ArrayList<EngineChannel*> engineChannels; ///< All engine channels of a gig::Engine instance.
147    
148                static std::map<AudioOutputDevice*,Engine*> engines; ///< All instances of gig::Engine.
149    
150              uint8_t GSCheckSum(const RingBuffer<uint8_t>::NonVolatileReader AddrReader, uint DataSize);              uint8_t GSCheckSum(const RingBuffer<uint8_t>::NonVolatileReader AddrReader, uint DataSize);
151              void    AdjustScale(int8_t ScaleTunes[12]);              void    AdjustScale(int8_t ScaleTunes[12]);
152                void    ReleaseAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itReleaseEvent);
153                void    KillAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itKillEvent);
154      };      };
155    
156  }} // namespace LinuxSampler::gig  }} // namespace LinuxSampler::gig
Legend:
Removed from v.285  
changed lines
  Added in v.475
  ViewVC Help
Powered by ViewVC