jack2 codebase
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

649 lines
16KB

  1. /*
  2. JACK control API
  3. Copyright (C) 2008 Nedko Arnaudov
  4. This program is free software; you can redistribute it and/or modify
  5. it under the terms of the GNU General Public License as published by
  6. the Free Software Foundation; version 2 of the License.
  7. This program is distributed in the hope that it will be useful,
  8. but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  10. GNU General Public License for more details.
  11. You should have received a copy of the GNU General Public License
  12. along with this program; if not, write to the Free Software
  13. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  14. */
  15. #ifndef __control_types__
  16. #define __control_types__
  17. #include "jslist.h"
  18. #include "JackExports.h"
  19. #ifdef WIN32
  20. typedef HANDLE sigset_t;
  21. #endif
  22. /** Parameter types, intentionally similar to jack_driver_param_type_t */
  23. typedef enum
  24. {
  25. JackParamInt = 1, /**< @brief value type is a signed integer */
  26. JackParamUInt, /**< @brief value type is an unsigned integer */
  27. JackParamChar, /**< @brief value type is a char */
  28. JackParamString, /**< @brief value type is a string with max size of ::JACK_PARAM_STRING_MAX+1 chars */
  29. JackParamBool, /**< @brief value type is a boolean */
  30. } jackctl_param_type_t;
  31. /** @brief Max value that jackctl_param_type_t type can have */
  32. #define JACK_PARAM_MAX (JackParamBool + 1)
  33. /** @brief Max length of string parameter value, excluding terminating nul char */
  34. #define JACK_PARAM_STRING_MAX 63
  35. /** @brief Type for parameter value */
  36. /* intentionally similar to jack_driver_param_value_t */
  37. union jackctl_parameter_value
  38. {
  39. uint32_t ui; /**< @brief member used for ::JackParamUInt */
  40. int32_t i; /**< @brief member used for ::JackParamInt */
  41. char c; /**< @brief member used for ::JackParamChar */
  42. char str[JACK_PARAM_STRING_MAX + 1]; /**< @brief member used for ::JackParamString */
  43. bool b; /**< @brief member used for ::JackParamBool */
  44. };
  45. /** opaque type for server object */
  46. typedef struct jackctl_server jackctl_server_t;
  47. /** opaque type for driver object */
  48. typedef struct jackctl_driver jackctl_driver_t;
  49. /** opaque type for parameter object */
  50. typedef struct jackctl_parameter jackctl_parameter_t;
  51. #ifdef __cplusplus
  52. extern "C" {
  53. #endif
  54. #if 0
  55. } /* Adjust editor indent */
  56. #endif
  57. EXPORT sigset_t
  58. jackctl_setup_signals(
  59. unsigned int flags);
  60. EXPORT void
  61. jackctl_wait_signals(
  62. sigset_t signals);
  63. EXPORT jackctl_server_t *
  64. jackctl_server_create();
  65. EXPORT void
  66. jackctl_server_destroy(
  67. jackctl_server_t * server);
  68. EXPORT const JSList *
  69. jackctl_server_get_drivers_list(
  70. jackctl_server_t * server);
  71. EXPORT bool
  72. jackctl_server_start(
  73. jackctl_server_t * server,
  74. jackctl_driver_t * driver);
  75. EXPORT bool
  76. jackctl_server_stop(
  77. jackctl_server_t * server);
  78. EXPORT const JSList *
  79. jackctl_server_get_parameters(
  80. jackctl_server_t * server);
  81. EXPORT const char *
  82. jackctl_driver_get_name(
  83. jackctl_driver_t * driver);
  84. EXPORT const JSList *
  85. jackctl_driver_get_parameters(
  86. jackctl_driver_t * driver);
  87. EXPORT const char *
  88. jackctl_parameter_get_name(
  89. jackctl_parameter_t * parameter);
  90. EXPORT const char *
  91. jackctl_parameter_get_short_description(
  92. jackctl_parameter_t * parameter);
  93. EXPORT const char *
  94. jackctl_parameter_get_long_description(
  95. jackctl_parameter_t * parameter);
  96. EXPORT jackctl_param_type_t
  97. jackctl_parameter_get_type(
  98. jackctl_parameter_t * parameter);
  99. EXPORT char
  100. jackctl_parameter_get_id(
  101. jackctl_parameter_t * parameter);
  102. EXPORT bool
  103. jackctl_parameter_is_set(
  104. jackctl_parameter_t * parameter);
  105. EXPORT bool
  106. jackctl_parameter_reset(
  107. jackctl_parameter_t * parameter);
  108. EXPORT union jackctl_parameter_value
  109. jackctl_parameter_get_value(
  110. jackctl_parameter_t * parameter);
  111. EXPORT bool
  112. jackctl_parameter_set_value(
  113. jackctl_parameter_t * parameter,
  114. const union jackctl_parameter_value * value_ptr);
  115. EXPORT union jackctl_parameter_value
  116. jackctl_parameter_get_default_value(
  117. jackctl_parameter_t * parameter);
  118. #if 0
  119. { /* Adjust editor indent */
  120. #endif
  121. #ifdef __cplusplus
  122. } /* extern "C" */
  123. #endif
  124. #endif
  125. /*
  126. JACK control API
  127. Copyright (C) 2008 Nedko Arnaudov
  128. This program is free software; you can redistribute it and/or modify
  129. it under the terms of the GNU General Public License as published by
  130. the Free Software Foundation; version 2 of the License.
  131. This program is distributed in the hope that it will be useful,
  132. but WITHOUT ANY WARRANTY; without even the implied warranty of
  133. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  134. GNU General Public License for more details.
  135. You should have received a copy of the GNU General Public License
  136. along with this program; if not, write to the Free Software
  137. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  138. */
  139. #ifndef __control_types__
  140. #define __control_types__
  141. #include "jslist.h"
  142. #include "JackExports.h"
  143. #ifdef WIN32
  144. typedef HANDLE sigset_t;
  145. #endif
  146. /** Parameter types, intentionally similar to jack_driver_param_type_t */
  147. typedef enum
  148. {
  149. JackParamInt = 1, /**< @brief value type is a signed integer */
  150. JackParamUInt, /**< @brief value type is an unsigned integer */
  151. JackParamChar, /**< @brief value type is a char */
  152. JackParamString, /**< @brief value type is a string with max size of ::JACK_PARAM_STRING_MAX+1 chars */
  153. JackParamBool, /**< @brief value type is a boolean */
  154. } jackctl_param_type_t;
  155. /** @brief Max value that jackctl_param_type_t type can have */
  156. #define JACK_PARAM_MAX (JackParamBool + 1)
  157. /** @brief Max length of string parameter value, excluding terminating nul char */
  158. #define JACK_PARAM_STRING_MAX 63
  159. /** @brief Type for parameter value */
  160. /* intentionally similar to jack_driver_param_value_t */
  161. union jackctl_parameter_value
  162. {
  163. uint32_t ui; /**< @brief member used for ::JackParamUInt */
  164. int32_t i; /**< @brief member used for ::JackParamInt */
  165. char c; /**< @brief member used for ::JackParamChar */
  166. char str[JACK_PARAM_STRING_MAX + 1]; /**< @brief member used for ::JackParamString */
  167. bool b; /**< @brief member used for ::JackParamBool */
  168. };
  169. /** opaque type for server object */
  170. typedef struct jackctl_server jackctl_server_t;
  171. /** opaque type for driver object */
  172. typedef struct jackctl_driver jackctl_driver_t;
  173. /** opaque type for parameter object */
  174. typedef struct jackctl_parameter jackctl_parameter_t;
  175. #ifdef __cplusplus
  176. extern "C" {
  177. #endif
  178. #if 0
  179. } /* Adjust editor indent */
  180. #endif
  181. EXPORT sigset_t
  182. jackctl_setup_signals(
  183. unsigned int flags);
  184. EXPORT void
  185. jackctl_wait_signals(
  186. sigset_t signals);
  187. EXPORT jackctl_server_t *
  188. jackctl_server_create();
  189. EXPORT void
  190. jackctl_server_destroy(
  191. jackctl_server_t * server);
  192. EXPORT const JSList *
  193. jackctl_server_get_drivers_list(
  194. jackctl_server_t * server);
  195. EXPORT bool
  196. jackctl_server_start(
  197. jackctl_server_t * server,
  198. jackctl_driver_t * driver);
  199. EXPORT bool
  200. jackctl_server_stop(
  201. jackctl_server_t * server);
  202. EXPORT const JSList *
  203. jackctl_server_get_parameters(
  204. jackctl_server_t * server);
  205. EXPORT const char *
  206. jackctl_driver_get_name(
  207. jackctl_driver_t * driver);
  208. EXPORT const JSList *
  209. jackctl_driver_get_parameters(
  210. jackctl_driver_t * driver);
  211. EXPORT const char *
  212. jackctl_parameter_get_name(
  213. jackctl_parameter_t * parameter);
  214. EXPORT const char *
  215. jackctl_parameter_get_short_description(
  216. jackctl_parameter_t * parameter);
  217. EXPORT const char *
  218. jackctl_parameter_get_long_description(
  219. jackctl_parameter_t * parameter);
  220. EXPORT jackctl_param_type_t
  221. jackctl_parameter_get_type(
  222. jackctl_parameter_t * parameter);
  223. EXPORT char
  224. jackctl_parameter_get_id(
  225. jackctl_parameter_t * parameter);
  226. EXPORT bool
  227. jackctl_parameter_is_set(
  228. jackctl_parameter_t * parameter);
  229. EXPORT bool
  230. jackctl_parameter_reset(
  231. jackctl_parameter_t * parameter);
  232. EXPORT union jackctl_parameter_value
  233. jackctl_parameter_get_value(
  234. jackctl_parameter_t * parameter);
  235. EXPORT bool
  236. jackctl_parameter_set_value(
  237. jackctl_parameter_t * parameter,
  238. const union jackctl_parameter_value * value_ptr);
  239. EXPORT union jackctl_parameter_value
  240. jackctl_parameter_get_default_value(
  241. jackctl_parameter_t * parameter);
  242. #if 0
  243. { /* Adjust editor indent */
  244. #endif
  245. #ifdef __cplusplus
  246. } /* extern "C" */
  247. #endif
  248. #endif
  249. /*
  250. JACK control API
  251. Copyright (C) 2008 Nedko Arnaudov
  252. This program is free software; you can redistribute it and/or modify
  253. it under the terms of the GNU General Public License as published by
  254. the Free Software Foundation; version 2 of the License.
  255. This program is distributed in the hope that it will be useful,
  256. but WITHOUT ANY WARRANTY; without even the implied warranty of
  257. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  258. GNU General Public License for more details.
  259. You should have received a copy of the GNU General Public License
  260. along with this program; if not, write to the Free Software
  261. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  262. */
  263. #ifndef __control_types__
  264. #define __control_types__
  265. #include "jslist.h"
  266. #include "JackExports.h"
  267. #ifdef WIN32
  268. typedef HANDLE sigset_t;
  269. #endif
  270. /** Parameter types, intentionally similar to jack_driver_param_type_t */
  271. typedef enum
  272. {
  273. JackParamInt = 1, /**< @brief value type is a signed integer */
  274. JackParamUInt, /**< @brief value type is an unsigned integer */
  275. JackParamChar, /**< @brief value type is a char */
  276. JackParamString, /**< @brief value type is a string with max size of ::JACK_PARAM_STRING_MAX+1 chars */
  277. JackParamBool, /**< @brief value type is a boolean */
  278. } jackctl_param_type_t;
  279. /** @brief Max value that jackctl_param_type_t type can have */
  280. #define JACK_PARAM_MAX (JackParamBool + 1)
  281. /** @brief Max length of string parameter value, excluding terminating nul char */
  282. #define JACK_PARAM_STRING_MAX 63
  283. /** @brief Type for parameter value */
  284. /* intentionally similar to jack_driver_param_value_t */
  285. union jackctl_parameter_value
  286. {
  287. uint32_t ui; /**< @brief member used for ::JackParamUInt */
  288. int32_t i; /**< @brief member used for ::JackParamInt */
  289. char c; /**< @brief member used for ::JackParamChar */
  290. char str[JACK_PARAM_STRING_MAX + 1]; /**< @brief member used for ::JackParamString */
  291. bool b; /**< @brief member used for ::JackParamBool */
  292. };
  293. /** opaque type for server object */
  294. typedef struct jackctl_server jackctl_server_t;
  295. /** opaque type for driver object */
  296. typedef struct jackctl_driver jackctl_driver_t;
  297. /** opaque type for parameter object */
  298. typedef struct jackctl_parameter jackctl_parameter_t;
  299. #ifdef __cplusplus
  300. extern "C" {
  301. #endif
  302. #if 0
  303. } /* Adjust editor indent */
  304. #endif
  305. EXPORT sigset_t
  306. jackctl_setup_signals(
  307. unsigned int flags);
  308. EXPORT void
  309. jackctl_wait_signals(
  310. sigset_t signals);
  311. EXPORT jackctl_server_t *
  312. jackctl_server_create();
  313. EXPORT void
  314. jackctl_server_destroy(
  315. jackctl_server_t * server);
  316. EXPORT const JSList *
  317. jackctl_server_get_drivers_list(
  318. jackctl_server_t * server);
  319. EXPORT bool
  320. jackctl_server_start(
  321. jackctl_server_t * server,
  322. jackctl_driver_t * driver);
  323. EXPORT bool
  324. jackctl_server_stop(
  325. jackctl_server_t * server);
  326. EXPORT const JSList *
  327. jackctl_server_get_parameters(
  328. jackctl_server_t * server);
  329. EXPORT const char *
  330. jackctl_driver_get_name(
  331. jackctl_driver_t * driver);
  332. EXPORT const JSList *
  333. jackctl_driver_get_parameters(
  334. jackctl_driver_t * driver);
  335. EXPORT const char *
  336. jackctl_parameter_get_name(
  337. jackctl_parameter_t * parameter);
  338. EXPORT const char *
  339. jackctl_parameter_get_short_description(
  340. jackctl_parameter_t * parameter);
  341. EXPORT const char *
  342. jackctl_parameter_get_long_description(
  343. jackctl_parameter_t * parameter);
  344. EXPORT jackctl_param_type_t
  345. jackctl_parameter_get_type(
  346. jackctl_parameter_t * parameter);
  347. EXPORT char
  348. jackctl_parameter_get_id(
  349. jackctl_parameter_t * parameter);
  350. EXPORT bool
  351. jackctl_parameter_is_set(
  352. jackctl_parameter_t * parameter);
  353. EXPORT bool
  354. jackctl_parameter_reset(
  355. jackctl_parameter_t * parameter);
  356. EXPORT union jackctl_parameter_value
  357. jackctl_parameter_get_value(
  358. jackctl_parameter_t * parameter);
  359. EXPORT bool
  360. jackctl_parameter_set_value(
  361. jackctl_parameter_t * parameter,
  362. const union jackctl_parameter_value * value_ptr);
  363. EXPORT union jackctl_parameter_value
  364. jackctl_parameter_get_default_value(
  365. jackctl_parameter_t * parameter);
  366. #if 0
  367. { /* Adjust editor indent */
  368. #endif
  369. #ifdef __cplusplus
  370. } /* extern "C" */
  371. #endif
  372. #endif
  373. /*
  374. JACK control API
  375. Copyright (C) 2008 Nedko Arnaudov
  376. This program is free software; you can redistribute it and/or modify
  377. it under the terms of the GNU General Public License as published by
  378. the Free Software Foundation; version 2 of the License.
  379. This program is distributed in the hope that it will be useful,
  380. but WITHOUT ANY WARRANTY; without even the implied warranty of
  381. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  382. GNU General Public License for more details.
  383. You should have received a copy of the GNU General Public License
  384. along with this program; if not, write to the Free Software
  385. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  386. */
  387. #ifndef __control_types__
  388. #define __control_types__
  389. #include "jslist.h"
  390. #include "JackExports.h"
  391. #ifdef WIN32
  392. typedef HANDLE sigset_t;
  393. #endif
  394. /** Parameter types, intentionally similar to jack_driver_param_type_t */
  395. typedef enum
  396. {
  397. JackParamInt = 1, /**< @brief value type is a signed integer */
  398. JackParamUInt, /**< @brief value type is an unsigned integer */
  399. JackParamChar, /**< @brief value type is a char */
  400. JackParamString, /**< @brief value type is a string with max size of ::JACK_PARAM_STRING_MAX+1 chars */
  401. JackParamBool, /**< @brief value type is a boolean */
  402. } jackctl_param_type_t;
  403. /** @brief Max value that jackctl_param_type_t type can have */
  404. #define JACK_PARAM_MAX (JackParamBool + 1)
  405. /** @brief Max length of string parameter value, excluding terminating nul char */
  406. #define JACK_PARAM_STRING_MAX 63
  407. /** @brief Type for parameter value */
  408. /* intentionally similar to jack_driver_param_value_t */
  409. union jackctl_parameter_value
  410. {
  411. uint32_t ui; /**< @brief member used for ::JackParamUInt */
  412. int32_t i; /**< @brief member used for ::JackParamInt */
  413. char c; /**< @brief member used for ::JackParamChar */
  414. char str[JACK_PARAM_STRING_MAX + 1]; /**< @brief member used for ::JackParamString */
  415. bool b; /**< @brief member used for ::JackParamBool */
  416. };
  417. /** opaque type for server object */
  418. typedef struct jackctl_server jackctl_server_t;
  419. /** opaque type for driver object */
  420. typedef struct jackctl_driver jackctl_driver_t;
  421. /** opaque type for parameter object */
  422. typedef struct jackctl_parameter jackctl_parameter_t;
  423. #ifdef __cplusplus
  424. extern "C" {
  425. #endif
  426. #if 0
  427. } /* Adjust editor indent */
  428. #endif
  429. EXPORT sigset_t
  430. jackctl_setup_signals(
  431. unsigned int flags);
  432. EXPORT void
  433. jackctl_wait_signals(
  434. sigset_t signals);
  435. EXPORT jackctl_server_t *
  436. jackctl_server_create();
  437. EXPORT void
  438. jackctl_server_destroy(
  439. jackctl_server_t * server);
  440. EXPORT const JSList *
  441. jackctl_server_get_drivers_list(
  442. jackctl_server_t * server);
  443. EXPORT bool
  444. jackctl_server_start(
  445. jackctl_server_t * server,
  446. jackctl_driver_t * driver);
  447. EXPORT bool
  448. jackctl_server_stop(
  449. jackctl_server_t * server);
  450. EXPORT const JSList *
  451. jackctl_server_get_parameters(
  452. jackctl_server_t * server);
  453. EXPORT const char *
  454. jackctl_driver_get_name(
  455. jackctl_driver_t * driver);
  456. EXPORT const JSList *
  457. jackctl_driver_get_parameters(
  458. jackctl_driver_t * driver);
  459. EXPORT const char *
  460. jackctl_parameter_get_name(
  461. jackctl_parameter_t * parameter);
  462. EXPORT const char *
  463. jackctl_parameter_get_short_description(
  464. jackctl_parameter_t * parameter);
  465. EXPORT const char *
  466. jackctl_parameter_get_long_description(
  467. jackctl_parameter_t * parameter);
  468. EXPORT jackctl_param_type_t
  469. jackctl_parameter_get_type(
  470. jackctl_parameter_t * parameter);
  471. EXPORT char
  472. jackctl_parameter_get_id(
  473. jackctl_parameter_t * parameter);
  474. EXPORT bool
  475. jackctl_parameter_is_set(
  476. jackctl_parameter_t * parameter);
  477. EXPORT bool
  478. jackctl_parameter_reset(
  479. jackctl_parameter_t * parameter);
  480. EXPORT union jackctl_parameter_value
  481. jackctl_parameter_get_value(
  482. jackctl_parameter_t * parameter);
  483. EXPORT bool
  484. jackctl_parameter_set_value(
  485. jackctl_parameter_t * parameter,
  486. const union jackctl_parameter_value * value_ptr);
  487. EXPORT union jackctl_parameter_value
  488. jackctl_parameter_get_default_value(
  489. jackctl_parameter_t * parameter);
  490. #if 0
  491. { /* Adjust editor indent */
  492. #endif
  493. #ifdef __cplusplus
  494. } /* extern "C" */
  495. #endif
  496. #endif