~ubuntu-branches/ubuntu/quantal/jackd2/quantal

« back to all changes in this revision

Viewing changes to .pc/0000_sync_upstream_VCS.patch/common/JackControlAPI.h

  • Committer: Bazaar Package Importer
  • Author(s): Reinhard Tartler, Adrian Knoth, Reinhard Tartler, Jonas Smedegaard
  • Date: 2010-06-19 18:54:29 UTC
  • Revision ID: james.westby@ubuntu.com-20100619185429-zhbhh0mqvukgzx0l
Tags: 1.9.5~dfsg-15
[ Adrian Knoth ]
* Also provide the shlibs file for libjack-jackd2-0
* Fix FTBFS on sparc64 (Closes: #586257)

[ Reinhard Tartler ]
* jackd must not be a virtual package, use 'jack-daemon' for that
* add breaks/replaces on old libjack0
* change shlibsfile to prefer jackd2's libjack
* use conflicts instead of breaks. libjack-jackd2-0 has file conflicts
  with libjack0 and will keep it

[ Jonas Smedegaard ]
* Update control file.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
/*
 
2
  JACK control API
 
3
 
 
4
  Copyright (C) 2008 Nedko Arnaudov
 
5
  Copyright (C) 2008 Grame
 
6
 
 
7
  This program is free software; you can redistribute it and/or modify
 
8
  it under the terms of the GNU General Public License as published by
 
9
  the Free Software Foundation; version 2 of the License.
 
10
 
 
11
  This program is distributed in the hope that it will be useful,
 
12
  but WITHOUT ANY WARRANTY; without even the implied warranty of
 
13
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
14
  GNU General Public License for more details.
 
15
 
 
16
  You should have received a copy of the GNU General Public License
 
17
  along with this program; if not, write to the Free Software
 
18
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 
19
 
 
20
*/
 
21
 
 
22
#ifndef __JackControlAPI__
 
23
#define __JackControlAPI__
 
24
 
 
25
#include "jslist.h"
 
26
#include "JackCompilerDeps.h"
 
27
 
 
28
#ifdef WIN32
 
29
#ifdef __MINGW32__
 
30
#include <sys/types.h>
 
31
#else
 
32
typedef HANDLE sigset_t;
 
33
#endif
 
34
#endif
 
35
 
 
36
/** Parameter types, intentionally similar to jack_driver_param_type_t */
 
37
typedef enum
 
38
{
 
39
    JackParamInt = 1,                   /**< @brief value type is a signed integer */
 
40
    JackParamUInt,                              /**< @brief value type is an unsigned integer */
 
41
    JackParamChar,                              /**< @brief value type is a char */
 
42
    JackParamString,                    /**< @brief value type is a string with max size of ::JACK_PARAM_STRING_MAX+1 chars */
 
43
    JackParamBool,                              /**< @brief value type is a boolean */
 
44
} jackctl_param_type_t;
 
45
 
 
46
/** @brief Max value that jackctl_param_type_t type can have */
 
47
#define JACK_PARAM_MAX (JackParamBool + 1)
 
48
 
 
49
/** @brief Max length of string parameter value, excluding terminating nul char */
 
50
#define JACK_PARAM_STRING_MAX  63
 
51
 
 
52
/** @brief Type for parameter value */
 
53
/* intentionally similar to jack_driver_param_value_t */
 
54
union jackctl_parameter_value
 
55
{
 
56
    uint32_t ui;                                /**< @brief member used for ::JackParamUInt */
 
57
    int32_t i;                                  /**< @brief member used for ::JackParamInt */
 
58
    char c;                                             /**< @brief member used for ::JackParamChar */
 
59
    char str[JACK_PARAM_STRING_MAX + 1]; /**< @brief member used for ::JackParamString */
 
60
    bool b;                             /**< @brief member used for ::JackParamBool */
 
61
};
 
62
 
 
63
/** opaque type for server object */
 
64
typedef struct jackctl_server jackctl_server_t;
 
65
 
 
66
/** opaque type for driver object */
 
67
typedef struct jackctl_driver jackctl_driver_t;
 
68
 
 
69
/** opaque type for internal client object */
 
70
typedef struct jackctl_internal jackctl_internal_t;
 
71
 
 
72
/** opaque type for parameter object */
 
73
typedef struct jackctl_parameter jackctl_parameter_t;
 
74
 
 
75
#ifdef __cplusplus
 
76
extern "C" {
 
77
#endif
 
78
#if 0
 
79
} /* Adjust editor indent */
 
80
#endif
 
81
 
 
82
EXPORT sigset_t
 
83
jackctl_setup_signals(
 
84
    unsigned int flags);
 
85
 
 
86
EXPORT void
 
87
jackctl_wait_signals(
 
88
    sigset_t signals);
 
89
 
 
90
EXPORT jackctl_server_t *
 
91
jackctl_server_create(
 
92
    bool (* on_device_acquire)(const char * device_name),
 
93
    void (* on_device_release)(const char * device_name));
 
94
 
 
95
EXPORT void
 
96
jackctl_server_destroy(
 
97
        jackctl_server_t * server);
 
98
 
 
99
EXPORT const JSList *
 
100
jackctl_server_get_drivers_list(
 
101
        jackctl_server_t * server);
 
102
 
 
103
EXPORT bool
 
104
jackctl_server_start(
 
105
    jackctl_server_t * server,
 
106
    jackctl_driver_t * driver);
 
107
 
 
108
EXPORT bool
 
109
jackctl_server_stop(
 
110
        jackctl_server_t * server);
 
111
 
 
112
EXPORT const JSList *
 
113
jackctl_server_get_parameters(
 
114
        jackctl_server_t * server);
 
115
 
 
116
EXPORT const char *
 
117
jackctl_driver_get_name(
 
118
        jackctl_driver_t * driver);
 
119
 
 
120
EXPORT const JSList *
 
121
jackctl_driver_get_parameters(
 
122
        jackctl_driver_t * driver);
 
123
 
 
124
EXPORT const char *
 
125
jackctl_parameter_get_name(
 
126
        jackctl_parameter_t * parameter);
 
127
 
 
128
EXPORT const char *
 
129
jackctl_parameter_get_short_description(
 
130
        jackctl_parameter_t * parameter);
 
131
 
 
132
EXPORT const char *
 
133
jackctl_parameter_get_long_description(
 
134
        jackctl_parameter_t * parameter);
 
135
 
 
136
EXPORT jackctl_param_type_t
 
137
jackctl_parameter_get_type(
 
138
        jackctl_parameter_t * parameter);
 
139
 
 
140
EXPORT char
 
141
jackctl_parameter_get_id(
 
142
        jackctl_parameter_t * parameter);
 
143
 
 
144
EXPORT bool
 
145
jackctl_parameter_is_set(
 
146
        jackctl_parameter_t * parameter);
 
147
 
 
148
EXPORT bool
 
149
jackctl_parameter_reset(
 
150
        jackctl_parameter_t * parameter);
 
151
 
 
152
EXPORT union jackctl_parameter_value
 
153
jackctl_parameter_get_value(
 
154
        jackctl_parameter_t * parameter);
 
155
 
 
156
EXPORT bool
 
157
jackctl_parameter_set_value(
 
158
        jackctl_parameter_t * parameter,
 
159
        const union jackctl_parameter_value * value_ptr);
 
160
 
 
161
EXPORT union jackctl_parameter_value
 
162
jackctl_parameter_get_default_value(
 
163
        jackctl_parameter_t * parameter);
 
164
    
 
165
EXPORT union jackctl_parameter_value 
 
166
jackctl_parameter_get_default_value(
 
167
    jackctl_parameter *parameter_ptr);
 
168
    
 
169
EXPORT bool
 
170
jackctl_parameter_has_range_constraint(
 
171
        jackctl_parameter_t * parameter_ptr);
 
172
 
 
173
EXPORT bool
 
174
jackctl_parameter_has_enum_constraint(
 
175
        jackctl_parameter_t * parameter_ptr);
 
176
 
 
177
EXPORT uint32_t
 
178
jackctl_parameter_get_enum_constraints_count(
 
179
        jackctl_parameter_t * parameter_ptr);
 
180
 
 
181
EXPORT union jackctl_parameter_value
 
182
jackctl_parameter_get_enum_constraint_value(
 
183
        jackctl_parameter_t * parameter_ptr,
 
184
        uint32_t index);
 
185
 
 
186
EXPORT const char *
 
187
jackctl_parameter_get_enum_constraint_description(
 
188
        jackctl_parameter_t * parameter_ptr,
 
189
        uint32_t index);
 
190
 
 
191
EXPORT void
 
192
jackctl_parameter_get_range_constraint(
 
193
        jackctl_parameter_t * parameter_ptr,
 
194
        union jackctl_parameter_value * min_ptr,
 
195
        union jackctl_parameter_value * max_ptr);
 
196
 
 
197
EXPORT bool
 
198
jackctl_parameter_constraint_is_strict(
 
199
        jackctl_parameter_t * parameter_ptr);
 
200
 
 
201
EXPORT bool
 
202
jackctl_parameter_constraint_is_fake_value(
 
203
        jackctl_parameter_t * parameter_ptr);
 
204
 
 
205
EXPORT const JSList * 
 
206
jackctl_server_get_internals_list(
 
207
    jackctl_server *server_ptr);
 
208
    
 
209
EXPORT const char * 
 
210
jackctl_internal_get_name(
 
211
    jackctl_internal *internal_ptr);
 
212
    
 
213
EXPORT const JSList * 
 
214
jackctl_internal_get_parameters(
 
215
    jackctl_internal *internal_ptr);
 
216
    
 
217
EXPORT bool jackctl_server_load_internal(
 
218
    jackctl_server * server,
 
219
    jackctl_internal * internal);
 
220
    
 
221
EXPORT bool jackctl_server_unload_internal(
 
222
    jackctl_server * server,
 
223
    jackctl_internal * internal);
 
224
    
 
225
EXPORT bool jackctl_server_add_slave(jackctl_server_t * server,
 
226
                            jackctl_driver_t * driver);
 
227
 
 
228
EXPORT bool jackctl_server_remove_slave(jackctl_server_t * server,
 
229
                            jackctl_driver_t * driver);
 
230
 
 
231
EXPORT bool 
 
232
jackctl_server_switch_master(jackctl_server_t * server,
 
233
                            jackctl_driver_t * driver);
 
234
 
 
235
#if 0
 
236
{ /* Adjust editor indent */
 
237
#endif
 
238
#ifdef __cplusplus
 
239
} /* extern "C" */
 
240
#endif
 
241
 
 
242
#endif