falkTX
/
Carla
mirror of https://github.com/falkTX/Carla
1
0
Fork 0
Code Releases 42 Activity
Audio plugin host https://kx.studio/carla
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
869 Commits
16 Branches
283MB
Tree: d53df87d60
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'd53df87d60'
${ noResults }
Carla/source/carla_shared.py

583 lines
19KB
Raw Blame History 

  1. #!/usr/bin/env python3

  2. # -*- coding: utf-8 -*-

  3. 

  4. # Common Carla code

  5. # Copyright (C) 2011-2013 Filipe Coelho <falktx@falktx.com>

  6. #

  7. # This program is free software; you can redistribute it and/or

  8. # modify it under the terms of the GNU General Public License as

  9. # published by the Free Software Foundation; either version 2 of

  10. # the License, or any later version.

  11. #

  12. # This program is distributed in the hope that it will be useful,

  13. # but WITHOUT ANY WARRANTY; without even the implied warranty of

  14. # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

  15. # GNU General Public License for more details.

  16. #

  17. # For a full copy of the GNU General Public License see the doc/GPL.txt file.

  18. 

  19. # ------------------------------------------------------------------------------------------------------------

  20. # Imports (Global)

  21. 

  22. import os

  23. import sys

  24. from copy import deepcopy

  25. from subprocess import Popen, PIPE

  26. 

  27. try:

  28.     from PyQt5.QtCore import pyqtSignal, pyqtSlot, qCritical, qFatal, qWarning

  29.     from PyQt5.QtGui import QIcon

  30.     from PyQt5.QtWidgets import QFileDialog, QMessageBox

  31. except:

  32.     from PyQt4.QtCore import pyqtSignal, pyqtSlot, qCritical, qFatal, qWarning

  33.     from PyQt4.QtGui import QIcon

  34.     from PyQt4.QtGui import QFileDialog, QMessageBox

  35. 

  36. # ------------------------------------------------------------------------------------------------------------

  37. # Imports (Custom)

  38. 

  39. from carla_backend import *

  40. 

  41. # ------------------------------------------------------------------------------------------------------------

  42. # Try Import LADSPA-RDF

  43. 

  44. try:

  45.     import ladspa_rdf

  46.     haveLRDF = True

  47. except:

  48.     qWarning("LRDF Support not available (LADSPA-RDF will be disabled)")

  49.     haveLRDF = False

  50. 

  51. # ------------------------------------------------------------------------------------------------------------

  52. # Import Signal

  53. 

  54. from signal import signal, SIGINT, SIGTERM

  55. 

  56. try:

  57.     from signal import SIGUSR1

  58.     haveSIGUSR1 = True

  59. except:

  60.     haveSIGUSR1 = False

  61. 

  62. # ------------------------------------------------------------------------------------------------------------

  63. # Platform specific stuff

  64. 

  65. if MACOS:

  66.     from PyQt5.QtGui import qt_mac_set_menubar_icons

  67.     qt_mac_set_menubar_icons(False)

  68. elif WINDOWS:

  69.     WINDIR = os.getenv("WINDIR")

  70. 

  71. # ------------------------------------------------------------------------------------------------------------

  72. # Set Version

  73. 

  74. VERSION = "1.9.0"

  75. 

  76. # ------------------------------------------------------------------------------------------------------------

  77. # Set TMP

  78. 

  79. TMP = os.getenv("TMP")

  80. 

  81. if TMP is None:

  82.     if WINDOWS:

  83.         qWarning("TMP variable not set")

  84.         TMP = os.path.join(WINDIR, "temp")

  85.     else:

  86.         TMP = "/tmp"

  87. 

  88. # ------------------------------------------------------------------------------------------------------------

  89. # Set HOME

  90. 

  91. HOME = os.getenv("HOME")

  92. 

  93. if HOME is None:

  94.     HOME = os.path.expanduser("~")

  95. 

  96.     if LINUX or MACOS:

  97.         qWarning("HOME variable not set")

  98. 

  99. if not os.path.exists(HOME):

  100.     qWarning("HOME does not exist")

  101.     HOME = TMP

  102. 

  103. # ------------------------------------------------------------------------------------------------------------

  104. # Set PATH

  105. 

  106. PATH = os.getenv("PATH")

  107. 

  108. if PATH is None:

  109.     qWarning("PATH variable not set")

  110. 

  111.     if MACOS:

  112.         PATH = ("/opt/local/bin", "/usr/local/bin", "/usr/bin", "/bin")

  113.     elif WINDOWS:

  114.         PATH = (os.path.join(WINDIR, "system32"), WINDIR)

  115.     else:

  116.         PATH = ("/usr/local/bin", "/usr/bin", "/bin")

  117. 

  118. else:

  119.     PATH = PATH.split(os.pathsep)

  120. 

  121. # ------------------------------------------------------------------------------------------------------------

  122. # Global Carla object

  123. 

  124. class CarlaObject(object):

  125.     __slots__ = [

  126.         'host',

  127.         'gui',

  128.         'isControl',

  129.         'isLocal',

  130.         'processMode',

  131.         'maxParameters',

  132.         'LADSPA_PATH',

  133.         'DSSI_PATH',

  134.         'LV2_PATH',

  135.         'VST_PATH',

  136.         'AU_PATH',

  137.         'CSOUND_PATH',

  138.         'GIG_PATH',

  139.         'SF2_PATH',

  140.         'SFZ_PATH'

  141.     ]

  142. 

  143. Carla = CarlaObject()

  144. Carla.host = None

  145. Carla.gui  = None

  146. Carla.isControl = False

  147. Carla.isLocal   = False

  148. Carla.processMode   = PROCESS_MODE_MULTIPLE_CLIENTS if LINUX else PROCESS_MODE_CONTINUOUS_RACK

  149. Carla.maxParameters = MAX_DEFAULT_PARAMETERS

  150. 

  151. # ------------------------------------------------------------------------------------------------------------

  152. # Static MIDI CC list

  153. 

  154. MIDI_CC_LIST = (

  155.     "0x01 Modulation",

  156.     "0x02 Breath",

  157.     "0x03 (Undefined)",

  158.     "0x04 Foot",

  159.     "0x05 Portamento",

  160.     "0x07 Volume",

  161.     "0x08 Balance",

  162.     "0x09 (Undefined)",

  163.     "0x0A Pan",

  164.     "0x0B Expression",

  165.     "0x0C FX Control 1",

  166.     "0x0D FX Control 2",

  167.     "0x0E (Undefined)",

  168.     "0x0F (Undefined)",

  169.     "0x10 General Purpose 1",

  170.     "0x11 General Purpose 2",

  171.     "0x12 General Purpose 3",

  172.     "0x13 General Purpose 4",

  173.     "0x14 (Undefined)",

  174.     "0x15 (Undefined)",

  175.     "0x16 (Undefined)",

  176.     "0x17 (Undefined)",

  177.     "0x18 (Undefined)",

  178.     "0x19 (Undefined)",

  179.     "0x1A (Undefined)",

  180.     "0x1B (Undefined)",

  181.     "0x1C (Undefined)",

  182.     "0x1D (Undefined)",

  183.     "0x1E (Undefined)",

  184.     "0x1F (Undefined)",

  185.     "0x46 Control 1 [Variation]",

  186.     "0x47 Control 2 [Timbre]",

  187.     "0x48 Control 3 [Release]",

  188.     "0x49 Control 4 [Attack]",

  189.     "0x4A Control 5 [Brightness]",

  190.     "0x4B Control 6 [Decay]",

  191.     "0x4C Control 7 [Vib Rate]",

  192.     "0x4D Control 8 [Vib Depth]",

  193.     "0x4E Control 9 [Vib Delay]",

  194.     "0x4F Control 10 [Undefined]",

  195.     "0x50 General Purpose 5",

  196.     "0x51 General Purpose 6",

  197.     "0x52 General Purpose 7",

  198.     "0x53 General Purpose 8",

  199.     "0x54 Portamento Control",

  200.     "0x5B FX 1 Depth [Reverb]",

  201.     "0x5C FX 2 Depth [Tremolo]",

  202.     "0x5D FX 3 Depth [Chorus]",

  203.     "0x5E FX 4 Depth [Detune]",

  204.     "0x5F FX 5 Depth [Phaser]"

  205.   )

  206. 

  207. # ------------------------------------------------------------------------------------------------------------

  208. # Default Plugin Folders

  209. 

  210. if WINDOWS:

  211.     splitter = ";"

  212.     APPDATA = os.getenv("APPDATA")

  213.     PROGRAMFILES = os.getenv("PROGRAMFILES")

  214.     PROGRAMFILESx86 = os.getenv("PROGRAMFILES(x86)")

  215.     COMMONPROGRAMFILES = os.getenv("COMMONPROGRAMFILES")

  216. 

  217.     # Small integrity tests

  218.     if not APPDATA:

  219.         qFatal("APPDATA variable not set, cannot continue")

  220.         sys.exit(1)

  221. 

  222.     if not PROGRAMFILES:

  223.         qFatal("PROGRAMFILES variable not set, cannot continue")

  224.         sys.exit(1)

  225. 

  226.     if not COMMONPROGRAMFILES:

  227.         qFatal("COMMONPROGRAMFILES variable not set, cannot continue")

  228.         sys.exit(1)

  229. 

  230.     DEFAULT_LADSPA_PATH = ";".join((os.path.join(APPDATA, "LADSPA"),

  231.                                     os.path.join(PROGRAMFILES, "LADSPA")))

  232. 

  233.     DEFAULT_DSSI_PATH   = ";".join((os.path.join(APPDATA, "DSSI"),

  234.                                     os.path.join(PROGRAMFILES, "DSSI")))

  235. 

  236.     DEFAULT_LV2_PATH    = ";".join((os.path.join(APPDATA, "LV2"),

  237.                                     os.path.join(COMMONPROGRAMFILES, "LV2")))

  238. 

  239.     DEFAULT_VST_PATH    = ";".join((os.path.join(PROGRAMFILES, "VstPlugins"),

  240.                                     os.path.join(PROGRAMFILES, "Steinberg", "VstPlugins")))

  241. 

  242.     DEFAULT_AU_PATH     = ""

  243. 

  244.     # TODO

  245.     DEFAULT_CSOUND_PATH = ""

  246. 

  247.     DEFAULT_GIG_PATH    = ";".join((os.path.join(APPDATA, "GIG"),))

  248.     DEFAULT_SF2_PATH    = ";".join((os.path.join(APPDATA, "SF2"),))

  249.     DEFAULT_SFZ_PATH    = ";".join((os.path.join(APPDATA, "SFZ"),))

  250. 

  251.     if PROGRAMFILESx86:

  252.         DEFAULT_LADSPA_PATH += ";"+os.path.join(PROGRAMFILESx86, "LADSPA")

  253.         DEFAULT_DSSI_PATH   += ";"+os.path.join(PROGRAMFILESx86, "DSSI")

  254.         DEFAULT_VST_PATH    += ";"+os.path.join(PROGRAMFILESx86, "VstPlugins")

  255.         DEFAULT_VST_PATH    += ";"+os.path.join(PROGRAMFILESx86, "Steinberg", "VstPlugins")

  256. 

  257. elif HAIKU:

  258.     splitter = ":"

  259. 

  260.     DEFAULT_LADSPA_PATH = ":".join((os.path.join(HOME, ".ladspa"),

  261.                                     os.path.join("/", "boot", "common", "add-ons", "ladspa")))

  262. 

  263.     DEFAULT_DSSI_PATH   = ":".join((os.path.join(HOME, ".dssi"),

  264.                                     os.path.join("/", "boot", "common", "add-ons", "dssi")))

  265. 

  266.     DEFAULT_LV2_PATH    = ":".join((os.path.join(HOME, ".lv2"),

  267.                                     os.path.join("/", "boot", "common", "add-ons", "lv2")))

  268. 

  269.     DEFAULT_VST_PATH    = ":".join((os.path.join(HOME, ".vst"),

  270.                                     os.path.join("/", "boot", "common", "add-ons", "vst")))

  271. 

  272.     DEFAULT_AU_PATH     = ""

  273. 

  274.     # TODO

  275.     DEFAULT_CSOUND_PATH = ""

  276. 

  277.     # TODO

  278.     DEFAULT_GIG_PATH    = ""

  279.     DEFAULT_SF2_PATH    = ""

  280.     DEFAULT_SFZ_PATH    = ""

  281. 

  282. elif MACOS:

  283.     splitter = ":"

  284. 

  285.     DEFAULT_LADSPA_PATH = ":".join((os.path.join(HOME, "Library", "Audio", "Plug-Ins", "LADSPA"),

  286.                                     os.path.join("/", "Library", "Audio", "Plug-Ins", "LADSPA")))

  287. 

  288.     DEFAULT_DSSI_PATH   = ":".join((os.path.join(HOME, "Library", "Audio", "Plug-Ins", "DSSI"),

  289.                                     os.path.join("/", "Library", "Audio", "Plug-Ins", "DSSI")))

  290. 

  291.     DEFAULT_LV2_PATH    = ":".join((os.path.join(HOME, "Library", "Audio", "Plug-Ins", "LV2"),

  292.                                     os.path.join("/", "Library", "Audio", "Plug-Ins", "LV2")))

  293. 

  294.     DEFAULT_VST_PATH    = ":".join((os.path.join(HOME, "Library", "Audio", "Plug-Ins", "VST"),

  295.                                     os.path.join("/", "Library", "Audio", "Plug-Ins", "VST")))

  296. 

  297.     DEFAULT_AU_PATH     = ":".join((os.path.join(HOME, "Library", "Audio", "Plug-Ins", "AudioUnits"),

  298.                                     os.path.join("/", "Library", "Audio", "Plug-Ins", "AudioUnits")))

  299. 

  300.     # TODO

  301.     DEFAULT_CSOUND_PATH = ""

  302. 

  303.     # TODO

  304.     DEFAULT_GIG_PATH    = ""

  305.     DEFAULT_SF2_PATH    = ""

  306.     DEFAULT_SFZ_PATH    = ""

  307. 

  308. else:

  309.     splitter = ":"

  310. 

  311.     DEFAULT_LADSPA_PATH = ":".join((os.path.join(HOME, ".ladspa"),

  312.                                     os.path.join("/", "usr", "lib", "ladspa"),

  313.                                     os.path.join("/", "usr", "local", "lib", "ladspa")))

  314. 

  315.     DEFAULT_DSSI_PATH   = ":".join((os.path.join(HOME, ".dssi"),

  316.                                     os.path.join("/", "usr", "lib", "dssi"),

  317.                                     os.path.join("/", "usr", "local", "lib", "dssi")))

  318. 

  319.     DEFAULT_LV2_PATH    = ":".join((os.path.join(HOME, ".lv2"),

  320.                                     os.path.join("/", "usr", "lib", "lv2"),

  321.                                     os.path.join("/", "usr", "local", "lib", "lv2")))

  322. 

  323.     DEFAULT_VST_PATH    = ":".join((os.path.join(HOME, ".vst"),

  324.                                     os.path.join("/", "usr", "lib", "vst"),

  325.                                     os.path.join("/", "usr", "local", "lib", "vst")))

  326. 

  327.     DEFAULT_AU_PATH     = ""

  328. 

  329.     # TODO

  330.     DEFAULT_CSOUND_PATH = ""

  331. 

  332.     DEFAULT_GIG_PATH    = ":".join((os.path.join(HOME, ".sounds"),

  333.                                     os.path.join("/", "usr", "share", "sounds", "gig")))

  334. 

  335.     DEFAULT_SF2_PATH    = ":".join((os.path.join(HOME, ".sounds"),

  336.                                     os.path.join("/", "usr", "share", "sounds", "sf2")))

  337. 

  338.     DEFAULT_SFZ_PATH    = ":".join((os.path.join(HOME, ".sounds"),

  339.                                     os.path.join("/", "usr", "share", "sounds", "sfz")))

  340. 

  341. # ------------------------------------------------------------------------------------------------------------

  342. # Default Plugin Folders (set)

  343. 

  344. readEnvVars = True

  345. 

  346. if WINDOWS:

  347.     # Check if running Wine. If yes, ignore env vars

  348.     from winreg import ConnectRegistry, OpenKey, CloseKey, HKEY_CURRENT_USER

  349.     reg = ConnectRegistry(None, HKEY_CURRENT_USER)

  350. 

  351.     try:

  352.         key = OpenKey(reg, r"SOFTWARE\Wine")

  353.         CloseKey(key)

  354.         readEnvVars = False

  355.     except:

  356.         pass

  357. 

  358.     CloseKey(reg)

  359.     del reg

  360. 

  361. if readEnvVars:

  362.     Carla.LADSPA_PATH = os.getenv("LADSPA_PATH", DEFAULT_LADSPA_PATH).split(splitter)

  363.     Carla.DSSI_PATH   = os.getenv("DSSI_PATH",   DEFAULT_DSSI_PATH).split(splitter)

  364.     Carla.LV2_PATH    = os.getenv("LV2_PATH",    DEFAULT_LV2_PATH).split(splitter)

  365.     Carla.VST_PATH    = os.getenv("VST_PATH",    DEFAULT_VST_PATH).split(splitter)

  366.     Carla.AU_PATH     = os.getenv("AU_PATH",     DEFAULT_AU_PATH).split(splitter)

  367.     Carla.CSOUND_PATH = os.getenv("CSOUND_PATH", DEFAULT_CSOUND_PATH).split(splitter)

  368.     Carla.GIG_PATH    = os.getenv("GIG_PATH",    DEFAULT_GIG_PATH).split(splitter)

  369.     Carla.SF2_PATH    = os.getenv("SF2_PATH",    DEFAULT_SF2_PATH).split(splitter)

  370.     Carla.SFZ_PATH    = os.getenv("SFZ_PATH",    DEFAULT_SFZ_PATH).split(splitter)

  371. 

  372.     if haveLRDF:

  373.         LADSPA_RDF_PATH_env = os.getenv("LADSPA_RDF_PATH")

  374.         if LADSPA_RDF_PATH_env:

  375.             ladspa_rdf.set_rdf_path(LADSPA_RDF_PATH_env.split(splitter))

  376.         del LADSPA_RDF_PATH_env

  377. 

  378. else:

  379.     Carla.LADSPA_PATH = DEFAULT_LADSPA_PATH.split(splitter)

  380.     Carla.DSSI_PATH   = DEFAULT_DSSI_PATH.split(splitter)

  381.     Carla.LV2_PATH    = DEFAULT_LV2_PATH.split(splitter)

  382.     Carla.VST_PATH    = DEFAULT_VST_PATH.split(splitter)

  383.     Carla.AU_PATH     = DEFAULT_AU_PATH.split(splitter)

  384.     Carla.CSOUND_PATH = DEFAULT_CSOUND_PATH.split(splitter)

  385.     Carla.GIG_PATH    = DEFAULT_GIG_PATH.split(splitter)

  386.     Carla.SF2_PATH    = DEFAULT_SF2_PATH.split(splitter)

  387.     Carla.SFZ_PATH    = DEFAULT_SFZ_PATH.split(splitter)

  388. 

  389. del readEnvVars

  390. 

  391. # ------------------------------------------------------------------------------------------------------------

  392. # Search for Carla library and tools

  393. 

  394. carla_library_filename  = ""

  395. 

  396. carla_discovery_native  = ""

  397. carla_discovery_posix32 = ""

  398. carla_discovery_posix64 = ""

  399. carla_discovery_win32   = ""

  400. carla_discovery_win64   = ""

  401. 

  402. carla_bridge_native  = ""

  403. carla_bridge_posix32 = ""

  404. carla_bridge_posix64 = ""

  405. carla_bridge_win32   = ""

  406. carla_bridge_win64   = ""

  407. 

  408. carla_bridge_lv2_external = ""

  409. carla_bridge_lv2_gtk2     = ""

  410. carla_bridge_lv2_gtk3     = ""

  411. carla_bridge_lv2_qt4      = ""

  412. carla_bridge_lv2_qt5      = ""

  413. carla_bridge_lv2_cocoa    = ""

  414. carla_bridge_lv2_windows  = ""

  415. carla_bridge_lv2_x11      = ""

  416. 

  417. carla_bridge_vst_mac  = ""

  418. carla_bridge_vst_hwnd = ""

  419. carla_bridge_vst_x11  = ""

  420. 

  421. carla_libname = "libcarla_%s" % "control" if Carla.isControl else "standalone"

  422. 

  423. if WINDOWS:

  424.     carla_libname += ".dll"

  425. elif MACOS:

  426.     carla_libname += ".dylib"

  427. else:

  428.     carla_libname += ".so"

  429. 

  430. CWD = sys.path[0]

  431. 

  432. # make it work with cxfreeze

  433. if CWD.endswith("/carla"):

  434.     CWD = CWD.rsplit("/carla", 1)[0]

  435. elif CWD.endswith("\\carla.exe"):

  436.     CWD = CWD.rsplit("\\carla.exe", 1)[0]

  437. 

  438. # find carla_library_filename

  439. if os.path.exists(os.path.join(CWD, "backend", carla_libname)):

  440.     carla_library_filename = os.path.join(CWD, "backend", carla_libname)

  441. else:

  442.     if WINDOWS:

  443.         CARLA_PATH = (os.path.join(PROGRAMFILES, "Carla"),)

  444.     elif MACOS:

  445.         CARLA_PATH = ("/opt/local/lib", "/usr/local/lib/", "/usr/lib")

  446.     else:

  447.         CARLA_PATH = ("/usr/local/lib/", "/usr/lib")

  448. 

  449.     for path in CARLA_PATH:

  450.         if os.path.exists(os.path.join(path, "carla", carla_libname)):

  451.             carla_library_filename = os.path.join(path, "carla", carla_libname)

  452.             break

  453. 

  454.     del CARLA_PATH

  455. 

  456. # find tool

  457. def findTool(toolDir, toolName):

  458.     if os.path.exists(os.path.join(CWD, toolDir, toolName)):

  459.         return os.path.join(CWD, toolDir, toolName)

  460. 

  461.     for p in PATH:

  462.         if os.path.exists(os.path.join(p, toolName)):

  463.             return os.path.join(p, toolName)

  464. 

  465.     return ""

  466. 

  467. # find windows tools

  468. carla_discovery_win32 = findTool("discovery", "carla-discovery-win32.exe")

  469. carla_discovery_win64 = findTool("discovery", "carla-discovery-win64.exe")

  470. carla_bridge_win32    = findTool("bridges", "carla-bridge-win32.exe")

  471. carla_bridge_win64    = findTool("bridges", "carla-bridge-win64.exe")

  472. 

  473. # find native and posix tools

  474. if not WINDOWS:

  475.     carla_discovery_native  = findTool("discovery", "carla-discovery-native")

  476.     carla_discovery_posix32 = findTool("discovery", "carla-discovery-posix32")

  477.     carla_discovery_posix64 = findTool("discovery", "carla-discovery-posix64")

  478.     carla_bridge_native     = findTool("bridges", "carla-bridge-native")

  479.     carla_bridge_posix32    = findTool("bridges", "carla-bridge-posix32")

  480.     carla_bridge_posix64    = findTool("bridges", "carla-bridge-posix64")

  481. 

  482. # find generic tools

  483. carla_bridge_lv2_external = findTool("bridges", "carla-bridge-lv2-external")

  484. 

  485. # find windows only tools

  486. if WINDOWS:

  487.     carla_bridge_lv2_windows = findTool("bridges", "carla-bridge-lv2-windows.exe")

  488.     carla_bridge_vst_hwnd    = findTool("bridges", "carla-bridge-vst-hwnd.exe")

  489. 

  490. # find mac os only tools

  491. elif MACOS:

  492.     carla_bridge_lv2_cocoa = findTool("bridges", "carla-bridge-lv2-cocoa")

  493.     carla_bridge_vst_mac   = findTool("bridges", "carla-bridge-vst-mac")

  494. 

  495. # find other tools

  496. else:

  497.     carla_bridge_lv2_gtk2 = findTool("bridges", "carla-bridge-lv2-gtk2")

  498.     carla_bridge_lv2_gtk3 = findTool("bridges", "carla-bridge-lv2-gtk3")

  499.     carla_bridge_lv2_qt4  = findTool("bridges", "carla-bridge-lv2-qt4")

  500.     carla_bridge_lv2_qt5  = findTool("bridges", "carla-bridge-lv2-qt5")

  501.     carla_bridge_lv2_x11  = findTool("bridges", "carla-bridge-lv2-x11")

  502.     carla_bridge_vst_x11  = findTool("bridges", "carla-bridge-vst-x11")

  503. 

  504. # ------------------------------------------------------------------------------------------------------------

  505. # Convert a ctypes c_char_p into a python string

  506. 

  507. def cString(value):

  508.     if not value:

  509.         return ""

  510.     if isinstance(value, str):

  511.         return value

  512.     return value.decode("utf-8", errors="ignore")

  513. 

  514. # ------------------------------------------------------------------------------------------------------------

  515. # Check if a value is a number (float support)

  516. 

  517. def isNumber(value):

  518.     try:

  519.         float(value)

  520.         return True

  521.     except:

  522.         return False

  523. 

  524. # ------------------------------------------------------------------------------------------------------------

  525. # Convert a value to a list

  526. 

  527. def toList(value):

  528.     if value is None:

  529.         return []

  530.     elif not isinstance(value, list):

  531.         return [value]

  532.     else:

  533.         return value

  534. 

  535. # ------------------------------------------------------------------------------------------------------------

  536. # Get Icon from user theme, using our own as backup (Oxygen)

  537. 

  538. def getIcon(icon, size=16):

  539.     return QIcon.fromTheme(icon, QIcon(":/%ix%i/%s.png" % (size, size, icon)))

  540. 

  541. # ------------------------------------------------------------------------------------------------------------

  542. # Signal handler

  543. 

  544. def signalHandler(sig, frame):

  545.     if Carla.gui is None:

  546.         return

  547. 

  548.     if sig in (SIGINT, SIGTERM):

  549.         Carla.gui.SIGTERM.emit()

  550.     elif haveSIGUSR1 and sig == SIGUSR1:

  551.         Carla.gui.SIGUSR1.emit()

  552. 

  553. def setUpSignals():

  554.     signal(SIGINT,  signalHandler)

  555.     signal(SIGTERM, signalHandler)

  556. 

  557.     if haveSIGUSR1:

  558.         return

  559. 

  560.     signal(SIGUSR1, signalHandler)

  561. 

  562. # ------------------------------------------------------------------------------------------------------------

  563. # QLineEdit and QPushButton combo

  564. 

  565. def getAndSetPath(self_, currentPath, lineEdit):

  566.     newPath = QFileDialog.getExistingDirectory(self_, self_.tr("Set Path"), currentPath, QFileDialog.ShowDirsOnly)

  567.     if newPath:

  568.         lineEdit.setText(newPath)

  569.     return newPath

  570. 

  571. # ------------------------------------------------------------------------------------------------------------

  572. # Custom MessageBox

  573. 

  574. def CustomMessageBox(self_, icon, title, text, extraText="", buttons=QMessageBox.Yes|QMessageBox.No, defButton=QMessageBox.No):

  575.     msgBox = QMessageBox(self_)

  576.     msgBox.setIcon(icon)

  577.     msgBox.setWindowTitle(title)

  578.     msgBox.setText(text)

  579.     msgBox.setInformativeText(extraText)

  580.     msgBox.setStandardButtons(buttons)

  581.     msgBox.setDefaultButton(defButton)

  582.     return msgBox.exec_()