#!/usr/bin/env python3 # -*- coding: utf-8 -*- # JACK ctypes definitions for usage in python applications # Copyright (C) 2010-2013 Filipe Coelho # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # any later version. # # This program 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 General Public License for more details. # # For a full copy of the GNU General Public License see the COPYING file # ------------------------------------------------------------------------------------------------------------ # Imports (Global) from ctypes import * from sys import platform # ------------------------------------------------------------------------------------------------------------ # Load JACK shared library try: if platform == "darwin": jacklib = cdll.LoadLibrary("libjack.dylib") elif platform in ("win32", "win64", "cygwin"): jacklib = cdll.LoadLibrary("libjack.dll") else: jacklib = cdll.LoadLibrary("libjack.so.0") except: jacklib = None raise ImportError("JACK is not available in this system") # ------------------------------------------------------------------------------------------------------------ # JACK2 test try: if jacklib.jack_get_version_string: JACK2 = True else: JACK2 = False except: JACK2 = False # ------------------------------------------------------------------------------------------------------------ # Pre-Types c_enum = c_int c_uchar = c_uint8 class _jack_port(Structure): _fields_ = [] class _jack_client(Structure): _fields_ = [] # ------------------------------------------------------------------------------------------------------------ # Defines JACK_MAX_FRAMES = 4294967295 JACK_LOAD_INIT_LIMIT = 1024 JACK_DEFAULT_AUDIO_TYPE = "32 bit float mono audio" JACK_DEFAULT_MIDI_TYPE = "8 bit raw midi" # ------------------------------------------------------------------------------------------------------------ # Types jack_nframes_t = c_uint32 jack_port_id_t = c_uint32 jack_time_t = c_uint64 jack_unique_t = c_uint64 jack_midi_data_t = c_uchar jack_default_audio_sample_t = c_float jack_options_t = c_enum # JackOptions jack_status_t = c_enum # JackStatus jack_transport_state_t = c_enum # JackTransportState jack_position_bits_t = c_enum # JackPositionBits jack_session_event_type_t = c_enum # JackSessionEventType jack_session_flags_t = c_enum # JackSessionFlags jack_custom_change_t = c_enum # JackCustomChange jack_latency_callback_mode_t = c_enum # JackLatencyCallbackMode jack_port_t = _jack_port jack_client_t = _jack_client jack_port_type_id_t = c_uint32 # JACK2 only # enum JackOptions JackNullOption = 0x00 JackNoStartServer = 0x01 JackUseExactName = 0x02 JackServerName = 0x04 JackLoadName = 0x08 JackLoadInit = 0x10 JackSessionID = 0x20 JackOpenOptions = JackSessionID|JackServerName|JackNoStartServer|JackUseExactName JackLoadOptions = JackLoadInit|JackLoadName|JackUseExactName # enum JackStatus JackFailure = 0x01 JackInvalidOption = 0x02 JackNameNotUnique = 0x04 JackServerStarted = 0x08 JackServerFailed = 0x10 JackServerError = 0x20 JackNoSuchClient = 0x40 JackLoadFailure = 0x80 JackInitFailure = 0x100 JackShmFailure = 0x200 JackVersionError = 0x400 JackBackendError = 0x800 JackClientZombie = 0x1000 # enum JackLatencyCallbackMode JackCaptureLatency = 0 JackPlaybackLatency = 1 # enum JackPortFlags JackPortIsInput = 0x1 JackPortIsOutput = 0x2 JackPortIsPhysical = 0x4 JackPortCanMonitor = 0x8 JackPortIsTerminal = 0x10 JackPortIsControlVoltage = 0x100 # enum JackTransportState JackTransportStopped = 0 JackTransportRolling = 1 JackTransportLooping = 2 JackTransportStarting = 3 JackTransportNetStarting = 4 # JACK2 only # enum JackPositionBits JackPositionBBT = 0x10 JackPositionTimecode = 0x20 JackBBTFrameOffset = 0x40 JackAudioVideoRatio = 0x80 JackVideoFrameOffset = 0x100 JACK_POSITION_MASK = JackPositionBBT|JackPositionTimecode|JackBBTFrameOffset|JackAudioVideoRatio|JackVideoFrameOffset # enum JackSessionEventType JackSessionSave = 1 JackSessionSaveAndQuit = 2 JackSessionSaveTemplate = 3 # enum JackSessionFlags JackSessionSaveError = 0x01 JackSessionNeedTerminal = 0x02 # enum JackCustomChange JackCustomRemoved = 0 JackCustomAdded = 1 JackCustomReplaced = 2 # ------------------------------------------------------------------------------------------------------------ # Structs class jack_midi_event_t(Structure): _fields_ = [ ("time", jack_nframes_t), ("size", c_size_t), ("buffer", POINTER(jack_midi_data_t)) ] class jack_latency_range_t(Structure): _fields_ = [ ("min", jack_nframes_t), ("max", jack_nframes_t) ] class jack_position_t(Structure): _fields_ = [ ("unique_1", jack_unique_t), ("usecs", jack_time_t), ("frame_rate", jack_nframes_t), ("frame", jack_nframes_t), ("valid", jack_position_bits_t), ("bar", c_int32), ("beat", c_int32), ("tick", c_int32), ("bar_start_tick", c_double), ("beats_per_bar", c_float), ("beat_type", c_float), ("ticks_per_beat", c_double), ("beats_per_minute", c_double), ("frame_time", c_double), ("next_time", c_double), ("bbt_offset", jack_nframes_t), ("audio_frames_per_video_frame", c_float), ("video_offset", jack_nframes_t), ("padding", ARRAY(c_int32, 7)), ("unique_2", jack_unique_t) ] class jack_session_event_t(Structure): _fields_ = [ ("type", jack_session_event_type_t), ("session_dir", c_char_p), ("client_uuid", c_char_p), ("command_line", c_char_p), ("flags", jack_session_flags_t), ("future", c_uint32) ] class jack_session_command_t(Structure): _fields_ = [ ("uuid", c_char_p), ("client_name", c_char_p), ("command", c_char_p), ("flags", jack_session_flags_t) ] # ------------------------------------------------------------------------------------------------------------ # Callbacks JackLatencyCallback = CFUNCTYPE(None, jack_latency_callback_mode_t, c_void_p) JackProcessCallback = CFUNCTYPE(c_int, jack_nframes_t, c_void_p) JackThreadCallback = CFUNCTYPE(c_void_p, c_void_p) JackThreadInitCallback = CFUNCTYPE(None, c_void_p) JackGraphOrderCallback = CFUNCTYPE(c_int, c_void_p) JackXRunCallback = CFUNCTYPE(c_int, c_void_p) JackBufferSizeCallback = CFUNCTYPE(c_int, jack_nframes_t, c_void_p) JackSampleRateCallback = CFUNCTYPE(c_int, jack_nframes_t, c_void_p) JackPortRegistrationCallback = CFUNCTYPE(None, jack_port_id_t, c_int, c_void_p) JackClientRegistrationCallback = CFUNCTYPE(None, c_char_p, c_int, c_void_p) JackClientRenameCallback = CFUNCTYPE(c_int, c_char_p, c_char_p, c_void_p) # JACK2 only JackPortConnectCallback = CFUNCTYPE(None, jack_port_id_t, jack_port_id_t, c_int, c_void_p) JackPortRenameCallback = CFUNCTYPE(c_int, jack_port_id_t, c_char_p, c_char_p, c_void_p) # JACK2 only JackFreewheelCallback = CFUNCTYPE(None, c_int, c_void_p) JackShutdownCallback = CFUNCTYPE(None, c_void_p) JackInfoShutdownCallback = CFUNCTYPE(None, jack_status_t, c_char_p, c_void_p) JackSyncCallback = CFUNCTYPE(c_int, jack_transport_state_t, POINTER(jack_position_t), c_void_p) JackTimebaseCallback = CFUNCTYPE(None, jack_transport_state_t, jack_nframes_t, POINTER(jack_position_t), c_int, c_void_p) JackSessionCallback = CFUNCTYPE(None, POINTER(jack_session_event_t), c_void_p) JackCustomDataAppearanceCallback = CFUNCTYPE(None, c_char_p, c_char_p, jack_custom_change_t, c_void_p) # ------------------------------------------------------------------------------------------------------------ # Functions try: jacklib.jack_get_version_string.argtypes = None jacklib.jack_get_version_string.restype = c_char_p except: jacklib.jack_get_version_string = None try: jacklib.jack_client_open.argtypes = [c_char_p, jack_options_t, POINTER(jack_status_t), c_char_p] jacklib.jack_client_open.restype = POINTER(jack_client_t) except: jacklib.jack_client_open = None try: jacklib.jack_client_rename.argtypes = [POINTER(jack_client_t), c_char_p] jacklib.jack_client_rename.restype = c_char_p except: jacklib.jack_client_rename = None try: jacklib.jack_client_close.argtypes = [POINTER(jack_client_t)] jacklib.jack_client_close.restype = c_int except: jacklib.jack_client_close = None try: jacklib.jack_client_name_size.argtypes = None jacklib.jack_client_name_size.restype = c_int except: jacklib.jack_client_name_size = None try: jacklib.jack_get_client_name.argtypes = [POINTER(jack_client_t)] jacklib.jack_get_client_name.restype = c_char_p except: jacklib.jack_get_client_name = None try: jacklib.jack_activate.argtypes = [POINTER(jack_client_t)] jacklib.jack_activate.restype = c_int except: jacklib.jack_activate = None try: jacklib.jack_deactivate.argtypes = [POINTER(jack_client_t)] jacklib.jack_deactivate.restype = c_int except: jacklib.jack_deactivate = None try: jacklib.jack_get_client_pid.argtypes = [c_char_p] jacklib.jack_get_client_pid.restype = c_int except: jacklib.jack_get_client_pid = None try: jacklib.jack_is_realtime.argtypes = [POINTER(jack_client_t)] jacklib.jack_is_realtime.restype = c_int except: jacklib.jack_is_realtime = None def get_version_string(): # JACK2 only if jacklib.jack_get_version_string: return jacklib.jack_get_version_string() return None def client_open(client_name, options, status, uuid=""): if jacklib.jack_client_open: return jacklib.jack_client_open(client_name.encode("utf-8"), options, status, uuid.encode("utf-8") if uuid else None) return None def client_rename(client, new_name): if jacklib.jack_client_rename: return jacklib.jack_client_rename(client, new_name.encode("utf-8")) return None def client_close(client): if jacklib.jack_client_close: return jacklib.jack_client_close(client) return -1 def client_name_size(): if jacklib.jack_client_name_size: return jacklib.jack_client_name_size() return 0 def get_client_name(client): if jacklib.jack_get_client_name: return jacklib.jack_get_client_name(client) return None def activate(client): if jacklib.jack_activate: return jacklib.jack_activate(client) return -1 def deactivate(client): if jacklib.jack_deactivate: return jacklib.jack_deactivate(client) return -1 def get_client_pid(name): # JACK2 only if jacklib.jack_get_client_pid: return jacklib.jack_get_client_pid(name.encode("utf-8")) return 0 def is_realtime(client): if jacklib.jack_is_realtime: return jacklib.jack_is_realtime(client) return 0 # ------------------------------------------------------------------------------------------------------------ # Non-Callback API global _thread_callback _thread_callback = None try: jacklib.jack_cycle_wait.argtypes = [POINTER(jack_client_t)] jacklib.jack_cycle_wait.restype = jack_nframes_t except: jacklib.jack_cycle_wait = None try: jacklib.jack_cycle_signal.argtypes = [POINTER(jack_client_t), c_int] jacklib.jack_cycle_signal.restype = None except: jacklib.jack_cycle_signal = None try: jacklib.jack_set_process_thread.argtypes = [POINTER(jack_client_t), JackThreadCallback, c_void_p] jacklib.jack_set_process_thread.restype = c_int except: jacklib.jack_set_process_thread = None def cycle_wait(client): if jacklib.jack_cycle_wait: return jacklib.jack_cycle_wait(client) return 0 def cycle_signal(client, status): if jacklib.jack_cycle_signal: jacklib.jack_cycle_signal(client, status) def set_process_thread(client, thread_callback, arg): if jacklib.jack_set_process_thread: global _thread_callback _thread_callback = JackThreadCallback(thread_callback) return jacklib.jack_set_process_thread(client, _thread_callback, arg) return -1 # ------------------------------------------------------------------------------------------------------------ # Client Callbacks global _thread_init_callback global _shutdown_callback global _info_shutdown_callback global _process_callback global _freewheel_callback global _bufsize_callback global _srate_callback global _client_registration_callback global _client_rename_callback global _port_registration_callback global _port_connect_callback global _port_rename_callback global _graph_callback global _xrun_callback global _latency_callback _thread_init_callback = _shutdown_callback = _info_shutdown_callback = None _process_callback = _freewheel_callback = _bufsize_callback = _srate_callback = None _client_registration_callback = _client_rename_callback = None _port_registration_callback = _port_connect_callback = _port_rename_callback = None _graph_callback = _xrun_callback = _latency_callback = None try: jacklib.jack_set_thread_init_callback.argtypes = [POINTER(jack_client_t), JackThreadInitCallback, c_void_p] jacklib.jack_set_thread_init_callback.restype = c_int except: jacklib.jack_set_thread_init_callback = None try: jacklib.jack_on_shutdown.argtypes = [POINTER(jack_client_t), JackShutdownCallback, c_void_p] jacklib.jack_on_shutdown.restype = None except: jacklib.jack_on_shutdown = None try: jacklib.jack_on_info_shutdown.argtypes = [POINTER(jack_client_t), JackInfoShutdownCallback, c_void_p] jacklib.jack_on_info_shutdown.restype = None except: jacklib.jack_on_info_shutdown = None try: jacklib.jack_set_process_callback.argtypes = [POINTER(jack_client_t), JackProcessCallback, c_void_p] jacklib.jack_set_process_callback.restype = c_int except: jacklib.jack_set_process_callback = None try: jacklib.jack_set_freewheel_callback.argtypes = [POINTER(jack_client_t), JackFreewheelCallback, c_void_p] jacklib.jack_set_freewheel_callback.restype = c_int except: jacklib.jack_set_freewheel_callback = None try: jacklib.jack_set_buffer_size_callback.argtypes = [POINTER(jack_client_t), JackBufferSizeCallback, c_void_p] jacklib.jack_set_buffer_size_callback.restype = c_int except: jacklib.jack_set_buffer_size_callback = None try: jacklib.jack_set_sample_rate_callback.argtypes = [POINTER(jack_client_t), JackSampleRateCallback, c_void_p] jacklib.jack_set_sample_rate_callback.restype = c_int except: jacklib.jack_set_sample_rate_callback = None try: jacklib.jack_set_client_registration_callback.argtypes = [POINTER(jack_client_t), JackClientRegistrationCallback, c_void_p] jacklib.jack_set_client_registration_callback.restype = c_int except: jacklib.jack_set_client_registration_callback = None try: jacklib.jack_set_client_rename_callback.argtypes = [POINTER(jack_client_t), JackClientRenameCallback, c_void_p] jacklib.jack_set_client_rename_callback.restype = c_int except: jacklib.jack_set_client_rename_callback = None try: jacklib.jack_set_port_registration_callback.argtypes = [POINTER(jack_client_t), JackPortRegistrationCallback, c_void_p] jacklib.jack_set_port_registration_callback.restype = c_int except: jacklib.jack_set_port_registration_callback = None try: jacklib.jack_set_port_connect_callback.argtypes = [POINTER(jack_client_t), JackPortConnectCallback, c_void_p] jacklib.jack_set_port_connect_callback.restype = c_int except: jacklib.jack_set_port_connect_callback = None try: jacklib.jack_set_port_rename_callback.argtypes = [POINTER(jack_client_t), JackPortRenameCallback, c_void_p] jacklib.jack_set_port_rename_callback.restype = c_int except: jacklib.jack_set_port_rename_callback = None try: jacklib.jack_set_graph_order_callback.argtypes = [POINTER(jack_client_t), JackGraphOrderCallback, c_void_p] jacklib.jack_set_graph_order_callback.restype = c_int except: jacklib.jack_set_graph_order_callback = None try: jacklib.jack_set_xrun_callback.argtypes = [POINTER(jack_client_t), JackXRunCallback, c_void_p] jacklib.jack_set_xrun_callback.restype = c_int except: jacklib.jack_set_xrun_callback = None try: jacklib.jack_set_latency_callback.argtypes = [POINTER(jack_client_t), JackLatencyCallback, c_void_p] jacklib.jack_set_latency_callback.restype = c_int except: jacklib.jack_set_latency_callback = None def set_thread_init_callback(client, thread_init_callback, arg): if jacklib.jack_set_thread_init_callback: global _thread_init_callback _thread_init_callback = JackThreadInitCallback(thread_init_callback) return jacklib.jack_set_thread_init_callback(client, _thread_init_callback, arg) return -1 def on_shutdown(client, shutdown_callback, arg): if jacklib.jack_on_shutdown: global _shutdown_callback _shutdown_callback = JackShutdownCallback(shutdown_callback) jacklib.jack_on_shutdown(client, _shutdown_callback, arg) def on_info_shutdown(client, info_shutdown_callback, arg): if jacklib.jack_on_info_shutdown: global _info_shutdown_callback _info_shutdown_callback = JackInfoShutdownCallback(info_shutdown_callback) jacklib.jack_on_info_shutdown(client, _info_shutdown_callback, arg) def set_process_callback(client, process_callback, arg): if jacklib.jack_set_process_callback: global _process_callback _process_callback = JackProcessCallback(process_callback) return jacklib.jack_set_process_callback(client, _process_callback, arg) return -1 def set_freewheel_callback(client, freewheel_callback, arg): if jacklib.jack_set_freewheel_callback: global _freewheel_callback _freewheel_callback = JackFreewheelCallback(freewheel_callback) return jacklib.jack_set_freewheel_callback(client, _freewheel_callback, arg) return -1 def set_buffer_size_callback(client, bufsize_callback, arg): if jacklib.jack_set_buffer_size_callback: global _bufsize_callback _bufsize_callback = JackBufferSizeCallback(bufsize_callback) return jacklib.jack_set_buffer_size_callback(client, _bufsize_callback, arg) return -1 def set_sample_rate_callback(client, srate_callback, arg): if jacklib.jack_set_sample_rate_callback: global _srate_callback _srate_callback = JackSampleRateCallback(srate_callback) return jacklib.jack_set_sample_rate_callback(client, _srate_callback, arg) return -1 def set_client_registration_callback(client, client_registration_callback, arg): if jacklib.jack_set_client_registration_callback: global _client_registration_callback _client_registration_callback = JackClientRegistrationCallback(client_registration_callback) return jacklib.jack_set_client_registration_callback(client, _client_registration_callback, arg) return -1 def set_client_rename_callback(client, client_rename_callback, arg): # JACK2 only if jacklib.jack_set_client_rename_callback: global _client_rename_callback _client_rename_callback = JackClientRenameCallback(client_rename_callback) return jacklib.jack_set_client_rename_callback(client, _client_rename_callback, arg) return -1 def set_port_registration_callback(client, port_registration_callback, arg): if jacklib.jack_set_port_registration_callback: global _port_registration_callback _port_registration_callback = JackPortRegistrationCallback(port_registration_callback) return jacklib.jack_set_port_registration_callback(client, _port_registration_callback, arg) return -1 def set_port_connect_callback(client, connect_callback, arg): if jacklib.jack_set_port_connect_callback: global _port_connect_callback _port_connect_callback = JackPortConnectCallback(connect_callback) return jacklib.jack_set_port_connect_callback(client, _port_connect_callback, arg) return -1 def set_port_rename_callback(client, rename_callback, arg): # JACK2 only if jacklib.jack_set_port_rename_callback: global _port_rename_callback _port_rename_callback = JackPortRenameCallback(rename_callback) return jacklib.jack_set_port_rename_callback(client, _port_rename_callback, arg) return -1 def set_graph_order_callback(client, graph_callback, arg): if jacklib.jack_set_graph_order_callback: global _graph_callback _graph_callback = JackGraphOrderCallback(graph_callback) return jacklib.jack_set_graph_order_callback(client, _graph_callback, arg) return -1 def set_xrun_callback(client, xrun_callback, arg): if jacklib.jack_set_xrun_callback: global _xrun_callback _xrun_callback = JackXRunCallback(xrun_callback) return jacklib.jack_set_xrun_callback(client, _xrun_callback, arg) return -1 def set_latency_callback(client, latency_callback, arg): if jacklib.jack_set_latency_callback: global _latency_callback _latency_callback = JackLatencyCallback(latency_callback) return jacklib.jack_set_latency_callback(client, _latency_callback, arg) return -1 # ------------------------------------------------------------------------------------------------------------ # Server Control jacklib.jack_set_freewheel.argtypes = [POINTER(jack_client_t), c_int] jacklib.jack_set_freewheel.restype = c_int jacklib.jack_set_buffer_size.argtypes = [POINTER(jack_client_t), jack_nframes_t] jacklib.jack_set_buffer_size.restype = c_int jacklib.jack_get_sample_rate.argtypes = [POINTER(jack_client_t)] jacklib.jack_get_sample_rate.restype = jack_nframes_t jacklib.jack_get_buffer_size.argtypes = [POINTER(jack_client_t)] jacklib.jack_get_buffer_size.restype = jack_nframes_t jacklib.jack_engine_takeover_timebase.argtypes = [POINTER(jack_client_t)] jacklib.jack_engine_takeover_timebase.restype = c_int jacklib.jack_cpu_load.argtypes = [POINTER(jack_client_t)] jacklib.jack_cpu_load.restype = c_float def set_freewheel(client, onoff): return jacklib.jack_set_freewheel(client, onoff) def set_buffer_size(client, nframes): return jacklib.jack_set_buffer_size(client, nframes) def get_sample_rate(client): return jacklib.jack_get_sample_rate(client) def get_buffer_size(client): return jacklib.jack_get_buffer_size(client) def engine_takeover_timebase(client): return jacklib.jack_engine_takeover_timebase(client) def cpu_load(client): return jacklib.jack_cpu_load(client) # ------------------------------------------------------------------------------------------------------------ # Port Functions jacklib.jack_port_register.argtypes = [POINTER(jack_client_t), c_char_p, c_char_p, c_ulong, c_ulong] jacklib.jack_port_register.restype = POINTER(jack_port_t) jacklib.jack_port_unregister.argtypes = [POINTER(jack_client_t), POINTER(jack_port_t)] jacklib.jack_port_unregister.restype = c_int jacklib.jack_port_get_buffer.argtypes = [POINTER(jack_port_t), jack_nframes_t] jacklib.jack_port_get_buffer.restype = c_void_p jacklib.jack_port_name.argtypes = [POINTER(jack_port_t)] jacklib.jack_port_name.restype = c_char_p jacklib.jack_port_short_name.argtypes = [POINTER(jack_port_t)] jacklib.jack_port_short_name.restype = c_char_p jacklib.jack_port_flags.argtypes = [POINTER(jack_port_t)] jacklib.jack_port_flags.restype = c_int jacklib.jack_port_type.argtypes = [POINTER(jack_port_t)] jacklib.jack_port_type.restype = c_char_p if JACK2: jacklib.jack_port_type_id.argtypes = [POINTER(jack_port_t)] jacklib.jack_port_type_id.restype = jack_port_type_id_t jacklib.jack_port_is_mine.argtypes = [POINTER(jack_client_t), POINTER(jack_port_t)] jacklib.jack_port_is_mine.restype = c_int jacklib.jack_port_connected.argtypes = [POINTER(jack_port_t)] jacklib.jack_port_connected.restype = c_int jacklib.jack_port_connected_to.argtypes = [POINTER(jack_port_t), c_char_p] jacklib.jack_port_connected_to.restype = c_int jacklib.jack_port_get_connections.argtypes = [POINTER(jack_port_t)] jacklib.jack_port_get_connections.restype = POINTER(c_char_p) jacklib.jack_port_get_all_connections.argtypes = [POINTER(jack_client_t), POINTER(jack_port_t)] jacklib.jack_port_get_all_connections.restype = POINTER(c_char_p) jacklib.jack_port_tie.argtypes = [POINTER(jack_port_t), POINTER(jack_port_t)] jacklib.jack_port_tie.restype = c_int jacklib.jack_port_untie.argtypes = [POINTER(jack_port_t)] jacklib.jack_port_untie.restype = c_int jacklib.jack_port_set_name.argtypes = [POINTER(jack_port_t), c_char_p] jacklib.jack_port_set_name.restype = c_int jacklib.jack_port_set_alias.argtypes = [POINTER(jack_port_t), c_char_p] jacklib.jack_port_set_alias.restype = c_int jacklib.jack_port_unset_alias.argtypes = [POINTER(jack_port_t), c_char_p] jacklib.jack_port_unset_alias.restype = c_int jacklib.jack_port_get_aliases.argtypes = [POINTER(jack_port_t), POINTER(ARRAY(c_char_p, 2))] jacklib.jack_port_get_aliases.restype = c_int jacklib.jack_port_request_monitor.argtypes = [POINTER(jack_port_t), c_int] jacklib.jack_port_request_monitor.restype = c_int jacklib.jack_port_request_monitor_by_name.argtypes = [POINTER(jack_client_t), c_char_p, c_int] jacklib.jack_port_request_monitor_by_name.restype = c_int jacklib.jack_port_ensure_monitor.argtypes = [POINTER(jack_port_t), c_int] jacklib.jack_port_ensure_monitor.restype = c_int jacklib.jack_port_monitoring_input.argtypes = [POINTER(jack_port_t)] jacklib.jack_port_monitoring_input.restype = c_int jacklib.jack_connect.argtypes = [POINTER(jack_client_t), c_char_p, c_char_p] jacklib.jack_connect.restype = c_int jacklib.jack_disconnect.argtypes = [POINTER(jack_client_t), c_char_p, c_char_p] jacklib.jack_disconnect.restype = c_int jacklib.jack_port_disconnect.argtypes = [POINTER(jack_client_t), POINTER(jack_port_t)] jacklib.jack_port_disconnect.restype = c_int jacklib.jack_port_name_size.argtypes = None jacklib.jack_port_name_size.restype = c_int jacklib.jack_port_type_size.argtypes = None jacklib.jack_port_type_size.restype = c_int try: jacklib.jack_port_type_get_buffer_size.argtypes = [POINTER(jack_client_t), c_char_p] jacklib.jack_port_type_get_buffer_size.restype = c_size_t except: jacklib.jack_port_type_get_buffer_size = None def port_register(client, port_name, port_type, flags, buffer_size): return jacklib.jack_port_register(client, port_name.encode("utf-8"), port_type.encode("utf-8"), flags, buffer_size) def port_unregister(client, port): return jacklib.jack_port_unregister(client, port) def port_get_buffer(port, nframes): return jacklib.jack_port_get_buffer(port, nframes) def port_name(port): return jacklib.jack_port_name(port) def port_short_name(port): return jacklib.jack_port_short_name(port) def port_flags(port): return jacklib.jack_port_flags(port) def port_type(port): return jacklib.jack_port_type(port) def port_type_id(port): # JACK2 only return jacklib.jack_port_type_id(port) def port_is_mine(client, port): return jacklib.jack_port_is_mine(client, port) def port_connected(port): return jacklib.jack_port_connected(port) def port_connected_to(port, port_name): return jacklib.jack_port_connected_to(port, port_name.encode("utf-8")) def port_get_connections(port): return jacklib.jack_port_get_connections(port) def port_get_all_connections(client, port): return jacklib.jack_port_get_all_connections(client, port) def port_tie(src, dst): return jacklib.jack_port_tie(src, dst) def port_untie(port): return jacklib.jack_port_untie(port) def port_set_name(port, port_name): return jacklib.jack_port_set_name(port, port_name.encode("utf-8")) def port_set_alias(port, alias): return jacklib.jack_port_set_alias(port, alias.encode("utf-8")) def port_unset_alias(port, alias): return jacklib.jack_port_unset_alias(port, alias.encode("utf-8")) def port_get_aliases(port): # NOTE - this function has no 2nd argument in jacklib # Instead, aliases will be passed in return value, in form of (int ret, str alias1, str alias2) name_size = port_name_size() alias_type = c_char_p * 2 aliases = alias_type(" ".encode("utf-8") * name_size, " ".encode("utf-8") * name_size) ret = jacklib.jack_port_get_aliases(port, pointer(aliases)) return (ret, str(aliases[0], encoding="utf-8"), str(aliases[1], encoding="utf-8")) def port_request_monitor(port, onoff): return jacklib.jack_port_request_monitor(port, onoff) def port_request_monitor_by_name(client, port_name, onoff): return jacklib.jack_port_request_monitor_by_name(client, port_name.encode("utf-8"), onoff) def port_ensure_monitor(port, onoff): return jacklib.jack_port_ensure_monitor(port, onoff) def port_monitoring_input(port): return jacklib.jack_port_monitoring_input(port) def connect(client, source_port, destination_port): return jacklib.jack_connect(client, source_port.encode("utf-8"), destination_port.encode("utf-8")) def disconnect(client, source_port, destination_port): return jacklib.jack_disconnect(client, source_port.encode("utf-8"), destination_port.encode("utf-8")) def port_disconnect(client, port): return jacklib.jack_port_disconnect(client, port) def port_name_size(): return jacklib.jack_port_name_size() def port_type_size(): return jacklib.jack_port_type_size() def port_type_get_buffer_size(client, port_type): if jacklib.jack_port_type_get_buffer_size: return jacklib.jack_port_type_get_buffer_size(client, port_type.encode("utf-8")) return 0 # ------------------------------------------------------------------------------------------------------------ # Latency Functions jacklib.jack_port_set_latency.argtypes = [POINTER(jack_port_t), jack_nframes_t] jacklib.jack_port_set_latency.restype = None try: jacklib.jack_port_get_latency_range.argtypes = [POINTER(jack_port_t), jack_latency_callback_mode_t, POINTER(jack_latency_range_t)] jacklib.jack_port_get_latency_range.restype = None except: jacklib.jack_port_get_latency_range = None try: jacklib.jack_port_set_latency_range.argtypes = [POINTER(jack_port_t), jack_latency_callback_mode_t, POINTER(jack_latency_range_t)] jacklib.jack_port_set_latency_range.restype = None except: jacklib.jack_port_set_latency_range = None jacklib.jack_recompute_total_latencies.argtypes = [POINTER(jack_client_t)] jacklib.jack_recompute_total_latencies.restype = c_int jacklib.jack_port_get_latency.argtypes = [POINTER(jack_port_t)] jacklib.jack_port_get_latency.restype = jack_nframes_t jacklib.jack_port_get_total_latency.argtypes = [POINTER(jack_client_t), POINTER(jack_port_t)] jacklib.jack_port_get_total_latency.restype = jack_nframes_t jacklib.jack_recompute_total_latency.argtypes = [POINTER(jack_client_t), POINTER(jack_port_t)] jacklib.jack_recompute_total_latency.restype = c_int def port_set_latency(port, nframes): jacklib.jack_port_set_latency(port, nframes) def port_get_latency_range(port, mode, range_): if jacklib.jack_port_get_latency_range: jacklib.jack_port_get_latency_range(port, mode, range_) def port_set_latency_range(port, mode, range_): if jacklib.jack_port_set_latency_range: jacklib.jack_port_set_latency_range(port, mode, range_) def recompute_total_latencies(): return jacklib.jack_recompute_total_latencies() def port_get_latency(port): return jacklib.jack_port_get_latency(port) def port_get_total_latency(client, port): return jacklib.jack_port_get_total_latency(client, port) def recompute_total_latency(client, port): return jacklib.jack_recompute_total_latency(client, port) # ------------------------------------------------------------------------------------------------------------ # Port Searching jacklib.jack_get_ports.argtypes = [POINTER(jack_client_t), c_char_p, c_char_p, c_ulong] jacklib.jack_get_ports.restype = POINTER(c_char_p) jacklib.jack_port_by_name.argtypes = [POINTER(jack_client_t), c_char_p] jacklib.jack_port_by_name.restype = POINTER(jack_port_t) jacklib.jack_port_by_id.argtypes = [POINTER(jack_client_t), jack_port_id_t] jacklib.jack_port_by_id.restype = POINTER(jack_port_t) def get_ports(client, port_name_pattern, type_name_pattern, flags): return jacklib.jack_get_ports(client, port_name_pattern.encode("utf-8"), type_name_pattern.encode("utf-8"), flags) def port_by_name(client, port_name): return jacklib.jack_port_by_name(client, port_name.encode("utf-8")) def port_by_id(client, port_id): return jacklib.jack_port_by_id(client, port_id) # ------------------------------------------------------------------------------------------------------------ # Time Functions jacklib.jack_frames_since_cycle_start.argtypes = [POINTER(jack_client_t)] jacklib.jack_frames_since_cycle_start.restype = jack_nframes_t jacklib.jack_frame_time.argtypes = [POINTER(jack_client_t)] jacklib.jack_frame_time.restype = jack_nframes_t jacklib.jack_last_frame_time.argtypes = [POINTER(jack_client_t)] jacklib.jack_last_frame_time.restype = jack_nframes_t try: # JACK_OPTIONAL_WEAK_EXPORT jacklib.jack_get_cycle_times.argtypes = [POINTER(jack_client_t), POINTER(jack_nframes_t), POINTER(jack_time_t), POINTER(jack_time_t), POINTER(c_float)] jacklib.jack_get_cycle_times.restype = c_int except: jacklib.jack_get_cycle_times = None jacklib.jack_frames_to_time.argtypes = [POINTER(jack_client_t), jack_nframes_t] jacklib.jack_frames_to_time.restype = jack_time_t jacklib.jack_time_to_frames.argtypes = [POINTER(jack_client_t), jack_time_t] jacklib.jack_time_to_frames.restype = jack_nframes_t jacklib.jack_get_time.argtypes = None jacklib.jack_get_time.restype = jack_time_t def frames_since_cycle_start(client): return jacklib.jack_frames_since_cycle_start(client) def frame_time(client): return jacklib.jack_frame_time(client) def last_frame_time(client): return jacklib.jack_last_frame_time(client) def get_cycle_times(client, current_frames, current_usecs, next_usecs, period_usecs): # JACK_OPTIONAL_WEAK_EXPORT if jacklib.jack_frames_to_time: return jacklib.jack_get_cycle_times(client, current_frames, current_usecs, next_usecs, period_usecs) return -1 def frames_to_time(client, nframes): return jacklib.jack_frames_to_time(client, nframes) def time_to_frames(client, time): return jacklib.jack_time_to_frames(client, time) def get_time(): return jacklib.jack_get_time() # ------------------------------------------------------------------------------------------------------------ # Error Output # TODO # ------------------------------------------------------------------------------------------------------------ # Misc jacklib.jack_free.argtypes = [c_void_p] jacklib.jack_free.restype = None def free(ptr): return jacklib.jack_free(ptr) # ------------------------------------------------------------------------------------------------------------ # Transport global _sync_callback global _timebase_callback _sync_callback = _timebase_callback = None jacklib.jack_release_timebase.argtypes = [POINTER(jack_client_t)] jacklib.jack_release_timebase.restype = c_int jacklib.jack_set_sync_callback.argtypes = [POINTER(jack_client_t), JackSyncCallback, c_void_p] jacklib.jack_set_sync_callback.restype = c_int jacklib.jack_set_sync_timeout.argtypes = [POINTER(jack_client_t), jack_time_t] jacklib.jack_set_sync_timeout.restype = c_int jacklib.jack_set_timebase_callback.argtypes = [POINTER(jack_client_t), c_int, JackTimebaseCallback, c_void_p] jacklib.jack_set_timebase_callback.restype = c_int jacklib.jack_transport_locate.argtypes = [POINTER(jack_client_t), jack_nframes_t] jacklib.jack_transport_locate.restype = c_int jacklib.jack_transport_query.argtypes = [POINTER(jack_client_t), POINTER(jack_position_t)] jacklib.jack_transport_query.restype = jack_transport_state_t jacklib.jack_get_current_transport_frame.argtypes = [POINTER(jack_client_t)] jacklib.jack_get_current_transport_frame.restype = jack_nframes_t jacklib.jack_transport_reposition.argtypes = [POINTER(jack_client_t), POINTER(jack_position_t)] jacklib.jack_transport_reposition.restype = c_int jacklib.jack_transport_start.argtypes = [POINTER(jack_client_t)] jacklib.jack_transport_start.restype = None jacklib.jack_transport_stop.argtypes = [POINTER(jack_client_t)] jacklib.jack_transport_stop.restype = None def release_timebase(client): return jacklib.jack_release_timebase(client) def set_sync_callback(client, sync_callback, arg): global _sync_callback _sync_callback = JackSyncCallback(sync_callback) return jacklib.jack_set_sync_callback(client, _sync_callback, arg) def set_sync_timeout(client, timeout): return jacklib.jack_set_sync_timeout(client, timeout) def set_timebase_callback(client, conditional, timebase_callback, arg): global _timebase_callback _timebase_callback = JackTimebaseCallback(timebase_callback) return jacklib.jack_set_timebase_callback(client, conditional, _timebase_callback, arg) def transport_locate(client, frame): return jacklib.jack_transport_locate(client, frame) def transport_query(client, pos): return jacklib.jack_transport_query(client, pos) def get_current_transport_frame(client): return jacklib.jack_get_current_transport_frame(client) def transport_reposition(client, pos): return jacklib.jack_transport_reposition(client, pos) def transport_start(client): return jacklib.jack_transport_start(client) def transport_stop(client): return jacklib.jack_transport_stop(client) # ------------------------------------------------------------------------------------------------------------ # MIDI jacklib.jack_midi_get_event_count.argtypes = [c_void_p] jacklib.jack_midi_get_event_count.restype = jack_nframes_t jacklib.jack_midi_event_get.argtypes = [POINTER(jack_midi_event_t), c_void_p, c_uint32] jacklib.jack_midi_event_get.restype = c_int jacklib.jack_midi_clear_buffer.argtypes = [c_void_p] jacklib.jack_midi_clear_buffer.restype = None jacklib.jack_midi_max_event_size.argtypes = [c_void_p] jacklib.jack_midi_max_event_size.restype = c_size_t jacklib.jack_midi_event_reserve.argtypes = [c_void_p, jack_nframes_t, c_size_t] jacklib.jack_midi_event_reserve.restype = POINTER(jack_midi_data_t) jacklib.jack_midi_event_write.argtypes = [c_void_p, jack_nframes_t, POINTER(jack_midi_data_t), c_size_t] jacklib.jack_midi_event_write.restype = c_int jacklib.jack_midi_get_lost_event_count.argtypes = [c_void_p] jacklib.jack_midi_get_lost_event_count.restype = c_uint32 def midi_get_event_count(port_buffer): return jacklib.jack_midi_get_event_count(port_buffer) def midi_event_get(event, port_buffer, event_index): return jacklib.jack_midi_event_get(event, port_buffer, event_index) def midi_clear_buffer(port_buffer): return jacklib.jack_midi_clear_buffer(port_buffer) def midi_max_event_size(port_buffer): return jacklib.jack_midi_max_event_size(port_buffer) def midi_event_reserve(port_buffer, time, data_size): return jacklib.jack_midi_event_reserve(port_buffer, time, data_size) def midi_event_write(port_buffer, time, data, data_size): return jacklib.jack_midi_event_write(port_buffer, time, data, data_size) def midi_get_lost_event_count(port_buffer): return jacklib.jack_midi_get_lost_event_count(port_buffer) # ------------------------------------------------------------------------------------------------------------ # Session global _session_callback _session_callback = None try: jacklib.jack_set_session_callback.argtypes = [POINTER(jack_client_t), JackSessionCallback, c_void_p] jacklib.jack_set_session_callback.restype = c_int except: jacklib.jack_set_session_callback = None try: jacklib.jack_session_reply.argtypes = [POINTER(jack_client_t), POINTER(jack_session_event_t)] jacklib.jack_session_reply.restype = c_int except: jacklib.jack_session_reply = None try: jacklib.jack_session_event_free.argtypes = [POINTER(jack_session_event_t)] jacklib.jack_session_event_free.restype = None except: jacklib.jack_session_event_free = None try: jacklib.jack_client_get_uuid.argtypes = [POINTER(jack_client_t)] jacklib.jack_client_get_uuid.restype = c_char_p except: jacklib.jack_client_get_uuid = None try: jacklib.jack_session_notify.argtypes = [POINTER(jack_client_t), c_char_p, jack_session_event_type_t, c_char_p] jacklib.jack_session_notify.restype = POINTER(jack_session_command_t) except: jacklib.jack_session_notify = None try: jacklib.jack_session_commands_free.argtypes = [POINTER(jack_session_command_t)] jacklib.jack_session_commands_free.restype = None except: jacklib.jack_session_commands_free = None try: jacklib.jack_get_uuid_for_client_name.argtypes = [POINTER(jack_client_t), c_char_p] jacklib.jack_get_uuid_for_client_name.restype = c_char_p except: jacklib.jack_get_uuid_for_client_name = None try: jacklib.jack_get_client_name_by_uuid.argtypes = [POINTER(jack_client_t), c_char_p] jacklib.jack_get_client_name_by_uuid.restype = c_char_p except: jacklib.jack_get_client_name_by_uuid = None try: jacklib.jack_reserve_client_name.argtypes = [POINTER(jack_client_t), c_char_p, c_char_p] jacklib.jack_reserve_client_name.restype = c_int except: jacklib.jack_reserve_client_name = None try: jacklib.jack_client_has_session_callback.argtypes = [POINTER(jack_client_t), c_char_p] jacklib.jack_client_has_session_callback.restype = c_int except: jacklib.jack_client_has_session_callback = None def set_session_callback(client, session_callback, arg): if jacklib.jack_set_session_callback: global _session_callback _session_callback = JackSessionCallback(session_callback) return jacklib.jack_set_session_callback(client, _session_callback, arg) return -1 def session_reply(client, event): if jacklib.jack_session_reply: return jacklib.jack_session_reply(client, event) return -1 def session_event_free(event): if jacklib.jack_session_event_free: jacklib.jack_session_event_free(event) def client_get_uuid(client): if jacklib.jack_client_get_uuid: return jacklib.jack_client_get_uuid(client) return None def session_notify(client, target, type_, path): if jacklib.jack_session_notify: return jacklib.jack_session_notify(client, target.encode("utf-8"), type_, path.encode("utf-8")) return jack_session_command_t() def session_commands_free(cmds): if jacklib.jack_session_commands_free: jacklib.jack_session_commands_free(cmds) def get_uuid_for_client_name(client, client_name): if jacklib.jack_get_uuid_for_client_name: return jacklib.jack_get_uuid_for_client_name(client, client_name.encode("utf-8")) return None def get_client_name_by_uuid(client, client_uuid): if jacklib.jack_get_client_name_by_uuid: return jacklib.jack_get_client_name_by_uuid(client, client_uuid.encode("utf-8")) return None def reserve_client_name(client, name, uuid): if jacklib.jack_reserve_client_name: return jacklib.jack_reserve_client_name(client, name.encode("utf-8"), uuid.encode("utf-8")) return -1 def client_has_session_callback(client, client_name): if jacklib.jack_client_has_session_callback: return jacklib.jack_client_has_session_callback(client, client_name.encode("utf-8")) return -1 # ------------------------------------------------------------------------------------------------------------ # Custom global _custom_appearance_callback _custom_appearance_callback = None try: jacklib.jack_custom_publish_data.argtypes = [POINTER(jack_client_t), c_char_p, c_void_p, c_size_t] jacklib.jack_custom_publish_data.restype = c_int except: jacklib.jack_custom_publish_data = None try: jacklib.jack_custom_get_data.argtypes = [POINTER(jack_client_t), c_char_p, c_char_p, POINTER(c_void_p), POINTER(c_size_t)] jacklib.jack_custom_get_data.restype = c_int except: jacklib.jack_custom_get_data = None try: jacklib.jack_custom_unpublish_data.argtypes = [POINTER(jack_client_t), c_char_p] jacklib.jack_custom_unpublish_data.restype = c_int except: jacklib.jack_custom_unpublish_data = None try: jacklib.jack_custom_get_keys.argtypes = [POINTER(jack_client_t), c_char_p] jacklib.jack_custom_get_keys.restype = POINTER(c_char_p) except: jacklib.jack_custom_get_keys = None try: jacklib.jack_custom_set_data_appearance_callback.argtypes = [POINTER(jack_client_t), JackCustomDataAppearanceCallback, c_void_p] jacklib.jack_custom_set_data_appearance_callback.restype = c_int except: jacklib.jack_custom_set_data_appearance_callback = None def custom_publish_data(client, key, data, size): if jacklib.jack_custom_publish_data: return jacklib.jack_custom_publish_data(client, key.encode("utf-8"), data, size) return -1 def custom_get_data(client, client_name, key): # NOTE - this function has no extra arguments in jacklib # Instead, data and size will be passed in return value, in form of (int ret, void* data, size_t size) if jacklib.jack_custom_get_data: data = c_void_p(0) size = c_size_t(0) ret = jacklib.jack_custom_get_data(client, client_name.encode("utf-8"), key.encode("utf-8"), pointer(data), pointer(size)) return (ret, data, size) return (-1, None, 0) def custom_unpublish_data(client, key): if jacklib.jack_custom_unpublish_data: return jacklib.jack_custom_unpublish_data(client, key.encode("utf-8")) return -1 def custom_get_keys(client, client_name): if jacklib.jack_custom_get_keys: return jacklib.jack_custom_get_keys(client, client_name.encode("utf-8")) return None def custom_set_data_appearance_callback(client, custom_callback, arg): if jacklib.jack_custom_set_data_appearance_callback: global _custom_appearance_callback _custom_appearance_callback = JackCustomDataAppearanceCallback(custom_callback) return jacklib.jack_custom_set_data_appearance_callback(client, _custom_appearance_callback, arg) return -1