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.
6542 Commits
16 Branches
3.6GB
Tree: de6833ab60
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'de6833ab60'
${ noResults }
Carla/source/frontend/carla_shared.py

910 lines
33KB
Raw Blame History 

  1. #!/usr/bin/env python3

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

  3. 

  4. # Common Carla code

  5. # Copyright (C) 2011-2022 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. 

  25. from math import fmod

  26. 

  27. # ------------------------------------------------------------------------------------------------------------

  28. # Imports (Signal)

  29. 

  30. from signal import signal, SIGINT, SIGTERM

  31. 

  32. try:

  33.     from signal import SIGUSR1

  34.     haveSIGUSR1 = True

  35. except:

  36.     haveSIGUSR1 = False

  37. 

  38. # ------------------------------------------------------------------------------------------------------------

  39. # Imports (PyQt5)

  40. 

  41. from PyQt5.Qt import PYQT_VERSION_STR

  42. from PyQt5.QtCore import qFatal, QT_VERSION, QT_VERSION_STR, qWarning, QDir, QSettings

  43. from PyQt5.QtGui import QIcon

  44. from PyQt5.QtWidgets import QFileDialog, QMessageBox

  45. 

  46. # ------------------------------------------------------------------------------------------------------------

  47. # Imports (Custom)

  48. 

  49. from carla_backend import (

  50.     MAX_DEFAULT_PARAMETERS,

  51.     ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS,

  52.     ENGINE_PROCESS_MODE_PATCHBAY,

  53.     ENGINE_TRANSPORT_MODE_INTERNAL,

  54.     ENGINE_TRANSPORT_MODE_JACK

  55. )

  56. 

  57. from common import kIs64bit, HAIKU, LINUX, MACOS, WINDOWS, VERSION

  58. 

  59. # ------------------------------------------------------------------------------------------------------------

  60. # Config

  61. 

  62. # These will be modified during install

  63. X_LIBDIR_X = None

  64. X_DATADIR_X = None

  65. 

  66. # ------------------------------------------------------------------------------------------------------------

  67. # Platform specific stuff

  68. 

  69. if WINDOWS:

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

  71. 

  72. # ------------------------------------------------------------------------------------------------------------

  73. # Set TMP

  74. 

  75. envTMP = os.getenv("TMP")

  76. 

  77. if envTMP is None:

  78.     if WINDOWS:

  79.         qWarning("TMP variable not set")

  80.     TMP = QDir.tempPath()

  81. else:

  82.     TMP = envTMP

  83. 

  84. if not os.path.exists(TMP):

  85.     qWarning("TMP does not exist")

  86.     TMP = "/"

  87. 

  88. del envTMP

  89. 

  90. # ------------------------------------------------------------------------------------------------------------

  91. # Set HOME

  92. 

  93. envHOME = os.getenv("HOME")

  94. 

  95. if envHOME is None:

  96.     if LINUX or MACOS:

  97.         qWarning("HOME variable not set")

  98.     HOME = QDir.toNativeSeparators(QDir.homePath())

  99. else:

  100.     HOME = envHOME

  101. 

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

  103.     qWarning("HOME does not exist")

  104.     HOME = TMP

  105. 

  106. del envHOME

  107. 

  108. # ------------------------------------------------------------------------------------------------------------

  109. # Set PATH

  110. 

  111. envPATH = os.getenv("PATH")

  112. 

  113. if envPATH is None:

  114.     qWarning("PATH variable not set")

  115.     if MACOS:

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

  117.     elif WINDOWS:

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

  119.     else:

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

  121. else:

  122.     PATH = envPATH.split(os.pathsep)

  123. 

  124. del envPATH

  125. 

  126. # ------------------------------------------------------------------------------------------------------------

  127. # Static MIDI CC list

  128. 

  129. MIDI_CC_LIST = (

  130.     "01 [0x01] Modulation",

  131.     "02 [0x02] Breath",

  132.     "04 [0x04] Foot",

  133.     "05 [0x05] Portamento",

  134.     "07 [0x07] Volume",

  135.     "08 [0x08] Balance",

  136.     "10 [0x0A] Pan",

  137.     "11 [0x0B] Expression",

  138.     "12 [0x0C] FX Control 1",

  139.     "13 [0x0D] FX Control 2",

  140.     "16 [0x10] General Purpose 1",

  141.     "17 [0x11] General Purpose 2",

  142.     "18 [0x12] General Purpose 3",

  143.     "19 [0x13] General Purpose 4",

  144.     "70 [0x46] Control 1 [Variation]",

  145.     "71 [0x47] Control 2 [Timbre]",

  146.     "72 [0x48] Control 3 [Release]",

  147.     "73 [0x49] Control 4 [Attack]",

  148.     "74 [0x4A] Control 5 [Brightness]",

  149.     "75 [0x4B] Control 6 [Decay]",

  150.     "76 [0x4C] Control 7 [Vib Rate]",

  151.     "77 [0x4D] Control 8 [Vib Depth]",

  152.     "78 [0x4E] Control 9 [Vib Delay]",

  153.     "79 [0x4F] Control 10 [Undefined]",

  154.     "80 [0x50] General Purpose 5",

  155.     "81 [0x51] General Purpose 6",

  156.     "82 [0x52] General Purpose 7",

  157.     "83 [0x53] General Purpose 8",

  158.     "84 [0x54] Portamento Control",

  159.     "91 [0x5B] FX 1 Depth [Reverb]",

  160.     "92 [0x5C] FX 2 Depth [Tremolo]",

  161.     "93 [0x5D] FX 3 Depth [Chorus]",

  162.     "94 [0x5E] FX 4 Depth [Detune]",

  163.     "95 [0x5F] FX 5 Depth [Phaser]"

  164. )

  165. 

  166. MAX_MIDI_CC_LIST_ITEM = 95

  167. 

  168. # ------------------------------------------------------------------------------------------------------------

  169. # PatchCanvas defines

  170. 

  171. CANVAS_ANTIALIASING_SMALL = 1

  172. CANVAS_EYECANDY_SMALL     = 1

  173. 

  174. # ------------------------------------------------------------------------------------------------------------

  175. # Carla Settings keys

  176. 

  177. CARLA_KEY_MAIN_PROJECT_FOLDER   = "Main/ProjectFolder"   # str

  178. CARLA_KEY_MAIN_USE_PRO_THEME    = "Main/UseProTheme"     # bool

  179. CARLA_KEY_MAIN_PRO_THEME_COLOR  = "Main/ProThemeColor"   # str

  180. CARLA_KEY_MAIN_REFRESH_INTERVAL = "Main/RefreshInterval" # int

  181. CARLA_KEY_MAIN_CONFIRM_EXIT     = "Main/ConfirmExit"     # bool

  182. CARLA_KEY_MAIN_CLASSIC_SKIN     = "Main/ClassicSkin"     # bool

  183. CARLA_KEY_MAIN_SHOW_LOGS        = "Main/ShowLogs"        # bool

  184. CARLA_KEY_MAIN_SYSTEM_ICONS     = "Main/SystemIcons"     # bool

  185. CARLA_KEY_MAIN_EXPERIMENTAL     = "Main/Experimental"    # bool

  186. 

  187. CARLA_KEY_CANVAS_THEME             = "Canvas/Theme"           # str

  188. CARLA_KEY_CANVAS_SIZE              = "Canvas/Size"            # str "NxN"

  189. CARLA_KEY_CANVAS_USE_BEZIER_LINES  = "Canvas/UseBezierLines"  # bool

  190. CARLA_KEY_CANVAS_AUTO_HIDE_GROUPS  = "Canvas/AutoHideGroups"  # bool

  191. CARLA_KEY_CANVAS_AUTO_SELECT_ITEMS = "Canvas/AutoSelectItems" # bool

  192. CARLA_KEY_CANVAS_EYE_CANDY         = "Canvas/EyeCandy2"       # bool

  193. CARLA_KEY_CANVAS_FANCY_EYE_CANDY   = "Canvas/FancyEyeCandy"   # bool

  194. CARLA_KEY_CANVAS_USE_OPENGL        = "Canvas/UseOpenGL"       # bool

  195. CARLA_KEY_CANVAS_ANTIALIASING      = "Canvas/Antialiasing"    # enum

  196. CARLA_KEY_CANVAS_HQ_ANTIALIASING   = "Canvas/HQAntialiasing"  # bool

  197. CARLA_KEY_CANVAS_INLINE_DISPLAYS   = "Canvas/InlineDisplays"  # bool

  198. CARLA_KEY_CANVAS_FULL_REPAINTS     = "Canvas/FullRepaints"    # bool

  199. 

  200. CARLA_KEY_ENGINE_DRIVER_PREFIX         = "Engine/Driver-"

  201. CARLA_KEY_ENGINE_AUDIO_DRIVER          = "Engine/AudioDriver"         # str

  202. CARLA_KEY_ENGINE_PROCESS_MODE          = "Engine/ProcessMode"         # enum

  203. CARLA_KEY_ENGINE_TRANSPORT_MODE        = "Engine/TransportMode"       # enum

  204. CARLA_KEY_ENGINE_TRANSPORT_EXTRA       = "Engine/TransportExtra"      # str

  205. CARLA_KEY_ENGINE_FORCE_STEREO          = "Engine/ForceStereo"         # bool

  206. CARLA_KEY_ENGINE_PREFER_PLUGIN_BRIDGES = "Engine/PreferPluginBridges" # bool

  207. CARLA_KEY_ENGINE_PREFER_UI_BRIDGES     = "Engine/PreferUiBridges"     # bool

  208. CARLA_KEY_ENGINE_MANAGE_UIS            = "Engine/ManageUIs"           # bool

  209. CARLA_KEY_ENGINE_UIS_ALWAYS_ON_TOP     = "Engine/UIsAlwaysOnTop"      # bool

  210. CARLA_KEY_ENGINE_MAX_PARAMETERS        = "Engine/MaxParameters"       # int

  211. CARLA_KEY_ENGINE_RESET_XRUNS           = "Engine/ResetXruns"          # bool

  212. CARLA_KEY_ENGINE_UI_BRIDGES_TIMEOUT    = "Engine/UiBridgesTimeout"    # int

  213. 

  214. CARLA_KEY_OSC_ENABLED          = "OSC/Enabled"

  215. CARLA_KEY_OSC_TCP_PORT_ENABLED = "OSC/TCPEnabled"

  216. CARLA_KEY_OSC_TCP_PORT_NUMBER  = "OSC/TCPNumber"

  217. CARLA_KEY_OSC_TCP_PORT_RANDOM  = "OSC/TCPRandom"

  218. CARLA_KEY_OSC_UDP_PORT_ENABLED = "OSC/UDPEnabled"

  219. CARLA_KEY_OSC_UDP_PORT_NUMBER  = "OSC/UDPNumber"

  220. CARLA_KEY_OSC_UDP_PORT_RANDOM  = "OSC/UDPRandom"

  221. 

  222. CARLA_KEY_PATHS_AUDIO = "Paths/Audio"

  223. CARLA_KEY_PATHS_MIDI  = "Paths/MIDI"

  224. 

  225. CARLA_KEY_PATHS_LADSPA = "Paths/LADSPA"

  226. CARLA_KEY_PATHS_DSSI   = "Paths/DSSI"

  227. CARLA_KEY_PATHS_LV2    = "Paths/LV2"

  228. CARLA_KEY_PATHS_VST2   = "Paths/VST2"

  229. CARLA_KEY_PATHS_VST3   = "Paths/VST3"

  230. CARLA_KEY_PATHS_CLAP   = "Paths/CLAP"

  231. CARLA_KEY_PATHS_SF2    = "Paths/SF2"

  232. CARLA_KEY_PATHS_SFZ    = "Paths/SFZ"

  233. CARLA_KEY_PATHS_JSFX   = "Paths/JSFX"

  234. 

  235. CARLA_KEY_WINE_EXECUTABLE      = "Wine/Executable"     # str

  236. CARLA_KEY_WINE_AUTO_PREFIX     = "Wine/AutoPrefix"     # bool

  237. CARLA_KEY_WINE_FALLBACK_PREFIX = "Wine/FallbackPrefix" # str

  238. CARLA_KEY_WINE_RT_PRIO_ENABLED = "Wine/RtPrioEnabled"  # bool

  239. CARLA_KEY_WINE_BASE_RT_PRIO    = "Wine/BaseRtPrio"     # int

  240. CARLA_KEY_WINE_SERVER_RT_PRIO  = "Wine/ServerRtPrio"   # int

  241. 

  242. CARLA_KEY_EXPERIMENTAL_PLUGIN_BRIDGES        = "Experimental/PluginBridges"       # bool

  243. CARLA_KEY_EXPERIMENTAL_WINE_BRIDGES          = "Experimental/WineBridges"         # bool

  244. CARLA_KEY_EXPERIMENTAL_JACK_APPS             = "Experimental/JackApplications"    # bool

  245. CARLA_KEY_EXPERIMENTAL_EXPORT_LV2            = "Experimental/ExportLV2"           # bool

  246. CARLA_KEY_EXPERIMENTAL_PREVENT_BAD_BEHAVIOUR = "Experimental/PreventBadBehaviour" # bool

  247. CARLA_KEY_EXPERIMENTAL_LOAD_LIB_GLOBAL       = "Experimental/LoadLibGlobal"       # bool

  248. 

  249. # if pro theme is on and color is black

  250. CARLA_KEY_CUSTOM_PAINTING = "UseCustomPainting" # bool

  251. 

  252. # ------------------------------------------------------------------------------------------------------------

  253. # Carla Settings defaults

  254. 

  255. # Main

  256. CARLA_DEFAULT_MAIN_PROJECT_FOLDER   = HOME

  257. CARLA_DEFAULT_MAIN_USE_PRO_THEME    = True

  258. CARLA_DEFAULT_MAIN_PRO_THEME_COLOR  = "Black"

  259. CARLA_DEFAULT_MAIN_REFRESH_INTERVAL = 20

  260. CARLA_DEFAULT_MAIN_CONFIRM_EXIT     = True

  261. CARLA_DEFAULT_MAIN_CLASSIC_SKIN     = False

  262. CARLA_DEFAULT_MAIN_SHOW_LOGS        = bool(not WINDOWS)

  263. CARLA_DEFAULT_MAIN_SYSTEM_ICONS     = False

  264. CARLA_DEFAULT_MAIN_EXPERIMENTAL     = False

  265. 

  266. # Canvas

  267. CARLA_DEFAULT_CANVAS_THEME             = "Modern Dark"

  268. CARLA_DEFAULT_CANVAS_SIZE              = "3100x2400"

  269. CARLA_DEFAULT_CANVAS_SIZE_WIDTH        = 3100

  270. CARLA_DEFAULT_CANVAS_SIZE_HEIGHT       = 2400

  271. CARLA_DEFAULT_CANVAS_USE_BEZIER_LINES  = True

  272. CARLA_DEFAULT_CANVAS_AUTO_HIDE_GROUPS  = True

  273. CARLA_DEFAULT_CANVAS_AUTO_SELECT_ITEMS = False

  274. CARLA_DEFAULT_CANVAS_EYE_CANDY         = True

  275. CARLA_DEFAULT_CANVAS_FANCY_EYE_CANDY   = False

  276. CARLA_DEFAULT_CANVAS_USE_OPENGL        = False

  277. CARLA_DEFAULT_CANVAS_ANTIALIASING      = CANVAS_ANTIALIASING_SMALL

  278. CARLA_DEFAULT_CANVAS_HQ_ANTIALIASING   = False

  279. CARLA_DEFAULT_CANVAS_INLINE_DISPLAYS   = False

  280. CARLA_DEFAULT_CANVAS_FULL_REPAINTS     = False

  281. 

  282. # Engine

  283. CARLA_DEFAULT_FORCE_STEREO          = False

  284. CARLA_DEFAULT_PREFER_PLUGIN_BRIDGES = False

  285. CARLA_DEFAULT_PREFER_UI_BRIDGES     = True

  286. CARLA_DEFAULT_MANAGE_UIS            = True

  287. CARLA_DEFAULT_UIS_ALWAYS_ON_TOP     = False

  288. CARLA_DEFAULT_MAX_PARAMETERS        = MAX_DEFAULT_PARAMETERS

  289. CARLA_DEFAULT_RESET_XRUNS           = False

  290. CARLA_DEFAULT_UI_BRIDGES_TIMEOUT    = 4000

  291. 

  292. CARLA_DEFAULT_AUDIO_BUFFER_SIZE     = 512

  293. CARLA_DEFAULT_AUDIO_SAMPLE_RATE     = 44100

  294. CARLA_DEFAULT_AUDIO_TRIPLE_BUFFER   = False

  295. 

  296. if WINDOWS:

  297.     CARLA_DEFAULT_AUDIO_DRIVER = "Windows Audio"

  298. elif MACOS:

  299.     CARLA_DEFAULT_AUDIO_DRIVER = "CoreAudio"

  300. elif os.path.exists("/usr/bin/jackd") or os.path.exists("/usr/bin/jackdbus") or os.path.exists("/usr/bin/pw-jack"):

  301.     CARLA_DEFAULT_AUDIO_DRIVER = "JACK"

  302. else:

  303.     CARLA_DEFAULT_AUDIO_DRIVER = "PulseAudio"

  304. 

  305. if CARLA_DEFAULT_AUDIO_DRIVER == "JACK":

  306.     CARLA_DEFAULT_PROCESS_MODE   = ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS

  307.     CARLA_DEFAULT_TRANSPORT_MODE = ENGINE_TRANSPORT_MODE_JACK

  308. else:

  309.     CARLA_DEFAULT_PROCESS_MODE   = ENGINE_PROCESS_MODE_PATCHBAY

  310.     CARLA_DEFAULT_TRANSPORT_MODE = ENGINE_TRANSPORT_MODE_INTERNAL

  311. 

  312. # OSC

  313. CARLA_DEFAULT_OSC_ENABLED = not (MACOS or WINDOWS)

  314. CARLA_DEFAULT_OSC_TCP_PORT_ENABLED = True

  315. CARLA_DEFAULT_OSC_TCP_PORT_NUMBER  = 22752

  316. CARLA_DEFAULT_OSC_TCP_PORT_RANDOM  = False

  317. CARLA_DEFAULT_OSC_UDP_PORT_ENABLED = True

  318. CARLA_DEFAULT_OSC_UDP_PORT_NUMBER  = 22752

  319. CARLA_DEFAULT_OSC_UDP_PORT_RANDOM  = False

  320. 

  321. # Wine

  322. CARLA_DEFAULT_WINE_EXECUTABLE      = "wine"

  323. CARLA_DEFAULT_WINE_AUTO_PREFIX     = True

  324. CARLA_DEFAULT_WINE_FALLBACK_PREFIX = os.path.expanduser("~/.wine")

  325. CARLA_DEFAULT_WINE_RT_PRIO_ENABLED = True

  326. CARLA_DEFAULT_WINE_BASE_RT_PRIO    = 15

  327. CARLA_DEFAULT_WINE_SERVER_RT_PRIO  = 10

  328. 

  329. # Experimental

  330. CARLA_DEFAULT_EXPERIMENTAL_PLUGIN_BRIDGES        = False

  331. CARLA_DEFAULT_EXPERIMENTAL_WINE_BRIDGES          = False

  332. CARLA_DEFAULT_EXPERIMENTAL_JACK_APPS             = False

  333. CARLA_DEFAULT_EXPERIMENTAL_LV2_EXPORT            = False

  334. CARLA_DEFAULT_EXPERIMENTAL_PREVENT_BAD_BEHAVIOUR = False

  335. CARLA_DEFAULT_EXPERIMENTAL_LOAD_LIB_GLOBAL       = False

  336. 

  337. # ------------------------------------------------------------------------------------------------------------

  338. # Default File Folders

  339. 

  340. CARLA_DEFAULT_FILE_PATH_AUDIO = []

  341. CARLA_DEFAULT_FILE_PATH_MIDI  = []

  342. 

  343. # ------------------------------------------------------------------------------------------------------------

  344. # Default Plugin Folders (get)

  345. 

  346. DEFAULT_LADSPA_PATH = ""

  347. DEFAULT_DSSI_PATH   = ""

  348. DEFAULT_LV2_PATH    = ""

  349. DEFAULT_VST2_PATH   = ""

  350. DEFAULT_VST3_PATH   = ""

  351. DEFAULT_CLAP_PATH   = ""

  352. DEFAULT_SF2_PATH    = ""

  353. DEFAULT_SFZ_PATH    = ""

  354. DEFAULT_JSFX_PATH   = ""

  355. 

  356. if WINDOWS:

  357.     splitter = ";"

  358. 

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

  360.     LOCALAPPDATA = os.getenv("LOCALAPPDATA", APPDATA)

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

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

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

  364.     COMMONPROGRAMFILESx86 = os.getenv("COMMONPROGRAMFILES(x86)")

  365. 

  366.     # Small integrity tests

  367.     if not APPDATA:

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

  369.         sys.exit(1)

  370. 

  371.     if not PROGRAMFILES:

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

  373.         sys.exit(1)

  374. 

  375.     if not COMMONPROGRAMFILES:

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

  377.         sys.exit(1)

  378. 

  379.     DEFAULT_LADSPA_PATH  = APPDATA + "\\LADSPA"

  380.     DEFAULT_LADSPA_PATH += ";" + PROGRAMFILES + "\\LADSPA"

  381. 

  382.     DEFAULT_DSSI_PATH    = APPDATA + "\\DSSI"

  383.     DEFAULT_DSSI_PATH   += ";" + PROGRAMFILES + "\\DSSI"

  384. 

  385.     DEFAULT_LV2_PATH     = APPDATA + "\\LV2"

  386.     DEFAULT_LV2_PATH    += ";" + COMMONPROGRAMFILES + "\\LV2"

  387. 

  388.     DEFAULT_VST2_PATH    = PROGRAMFILES + "\\VstPlugins"

  389.     DEFAULT_VST2_PATH   += ";" + PROGRAMFILES + "\\Steinberg\\VstPlugins"

  390. 

  391.     DEFAULT_JSFX_PATH    = APPDATA + "\\REAPER\\Effects"

  392.     #DEFAULT_JSFX_PATH   += ";" + PROGRAMFILES + "\\REAPER\\InstallData\\Effects"

  393. 

  394.     if kIs64bit:

  395.         DEFAULT_VST2_PATH  += ";" + COMMONPROGRAMFILES + "\\VST2"

  396. 

  397.     DEFAULT_VST3_PATH    = COMMONPROGRAMFILES + "\\VST3"

  398.     DEFAULT_VST3_PATH   += ";" + LOCALAPPDATA + "\\Programs\\Common\\VST3"

  399. 

  400.     DEFAULT_CLAP_PATH    = COMMONPROGRAMFILES + "\\CLAP"

  401.     DEFAULT_CLAP_PATH   += ";" + LOCALAPPDATA + "\\Programs\\Common\\CLAP"

  402. 

  403.     DEFAULT_SF2_PATH     = APPDATA + "\\SF2"

  404.     DEFAULT_SFZ_PATH     = APPDATA + "\\SFZ"

  405. 

  406.     if PROGRAMFILESx86:

  407.         DEFAULT_LADSPA_PATH += ";" + PROGRAMFILESx86 + "\\LADSPA"

  408.         DEFAULT_DSSI_PATH   += ";" + PROGRAMFILESx86 + "\\DSSI"

  409.         DEFAULT_VST2_PATH   += ";" + PROGRAMFILESx86 + "\\VstPlugins"

  410.         DEFAULT_VST2_PATH   += ";" + PROGRAMFILESx86 + "\\Steinberg\\VstPlugins"

  411.         #DEFAULT_JSFX_PATH   += ";" + PROGRAMFILESx86 + "\\REAPER\\InstallData\\Effects"

  412. 

  413.     if COMMONPROGRAMFILESx86:

  414.         DEFAULT_VST3_PATH   += COMMONPROGRAMFILESx86 + "\\VST3"

  415.         DEFAULT_CLAP_PATH   += COMMONPROGRAMFILESx86 + "\\CLAP"

  416. 

  417. elif HAIKU:

  418.     splitter = ":"

  419. 

  420.     DEFAULT_LADSPA_PATH  = HOME + "/.ladspa"

  421.     DEFAULT_LADSPA_PATH += ":/system/add-ons/media/ladspaplugins"

  422.     DEFAULT_LADSPA_PATH += ":/system/lib/ladspa"

  423. 

  424.     DEFAULT_DSSI_PATH    = HOME + "/.dssi"

  425.     DEFAULT_DSSI_PATH   += ":/system/add-ons/media/dssiplugins"

  426.     DEFAULT_DSSI_PATH   += ":/system/lib/dssi"

  427. 

  428.     DEFAULT_LV2_PATH     = HOME + "/.lv2"

  429.     DEFAULT_LV2_PATH    += ":/system/add-ons/media/lv2plugins"

  430. 

  431.     DEFAULT_VST2_PATH    = HOME + "/.vst"

  432.     DEFAULT_VST2_PATH   += ":/system/add-ons/media/vstplugins"

  433. 

  434.     DEFAULT_VST3_PATH    = HOME + "/.vst3"

  435.     DEFAULT_VST3_PATH   += ":/system/add-ons/media/vst3plugins"

  436. 

  437.     DEFAULT_CLAP_PATH    = HOME + "/.clap"

  438.     DEFAULT_CLAP_PATH   += ":/system/add-ons/media/clapplugins"

  439. 

  440. elif MACOS:

  441.     splitter = ":"

  442. 

  443.     DEFAULT_LADSPA_PATH  = HOME + "/Library/Audio/Plug-Ins/LADSPA"

  444.     DEFAULT_LADSPA_PATH += ":/Library/Audio/Plug-Ins/LADSPA"

  445. 

  446.     DEFAULT_DSSI_PATH    = HOME + "/Library/Audio/Plug-Ins/DSSI"

  447.     DEFAULT_DSSI_PATH   += ":/Library/Audio/Plug-Ins/DSSI"

  448. 

  449.     DEFAULT_LV2_PATH     = HOME + "/Library/Audio/Plug-Ins/LV2"

  450.     DEFAULT_LV2_PATH    += ":/Library/Audio/Plug-Ins/LV2"

  451. 

  452.     DEFAULT_VST2_PATH    = HOME + "/Library/Audio/Plug-Ins/VST"

  453.     DEFAULT_VST2_PATH   += ":/Library/Audio/Plug-Ins/VST"

  454. 

  455.     DEFAULT_VST3_PATH    = HOME + "/Library/Audio/Plug-Ins/VST3"

  456.     DEFAULT_VST3_PATH   += ":/Library/Audio/Plug-Ins/VST3"

  457. 

  458.     DEFAULT_CLAP_PATH    = HOME + "/Library/Audio/Plug-Ins/CLAP"

  459.     DEFAULT_CLAP_PATH   += ":/Library/Audio/Plug-Ins/CLAP"

  460. 

  461.     DEFAULT_JSFX_PATH    = HOME + "/Library/Application Support/REAPER/Effects"

  462.     #DEFAULT_JSFX_PATH   += ":/Applications/REAPER.app/Contents/InstallFiles/Effects"

  463. 

  464. else:

  465.     CONFIG_HOME = os.getenv("XDG_CONFIG_HOME", HOME + "/.config")

  466. 

  467.     splitter = ":"

  468. 

  469.     DEFAULT_LADSPA_PATH  = HOME + "/.ladspa"

  470.     DEFAULT_LADSPA_PATH += ":/usr/lib/ladspa"

  471.     DEFAULT_LADSPA_PATH += ":/usr/local/lib/ladspa"

  472. 

  473.     DEFAULT_DSSI_PATH    = HOME + "/.dssi"

  474.     DEFAULT_DSSI_PATH   += ":/usr/lib/dssi"

  475.     DEFAULT_DSSI_PATH   += ":/usr/local/lib/dssi"

  476. 

  477.     DEFAULT_LV2_PATH     = HOME + "/.lv2"

  478.     DEFAULT_LV2_PATH    += ":/usr/lib/lv2"

  479.     DEFAULT_LV2_PATH    += ":/usr/local/lib/lv2"

  480. 

  481.     DEFAULT_VST2_PATH    = HOME + "/.vst"

  482.     DEFAULT_VST2_PATH   += ":/usr/lib/vst"

  483.     DEFAULT_VST2_PATH   += ":/usr/local/lib/vst"

  484. 

  485.     DEFAULT_VST2_PATH   += HOME + "/.lxvst"

  486.     DEFAULT_VST2_PATH   += ":/usr/lib/lxvst"

  487.     DEFAULT_VST2_PATH   += ":/usr/local/lib/lxvst"

  488. 

  489.     DEFAULT_VST3_PATH    = HOME + "/.vst3"

  490.     DEFAULT_VST3_PATH   += ":/usr/lib/vst3"

  491.     DEFAULT_VST3_PATH   += ":/usr/local/lib/vst3"

  492. 

  493.     DEFAULT_CLAP_PATH    = HOME + "/.clap"

  494.     DEFAULT_CLAP_PATH   += ":/usr/lib/clap"

  495.     DEFAULT_CLAP_PATH   += ":/usr/local/lib/clap"

  496. 

  497.     DEFAULT_SF2_PATH     = HOME + "/.sounds/sf2"

  498.     DEFAULT_SF2_PATH    += ":" + HOME + "/.sounds/sf3"

  499.     DEFAULT_SF2_PATH    += ":/usr/share/sounds/sf2"

  500.     DEFAULT_SF2_PATH    += ":/usr/share/sounds/sf3"

  501.     DEFAULT_SF2_PATH    += ":/usr/share/soundfonts"

  502. 

  503.     DEFAULT_SFZ_PATH     = HOME + "/.sounds/sfz"

  504.     DEFAULT_SFZ_PATH    += ":/usr/share/sounds/sfz"

  505. 

  506.     DEFAULT_JSFX_PATH    = CONFIG_HOME + "/REAPER/Effects"

  507.     #DEFAULT_JSFX_PATH   += ":" + "/opt/REAPER/InstallData/Effects"

  508. 

  509. if not WINDOWS:

  510.     winePrefix = os.getenv("WINEPREFIX")

  511. 

  512.     if not winePrefix:

  513.         winePrefix = HOME + "/.wine"

  514. 

  515.     if os.path.exists(winePrefix):

  516.         DEFAULT_VST2_PATH += ":" + winePrefix + "/drive_c/Program Files/VstPlugins"

  517.         DEFAULT_VST3_PATH += ":" + winePrefix + "/drive_c/Program Files/Common Files/VST3"

  518.         DEFAULT_CLAP_PATH += ":" + winePrefix + "/drive_c/Program Files/Common Files/CLAP"

  519. 

  520.         if kIs64bit and os.path.exists(winePrefix + "/drive_c/Program Files (x86)"):

  521.             DEFAULT_VST2_PATH += ":" + winePrefix + "/drive_c/Program Files (x86)/VstPlugins"

  522.             DEFAULT_VST3_PATH += ":" + winePrefix + "/drive_c/Program Files (x86)/Common Files/VST3"

  523.             DEFAULT_CLAP_PATH += ":" + winePrefix + "/drive_c/Program Files (x86)/Common Files/CLAP"

  524. 

  525.     del winePrefix

  526. 

  527. # ------------------------------------------------------------------------------------------------------------

  528. # Default Plugin Folders (set)

  529. 

  530. readEnvVars = True

  531. 

  532. if WINDOWS:

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

  534.     # pylint: disable=import-error

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

  536.     # pylint: enable=import-error

  537.     _reg = ConnectRegistry(None, HKEY_CURRENT_USER)

  538. 

  539.     try:

  540.         _key = OpenKey(_reg, r"SOFTWARE\Wine")

  541.         CloseKey(_key)

  542.         del _key

  543.         readEnvVars = False

  544.     except:

  545.         pass

  546. 

  547.     CloseKey(_reg)

  548.     del _reg

  549. 

  550. if readEnvVars:

  551.     CARLA_DEFAULT_LADSPA_PATH = os.getenv("LADSPA_PATH", DEFAULT_LADSPA_PATH).split(splitter)

  552.     CARLA_DEFAULT_DSSI_PATH   = os.getenv("DSSI_PATH",   DEFAULT_DSSI_PATH).split(splitter)

  553.     CARLA_DEFAULT_LV2_PATH    = os.getenv("LV2_PATH",    DEFAULT_LV2_PATH).split(splitter)

  554.     CARLA_DEFAULT_VST2_PATH   = os.getenv("VST_PATH",    DEFAULT_VST2_PATH).split(splitter)

  555.     CARLA_DEFAULT_VST3_PATH   = os.getenv("VST3_PATH",   DEFAULT_VST3_PATH).split(splitter)

  556.     CARLA_DEFAULT_CLAP_PATH   = os.getenv("CLAP_PATH",   DEFAULT_CLAP_PATH).split(splitter)

  557.     CARLA_DEFAULT_SF2_PATH    = os.getenv("SF2_PATH",    DEFAULT_SF2_PATH).split(splitter)

  558.     CARLA_DEFAULT_SFZ_PATH    = os.getenv("SFZ_PATH",    DEFAULT_SFZ_PATH).split(splitter)

  559.     CARLA_DEFAULT_JSFX_PATH   = os.getenv("JSFX_PATH",   DEFAULT_JSFX_PATH).split(splitter)

  560. 

  561. else:

  562.     CARLA_DEFAULT_LADSPA_PATH = DEFAULT_LADSPA_PATH.split(splitter)

  563.     CARLA_DEFAULT_DSSI_PATH   = DEFAULT_DSSI_PATH.split(splitter)

  564.     CARLA_DEFAULT_LV2_PATH    = DEFAULT_LV2_PATH.split(splitter)

  565.     CARLA_DEFAULT_VST2_PATH   = DEFAULT_VST2_PATH.split(splitter)

  566.     CARLA_DEFAULT_VST3_PATH   = DEFAULT_VST3_PATH.split(splitter)

  567.     CARLA_DEFAULT_CLAP_PATH   = DEFAULT_CLAP_PATH.split(splitter)

  568.     CARLA_DEFAULT_SF2_PATH    = DEFAULT_SF2_PATH.split(splitter)

  569.     CARLA_DEFAULT_SFZ_PATH    = DEFAULT_SFZ_PATH.split(splitter)

  570.     CARLA_DEFAULT_JSFX_PATH   = DEFAULT_JSFX_PATH.split(splitter)

  571. 

  572. # ------------------------------------------------------------------------------------------------------------

  573. # Default Plugin Folders (cleanup)

  574. 

  575. del DEFAULT_LADSPA_PATH

  576. del DEFAULT_DSSI_PATH

  577. del DEFAULT_LV2_PATH

  578. del DEFAULT_VST2_PATH

  579. del DEFAULT_VST3_PATH

  580. del DEFAULT_CLAP_PATH

  581. del DEFAULT_SF2_PATH

  582. del DEFAULT_SFZ_PATH

  583. 

  584. # ------------------------------------------------------------------------------------------------------------

  585. # Global Carla object

  586. 

  587. class CarlaObject():

  588.     def __init__(self):

  589.         self.cnprefix = ""    # Client name prefix

  590.         self.gui      = None  # Host Window

  591.         self.nogui    = False # Skip UI

  592.         self.term     = False # Terminated by OS signal

  593.         self.felib    = None  # Frontend lib object

  594.         self.utils    = None  # Utils object

  595. 

  596. gCarla = CarlaObject()

  597. 

  598. # ------------------------------------------------------------------------------------------------------------

  599. # Set CWD

  600. 

  601. CWD = sys.path[0]

  602. 

  603. if not CWD:

  604.     CWD = os.path.dirname(sys.argv[0])

  605. 

  606. # make it work with cxfreeze

  607. if os.path.isfile(CWD):

  608.     CWD = os.path.dirname(CWD)

  609.     if CWD.endswith("/lib"):

  610.         CWD = CWD.rsplit("/lib",1)[0]

  611.     CXFREEZE = True

  612.     if not WINDOWS:

  613.         os.environ['CARLA_MAGIC_FILE'] = os.path.join(CWD, "magic.mgc")

  614. else:

  615.     CXFREEZE = False

  616. 

  617. # ------------------------------------------------------------------------------------------------------------

  618. # Set DLL_EXTENSION

  619. 

  620. if WINDOWS:

  621.     DLL_EXTENSION = "dll"

  622. elif MACOS:

  623.     DLL_EXTENSION = "dylib"

  624. else:

  625.     DLL_EXTENSION = "so"

  626. 

  627. # ------------------------------------------------------------------------------------------------------------

  628. # Find decimal points for a parameter, using step and stepSmall

  629. 

  630. def countDecimalPoints(step, stepSmall):

  631.     if stepSmall >= 1.0:

  632.         return 0

  633.     if step >= 1.0:

  634.         return 2

  635. 

  636.     count = 0

  637.     value = fmod(abs(step), 1)

  638.     while 0.0001 < value < 0.999 and count < 6:

  639.         value = fmod(value*10, 1)

  640.         count += 1

  641. 

  642.     return count

  643. 

  644. # ------------------------------------------------------------------------------------------------------------

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

  646. 

  647. def isNumber(value):

  648.     try:

  649.         float(value)

  650.         return True

  651.     except:

  652.         return False

  653. 

  654. # ------------------------------------------------------------------------------------------------------------

  655. # Convert a value to a list

  656. 

  657. def toList(value):

  658.     if value is None:

  659.         return []

  660.     if not isinstance(value, list):

  661.         return [value]

  662.     return value

  663. 

  664. # ------------------------------------------------------------------------------------------------------------

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

  666. 

  667. def getIcon(icon, size, qrcformat):

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

  669. 

  670. # ------------------------------------------------------------------------------------------------------------

  671. # Handle some basic command-line arguments shared between all carla variants

  672. 

  673. def handleInitialCommandLineArguments(file):

  674.     initName  = os.path.basename(file) if (file is not None and os.path.dirname(file) in PATH) else sys.argv[0]

  675.     libPrefix = None

  676.     readPrefixNext = False

  677. 

  678.     for arg in sys.argv[1:]:

  679.         if arg.startswith("--with-appname="):

  680.             initName = os.path.basename(arg.replace("--with-appname=", ""))

  681. 

  682.         elif arg.startswith("--with-libprefix="):

  683.             libPrefix = arg.replace("--with-libprefix=", "")

  684. 

  685.         elif arg.startswith("--osc-gui="):

  686.             gCarla.nogui = int(arg.replace("--osc-gui=", ""))

  687. 

  688.         elif arg.startswith("--cnprefix="):

  689.             gCarla.cnprefix = arg.replace("--cnprefix=", "")

  690. 

  691.         elif arg == "--cnprefix":

  692.             readPrefixNext = True

  693. 

  694.         elif arg == "--gdb":

  695.             pass

  696. 

  697.         elif arg in ("-n", "--n", "-no-gui", "--no-gui", "-nogui", "--nogui"):

  698.             gCarla.nogui = True

  699. 

  700.         elif MACOS and arg.startswith("-psn_"):

  701.             pass

  702. 

  703.         elif arg in ("-h", "--h", "-help", "--help"):

  704.             print("Usage: %s [OPTION]... [FILE|URL]" % initName)

  705.             print("")

  706.             print(" where FILE can be a Carla project or preset file to be loaded, or URL if using Carla-Control")

  707.             print("")

  708.             print(" and OPTION can be one or more of the following:")

  709.             print("")

  710.             print("    --cnprefix\t Set a prefix for client names in multi-client mode.")

  711.             if isinstance(gCarla.nogui, bool):

  712.                 if X_LIBDIR_X is not None:

  713.                     print("    --gdb     \t Run Carla inside gdb.")

  714.                 print(" -n,--no-gui  \t Run Carla headless, don't show UI.")

  715.                 print("")

  716.             print(" -h,--help    \t Print this help text and exit.")

  717.             print(" -v,--version \t Print version information and exit.")

  718.             print("")

  719. 

  720.             if not isinstance(gCarla.nogui, bool):

  721.                 print("NOTE: when using %s the FILE is only valid the first time the backend is started" % initName)

  722.                 sys.exit(1)

  723. 

  724.             sys.exit(0)

  725. 

  726.         elif arg in ("-v", "--v", "-version", "--version"):

  727.             pathBinaries, pathResources = getPaths(libPrefix)

  728. 

  729.             print("Using Carla version %s" % VERSION)

  730.             print("  Python version: %s" % sys.version.split(" ",1)[0])

  731.             print("  Qt version:     %s" % QT_VERSION_STR)

  732.             print("  PyQt version:   %s" % PYQT_VERSION_STR)

  733.             print("  Binary dir:     %s" % pathBinaries)

  734.             print("  Resources dir:  %s" % pathResources)

  735. 

  736.             sys.exit(1 if gCarla.nogui else 0)

  737. 

  738.         elif readPrefixNext:

  739.             readPrefixNext = False

  740.             gCarla.cnprefix = arg

  741. 

  742.     if gCarla.nogui and not isinstance(gCarla.nogui, bool):

  743.         if os.fork():

  744.             # pylint: disable=protected-access

  745.             os._exit(0)

  746.             # pylint: enable=protected-access

  747.         else:

  748.             os.setsid()

  749. 

  750.     return (initName, libPrefix)

  751. 

  752. # ------------------------------------------------------------------------------------------------------------

  753. # Get initial project file (as passed in the command-line parameters)

  754. 

  755. def getInitialProjectFile(skipExistCheck = False):

  756.     # NOTE: PyQt mishandles unicode characters, we directly use sys.argv instead of qApp->arguments()

  757.     # see https://riverbankcomputing.com/pipermail/pyqt/2015-January/035395.html

  758.     args = sys.argv[1:]

  759.     readPrefixNext = False

  760.     for arg in args:

  761.         if readPrefixNext:

  762.             readPrefixNext = False

  763.             continue

  764.         if arg.startswith("--cnprefix="):

  765.             continue

  766.         if arg.startswith("--osc-gui="):

  767.             continue

  768.         if arg.startswith("--with-appname="):

  769.             continue

  770.         if arg.startswith("--with-libprefix="):

  771.             continue

  772.         if arg == "--cnprefix":

  773.             readPrefixNext = True

  774.             continue

  775.         if arg in ("-n", "--n", "-no-gui", "--no-gui", "-nogui", "--nogui", "--gdb"):

  776.             continue

  777.         if MACOS and arg.startswith("-psn_"):

  778.             continue

  779.         arg = os.path.expanduser(arg)

  780.         if skipExistCheck or os.path.exists(arg):

  781.             return arg

  782. 

  783.     return None

  784. 

  785. # ------------------------------------------------------------------------------------------------------------

  786. # Get paths (binaries, resources)

  787. 

  788. def getPaths(libPrefix = None):

  789.     CWDl = CWD.lower()

  790. 

  791.     # adjust for special distros

  792.     libdir  = os.path.basename(os.path.normpath(X_LIBDIR_X))  if X_LIBDIR_X  else "lib"

  793.     datadir = os.path.basename(os.path.normpath(X_DATADIR_X)) if X_DATADIR_X else "share"

  794. 

  795.     # standalone, installed system-wide linux

  796.     if libPrefix is not None:

  797.         pathBinaries  = os.path.join(libPrefix, libdir, "carla")

  798.         pathResources = os.path.join(libPrefix, datadir, "carla", "resources")

  799. 

  800.     # standalone, local source

  801.     elif CWDl.endswith("frontend"):

  802.         pathBinaries  = os.path.abspath(os.path.join(CWD, "..", "..", "bin"))

  803.         pathResources = os.path.join(pathBinaries, "resources")

  804. 

  805.     # plugin

  806.     elif CWDl.endswith("resources"):

  807.         # installed system-wide linux

  808.         if CWDl.endswith("/share/carla/resources"):

  809.             pathBinaries  = os.path.abspath(os.path.join(CWD, "..", "..", "..", libdir, "carla"))

  810.             pathResources = CWD

  811. 

  812.         # local source

  813.         elif CWDl.endswith("native-plugins%sresources" % os.sep):

  814.             pathBinaries  = os.path.abspath(os.path.join(CWD, "..", "..", "..", "bin"))

  815.             pathResources = CWD

  816. 

  817.         # other

  818.         else:

  819.             pathBinaries  = os.path.abspath(os.path.join(CWD, ".."))

  820.             pathResources = CWD

  821. 

  822.     # everything else

  823.     else:

  824.         pathBinaries  = CWD

  825.         pathResources = os.path.join(pathBinaries, "resources")

  826. 

  827.     return (pathBinaries, pathResources)

  828. 

  829. # ------------------------------------------------------------------------------------------------------------

  830. # Signal handler

  831. # TODO move to carla_host.py or something

  832. 

  833. def signalHandler(sig, frame):

  834.     if sig in (SIGINT, SIGTERM):

  835.         gCarla.term = True

  836.         if gCarla.gui is not None:

  837.             gCarla.gui.SIGTERM.emit()

  838. 

  839.     elif haveSIGUSR1 and sig == SIGUSR1:

  840.         if gCarla.gui is not None:

  841.             gCarla.gui.SIGUSR1.emit()

  842. 

  843. def setUpSignals():

  844.     signal(SIGINT,  signalHandler)

  845.     signal(SIGTERM, signalHandler)

  846. 

  847.     if not haveSIGUSR1:

  848.         return

  849. 

  850.     signal(SIGUSR1, signalHandler)

  851. 

  852. # ------------------------------------------------------------------------------------------------------------

  853. # QLineEdit and QPushButton combo

  854. 

  855. def getAndSetPath(parent, lineEdit):

  856.     newPath = QFileDialog.getExistingDirectory(parent, parent.tr("Set Path"), lineEdit.text(), QFileDialog.ShowDirsOnly)

  857.     if newPath:

  858.         lineEdit.setText(newPath)

  859.     return newPath

  860. 

  861. # ------------------------------------------------------------------------------------------------------------

  862. # Backwards-compatible horizontalAdvance/width call, depending on Qt version

  863. 

  864. def fontMetricsHorizontalAdvance(fontMetrics, string):

  865.     if QT_VERSION >= 0x50b00:

  866.         return fontMetrics.horizontalAdvance(string)

  867.     return fontMetrics.width(string)

  868. 

  869. # ------------------------------------------------------------------------------------------------------------

  870. # Custom QMessageBox which resizes itself to fit text

  871. 

  872. class QMessageBoxWithBetterWidth(QMessageBox):

  873.     def __init__(self, parent):

  874.         QMessageBox.__init__(self, parent)

  875. 

  876.     def showEvent(self, event):

  877.         fontMetrics = self.fontMetrics()

  878. 

  879.         lines = self.text().strip().split("\n") + self.informativeText().strip().split("\n")

  880. 

  881.         if lines:

  882.             width = 0

  883. 

  884.             for line in lines:

  885.                 width = max(fontMetricsHorizontalAdvance(fontMetrics, line), width)

  886. 

  887.             self.layout().setColumnMinimumWidth(2, width + 12)

  888. 

  889.         QMessageBox.showEvent(self, event)

  890. 

  891. # ------------------------------------------------------------------------------------------------------------

  892. # Custom MessageBox

  893. 

  894. # pylint: disable=too-many-arguments

  895. def CustomMessageBox(parent, icon, title, text,

  896.                      extraText="",

  897.                      buttons=QMessageBox.Yes|QMessageBox.No,

  898.                      defButton=QMessageBox.No):

  899.     msgBox = QMessageBoxWithBetterWidth(parent)

  900.     msgBox.setIcon(icon)

  901.     msgBox.setWindowTitle(title)

  902.     msgBox.setText(text)

  903.     msgBox.setInformativeText(extraText)

  904.     msgBox.setStandardButtons(buttons)

  905.     msgBox.setDefaultButton(defButton)

  906.     return msgBox.exec_()

  907. # pylint: enable=too-many-arguments

  908. 

  909. # ------------------------------------------------------------------------------------------------------------