Initial import of 'jacket' Nim wrapper for JACK API

Signed-off-by: Christopher Arndt <chris@chrisarndt.de>
This commit is contained in:
Christopher Arndt 2022-10-06 04:18:57 +02:00
commit fcbb796cd4
4 changed files with 612 additions and 0 deletions

32
examples/test_jacket.nim Normal file
View File

@ -0,0 +1,32 @@
import std/strformat
import jacket
var client: ClientTPtr
var time: TimeT
var status: cint
client = clientOpen("test_jacket", ord(NullOption), addr status)
echo fmt"Server status: {status}"
if client == nil:
echo getJackStatusErrorString(status)
quit 1
time = getTime()
var ver = getVersionString()
echo fmt"JACK version: {ver}"
var rate = getSampleRate(client)
echo fmt"Sample rate: {rate}"
var bufsize = getBufferSize(client)
echo fmt"Buffer size: {bufsize}"
var load = cpuLoad(client)
echo fmt"DSP load: {load}%"
echo fmt"Server time: {time}"
var name = getClientName(client)
echo fmt"Client name: {name}"
var rt = if isRealtime(client) > 0: "yes" else: "no"
echo fmt"RT enabled: {rt}"
discard clientClose(client)

View File

@ -0,0 +1,55 @@
import std/[strformat, os]
import jacket
var client: ClientTPtr
var status: cint
proc cleanup() {.noconv.} =
echo "Cleaning up..."
if client != nil:
discard deactivate(client)
discard clientClose(client)
client = nil
quit 0
proc portConnected(portA: PortIdT; portB: PortIdT; connect: cint; arg: pointer) {.exportc.} =
let portAPtr = portById(client, portA)
let portBPtr = portById(client, portB)
if portAPtr != nil:
let portAName = portName(portAPtr)
echo fmt"Port A: {portAName}"
else:
echo "Port A: <unknown>"
if portAPtr != nil:
let portBName = portName(portBPtr)
echo fmt"Port B: {portBName}"
else:
echo "Port B: <unknown>"
var action = if connect > 0: "connect" else: "disconnect"
echo fmt"Action: {action}"
client = clientOpen("jacket_port_register", ord(NoStartServer) or ord(UseExactName), addr status)
echo fmt"Server status: {status}"
if client == nil:
echo getJackStatusErrorString(status)
quit 1
discard portRegister(client, "in_1", JACK_DEFAULT_AUDIO_TYPE, ord(PortIsInput), 0)
discard portRegister(client, "out_1", JACK_DEFAULT_AUDIO_TYPE, ord(PortIsOutput), 0)
if setPortConnectCallback(client, portConnected, nil) != 0:
echo "Error: could not set port connection callback."
discard activate(client)
while true:
sleep(50)
cleanup()

View File

@ -0,0 +1,32 @@
import std/[strformat, os]
import jacket
var client: ClientTPtr
var status: cint
proc cleanup() {.noconv.} =
echo "Cleaning up..."
if client != nil:
discard clientClose(client)
client = nil
quit 0
client = clientOpen("jacket_port_register", ord(NoStartServer) or ord(UseExactName), addr status)
echo fmt"Server status: {status}"
if client == nil:
echo getJackStatusErrorString(status)
quit 1
setControlCHook(cleanup)
discard portRegister(client, "in_1", JACK_DEFAULT_AUDIO_TYPE, ord(PortIsInput), 0)
discard portRegister(client, "out_1", JACK_DEFAULT_AUDIO_TYPE, ord(PortIsOutput), 0)
while true:
sleep(50)
cleanup()

493
jacket.nim Normal file
View File

