118 lines
4.1 KiB
Python
118 lines
4.1 KiB
Python
#!/usr/bin/env python3
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# Helper functions for extra jacklib functionality
|
|
# Copyright (C) 2012-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
|
|
|
|
# ------------------------------------------------------------------------------------------------------------
|
|
# Try Import jacklib
|
|
|
|
try:
|
|
import jacklib
|
|
except ImportError:
|
|
jacklib = None
|
|
|
|
# ------------------------------------------------------------------------------------------------------------
|
|
# Get JACK error status as string
|
|
|
|
def get_jack_status_error_string(cStatus):
|
|
status = cStatus.value
|
|
|
|
if status == 0x0:
|
|
return ""
|
|
|
|
errorString = ""
|
|
|
|
if status & jacklib.JackFailure:
|
|
errorString += "Overall operation failed;\n"
|
|
if status & jacklib.JackInvalidOption:
|
|
errorString += "The operation contained an invalid or unsupported option;\n"
|
|
if status & jacklib.JackNameNotUnique:
|
|
errorString += "The desired client name was not unique;\n"
|
|
if status & jacklib.JackServerStarted:
|
|
errorString += "The JACK server was started as a result of this operation;\n"
|
|
if status & jacklib.JackServerFailed:
|
|
errorString += "Unable to connect to the JACK server;\n"
|
|
if status & jacklib.JackServerError:
|
|
errorString += "Communication error with the JACK server;\n"
|
|
if status & jacklib.JackNoSuchClient:
|
|
errorString += "Requested client does not exist;\n"
|
|
if status & jacklib.JackLoadFailure:
|
|
errorString += "Unable to load internal client;\n"
|
|
if status & jacklib.JackInitFailure:
|
|
errorString += "Unable to initialize client;\n"
|
|
if status & jacklib.JackShmFailure:
|
|
errorString += "Unable to access shared memory;\n"
|
|
if status & jacklib.JackVersionError:
|
|
errorString += "Client's protocol version does not match;\n"
|
|
if status & jacklib.JackBackendError:
|
|
errorString += "Backend Error;\n"
|
|
if status & jacklib.JackClientZombie:
|
|
errorString += "Client is being shutdown against its will;\n"
|
|
|
|
return errorString.strip().rsplit(";", 1)[0] + "."
|
|
|
|
# ------------------------------------------------------------------------------------------------------------
|
|
# Convert C char** -> Python list
|
|
|
|
def c_char_p_p_to_list(c_char_p_p):
|
|
i = 0
|
|
retList = []
|
|
|
|
if not c_char_p_p:
|
|
return retList
|
|
|
|
while True:
|
|
new_char_p = c_char_p_p[i]
|
|
if new_char_p:
|
|
retList.append(str(new_char_p, encoding="utf-8"))
|
|
i += 1
|
|
else:
|
|
break
|
|
|
|
jacklib.free(c_char_p_p)
|
|
return retList
|
|
|
|
# ------------------------------------------------------------------------------------------------------------
|
|
# Convert C void* -> string
|
|
|
|
def voidptr2str(void_p):
|
|
char_p = jacklib.cast(void_p, jacklib.c_char_p)
|
|
string = str(char_p.value, encoding="utf-8")
|
|
return string
|
|
|
|
# ------------------------------------------------------------------------------------------------------------
|
|
# Convert C void* -> jack_default_audio_sample_t*
|
|
|
|
def translate_audio_port_buffer(void_p):
|
|
return jacklib.cast(void_p, jacklib.POINTER(jacklib.jack_default_audio_sample_t))
|
|
|
|
# ------------------------------------------------------------------------------------------------------------
|
|
# Convert a JACK midi buffer into a python variable-size list
|
|
|
|
def translate_midi_event_buffer(void_p, size):
|
|
if not void_p:
|
|
return ()
|
|
elif size == 1:
|
|
return (void_p[0],)
|
|
elif size == 2:
|
|
return (void_p[0], void_p[1])
|
|
elif size == 3:
|
|
return (void_p[0], void_p[1], void_p[2])
|
|
elif size == 4:
|
|
return (void_p[0], void_p[1], void_p[2], void_p[3])
|
|
else:
|
|
return ()
|