falkTX
/
Carla
mirror of https://github.com/falkTX/Carla
1
0
Fork 0
Code Releases 42 Activity
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.
465 Commits
16 Branches
233MB
Tree: 1a13fe4119
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '1a13fe4119'
${ noResults }
Carla/source/libs/jackbridge/JackBridge.hpp

236 lines
9.7KB
Raw Blame History 

  1. /*

  2.  * JackBridge

  3.  * Copyright (C) 2013 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 Lesser General Public

  7.  * License as published by the Free Software Foundation.

  8.  *

  9.  * This program is distributed in the hope that it will be useful,

  10.  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  11.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

  12.  * GNU Lesser General Public License for more details.

  13.  *

  14.  * For a full copy of the license see the LGPL.txt file

  15.  */

  16. 

  17. #ifndef __JACKBRIDGE_HPP__

  18. #define __JACKBRIDGE_HPP__

  19. 

  20. #include "CarlaDefines.hpp"

  21. 

  22. #ifndef JACKBRIDGE_EXPORT

  23. # undef CARLA_EXPORT

  24. # define CARLA_EXPORT

  25. #endif

  26. 

  27. #ifdef JACKBRIDGE_DIRECT

  28. # include <jack/jack.h>

  29. # include <jack/midiport.h>

  30. # include <jack/transport.h>

  31. #else

  32. 

  33. #define PRE_PACKED_STRUCTURE

  34. #define POST_PACKED_STRUCTURE __attribute__((__packed__))

  35. 

  36. #define JACK_DEFAULT_AUDIO_TYPE "32 bit float mono audio"

  37. #define JACK_DEFAULT_MIDI_TYPE  "8 bit raw midi"

  38. 

  39. #include <cstddef>

  40. #include <cstdint>

  41. 

  42. enum JackOptions {

  43.     JackNullOption    = 0x00,

  44.     JackNoStartServer = 0x01,

  45.     JackUseExactName  = 0x02,

  46.     JackServerName    = 0x04,

  47.     JackLoadName      = 0x08,

  48.     JackLoadInit      = 0x10,

  49.     JackSessionID     = 0x20

  50. };

  51. 

  52. enum JackStatus {

  53.     JackFailure       = 0x01,

  54.     JackInvalidOption = 0x02,

  55.     JackNameNotUnique = 0x04,

  56.     JackServerStarted = 0x08,

  57.     JackServerFailed  = 0x10,

  58.     JackServerError   = 0x20,

  59.     JackNoSuchClient  = 0x40,

  60.     JackLoadFailure   = 0x80,

  61.     JackInitFailure   = 0x100,

  62.     JackShmFailure    = 0x200,

  63.     JackVersionError  = 0x400,

  64.     JackBackendError  = 0x800,

  65.     JackClientZombie  = 0x1000

  66. };

  67. 

  68. enum JackLatencyCallbackMode {

  69.      JackCaptureLatency,

  70.      JackPlaybackLatency

  71. };

  72. 

  73. enum JackPortFlags {

  74.     JackPortIsInput    = 0x1,

  75.     JackPortIsOutput   = 0x2,

  76.     JackPortIsPhysical = 0x4,

  77.     JackPortCanMonitor = 0x8,

  78.     JackPortIsTerminal = 0x10,

  79. };

  80. 

  81. enum JackTransportFlags {

  82.     JackTransportStopped     = 0,

  83.     JackTransportRolling     = 1,

  84.     JackTransportLooping     = 2,

  85.     JackTransportStarting    = 3,

  86.     JackTransportNetStarting = 4

  87. };

  88. 

  89. enum JackPositionBits {

  90.     JackPositionBBT      = 0x010,

  91.     JackPositionTimecode = 0x020,

  92.     JackBBTFrameOffset   = 0x040,

  93.     JackAudioVideoRatio  = 0x080,

  94.     JackVideoFrameOffset = 0x100

  95. };

  96. 

  97. enum JackTransportBits {

  98.     JackTransportState    = 0x01,

  99.     JackTransportPosition = 0x02,

  100.     JackTransportLoop     = 0x04,

  101.     JackTransportSMPTE    = 0x08,

  102.     JackTransportBBT      = 0x10

  103. };

  104. 

  105. typedef uint32_t jack_nframes_t;

  106. typedef uint32_t jack_port_id_t;

  107. typedef uint64_t jack_time_t;

  108. typedef uint64_t jack_unique_t;

  109. typedef unsigned char jack_midi_data_t;

  110. 

  111. typedef enum JackOptions jack_options_t;

  112. typedef enum JackStatus jack_status_t;

  113. typedef enum JackLatencyCallbackMode jack_latency_callback_mode_t;

  114. typedef enum JackTransportFlags jack_transport_state_t;

  115. typedef enum JackPositionBits jack_position_bits_t;

  116. typedef enum JackTransportBits jack_transport_bits_t;

  117. 

  118. struct _jack_midi_event {

  119.     jack_nframes_t    time;

  120.     size_t            size;

  121.     jack_midi_data_t* buffer;

  122. };

  123. 

  124. PRE_PACKED_STRUCTURE

  125. struct _jack_latency_range {

  126.     jack_nframes_t min;

  127.     jack_nframes_t max;

  128. } POST_PACKED_STRUCTURE;

  129. 

  130. PRE_PACKED_STRUCTURE

  131. struct _jack_position {

  132.     jack_unique_t  unique_1;

  133.     jack_time_t    usecs;

  134.     jack_nframes_t frame_rate;

  135.     jack_nframes_t frame;

  136.     jack_position_bits_t valid;

  137.     int32_t bar;

  138.     int32_t beat;

  139.     int32_t tick;

  140.     double  bar_start_tick;

  141.     float   beats_per_bar;

  142.     float   beat_type;

  143.     double  ticks_per_beat;

  144.     double  beats_per_minute;

  145.     double  frame_time;

  146.     double  next_time;

  147.     jack_nframes_t bbt_offset;

  148.     float          audio_frames_per_video_frame;

  149.     jack_nframes_t video_offset;

  150.     int32_t        padding[7];

  151.     jack_unique_t  unique_2;

  152. } POST_PACKED_STRUCTURE;

  153. 

  154. typedef struct _jack_port jack_port_t;

  155. typedef struct _jack_client jack_client_t;

  156. typedef struct _jack_latency_range jack_latency_range_t;

  157. typedef struct _jack_position jack_position_t;

  158. typedef struct _jack_midi_event jack_midi_event_t;

  159. 

  160. typedef void (*JackLatencyCallback)(jack_latency_callback_mode_t mode, void *arg);

  161. typedef int  (*JackProcessCallback)(jack_nframes_t nframes, void *arg);

  162. typedef int  (*JackBufferSizeCallback)(jack_nframes_t nframes, void *arg);

  163. typedef int  (*JackSampleRateCallback)(jack_nframes_t nframes, void *arg);

  164. typedef void (*JackPortRegistrationCallback)(jack_port_id_t port, int register_, void *arg);

  165. typedef void (*JackClientRegistrationCallback)(const char* name, int register_, void *arg);

  166. typedef void (*JackPortConnectCallback)(jack_port_id_t a, jack_port_id_t b, int connect, void* arg);

  167. typedef int  (*JackPortRenameCallback)(jack_port_id_t port, const char* old_name, const char* new_name, void *arg);

  168. typedef void (*JackFreewheelCallback)(int starting, void *arg);

  169. typedef void (*JackShutdownCallback)(void *arg);

  170. 

  171. #endif // ! JACKBRIDGE_DIRECT

  172. 

  173. CARLA_EXPORT const char*    jackbridge_get_version_string();

  174. CARLA_EXPORT jack_client_t* jackbridge_client_open(const char* client_name, jack_options_t options, jack_status_t* status, ...);

  175. CARLA_EXPORT const char*    jackbridge_client_rename(jack_client_t* client, const char* new_name);

  176. 

  177. CARLA_EXPORT bool  jackbridge_client_close(jack_client_t* client);

  178. CARLA_EXPORT int   jackbridge_client_name_size();

  179. CARLA_EXPORT char* jackbridge_get_client_name(jack_client_t* client);

  180. 

  181. CARLA_EXPORT bool jackbridge_activate(jack_client_t* client);

  182. CARLA_EXPORT bool jackbridge_deactivate(jack_client_t* client);

  183. CARLA_EXPORT void jackbridge_on_shutdown(jack_client_t* client, JackShutdownCallback shutdown_callback, void* arg);

  184. CARLA_EXPORT bool jackbridge_set_process_callback(jack_client_t* client, JackProcessCallback process_callback, void* arg);

  185. CARLA_EXPORT bool jackbridge_set_freewheel_callback(jack_client_t* client, JackFreewheelCallback freewheel_callback, void* arg);

  186. CARLA_EXPORT bool jackbridge_set_buffer_size_callback(jack_client_t* client, JackBufferSizeCallback bufsize_callback, void* arg);

  187. CARLA_EXPORT bool jackbridge_set_sample_rate_callback(jack_client_t* client, JackSampleRateCallback srate_callback, void* arg);

  188. CARLA_EXPORT bool jackbridge_set_client_registration_callback(jack_client_t* client, JackClientRegistrationCallback registration_callback, void* arg);

  189. CARLA_EXPORT bool jackbridge_set_port_registration_callback (jack_client_t* client, JackPortRegistrationCallback registration_callback, void *arg);

  190. CARLA_EXPORT bool jackbridge_set_port_connect_callback (jack_client_t* client, JackPortConnectCallback connect_callback, void* arg);

  191. CARLA_EXPORT bool jackbridge_set_port_rename_callback (jack_client_t* client, JackPortRenameCallback rename_callback, void* arg);

  192. CARLA_EXPORT bool jackbridge_set_latency_callback(jack_client_t* client, JackLatencyCallback latency_callback, void* arg);

  193. 

  194. CARLA_EXPORT jack_nframes_t jackbridge_get_sample_rate(jack_client_t* client);

  195. CARLA_EXPORT jack_nframes_t jackbridge_get_buffer_size(jack_client_t* client);

  196. CARLA_EXPORT jack_port_t*   jackbridge_port_register(jack_client_t* client, const char* port_name, const char* port_type, unsigned long flags, unsigned long buffer_size);

  197. 

  198. CARLA_EXPORT bool  jackbridge_port_unregister(jack_client_t* client, jack_port_t* port);

  199. CARLA_EXPORT void* jackbridge_port_get_buffer(jack_port_t* port, jack_nframes_t nframes);

  200. 

  201. CARLA_EXPORT const char*  jackbridge_port_name(const jack_port_t* port);

  202. CARLA_EXPORT const char*  jackbridge_port_short_name(const jack_port_t* port);

  203. CARLA_EXPORT int          jackbridge_port_flags(const jack_port_t* port);

  204. CARLA_EXPORT const char*  jackbridge_port_type(const jack_port_t* port);

  205. CARLA_EXPORT const char** jackbridge_port_get_connections(const jack_port_t* port);

  206. 

  207. CARLA_EXPORT bool jackbridge_port_set_name(jack_port_t* port, const char* port_name);

  208. CARLA_EXPORT bool jackbridge_connect(jack_client_t* client, const char* source_port, const char* destination_port);

  209. CARLA_EXPORT bool jackbridge_disconnect(jack_client_t* client, const char* source_port, const char* destination_port);

  210. CARLA_EXPORT int  jackbridge_port_name_size();

  211. CARLA_EXPORT void jackbridge_port_get_latency_range(jack_port_t* port, jack_latency_callback_mode_t mode, jack_latency_range_t* range);

  212. CARLA_EXPORT void jackbridge_port_set_latency_range(jack_port_t* port, jack_latency_callback_mode_t mode, jack_latency_range_t* range);

  213. CARLA_EXPORT bool jackbridge_recompute_total_latencies(jack_client_t* client);

  214. 

  215. CARLA_EXPORT const char** jackbridge_get_ports(jack_client_t* client, const char* port_name_pattern, const char* type_name_pattern, unsigned long flags);

  216. CARLA_EXPORT jack_port_t* jackbridge_port_by_name(jack_client_t* client, const char* port_name);

  217. CARLA_EXPORT jack_port_t* jackbridge_port_by_id(jack_client_t* client, jack_port_id_t port_id);

  218. 

  219. CARLA_EXPORT void jackbridge_free(void* ptr);

  220. 

  221. CARLA_EXPORT uint32_t jackbridge_midi_get_event_count(void* port_buffer);

  222. CARLA_EXPORT bool     jackbridge_midi_event_get(jack_midi_event_t* event, void* port_buffer, uint32_t event_index);

  223. CARLA_EXPORT void     jackbridge_midi_clear_buffer(void* port_buffer);

  224. CARLA_EXPORT bool     jackbridge_midi_event_write(void* port_buffer, jack_nframes_t time, const jack_midi_data_t* data, size_t data_size);

  225. CARLA_EXPORT jack_midi_data_t* jackbridge_midi_event_reserve(void* port_buffer, jack_nframes_t time, size_t data_size);

  226. 

  227. CARLA_EXPORT int  jackbridge_transport_locate(jack_client_t* client, jack_nframes_t frame);

  228. CARLA_EXPORT void jackbridge_transport_start(jack_client_t* client);

  229. CARLA_EXPORT void jackbridge_transport_stop(jack_client_t* client);

  230. CARLA_EXPORT jack_transport_state_t jackbridge_transport_query(const jack_client_t* client, jack_position_t* pos);

  231. 

  232. CARLA_EXPORT bool jackbridge_sem_post(void* sem);

  233. CARLA_EXPORT bool jackbridge_sem_timedwait(void* sem, int secs);

  234. 

  235. #endif // __JACKBRIDGE_HPP__