@ -0,0 +1,493 @@
# jacket.nim
# Possible names/install locations of libjack, according to
# https://github.com/x42/weakjack/blob/master/weak_libjack.c#L108
#
# MacOS:
# * /usr/local/lib/libjack.dylib
# * /opt/homebrew/lib/libjack.dylib
# * /opt/local/lib/libjack.dylib
# Win:
# * libjack64.dll
# * libjack.dll
# Unix:
# * libjack.so.0
proc getJackLibName: string =
when system.hostOS == "windows":
result = "libjack.dll"
elif system.hostOS == "macosx":
result = "libjack.dylib"
else:
result = "libjack.so.0"
{.push dynlib: getJackLibName().}
const
JACK_MAX_FRAMES* = (4294967295'i64)
JACK_LOAD_INIT_LIMIT* = 1024
JACK_DEFAULT_AUDIO_TYPE* = "32 bit float mono audio"
JACK_DEFAULT_MIDI_TYPE* = "8 bit raw midi"
# ----------------------------- Custom Types ------------------------------
type
TimeT* = culonglong
NframesT* = culong
UuidT* = culonglong
PortIdT* = culong
PortTypeIdT* = culong
type
ClientT = object
ClientTPtr* = ptr ClientT
PortT = object
PortTPtr* = ptr PortT
type
JackOptions* {.size: sizeof(cint) pure.} = enum
NullOption = 0x00,
NoStartServer = 0x01,
UseExactName = 0x02,
ServerName = 0x04,
LoadName = 0x08,
LoadInit = 0x10,
SessionID = 0x20
type
JackStatus* {.size: sizeof(cint).} = enum
Success = 0x00
Failure = 0x01,
InvalidOption = 0x02,
NameNotUnique = 0x04,
ServerStarted = 0x08,
ServerFailed = 0x10,
ServerError = 0x20,
NoSuchClient = 0x40,
LoadFailure = 0x80,
InitFailure = 0x100,
ShmFailure = 0x200,
VersionError = 0x400,
BackendError = 0x800,
ClientZombie = 0x1000
type
JackPortFlags* {.size: sizeof(culong) pure.} = enum
PortIsInput = 0x1,
PortIsOutput = 0x2,
PortIsPhysical = 0x4,
PortCanMonitor = 0x8,
PortIsTerminal = 0x10
type
JackLatencyCallbackMode* {.size: sizeof(cint) pure.} = enum
CaptureLatency,
PlaybackLatency
# Callback function types
type
JackProcessCallback* = proc (nframes: NframesT; arg: pointer): cint
JackThreadCallback* = proc (arg: pointer): pointer
JackThreadInitCallback* = proc (arg: pointer)
JackGraphOrderCallback* = proc (arg: pointer): cint
JackXRunCallback* = proc (arg: pointer): cint
JackBufferSizeCallback* = proc (nframes: NframesT; arg: pointer): cint
JackSampleRateCallback* = proc (nframes: NframesT; arg: pointer): cint
JackPortRegistrationCallback* = proc (port: PortIdT; flag: cint; arg: pointer)
JackClientRegistrationCallback* = proc (name: cstring; flag: cint; arg: pointer)
JackPortConnectCallback* = proc (portA: PortIdT; portB: PortIdT; connect: cint; arg: pointer)
JackPortRenameCallback* = proc (port: PortIdT; oldName: cstring; newName: cstring; arg: pointer)
JackFreewheelCallback* = proc (starting: cint; arg: pointer)
JackShutdownCallback* = proc (arg: pointer)
JackInfoShutdownCallback* = proc (code: JackStatus; reason: cstring; arg: pointer)
JackLatencyCallback* = proc (mode: JackLatencyCallbackMode; arg: pointer)
JackInfoCallback* = proc (msg: cstring)
JackErrorCallback* = proc (msg: cstring)
# ----------------------------- Version info ------------------------------
# void jack_get_version(int *major_ptr, int *minor_ptr, int *micro_ptr, int *proto_ptr) ;
proc getVersion*(major: ptr cint; minor: ptr cint; micro: ptr cint; proto: ptr cint) {.importc: "jack_get_version".}
# const char * jack_get_version_string(void) ;
proc getVersionString*(): cstring {.importc: "jack_get_version_string".}
# --------------------------- Memory management ---------------------------
# void jack_free(void* ptr) ;
proc free*(`ptr`: pointer) {.importc: "jack_free".}
# -------------------------------- Clients --------------------------------
# jack_client_t * jack_client_open (char *client_name,
# jack_options_t options,
# jack_status_t *status, ...) ;
proc clientOpen*(clientName: cstring; options: cint; status: ptr cint): ClientTPtr {.
varargs, importc: "jack_client_open".}
# DEPRECATED
# proc clientNew*(clientName: cstring): ClientTPtr {.importc: "jack_client_new".}
# int jack_client_close (jack_client_t *client) ;
proc clientClose*(client: ClientTPtr): cint {.importc: "jack_client_close"}
# int jack_client_name_size (void) ;
proc clientNameSize*(): cint {.importc: "jack_client_name_size"}
# char * jack_get_client_name (jack_client_t *client) ;
proc getClientName*(client: ClientTPtr): cstring {.importc: "jack_get_client_name".}
# char *jack_get_uuid_for_client_name (jack_client_t *client,
# const char *client_name) ;
proc getUuidForClientName*(client: ClientTPtr; clientName: cstring): cstring {.
importc: "jack_get_uuid_for_client_name".}
# char *jack_get_client_name_by_uuid (jack_client_t *client,
# const char *client_uuid ) ;
proc getClientNameByUuid*(client: ClientTPtr; clientUuid: cstring): cstring {.
importc: "jack_get_client_name_by_uuid".}
#[ FIXME: not implemented yet
proc internalClientNew*(clientName: cstring; loadName: cstring; loadInit: cstring): cint {.
importc: "jack_internal_client_new".}
proc internalClientClose*(clientName: cstring) {.importc: "jack_internal_client_close".}
]#
# int jack_activate (jack_client_t *client) ;
proc activate*(client: ClientTPtr): cint {.importc: "jack_activate".}
# int jack_deactivate (jack_client_t *client) ;
proc deactivate*(client: ClientTPtr): cint {.importc: "jack_deactivate".}
# int jack_get_client_pid (const char *name) ;
proc getClientPid*(name: cstring): cint {.importc: "jack_get_client_pid".}
# FIXME: not implemented yet
# jack_native_thread_t jack_client_thread_id (jack_client_t *client) ;
# proc clientThreadId*(client: ClientTPtr): NativeThreadT {.
# importc: "jack_client_thread_id".}
# int jack_is_realtime (jack_client_t *client) ;
proc isRealtime*(client: ClientTPtr): cint {.importc: "jack_is_realtime".}
# DEPRECATED
# proc threadWait*(client: ClientTPtr; status: cint): NframesT {.
# importc: "jack_thread_wait".}
# jack_nframes_t jack_cycle_wait (jack_client_t* client) ;
proc cycleWait*(client: ClientTPtr): NframesT {.importc: "jack_cycle_wait".}
# void jack_cycle_signal (jack_client_t* client, int status) ;
proc cycleSignal*(client: ClientTPtr; status: cint) {.importc: "jack_cycle_signal".}
# ------------------------------- Callbacks -------------------------------
proc setProcessThread*(client: ClientTPtr; threadCallback: JackThreadCallback; arg: pointer): cint {.
importc: "jack_set_process_thread".}
proc setThreadInitCallback*(client: ClientTPtr; threadInitCallback: JackThreadInitCallback; arg: pointer): cint {.
importc: "jack_set_thread_init_callback".}
proc onShutdown*(client: ClientTPtr; shutdownCallback: JackShutdownCallback; arg: pointer) {.
importc: "jack_on_shutdown".}
proc onInfoShutdown*(client: ClientTPtr; shutdownCallback: JackInfoShutdownCallback; arg: pointer) {.
importc: "jack_on_info_shutdown".}
proc setProcessCallback*(client: ClientTPtr; processCallback: JackProcessCallback; arg: pointer): cint {.
importc: "jack_set_process_callback".}
proc setFreewheelCallback*(client: ClientTPtr; freewheelCallback: JackFreewheelCallback; arg: pointer): cint {.
importc: "jack_set_freewheel_callback".}
proc setBufferSizeCallback*(client: ClientTPtr; bufsizeCallback: JackBufferSizeCallback; arg: pointer): cint {.
importc: "jack_set_buffer_size_callback".}
proc setSampleRateCallback*(client: ClientTPtr; srateCallback: JackSampleRateCallback; arg: pointer): cint {.
importc: "jack_set_sample_rate_callback".}
proc setClientRegistrationCallback*(client: ClientTPtr; registrationCallback: JackClientRegistrationCallback;
arg: pointer): cint {.
importc: "jack_set_client_registration_callback".}
proc setPortRegistrationCallback*(client: ClientTPtr; registrationCallback: JackPortRegistrationCallback;
arg: pointer): cint {.
importc: "jack_set_port_registration_callback".}
proc setPortConnectCallback*(client: ClientTPtr; connectCallback: JackPortConnectCallback; arg: pointer): cint {.
importc: "jack_set_port_connect_callback".}
proc setPortRenameCallback*(client: ClientTPtr; renameCallback: JackPortRenameCallback; arg: pointer): cint {.
importc: "jack_set_port_rename_callback".}
proc setGraphOrderCallback*(client: ClientTPtr; graphCallback: JackGraphOrderCallback; a3: pointer): cint {.
importc: "jack_set_graph_order_callback".}
proc setXrunCallback*(client: ClientTPtr; xrunCallback: JackXRunCallback; arg: pointer): cint {.
importc: "jack_set_xrun_callback".}
proc setLatencyCallback*(client: ClientTPtr; latencyCallback: JackLatencyCallback; arg: pointer): cint {.
importc: "jack_set_latency_callback".}
# -------------------------- Server Client Control ------------------------
# int jack_set_freewheel(jack_client_t* client, int onoff) ;
proc setFreewheel*(client: ClientTPtr; onoff: cint): cint {.importc: "jack_set_freewheel".}
# int jack_set_buffer_size (jack_client_t *client, jack_nframes_t nframes) ;
proc setBufferSize*(client: ClientTPtr; nframes: NframesT): cint {.importc: "jack_set_buffer_size".}
#jack_nframes_t jack_get_sample_rate (jack_client_t *) ;
proc getSampleRate*(client: ClientTPtr): NframesT {.importc: "jack_get_sample_rate".}
# jack_nframes_t jack_get_buffer_size (jack_client_t *) ;
proc getBufferSize*(client: ClientTPtr): NframesT {.importc: "jack_get_buffer_size".}
# DEPRECATED
# proc engineTakeoverTimebase*(a1: ClientTPtr): cint {.
# importc: "jack_engine_takeover_timebase".}
# float jack_cpu_load (jack_client_t *client) ;
proc cpuLoad*(client: ClientTPtr): cfloat {.importc: "jack_cpu_load".}
# --------------------------------- Ports ---------------------------------
# jack_port_t * jack_port_register (jack_client_t *client,
# const char *port_name,
# const char *port_type,
# unsigned long flags,
# unsigned long buffer_size) ;
proc portRegister*(client: ClientTPtr; portName: cstring; portType: cstring;
flags: culong; bufferSize: culong): PortTPtr {.importc: "jack_port_register".}
# int jack_port_unregister (jack_client_t *client, jack_port_t *port) ;
proc portUnregister*(client: ClientTPtr; port: PortTPtr): cint {.importc: "jack_port_unregister".}
# void * jack_port_get_buffer (jack_port_t *port, jack_nframes_t) ;
proc portGetBuffer*(port: PortTPtr; nframes: NframesT): pointer {.importc: "jack_port_get_buffer".}
# jack_uuid_t jack_port_uuid (const jack_port_t *port) ;
proc portUuid*(port: PortTPtr): UuidT {.importc: "jack_port_uuid".}
# const char * jack_port_name (const jack_port_t *port) ;
proc portName*(port: PortTPtr): cstring {.importc: "jack_port_name".}
# const char * jack_port_short_name (const jack_port_t *port) ;
proc portShortName*(port: PortTPtr): cstring {.importc: "jack_port_short_name".}
# int jack_port_flags (const jack_port_t *port) ;
proc portFlags*(port: PortTPtr): cint {.importc: "jack_port_flags".}
# const char * jack_port_type (const jack_port_t *port) ;
proc portType*(port: PortTPtr): cstring {.importc: "jack_port_type".}
# jack_port_type_id_t jack_port_type_id (const jack_port_t *port) ;
proc portTypeId*(port: PortTPtr): PortTypeIdT {.importc: "jack_port_type_id".}
# int jack_port_is_mine (const jack_client_t *client, const jack_port_t *port) ;
proc portIsMine*(client: ClientTPtr; port: PortTPtr): cint {.
importc: "jack_port_is_mine".}
# int jack_port_connected (const jack_port_t *port) ;
proc portConnected*(port: PortTPtr): cint {.importc: "jack_port_connected".}
# int jack_port_connected_to (const jack_port_t *port,
# const char *port_name) ;
proc portConnectedTo*(port: PortTPtr; portName: cstring): cint {.importc: "jack_port_connected_to".}
# const char ** jack_port_get_connections (const jack_port_t *port) ;
#
# CAVEAT: The caller is responsible for calling jack_free() on any non-NULL
# returned value.
proc portGetConnections*(port: PortTPtr): cstringArray {.importc: "jack_port_get_connections".}
# const char ** jack_port_get_all_connections (const jack_client_t *client,
# const jack_port_t *port) ;
#
# CAVEAT: The caller is responsible for calling jack_free() on any non-NULL
# returned value.
proc portGetAllConnections*(client: ClientTPtr; port: PortTPtr): cstringArray {.
importc: "jack_port_get_all_connections".}
#[ DEPRECATED
proc portTie*(src: PortTPtr; dst: PortTPtr): cint {.importc: "jack_port_tie".}
proc portUntie*(port: PortTPtr): cint {.importc: "jack_port_untie".}
proc portSetName*(port: PortTPtr; portName: cstring): cint {.importc: "jack_port_set_name".}
]#
# int jack_port_rename (jack_client_t* client, jack_port_t *port, const char *port_name) ;
proc portRename*(client: ClientTPtr; port: PortTPtr; portName: cstring): cint {.importc: "jack_port_rename".}
# int jack_port_set_alias (jack_port_t *port, const char *alias) ;
proc portSetAlias*(port: PortTPtr; alias: cstring): cint {.importc: "jack_port_set_alias".}
# int jack_port_unset_alias (jack_port_t *port, const char *alias) ;
proc portUnsetAlias*(port: PortTPtr; alias: cstring): cint {.importc: "jack_port_unset_alias".}
# int jack_port_get_aliases (const jack_port_t *port, char* const aliases[2]) ;
proc portGetAliases*(port: PortTPtr; aliases: array[2, cstring]): cint {.importc: "jack_port_get_aliases".}
#int jack_port_request_monitor (jack_port_t *port, int onoff) ;
proc portRequestMonitor*(port: PortTPtr; onoff: cint): cint {.importc: "jack_port_request_monitor".}
# int jack_port_request_monitor_by_name (jack_client_t *client,
# const char *port_name, int onoff) ;
proc portRequestMonitorByName*(client: ClientTPtr; portName: cstring; onoff: cint): cint {.
importc: "jack_port_request_monitor_by_name".}
# int jack_port_ensure_monitor (jack_port_t *port, int onoff) ;
proc portEnsureMonitor*(port: PortTPtr; onoff: cint): cint {.
importc: "jack_port_ensure_monitor".}
# int jack_port_monitoring_input (jack_port_t *port) ;
proc portMonitoringInput*(port: PortTPtr): cint {.importc: "jack_port_monitoring_input".}
# ------------------------------ Connections ------------------------------
# int jack_connect (jack_client_t *client,
# const char *source_port,
# const char *destination_port) ;
proc connect*(client: ClientTPtr; srcPort: cstring; destPort: cstring): cint {.importc: "jack_connect".}
# int jack_disconnect (jack_client_t *client,
# const char *source_port,
# const char *destination_port) ;
proc disconnect*(client: ClientTPtr; srcPort: cstring; destPort: cstring): cint {.importc: "jack_disconnect".}
# int jack_port_disconnect (jack_client_t *client, jack_port_t *port) ;
proc portDisconnect*(client: ClientTPtr; port: PortTPtr): cint {.importc: "jack_port_disconnect".}
# int jack_port_name_size(void) ;
proc portNameSize*(): cint {.importc: "jack_port_name_size".}
# int jack_port_type_size(void) ;
proc portTypeSize*(): cint {.importc: "jack_port_type_size".}
# size_t jack_port_type_get_buffer_size (jack_client_t *client, const char *port_type) ;
proc portTypeGetBufferSize*(client: ClientTPtr; portType: cstring): csize_t {.
importc: "jack_port_type_get_buffer_size".}
# -------------------------------- Latency --------------------------------
#[ FIXME: not implemented yet
# void jack_port_set_latency (jack_port_t *port, jack_nframes_t) ;
proc portSetLatency*(port: PortTPtr; a2: NframesT) {.importc: "jack_port_set_latency".}
#[ FIXME: not implemented yet
# void jack_port_get_latency_range (jack_port_t *port, jack_latency_callback_mode_t mode, jack_latency_range_t *range) ;
proc portGetLatencyRange*(port: PortTPtr; mode: LatencyCallbackModeT;
range: ptr LatencyRangeT) {.importc: "jack_port_get_latency_range".}
proc portSetLatencyRange*(port: PortTPtr; mode: LatencyCallbackModeT;
range: ptr LatencyRangeT) {.importc: "jack_port_set_latency_range".}
]#
proc recomputeTotalLatencies*(client: ClientTPtr): cint {.importc: "jack_recompute_total_latencies".}
proc portGetLatency*(port: PortTPtr): NframesT {.importc: "jack_port_get_latency".}
proc portGetTotalLatency*(client: ClientTPtr; port: PortTPtr): NframesT {.importc: "jack_port_get_total_latency".}
proc recomputeTotalLatency*(a1: ClientTPtr; port: PortTPtr): cint {.importc: "jack_recompute_total_latency".}
]#
# ------------------------------ Port Lookup ------------------------------
# const char ** jack_get_ports (jack_client_t *client,
# const char *port_name_pattern,
# const char *type_name_pattern,
# unsigned long flags) ;
#
# CAVEAT: The caller is responsible for calling jack_free() on any non-NULL
# returned value.
proc getPorts*(client: ClientTPtr; portNamePattern: cstring;
typeNamePattern: cstring; flags: culong): cstringArray {.importc: "jack_get_ports".}
# jack_port_t * jack_port_by_name (jack_client_t *client, const char *port_name) ;
proc portByName*(client: ClientTPtr; portName: cstring): PortTPtr {.importc: "jack_port_by_name".}
# jack_port_t * jack_port_by_id (jack_client_t *client, jack_port_id_t port_id) ;
proc portById*(client: ClientTPtr; portId: PortIdT): PortTPtr {.importc: "jack_port_by_id".}
# ----------------------------- Time handling -----------------------------
# jack_nframes_t jack_frames_since_cycle_start (const jack_client_t *) ;
proc framesSinceCycleStart*(client: ClientTPtr): NframesT {.importc: "jack_frames_since_cycle_start".}
# jack_nframes_t jack_frame_time (const jack_client_t *) ;
proc frameTime*(client: ClientTPtr): NframesT {.importc: "jack_frame_time".}
# jack_nframes_t jack_last_frame_time (const jack_client_t *client) ;
proc lastFrameTime*(client: ClientTPtr): NframesT {.importc: "jack_last_frame_time".}
# int jack_get_cycle_times(const jack_client_t *client,
# jack_nframes_t *current_frames,
# jack_time_t *current_usecs,
# jack_time_t *next_usecs,
# float *period_usecs) ;
proc getCycleTimes*(client: ClientTPtr; currentFrames: ptr NframesT;
currentUsecs: ptr TimeT; nextUsecs: ptr TimeT;
periodUsecs: ptr cfloat): cint {.importc: "jack_get_cycle_times".}
# jack_time_t jack_frames_to_time(const jack_client_t *client, jack_nframes_t) ;
proc framesToTime*(client: ClientTPtr; nframes: NframesT): TimeT {.importc: "jack_frames_to_time".}
# jack_nframes_t jack_time_to_frames(const jack_client_t *client, jack_time_t) ;
proc timeToFrames*(client: ClientTPtr; time: TimeT): NframesT {.importc: "jack_time_to_frames".}
# jack_time_t jack_get_time(void) ;
proc getTime*(): TimeT {.importc: "jack_get_time".}
# ---------------------------- Error handling -----------------------------
proc setErrorFunction*(errorCallback: JackErrorCallback) {.importc: "jack_set_error_function".}
proc setInfoFunction*(infoCallback: JackInfoCallback) {.importc: "jack_set_info_function".}
{.pop.}
proc getJackStatusErrorString*(status: cint): string =
# Get JACK error status as string.
if status == ord(Success):
return ""
var errorString = ""
if status == ord(Failure):
# Only include this generic message if no other error status is set
errorString = "Overall operation failed"
if (status and ord(InvalidOption)) > 0:
errorString &= "\nThe operation contained an invalid and unsupported option"
if (status and ord(NameNotUnique)) > 0:
errorString &= "\nThe desired client name was not unique"
if (status and ord(ServerStarted)) > 0:
errorString &= "\nThe JACK server was started as a result of this operation"
if (status and ord(ServerFailed)) > 0:
errorString &= "\nUnable to connect to the JACK server"
if (status and ord(ServerError)) > 0:
errorString &= "\nCommunication error with the JACK server"
if (status and ord(NoSuchClient)) > 0:
errorString &= "\nRequested client does not exist"
if (status and ord(LoadFailure)) > 0:
errorString &= "\nUnable to load internal client"
if (status and ord(InitFailure)) > 0:
errorString &= "\nUnable to initialize client"
if (status and ord(ShmFailure)) > 0:
errorString &= "\nUnable to access shared memory"
if (status and ord(VersionError)) > 0:
errorString &= "\nClient's protocol version does not match"
if (status and ord(BackendError)) > 0:
errorString &= "\nBackend Error"
if (status and ord(ClientZombie)) > 0:
errorString &= "\nClient is being shutdown against its will"
return errorString