/[svn]/linuxsampler/trunk/src/network/lscpserver.h
ViewVC logotype

Annotation of /linuxsampler/trunk/src/network/lscpserver.h

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1350 - (hide annotations) (download) (as text)
Sun Sep 16 23:06:10 2007 UTC (16 years, 6 months ago) by iliev
File MIME type: text/x-c++hdr
File size: 18372 byte(s)
* instruments db: slashes-in-names are now escaped with \x2f

1 schoenebeck 35 /***************************************************************************
2     * *
3     * LinuxSampler - modular, streaming capable sampler *
4     * *
5 schoenebeck 56 * Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6 schoenebeck 1026 * Copyright (C) 2005 - 2007 Christian Schoenebeck *
7 schoenebeck 35 * *
8 schoenebeck 385 * This library is free software; you can redistribute it and/or modify *
9 schoenebeck 35 * it under the terms of the GNU General Public License as published by *
10     * the Free Software Foundation; either version 2 of the License, or *
11     * (at your option) any later version. *
12     * *
13 schoenebeck 385 * This library is distributed in the hope that it will be useful, *
14 schoenebeck 35 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
15     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16     * GNU General Public License for more details. *
17     * *
18     * You should have received a copy of the GNU General Public License *
19 schoenebeck 385 * along with this library; if not, write to the Free Software *
20 schoenebeck 35 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
21     * MA 02111-1307 USA *
22     ***************************************************************************/
23    
24     #ifndef __LSCPSERVER_H_
25     #define __LSCPSERVER_H_
26    
27     #include <unistd.h>
28     #include <sys/types.h>
29     #include <sys/socket.h>
30 senkov 170 #include <sys/select.h>
31     #include <sys/time.h>
32 schoenebeck 35 #include <netinet/in.h>
33     #include <netinet/tcp.h>
34     #include <arpa/inet.h>
35     #include <netdb.h>
36    
37 senkov 170 #include <list>
38    
39 schoenebeck 53 #include "lscp.h"
40 schoenebeck 35 #include "lscpparser.h"
41 senkov 170 #include "lscp.h"
42     #include "lscpevent.h"
43 schoenebeck 53 #include "../Sampler.h"
44     #include "../common/Thread.h"
45 senkov 170 #include "../common/Mutex.h"
46 schoenebeck 211 #include "../common/Condition.h"
47 iliev 1161 #include "../common/global.h"
48 schoenebeck 35
49 schoenebeck 947 #include "../drivers/midi/MidiInstrumentMapper.h"
50    
51 iliev 1161 #if HAVE_SQLITE3
52     #include "../db/InstrumentsDb.h"
53     #endif
54    
55 schoenebeck 35 /// TCP Port on which the server should listen for connection requests.
56 senkov 667 #define LSCP_ADDR INADDR_ANY
57 schoenebeck 35 #define LSCP_PORT 8888
58    
59 schoenebeck 227 /// try up to 3 minutes to bind server socket
60     #define LSCP_SERVER_BIND_TIMEOUT 180
61    
62 schoenebeck 53 using namespace LinuxSampler;
63    
64 schoenebeck 35 // External references to the main scanner and parser functions
65     extern int yyparse(void* YYPARSE_PARAM);
66 schoenebeck 219 extern void restart(yyparse_param_t* pparam, int& yychar);
67 schoenebeck 35
68     /**
69     * Network server for the LinuxSampler Control Protocol (LSCP).
70     */
71     class LSCPServer : public Thread {
72     public:
73 senkov 667 LSCPServer(Sampler* pSampler, long int addr, short int port);
74 schoenebeck 475 virtual ~LSCPServer();
75 schoenebeck 211 int WaitUntilInitialized(long TimeoutSeconds = 0L, long TimeoutNanoSeconds = 0L);
76 schoenebeck 35
77     // Methods called by the parser
78 schoenebeck 123 String DestroyAudioOutputDevice(uint DeviceIndex);
79 senkov 155 String DestroyMidiInputDevice(uint DeviceIndex);
80 capela 137 String LoadInstrument(String Filename, uint uiInstrument, uint uiSamplerChannel, bool bBackground = false);
81 schoenebeck 411 String SetEngineType(String EngineName, uint uiSamplerChannel);
82 schoenebeck 35 String GetChannels();
83 schoenebeck 209 String ListChannels();
84 schoenebeck 35 String AddChannel();
85 schoenebeck 53 String RemoveChannel(uint uiSamplerChannel);
86 schoenebeck 35 String GetAvailableEngines();
87 capela 527 String ListAvailableEngines();
88 schoenebeck 35 String GetEngineInfo(String EngineName);
89 schoenebeck 53 String GetChannelInfo(uint uiSamplerChannel);
90     String GetVoiceCount(uint uiSamplerChannel);
91     String GetStreamCount(uint uiSamplerChannel);
92     String GetBufferFill(fill_response_t ResponseType, uint uiSamplerChannel);
93 schoenebeck 123 String GetAvailableAudioOutputDrivers();
94 capela 527 String ListAvailableAudioOutputDrivers();
95 senkov 155 String GetAvailableMidiInputDrivers();
96 capela 527 String ListAvailableMidiInputDrivers();
97 schoenebeck 123 String GetAudioOutputDriverInfo(String Driver);
98 senkov 155 String GetMidiInputDriverInfo(String Driver);
99 schoenebeck 123 #ifdef __GNUC__
100     typedef std::map<String,String> StringMap; // nasty workaround for a GCC bug (see GCC bug #15980, #57)
101     String GetAudioOutputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = StringMap());
102 senkov 155 String GetMidiInputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = StringMap());
103 senkov 140 String CreateAudioOutputDevice(String Driver, std::map<String,String> Parameters = StringMap());
104 senkov 155 String CreateMidiInputDevice(String Driver, std::map<String,String> Parameters = StringMap());
105 schoenebeck 123 #else
106     String GetAudioOutputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = std::map<String,String>());
107 senkov 155 String GetMidiInputDriverParameterInfo(String Driver, String Parameter, std::map<String,String> DependencyList = std::map<String,String>());
108 senkov 140 String CreateAudioOutputDevice(String Driver, std::map<String,String> Parameters = std::map<String,String>());
109 senkov 155 String CreateMidiInputDevice(String Driver, std::map<String,String> Parameters = std::map<String,String>());
110 schoenebeck 123 #endif // __GNUC__
111     String GetAudioOutputDeviceCount();
112 senkov 155 String GetMidiInputDeviceCount();
113 schoenebeck 123 String GetAudioOutputDevices();
114 senkov 155 String GetMidiInputDevices();
115 schoenebeck 123 String GetAudioOutputDeviceInfo(uint DeviceIndex);
116 senkov 155 String GetMidiInputDeviceInfo(uint DeviceIndex);
117     String GetMidiInputPortInfo(uint DeviceIndex, uint PortIndex);
118 senkov 185 String GetMidiInputPortParameterInfo(uint DeviceId, uint PortId, String ParameterName);
119 schoenebeck 123 String GetAudioOutputChannelInfo(uint DeviceId, uint ChannelId);
120     String GetAudioOutputChannelParameterInfo(uint DeviceId, uint ChannelId, String ParameterName);
121     String SetAudioOutputChannelParameter(uint DeviceId, uint ChannelId, String ParamKey, String ParamVal);
122     String SetAudioOutputDeviceParameter(uint DeviceIndex, String ParamKey, String ParamVal);
123 senkov 155 String SetMidiInputDeviceParameter(uint DeviceIndex, String ParamKey, String ParamVal);
124 capela 159 String SetMidiInputPortParameter(uint DeviceIndex, uint PortIndex, String ParamKey, String ParamVal);
125 schoenebeck 123 String SetAudioOutputChannel(uint ChannelAudioOutputChannel, uint AudioOutputDeviceInputChannel, uint uiSamplerChannel);
126 capela 159 String SetAudioOutputDevice(uint AudioDeviceId, uint SamplerChannel);
127 capela 143 String SetAudioOutputType(String AudioOutputDriver, uint uiSamplerChannel);
128 capela 159 String SetMIDIInputPort(uint MIDIPort, uint uiSamplerChannel);
129     String SetMIDIInputChannel(uint MIDIChannel, uint uiSamplerChannel);
130     String SetMIDIInputDevice(uint MIDIDeviceId, uint uiSamplerChannel);
131 schoenebeck 123 String SetMIDIInputType(String MidiInputDriver, uint uiSamplerChannel);
132 capela 159 String SetMIDIInput(uint MIDIDeviceId, uint MIDIPort, uint MIDIChannel, uint uiSamplerChannel);
133 schoenebeck 225 String SetVolume(double dVolume, uint uiSamplerChannel);
134 schoenebeck 705 String SetChannelMute(bool bMute, uint uiSamplerChannel);
135     String SetChannelSolo(bool bSolo, uint uiSamplerChannel);
136 schoenebeck 1047 String AddOrReplaceMIDIInstrumentMapping(uint MidiMapID, uint MidiBank, uint MidiProg, String EngineType, String InstrumentFile, uint InstrumentIndex, float Volume, MidiInstrumentMapper::mode_t LoadMode, String Name, bool bModal);
137 schoenebeck 973 String RemoveMIDIInstrumentMapping(uint MidiMapID, uint MidiBank, uint MidiProg);
138     String GetMidiInstrumentMappings(uint MidiMapID);
139     String GetAllMidiInstrumentMappings();
140     String GetMidiInstrumentMapping(uint MidiMapID, uint MidiBank, uint MidiProg);
141     String ListMidiInstrumentMappings(uint MidiMapID);
142     String ListAllMidiInstrumentMappings();
143     String ClearMidiInstrumentMappings(uint MidiMapID);
144     String ClearAllMidiInstrumentMappings();
145     String AddMidiInstrumentMap(String MapName = "");
146     String RemoveMidiInstrumentMap(uint MidiMapID);
147     String RemoveAllMidiInstrumentMaps();
148     String GetMidiInstrumentMaps();
149     String ListMidiInstrumentMaps();
150     String GetMidiInstrumentMap(uint MidiMapID);
151     String SetMidiInstrumentMapName(uint MidiMapID, String NewName);
152     String SetChannelMap(uint uiSamplerChannel, int MidiMapID);
153 schoenebeck 1001 String CreateFxSend(uint uiSamplerChannel, uint MidiCtrl, String Name = "");
154     String DestroyFxSend(uint uiSamplerChannel, uint FxSendID);
155     String GetFxSends(uint uiSamplerChannel);
156     String ListFxSends(uint uiSamplerChannel);
157     String GetFxSendInfo(uint uiSamplerChannel, uint FxSendID);
158 iliev 1135 String SetFxSendName(uint uiSamplerChannel, uint FxSendID, String Name);
159 schoenebeck 1001 String SetFxSendAudioOutputChannel(uint uiSamplerChannel, uint FxSendID, uint FxSendChannel, uint DeviceChannel);
160 schoenebeck 1026 String SetFxSendMidiController(uint uiSamplerChannel, uint FxSendID, uint MidiController);
161     String SetFxSendLevel(uint uiSamplerChannel, uint FxSendID, double dLevel);
162 iliev 1161 String AddDbInstrumentDirectory(String Dir);
163     String RemoveDbInstrumentDirectory(String Dir, bool Force = false);
164 iliev 1187 String GetDbInstrumentDirectoryCount(String Dir, bool Recursive = false);
165     String GetDbInstrumentDirectories(String Dir, bool Recursive = false);
166 iliev 1161 String GetDbInstrumentDirectoryInfo(String Dir);
167     String SetDbInstrumentDirectoryName(String Dir, String Name);
168     String MoveDbInstrumentDirectory(String Dir, String Dst);
169 iliev 1187 String CopyDbInstrumentDirectory(String Dir, String Dst);
170 iliev 1161 String SetDbInstrumentDirectoryDescription(String Dir, String Desc);
171 iliev 1187 String FindDbInstrumentDirectories(String Dir, std::map<String,String> Parameters, bool Recursive = true);
172 iliev 1200 String AddDbInstruments(String DbDir, String FilePath, int Index = -1, bool bBackground = false);
173     String AddDbInstruments(String ScanMode, String DbDir, String FsDir, bool bBackground = false);
174 iliev 1161 String RemoveDbInstrument(String Instr);
175 iliev 1187 String GetDbInstrumentCount(String Dir, bool Recursive = false);
176     String GetDbInstruments(String Dir, bool Recursive = false);
177 iliev 1161 String GetDbInstrumentInfo(String Instr);
178     String SetDbInstrumentName(String Instr, String Name);
179     String MoveDbInstrument(String Instr, String Dst);
180 iliev 1187 String CopyDbInstrument(String Instr, String Dst);
181 iliev 1161 String SetDbInstrumentDescription(String Instr, String Desc);
182 iliev 1187 String FindDbInstruments(String Dir, std::map<String,String> Parameters, bool Recursive = true);
183 schoenebeck 1212 String EditSamplerChannelInstrument(uint uiSamplerChannel);
184 iliev 1200 String GetDbInstrumentsJobInfo(int JobId);
185 schoenebeck 53 String ResetChannel(uint uiSamplerChannel);
186 schoenebeck 212 String ResetSampler();
187 schoenebeck 563 String GetServerInfo();
188 iliev 778 String GetTotalVoiceCount();
189     String GetTotalVoiceCountMax();
190 schoenebeck 1005 String GetGlobalVolume();
191     String SetGlobalVolume(double dVolume);
192 senkov 170 String SubscribeNotification(LSCPEvent::event_t);
193     String UnsubscribeNotification(LSCPEvent::event_t);
194 schoenebeck 210 String SetEcho(yyparse_param_t* pSession, double boolean_value);
195 schoenebeck 35 void AnswerClient(String ReturnMessage);
196 senkov 170
197     static int currentSocket;
198     static std::map<int,String> bufferedCommands;
199 senkov 184
200     static void SendLSCPNotify( LSCPEvent Event );
201 senkov 360 static int EventSubscribers( std::list<LSCPEvent::event_t> events );
202     static void LockRTNotify( void ) { RTNotifyMutex.Lock(); }
203     static void UnlockRTNotify( void ) { RTNotifyMutex.Unlock(); }
204 iliev 1161 static String FilterEndlines(String s);
205 senkov 184
206 schoenebeck 35 protected:
207 schoenebeck 53 int hSocket;
208     sockaddr_in SocketAddress;
209     Sampler* pSampler;
210 schoenebeck 211 Condition Initialized;
211 schoenebeck 35
212     int Main(); ///< Implementation of virtual method from class Thread
213 senkov 170
214 schoenebeck 35 private:
215 schoenebeck 209
216 schoenebeck 35 /**
217 capela 143 * Find a created audio output device index.
218     */
219     int GetAudioOutputDeviceIndex (AudioOutputDevice *pDevice);
220 schoenebeck 209
221 senkov 155 /**
222     * Find a created midi input device index.
223     */
224     int GetMidiInputDeviceIndex (MidiInputDevice *pDevice);
225 capela 143
226 iliev 1135 EngineChannel* GetEngineChannel(uint uiSamplerChannel);
227    
228     /**
229     * Gets the specified effect send on the specified sampler channel.
230     */
231     FxSend* GetFxSend(uint uiSamplerChannel, uint FxSendID);
232    
233 schoenebeck 705 bool HasSoloChannel();
234     void MuteNonSoloChannels();
235     void UnmuteChannels();
236    
237 senkov 170 static std::map<int,String> bufferedNotifies;
238     static Mutex NotifyMutex;
239     static Mutex NotifyBufferMutex;
240 schoenebeck 210 static bool GetLSCPCommand( std::vector<yyparse_param_t>::iterator iter );
241     static void CloseConnection( std::vector<yyparse_param_t>::iterator iter );
242     static std::vector<yyparse_param_t> Sessions;
243 senkov 170 static Mutex SubscriptionMutex;
244     static std::map< LSCPEvent::event_t, std::list<int> > eventSubscriptions;
245     static fd_set fdSet;
246 senkov 360
247     //Protect main thread that generates real time notify messages
248     //like voice count, stream count and buffer fill
249     //from LSCP server removing engines and channels from underneath
250     static Mutex RTNotifyMutex;
251 iliev 1130
252 iliev 1133 class EventHandler : public ChannelCountListener, public AudioDeviceCountListener,
253     public MidiDeviceCountListener, public MidiInstrumentCountListener,
254     public MidiInstrumentInfoListener, public MidiInstrumentMapCountListener,
255     public MidiInstrumentMapInfoListener, public FxSendCountListener,
256     public VoiceCountListener, public StreamCountListener,
257     public BufferFillListener, public TotalVoiceCountListener {
258    
259     public:
260 iliev 1130 /**
261     * Invoked when the number of sampler channels has changed.
262     * @param NewCount The new number of sampler channels.
263     */
264     virtual void ChannelCountChanged(int NewCount);
265 schoenebeck 1212
266 iliev 1130 /**
267     * Invoked when the number of audio output devices has changed.
268     * @param NewCount The new number of audio output devices.
269     */
270     virtual void AudioDeviceCountChanged(int NewCount);
271 schoenebeck 1212
272 iliev 1130 /**
273     * Invoked when the number of MIDI input devices has changed.
274     * @param NewCount The new number of MIDI input devices.
275     */
276     virtual void MidiDeviceCountChanged(int NewCount);
277 iliev 1133
278 iliev 1130 /**
279     * Invoked when the number of MIDI instruments has changed.
280     * @param MapId The numerical ID of the MIDI instrument map.
281     * @param NewCount The new number of MIDI instruments.
282     */
283     virtual void MidiInstrumentCountChanged(int MapId, int NewCount);
284 schoenebeck 1212
285 iliev 1130 /**
286     * Invoked when a MIDI instrument in a MIDI instrument map is changed.
287     * @param MapId The numerical ID of the MIDI instrument map.
288     * @param Bank The index of the MIDI bank, containing the instrument.
289     * @param Program The MIDI program number of the instrument.
290     */
291     virtual void MidiInstrumentInfoChanged(int MapId, int Bank, int Program);
292 schoenebeck 1212
293 iliev 1133 /**
294 iliev 1130 * Invoked when the number of MIDI instrument maps has changed.
295     * @param NewCount The new number of MIDI instruments.
296     */
297     virtual void MidiInstrumentMapCountChanged(int NewCount);
298    
299     /**
300     * Invoked when the settings of a MIDI instrument map are changed.
301     * @param MapId The numerical ID of the MIDI instrument map.
302     */
303     virtual void MidiInstrumentMapInfoChanged(int MapId);
304 schoenebeck 1212
305 iliev 1130 /**
306     * Invoked when the number of effect sends
307     * on the specified sampler channel has changed.
308     * @param ChannelId The numerical ID of the sampler channel.
309     * @param NewCount The new number of effect sends.
310     */
311     virtual void FxSendCountChanged(int ChannelId, int NewCount);
312 iliev 1133
313 iliev 1130 /**
314     * Invoked when the number of active voices
315     * on the specified sampler channel has changed.
316     * @param ChannelId The numerical ID of the sampler channel.
317     * @param NewCount The new number of active voices.
318     */
319     virtual void VoiceCountChanged(int ChannelId, int NewCount);
320    
321     /**
322     * Invoked when the number of active disk streams
323     * on the specified sampler channel has changed.
324     * @param ChannelId The numerical ID of the sampler channel.
325     * @param NewCount The new number of active disk streams.
326     */
327     virtual void StreamCountChanged(int ChannelId, int NewCount);
328    
329     /**
330     * Invoked when the fill state of the disk stream
331     * buffers on the specified sampler channel is changed.
332     * @param ChannelId The numerical ID of the sampler channel.
333     * @param FillData The buffer fill data for the specified sampler channel.
334     */
335     virtual void BufferFillChanged(int ChannelId, String FillData);
336    
337     /**
338     * Invoked when the total number of active voices is changed.
339     * @param NewCount The new number of active voices.
340     */
341     virtual void TotalVoiceCountChanged(int NewCount);
342 iliev 1133 } eventHandler;
343 iliev 1161
344     #if HAVE_SQLITE3
345     class DbInstrumentsEventHandler : public InstrumentsDb::Listener {
346     public:
347     virtual void DirectoryCountChanged(String Dir);
348     virtual void DirectoryInfoChanged(String Dir);
349     virtual void DirectoryNameChanged(String Dir, String NewName);
350     virtual void InstrumentCountChanged(String Dir);
351     virtual void InstrumentInfoChanged(String Instr);
352     virtual void InstrumentNameChanged(String Instr, String NewName);
353 iliev 1200 virtual void JobStatusChanged(int JobId);
354 iliev 1161 } dbInstrumentsEventHandler;
355     #endif // HAVE_SQLITE3
356 schoenebeck 35 };
357    
358     #endif // __LSCPSERVER_H_

  ViewVC Help
Powered by ViewVC