trunk/src/common.h

// common.h
//
/****************************************************************************
   liblscp - LinuxSampler Control Protocol API
   Copyright (C) 2004, rncbc aka Rui Nuno Capela. All rights reserved.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   This library 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
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with this library; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

*****************************************************************************/

#ifndef __LSCP_COMMON_H
#define __LSCP_COMMON_H

#include "lscp/client.h"
#include "lscp/device.h"


// Case unsensitive comparison substitutes.
#if defined(WIN32)
#define strcasecmp      stricmp
#define strncasecmp     strnicmp
#endif

//-------------------------------------------------------------------------
// Client opaque descriptor struct.

struct _lscp_client_t
{
    // Client socket stuff.
    lscp_client_proc_t  pfnCallback;
    void *              pvData;
    lscp_socket_agent_t cmd;
    lscp_socket_agent_t evt;
    // Subscribed events.
    lscp_event_t        events;
    // Client struct persistent caches.
    char **             audio_drivers;
    char **             midi_drivers;
    int  *              audio_devices;
    int  *              midi_devices;
    char **             engines;
    int  *              channels;
    // Client struct volatile caches.
    lscp_driver_info_t  audio_driver_info;
    lscp_driver_info_t  midi_driver_info;
    lscp_device_info_t  audio_device_info;
    lscp_device_info_t  midi_device_info;
    lscp_param_info_t   audio_param_info;
    lscp_param_info_t   midi_param_info;
    lscp_device_port_info_t audio_channel_info;
    lscp_device_port_info_t midi_port_info;
    lscp_param_info_t   audio_channel_param_info;
    lscp_param_info_t   midi_port_param_info;
    lscp_engine_info_t  engine_info;
    lscp_channel_info_t channel_info;
    // Result and error status.
    char *              pszResult;
    int                 iErrno;
    // Stream buffers status.
    lscp_buffer_fill_t *buffer_fill;
    int                 iStreamCount;
    // Transaction call timeout (msecs).
    int                 iTimeout;
    lscp_mutex_t        mutex;
    lscp_cond_t         cond;
};


//-------------------------------------------------------------------------
// Local client request executive.

lscp_status_t   lscp_client_call            (lscp_client_t *pClient, const char *pszQuery);
void            lscp_client_set_result      (lscp_client_t *pClient, char *pszResult, int iErrno);

//-------------------------------------------------------------------------
// General utility function prototypes.

char *          lscp_strtok                 (char *pchBuffer, const char *pszSeps, char **ppch);
char *          lscp_ltrim                  (char *psz);
char *          lscp_unquote                (char **ppsz, int dup);
void            lscp_unquote_dup            (char **ppszDst, char **ppszSrc);

char **         lscp_szsplit_create         (const char *pszCsv, const char *pszSeps);
void            lscp_szsplit_destroy        (char **ppszSplit);
#ifdef LSCP_SZSPLIT_COUNT
int             lscp_szsplit_count          (char **ppszSplit);
int             lscp_szsplit_size           (char **ppszSplit);
#endif

int *           lscp_isplit_create          (const char *pszCsv, const char *pszSeps);
void            lscp_isplit_destroy         (int *piSplit);
#ifdef LSCP_ISPLIT_COUNT
int             lscp_isplit_count           (int *piSplit);
int             lscp_isplit_size            (int *piSplit);
#endif

lscp_param_t *  lscp_psplit_create          (const char *pszCsv, const char *pszSep1, const char *pszSep2);
void            lscp_psplit_destroy         (lscp_param_t *ppSplit);
#ifdef LSCP_PSPLIT_COUNT
int             lscp_psplit_count           (lscp_param_t *ppSplit);
int             lscp_psplit_size            (lscp_param_t *ppSplit);
#endif

void            lscp_plist_alloc       (lscp_param_t **ppList);
void            lscp_plist_free        (lscp_param_t **ppList);
void            lscp_plist_append      (lscp_param_t **ppList, const char *pszKey, const char *pszValue);
#ifdef LSCP_PLIST_COUNT
int             lscp_plist_count       (lscp_param_t **ppList);
int             lscp_plist_size        (lscp_param_t **ppList);
#endif

//-------------------------------------------------------------------------
// Engine struct helper functions.

void            lscp_engine_info_init       (lscp_engine_info_t *pEngineInfo);
void            lscp_engine_info_free       (lscp_engine_info_t *pEngineInfo);
void            lscp_engine_info_reset      (lscp_engine_info_t *pEngineInfo);

//-------------------------------------------------------------------------
// Channel struct helper functions.

void            lscp_channel_info_init      (lscp_channel_info_t *pChannelInfo);
void            lscp_channel_info_free      (lscp_channel_info_t *pChannelInfo);
void            lscp_channel_info_reset     (lscp_channel_info_t *pChannelInfo);

