cadence/src/jacklib.py

1281 lines
46 KiB
Python

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# JACK ctypes definitions for usage in python applications
# Copyright (C) 2010-2013 Filipe Coelho <falktx@falktx.com>
#
# 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