Audio plugin host https://kx.studio/carla
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.

475 lines
14KB

  1. /*
  2. * Carla JACK API for external applications
  3. * Copyright (C) 2016-2018 Filipe Coelho <falktx@falktx.com>
  4. *
  5. * This program is free software; you can redistribute it and/or
  6. * modify it under the terms of the GNU General Public License as
  7. * published by the Free Software Foundation; either version 2 of
  8. * the License, or any later version.
  9. *
  10. * This program is distributed in the hope that it will be useful,
  11. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13. * GNU General Public License for more details.
  14. *
  15. * For a full copy of the GNU General Public License see the doc/GPL.txt file.
  16. */
  17. #include "libjack.hpp"
  18. CARLA_BACKEND_USE_NAMESPACE
  19. // --------------------------------------------------------------------------------------------------------------------
  20. CARLA_EXPORT
  21. jack_port_t* jack_port_register(jack_client_t* client, const char* port_name, const char* port_type,
  22. unsigned long flags, unsigned long buffer_size)
  23. {
  24. carla_debug("%s(%p, %s, %s, 0x%lx, %lu)", __FUNCTION__, client, port_name, port_type, flags, buffer_size);
  25. JackClientState* const jclient = (JackClientState*)client;
  26. CARLA_SAFE_ASSERT_RETURN(jclient != nullptr, nullptr);
  27. CARLA_SAFE_ASSERT_RETURN(port_name != nullptr && port_name[0] != '\0', nullptr);
  28. CARLA_SAFE_ASSERT_RETURN(port_type != nullptr && port_type[0] != '\0', nullptr);
  29. const JackServerState& jserver(jclient->server);
  30. if (std::strcmp(port_type, JACK_DEFAULT_AUDIO_TYPE) == 0)
  31. {
  32. if (flags & JackPortIsInput)
  33. {
  34. const std::size_t index = jclient->audioIns.count();
  35. JackPortState* const port = new JackPortState(jclient->name, port_name, index, flags,
  36. false, false, index < jserver.numAudioIns);
  37. {
  38. const CarlaMutexLocker cms(jclient->mutex);
  39. jclient->audioIns.append(port);
  40. }
  41. jclient->portNameMapping[port->fullname] = port;
  42. return (jack_port_t*)port;
  43. }
  44. if (flags & JackPortIsOutput)
  45. {
  46. const std::size_t index = jclient->audioOuts.count();
  47. JackPortState* const port = new JackPortState(jclient->name, port_name, index, flags,
  48. false, false, index < jserver.numAudioOuts);
  49. {
  50. const CarlaMutexLocker cms(jclient->mutex);
  51. jclient->audioOuts.append(port);
  52. }
  53. jclient->portNameMapping[port->fullname] = port;
  54. return (jack_port_t*)port;
  55. }
  56. carla_stderr2("jack_port_register: invalid port flags '%x'", flags);
  57. return nullptr;
  58. }
  59. if (std::strcmp(port_type, JACK_DEFAULT_MIDI_TYPE) == 0)
  60. {
  61. if (flags & JackPortIsInput)
  62. {
  63. const std::size_t index = jclient->midiIns.count();
  64. JackPortState* const port = new JackPortState(jclient->name, port_name, index, flags,
  65. true, false, index < jserver.numMidiIns);
  66. {
  67. const CarlaMutexLocker cms(jclient->mutex);
  68. jclient->midiIns.append(port);
  69. }
  70. jclient->portNameMapping[port->fullname] = port;
  71. return (jack_port_t*)port;
  72. }
  73. if (flags & JackPortIsOutput)
  74. {
  75. const std::size_t index = jclient->midiOuts.count();
  76. JackPortState* const port = new JackPortState(jclient->name, port_name, index, flags,
  77. true, false, index < jserver.numMidiOuts);
  78. {
  79. const CarlaMutexLocker cms(jclient->mutex);
  80. jclient->midiOuts.append(port);
  81. }
  82. jclient->portNameMapping[port->fullname] = port;
  83. return (jack_port_t*)port;
  84. }
  85. carla_stderr2("jack_port_register: invalid port flags '%x'", flags);
  86. return nullptr;
  87. }
  88. carla_stderr2("jack_port_register: invalid port type '%s'", port_type);
  89. return nullptr;
  90. // unused
  91. (void)buffer_size;
  92. }
  93. CARLA_EXPORT
  94. int jack_port_unregister(jack_client_t* client, jack_port_t* port)
  95. {
  96. carla_debug("%s(%p, %p)", __FUNCTION__, client, port);
  97. JackClientState* const jclient = (JackClientState*)client;
  98. CARLA_SAFE_ASSERT_RETURN(jclient != nullptr, EINVAL);
  99. JackPortState* const jport = (JackPortState*)port;
  100. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, EINVAL);
  101. CARLA_SAFE_ASSERT_RETURN(! jport->isSystem, EINVAL);
  102. {
  103. const CarlaMutexLocker cms(jclient->mutex);
  104. if (jport->isMidi)
  105. {
  106. if (jport->flags & JackPortIsInput)
  107. {
  108. CARLA_SAFE_ASSERT_RETURN(jclient->midiIns.removeOne(jport), ENOENT);
  109. jclient->portNameMapping.erase(jport->fullname);
  110. return 0;
  111. }
  112. if (jport->flags & JackPortIsOutput)
  113. {
  114. CARLA_SAFE_ASSERT_RETURN(jclient->midiOuts.removeOne(jport), ENOENT);
  115. jclient->portNameMapping.erase(jport->fullname);
  116. return 0;
  117. }
  118. }
  119. else
  120. {
  121. if (jport->flags & JackPortIsInput)
  122. {
  123. CARLA_SAFE_ASSERT_RETURN(jclient->audioIns.removeOne(jport), ENOENT);
  124. jclient->portNameMapping.erase(jport->fullname);
  125. return 0;
  126. }
  127. if (jport->flags & JackPortIsOutput)
  128. {
  129. CARLA_SAFE_ASSERT_RETURN(jclient->audioOuts.removeOne(jport), ENOENT);
  130. jclient->portNameMapping.erase(jport->fullname);
  131. return 0;
  132. }
  133. }
  134. }
  135. carla_stderr2("jack_port_register: invalid port '%s'", jport->name);
  136. return EINVAL;
  137. }
  138. CARLA_EXPORT
  139. void* jack_port_get_buffer(jack_port_t* port, jack_nframes_t)
  140. {
  141. JackPortState* const jport = (JackPortState*)port;
  142. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, nullptr);
  143. return jport->buffer;
  144. }
  145. // --------------------------------------------------------------------------------------------------------------------
  146. CARLA_EXPORT
  147. jack_uuid_t jack_port_uuid(const jack_port_t* port)
  148. {
  149. carla_debug("%s(%p)", __FUNCTION__, port);
  150. JackPortState* const jport = (JackPortState*)port;
  151. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, 0);
  152. return jport->uuid;
  153. }
  154. CARLA_EXPORT
  155. const char* jack_port_name(const jack_port_t* port)
  156. {
  157. carla_debug("%s(%p)", __FUNCTION__, port);
  158. JackPortState* const jport = (JackPortState*)port;
  159. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, nullptr);
  160. return jport->fullname;
  161. }
  162. CARLA_EXPORT
  163. const char* jack_port_short_name(const jack_port_t* port)
  164. {
  165. carla_debug("%s(%p)", __FUNCTION__, port);
  166. JackPortState* const jport = (JackPortState*)port;
  167. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, nullptr);
  168. return jport->name;
  169. }
  170. CARLA_EXPORT
  171. int jack_port_flags(const jack_port_t* port)
  172. {
  173. carla_debug("%s(%p)", __FUNCTION__, port);
  174. JackPortState* const jport = (JackPortState*)port;
  175. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, 0);
  176. return jport->flags;
  177. }
  178. CARLA_EXPORT
  179. const char* jack_port_type(const jack_port_t* port)
  180. {
  181. carla_debug("%s(%p)", __FUNCTION__, port);
  182. JackPortState* const jport = (JackPortState*)port;
  183. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, nullptr);
  184. static const char* const kAudioType = JACK_DEFAULT_AUDIO_TYPE;
  185. static const char* const kMidiType = JACK_DEFAULT_MIDI_TYPE;
  186. return jport->isMidi ? kMidiType : kAudioType;
  187. }
  188. CARLA_EXPORT
  189. uint32_t jack_port_type_id(const jack_port_t* port)
  190. {
  191. carla_debug("%s(%p)", __FUNCTION__, port);
  192. JackPortState* const jport = (JackPortState*)port;
  193. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, 0);
  194. return jport->isMidi ? 1 : 0;
  195. }
  196. // --------------------------------------------------------------------------------------------------------------------
  197. CARLA_EXPORT
  198. int jack_port_is_mine(const jack_client_t*, const jack_port_t* port)
  199. {
  200. JackPortState* const jport = (JackPortState*)port;
  201. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, 0);
  202. return jport->isSystem ? 0 : 1;
  203. }
  204. CARLA_EXPORT
  205. int jack_port_connected(const jack_port_t* port)
  206. {
  207. JackPortState* const jport = (JackPortState*)port;
  208. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, 0);
  209. return jport->isConnected ? 1 : 0;
  210. }
  211. CARLA_EXPORT
  212. int jack_port_connected_to(const jack_port_t* port, const char* port_name)
  213. {
  214. carla_stderr2("%s(%p, %s) WIP", __FUNCTION__, port, port_name);
  215. JackPortState* const jport = (JackPortState*)port;
  216. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, 0);
  217. if (! jport->isConnected)
  218. return 0;
  219. // TODO
  220. return 1;
  221. }
  222. // --------------------------------------------------------------------------------------------------------------------
  223. CARLA_EXPORT
  224. const char** jack_port_get_connections(const jack_port_t* port)
  225. {
  226. carla_stderr2("%s(%p)", __FUNCTION__, port);
  227. return nullptr;
  228. }
  229. CARLA_EXPORT
  230. const char** jack_port_get_all_connections(const jack_client_t* client, const jack_port_t* port)
  231. {
  232. carla_stderr2("%s(%p, %p)", __FUNCTION__, client, port);
  233. return nullptr;
  234. }
  235. // --------------------------------------------------------------------------------------------------------------------
  236. CARLA_EXPORT
  237. int jack_port_tie(jack_port_t* src, jack_port_t* dst)
  238. {
  239. carla_debug("%s(%p, %p)", __FUNCTION__, src, dst);
  240. return ENOSYS;
  241. // unused
  242. (void)src;
  243. (void)dst;
  244. }
  245. CARLA_EXPORT
  246. int jack_port_untie(jack_port_t* port)
  247. {
  248. carla_debug("%s(%p)", __FUNCTION__, port);
  249. return ENOSYS;
  250. // unused
  251. (void)port;
  252. }
  253. // --------------------------------------------------------------------------------------------------------------------
  254. CARLA_EXPORT
  255. int jack_port_set_name(jack_port_t *port, const char *port_name)
  256. {
  257. carla_stderr2("%s(%p, %s)", __FUNCTION__, port, port_name);
  258. return ENOSYS;
  259. }
  260. CARLA_EXPORT
  261. int jack_port_rename(jack_client_t* client, jack_port_t *port, const char *port_name)
  262. {
  263. carla_stderr2("%s(%p, %p, %s) WIP", __FUNCTION__, client, port, port_name);
  264. JackClientState* const jclient = (JackClientState*)client;
  265. CARLA_SAFE_ASSERT_RETURN(jclient != nullptr, EINVAL);
  266. CARLA_SAFE_ASSERT_RETURN(port_name != nullptr && port_name[0] != '\0', EINVAL);
  267. JackPortState* const jport = (JackPortState*)port;
  268. CARLA_SAFE_ASSERT_RETURN(jport != nullptr, EINVAL);
  269. CARLA_SAFE_ASSERT_RETURN(! jport->isSystem, EINVAL);
  270. static CarlaString rname, rfullname;
  271. // TODO: verify uniqueness
  272. rname = port_name;
  273. CARLA_SAFE_ASSERT_RETURN(rname.isNotEmpty(), ENOMEM);
  274. char* const fullname = (char*)std::malloc(STR_MAX);
  275. CARLA_SAFE_ASSERT_RETURN(fullname != nullptr, ENOMEM);
  276. std::snprintf(fullname, STR_MAX, "%s:%s", jclient->name, port_name);
  277. fullname[STR_MAX-1] = '\0';
  278. jport->name = rname.buffer();
  279. jport->fullname = rfullname.buffer();
  280. std::free(fullname);
  281. // TODO: port rename callback
  282. return 0;
  283. }
  284. CARLA_EXPORT
  285. int jack_port_set_alias(jack_port_t* port, const char* alias)
  286. {
  287. carla_stderr2("%s(%p, %s)", __FUNCTION__, port, alias);
  288. return ENOSYS;
  289. }
  290. CARLA_EXPORT
  291. int jack_port_unset_alias(jack_port_t* port, const char* alias)
  292. {
  293. carla_stderr2("%s(%p, %s)", __FUNCTION__, port, alias);
  294. return ENOSYS;
  295. }
  296. CARLA_EXPORT
  297. int jack_port_get_aliases(const jack_port_t*, const char* aliases[2])
  298. {
  299. static const char nullChar = '\0';
  300. aliases[0] = aliases[1] = &nullChar;
  301. return 0;
  302. }
  303. // --------------------------------------------------------------------------------------------------------------------
  304. CARLA_EXPORT
  305. int jack_port_request_monitor(jack_port_t* port, int onoff)
  306. {
  307. carla_stderr2("%s(%p, %i)", __FUNCTION__, port, onoff);
  308. return ENOSYS;
  309. }
  310. CARLA_EXPORT
  311. int jack_port_request_monitor_by_name(jack_client_t* client, const char* port_name, int onoff)
  312. {
  313. carla_stderr2("%s(%p, %s, %i)", __FUNCTION__, client, port_name, onoff);
  314. return ENOSYS;
  315. }
  316. CARLA_EXPORT
  317. int jack_port_ensure_monitor(jack_port_t* port, int onoff)
  318. {
  319. carla_stderr2("%s(%p, %i)", __FUNCTION__, port, onoff);
  320. return ENOSYS;
  321. }
  322. CARLA_EXPORT
  323. int jack_port_monitoring_input(jack_port_t* port)
  324. {
  325. carla_stderr2("%s(%p)", __FUNCTION__, port);
  326. return 0;
  327. }
  328. // --------------------------------------------------------------------------------------------------------------------
  329. CARLA_EXPORT
  330. int jack_connect(jack_client_t* client, const char* a, const char* b)
  331. {
  332. carla_stderr2("%s(%p, %s. %s)", __FUNCTION__, client, a, b);
  333. return 0;
  334. }
  335. CARLA_EXPORT
  336. int jack_disconnect(jack_client_t* client, const char* a, const char* b)
  337. {
  338. carla_stderr2("%s(%p, %s. %s)", __FUNCTION__, client, a, b);
  339. return 0;
  340. }
  341. CARLA_EXPORT
  342. int jack_port_disconnect(jack_client_t* client, jack_port_t* port)
  343. {
  344. carla_stderr2("%s(%p, %p)", __FUNCTION__, client, port);
  345. return 0;
  346. }
  347. // --------------------------------------------------------------------------------------------------------------------
  348. CARLA_EXPORT
  349. int jack_port_name_size(void)
  350. {
  351. return STR_MAX;
  352. }
  353. CARLA_EXPORT
  354. int jack_port_type_size(void)
  355. {
  356. return STR_MAX;
  357. }
  358. CARLA_EXPORT
  359. size_t jack_port_type_get_buffer_size(jack_client_t* client, const char* port_type)
  360. {
  361. carla_debug("%s(%p, %s)", __FUNCTION__, client, port_type);
  362. CARLA_SAFE_ASSERT_RETURN(port_type != nullptr && port_type[0] != '\0', 0);
  363. if (std::strcmp(port_type, JACK_DEFAULT_MIDI_TYPE) == 0)
  364. return JackMidiPortBuffer::kMaxEventSize;
  365. return 0;
  366. // unused
  367. (void)client;
  368. }
  369. // --------------------------------------------------------------------------------------------------------------------