//-------------------------------------------------------------------------
// Driver struct helper functions.

void            lscp_driver_info_init       (lscp_driver_info_t *pDriverInfo);
void            lscp_driver_info_free       (lscp_driver_info_t *pDriverInfo);
void            lscp_driver_info_reset      (lscp_driver_info_t *pDriverInfo);

//-------------------------------------------------------------------------
// Device struct helper functions.

void            lscp_device_info_init       (lscp_device_info_t *pDeviceInfo);
void            lscp_device_info_free       (lscp_device_info_t *pDeviceInfo);
void            lscp_device_info_reset      (lscp_device_info_t *pDeviceInfo);

//-------------------------------------------------------------------------
// Device channel/port struct helper functions.

void            lscp_device_port_info_init  (lscp_device_port_info_t *pDevicePortInfo);
void            lscp_device_port_info_free  (lscp_device_port_info_t *pDevicePortInfo);
void            lscp_device_port_info_reset (lscp_device_port_info_t *pDevicePortInfo);

//-------------------------------------------------------------------------
// Parameter struct helper functions.

void            lscp_param_info_init        (lscp_param_info_t *pParamInfo);
void            lscp_param_info_free        (lscp_param_info_t *pParamInfo);
void            lscp_param_info_reset       (lscp_param_info_t *pParamInfo);

//-------------------------------------------------------------------------
// Concatenate a parameter list (key='value'...) into a string.

int             lscp_param_concat           (char *pszBuffer, int cchMaxBuffer, lscp_param_t *pParams);


#endif // __LSCP_COMMON_H

// end of common.h
1	capela	103	// common.h
2			//
3			/****************************************************************************
4			liblscp - LinuxSampler Control Protocol API
5			Copyright (C) 2004, rncbc aka Rui Nuno Capela. All rights reserved.
6
7			This library is free software; you can redistribute it and/or
8			modify it under the terms of the GNU Lesser General Public
9			License as published by the Free Software Foundation; either
10			version 2.1 of the License, or (at your option) any later version.
11
12			This library is distributed in the hope that it will be useful,
13			but WITHOUT ANY WARRANTY; without even the implied warranty of
14			MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15			Lesser General Public License for more details.
16
17			You should have received a copy of the GNU Lesser General Public
18			License along with this library; if not, write to the Free Software
19			Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20
21			*****************************************************************************/
22
23			#ifndef __LSCP_COMMON_H
24			#define __LSCP_COMMON_H
25
26			#include "lscp/client.h"
27			#include "lscp/device.h"
28
29
30			// Case unsensitive comparison substitutes.
31			#if defined(WIN32)
32			#define strcasecmp stricmp
33			#define strncasecmp strnicmp
34			#endif
35
36			//-------------------------------------------------------------------------
37			// Client opaque descriptor struct.
38
39			struct _lscp_client_t
40			{
41			// Client socket stuff.
42			lscp_client_proc_t pfnCallback;
43			void * pvData;
44	capela	132	lscp_socket_agent_t cmd;
45			lscp_socket_agent_t evt;
46	capela	144	// Subscribed events.
47			lscp_event_t events;
48	capela	103	// Client struct persistent caches.
49			char ** audio_drivers;
50			char ** midi_drivers;
51	capela	125	int * audio_devices;
52			int * midi_devices;
53	capela	103	char ** engines;
54	capela	125	int * channels;
55	capela	103	// Client struct volatile caches.
56	capela	171	lscp_driver_info_t audio_driver_info;
57			lscp_driver_info_t midi_driver_info;
58			lscp_device_info_t audio_device_info;
59			lscp_device_info_t midi_device_info;
60	capela	163	lscp_param_info_t audio_param_info;
61			lscp_param_info_t midi_param_info;
62	capela	171	lscp_device_port_info_t audio_channel_info;
63			lscp_device_port_info_t midi_port_info;
64			lscp_param_info_t audio_channel_param_info;
65			lscp_param_info_t midi_port_param_info;
66	capela	103	lscp_engine_info_t engine_info;
67			lscp_channel_info_t channel_info;
68			// Result and error status.
69			char * pszResult;
70			int iErrno;
71			// Stream buffers status.
72			lscp_buffer_fill_t *buffer_fill;
73			int iStreamCount;
74			// Transaction call timeout (msecs).
75			int iTimeout;
76			lscp_mutex_t mutex;
77	capela	177	lscp_cond_t cond;
78	capela	103	};
79
80
81			//-------------------------------------------------------------------------
82	capela	132	// Local client request executive.
83
84			lscp_status_t lscp_client_call (lscp_client_t pClient, const char pszQuery);
85			void lscp_client_set_result (lscp_client_t pClient, char pszResult, int iErrno);
86
87			//-------------------------------------------------------------------------
88	capela	103	// General utility function prototypes.
89
90	capela	132	char * lscp_strtok (char pchBuffer, const char pszSeps, char **ppch);
91			char * lscp_ltrim (char *psz);
92			char * lscp_unquote (char **ppsz, int dup);
93	capela	180	void lscp_unquote_dup (char ppszDst, char ppszSrc);
94	capela	103
95	capela	132	char ** lscp_szsplit_create (const char pszCsv, const char pszSeps);
96			void lscp_szsplit_destroy (char **ppszSplit);
97	capela	103	#ifdef LSCP_SZSPLIT_COUNT
98	capela	132	int lscp_szsplit_count (char **ppszSplit);
99			int lscp_szsplit_size (char **ppszSplit);
100	capela	103	#endif
101
102	capela	132	int * lscp_isplit_create (const char pszCsv, const char pszSeps);
103	capela	158	void lscp_isplit_destroy (int *piSplit);
104	capela	125	#ifdef LSCP_ISPLIT_COUNT
105	capela	158	int lscp_isplit_count (int *piSplit);
106			int lscp_isplit_size (int *piSplit);
107	capela	125	#endif
108	capela	103
109	capela	158	lscp_param_t * lscp_psplit_create (const char pszCsv, const char pszSep1, const char *pszSep2);
110			void lscp_psplit_destroy (lscp_param_t *ppSplit);
111			#ifdef LSCP_PSPLIT_COUNT
112			int lscp_psplit_count (lscp_param_t *ppSplit);
113			int lscp_psplit_size (lscp_param_t *ppSplit);
114			#endif
115
116	capela	171	void lscp_plist_alloc (lscp_param_t **ppList);
117			void lscp_plist_free (lscp_param_t **ppList);
118			void lscp_plist_append (lscp_param_t *ppList, const char pszKey, const char *pszValue);
119			#ifdef LSCP_PLIST_COUNT
120			int lscp_plist_count (lscp_param_t **ppList);
121			int lscp_plist_size (lscp_param_t **ppList);
122			#endif
123
124	capela	103	//-------------------------------------------------------------------------
125			// Engine struct helper functions.
126
127	capela	132	void lscp_engine_info_init (lscp_engine_info_t *pEngineInfo);
128	capela	179	void lscp_engine_info_free (lscp_engine_info_t *pEngineInfo);
129	capela	132	void lscp_engine_info_reset (lscp_engine_info_t *pEngineInfo);
130	capela	103
131			//-------------------------------------------------------------------------
132			// Channel struct helper functions.
133
134	capela	132	void lscp_channel_info_init (lscp_channel_info_t *pChannelInfo);
135	capela	179	void lscp_channel_info_free (lscp_channel_info_t *pChannelInfo);
136	capela	132	void lscp_channel_info_reset (lscp_channel_info_t *pChannelInfo);
137	capela	103
138			//-------------------------------------------------------------------------
139			// Driver struct helper functions.
140
141	capela	132	void lscp_driver_info_init (lscp_driver_info_t *pDriverInfo);
142	capela	179	void lscp_driver_info_free (lscp_driver_info_t *pDriverInfo);
143	capela	132	void lscp_driver_info_reset (lscp_driver_info_t *pDriverInfo);
144	capela	103
145	capela	163	//-------------------------------------------------------------------------
146	capela	171	// Device struct helper functions.
147
148			void lscp_device_info_init (lscp_device_info_t *pDeviceInfo);
149	capela	179	void lscp_device_info_free (lscp_device_info_t *pDeviceInfo);
150	capela	171	void lscp_device_info_reset (lscp_device_info_t *pDeviceInfo);
151
152			//-------------------------------------------------------------------------
153			// Device channel/port struct helper functions.
154
155			void lscp_device_port_info_init (lscp_device_port_info_t *pDevicePortInfo);
156	capela	179	void lscp_device_port_info_free (lscp_device_port_info_t *pDevicePortInfo);
157	capela	171	void lscp_device_port_info_reset (lscp_device_port_info_t *pDevicePortInfo);
158
159			//-------------------------------------------------------------------------
160	capela	163	// Parameter struct helper functions.
161	capela	103
162	capela	163	void lscp_param_info_init (lscp_param_info_t *pParamInfo);
163	capela	179	void lscp_param_info_free (lscp_param_info_t *pParamInfo);
164	capela	163	void lscp_param_info_reset (lscp_param_info_t *pParamInfo);
165
166			//-------------------------------------------------------------------------
167			// Concatenate a parameter list (key='value'...) into a string.
168
169			int lscp_param_concat (char pszBuffer, int cchMaxBuffer, lscp_param_t pParams);
170
171
172	capela	103	#endif // __LSCP_COMMON_H
173
174			// end of common.h