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

913 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.     kIs64bit, HAIKU, LINUX, MACOS, WINDOWS,

  51.     MAX_DEFAULT_PARAMETERS,

  52.     ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS,

  53.     ENGINE_PROCESS_MODE_PATCHBAY,

  54.     ENGINE_TRANSPORT_MODE_INTERNAL,

  55.     ENGINE_TRANSPORT_MODE_JACK

  56. )

  57. 

  58. # ------------------------------------------------------------------------------------------------------------

  59. # Config

  60. 

  61. # These will be modified during install

  62. X_LIBDIR_X = None

  63. X_DATADIR_X = None

  64. 

  65. # ------------------------------------------------------------------------------------------------------------

  66. # Platform specific stuff

  67. 

  68. if WINDOWS:

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

  70. 

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

  72. # Set Version

  73. 

  74. VERSION = "2.5.1"

  75. 

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

  77. # Set TMP

  78. 

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

  80. 

  81. if envTMP is None:

  82.     if WINDOWS:

  83.         qWarning("TMP variable not set")

  84.     TMP = QDir.tempPath()

  85. else:

  86.     TMP = envTMP

  87. 

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

  89.     qWarning("TMP does not exist")

  90.     TMP = "/"

  91. 

  92. del envTMP

  93. 

  94. # ------------------------------------------------------------------------------------------------------------

  95. # Set HOME

  96. 

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

  98. 

  99. if envHOME is None:

  100.     if LINUX or MACOS:

  101.         qWarning("HOME variable not set")

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

  103. else:

  104.     HOME = envHOME

  105. 

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

  107.     qWarning("HOME does not exist")

  108.     HOME = TMP

  109. 

  110. del envHOME

  111. 

  112. # ------------------------------------------------------------------------------------------------------------

  113. # Set PATH

  114. 

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

  116. 

  117. if envPATH is None:

  118.     qWarning("PATH variable not set")

  119.     if MACOS:

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

  121.     elif WINDOWS:

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

  123.     else:

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

  125. else:

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

  127. 

  128. del envPATH

  129. 

  130. # ------------------------------------------------------------------------------------------------------------

  131. # Static MIDI CC list

  132. 

  133. MIDI_CC_LIST = (

  134.     "01 [0x01] Modulation",

  135.     "02 [0x02] Breath",

  136.     "04 [0x04] Foot",

  137.     "05 [0x05] Portamento",

  138.     "07 [0x07] Volume",

  139.     "08 [0x08] Balance",

  140.     "10 [0x0A] Pan",

  141.     "11 [0x0B] Expression",

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  168. )

  169. 

  170. MAX_MIDI_CC_LIST_ITEM = 95

  171. 

  172. # ------------------------------------------------------------------------------------------------------------

  173. # PatchCanvas defines

  174. 

  175. CANVAS_ANTIALIASING_SMALL = 1

  176. CANVAS_EYECANDY_SMALL     = 1

  177. 

  178. # ------------------------------------------------------------------------------------------------------------

  179. # Carla Settings keys

  180. 

  181. CARLA_KEY_MAIN_PROJECT_FOLDER   = "Main/ProjectFolder"   # str

  182. CARLA_KEY_MAIN_USE_PRO_THEME    = "Main/UseProTheme"     # bool

  183. CARLA_KEY_MAIN_PRO_THEME_COLOR  = "Main/ProThemeColor"   # str

  184. CARLA_KEY_MAIN_REFRESH_INTERVAL = "Main/RefreshInterval" # int

  185. CARLA_KEY_MAIN_CONFIRM_EXIT     = "Main/ConfirmExit"     # bool

  186. CARLA_KEY_MAIN_CLASSIC_SKIN     = "Main/ClassicSkin"     # bool

  187. CARLA_KEY_MAIN_SHOW_LOGS        = "Main/ShowLogs"        # bool

  188. CARLA_KEY_MAIN_SYSTEM_ICONS     = "Main/SystemIcons"     # bool

  189. CARLA_KEY_MAIN_EXPERIMENTAL     = "Main/Experimental"    # bool

  190. 

  191. CARLA_KEY_CANVAS_THEME             = "Canvas/Theme"           # str

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

  193. CARLA_KEY_CANVAS_USE_BEZIER_LINES  = "Canvas/UseBezierLines"  # bool

  194. CARLA_KEY_CANVAS_AUTO_HIDE_GROUPS  = "Canvas/AutoHideGroups"  # bool

  195. CARLA_KEY_CANVAS_AUTO_SELECT_ITEMS = "Canvas/AutoSelectItems" # bool

  196. CARLA_KEY_CANVAS_EYE_CANDY         = "Canvas/EyeCandy2"       # bool

  197. CARLA_KEY_CANVAS_FANCY_EYE_CANDY   = "Canvas/FancyEyeCandy"   # bool

  198. CARLA_KEY_CANVAS_USE_OPENGL        = "Canvas/UseOpenGL"       # bool

  199. CARLA_KEY_CANVAS_ANTIALIASING      = "Canvas/Antialiasing"    # enum

  200. CARLA_KEY_CANVAS_HQ_ANTIALIASING   = "Canvas/HQAntialiasing"  # bool

  201. CARLA_KEY_CANVAS_INLINE_DISPLAYS   = "Canvas/InlineDisplays"  # bool

  202. CARLA_KEY_CANVAS_FULL_REPAINTS     = "Canvas/FullRepaints"    # bool

  203. 

  204. CARLA_KEY_ENGINE_DRIVER_PREFIX         = "Engine/Driver-"

  205. CARLA_KEY_ENGINE_AUDIO_DRIVER          = "Engine/AudioDriver"         # str

  206. CARLA_KEY_ENGINE_PROCESS_MODE          = "Engine/ProcessMode"         # enum

  207. CARLA_KEY_ENGINE_TRANSPORT_MODE        = "Engine/TransportMode"       # enum

  208. CARLA_KEY_ENGINE_TRANSPORT_EXTRA       = "Engine/TransportExtra"      # str

  209. CARLA_KEY_ENGINE_FORCE_STEREO          = "Engine/ForceStereo"         # bool

  210. CARLA_KEY_ENGINE_PREFER_PLUGIN_BRIDGES = "Engine/PreferPluginBridges" # bool

  211. CARLA_KEY_ENGINE_PREFER_UI_BRIDGES     = "Engine/PreferUiBridges"     # bool

  212. CARLA_KEY_ENGINE_MANAGE_UIS            = "Engine/ManageUIs"           # bool

  213. CARLA_KEY_ENGINE_UIS_ALWAYS_ON_TOP     = "Engine/UIsAlwaysOnTop"      # bool

  214. CARLA_KEY_ENGINE_MAX_PARAMETERS        = "Engine/MaxParameters"       # int

  215. CARLA_KEY_ENGINE_RESET_XRUNS           = "Engine/ResetXruns"          # bool

  216. CARLA_KEY_ENGINE_UI_BRIDGES_TIMEOUT    = "Engine/UiBridgesTimeout"    # int

  217. 

  218. CARLA_KEY_OSC_ENABLED          = "OSC/Enabled"

  219. CARLA_KEY_OSC_TCP_PORT_ENABLED = "OSC/TCPEnabled"

  220. CARLA_KEY_OSC_TCP_PORT_NUMBER  = "OSC/TCPNumber"

  221. CARLA_KEY_OSC_TCP_PORT_RANDOM  = "OSC/TCPRandom"

  222. CARLA_KEY_OSC_UDP_PORT_ENABLED = "OSC/UDPEnabled"

  223. CARLA_KEY_OSC_UDP_PORT_NUMBER  = "OSC/UDPNumber"

  224. CARLA_KEY_OSC_UDP_PORT_RANDOM  = "OSC/UDPRandom"

  225. 

  226. CARLA_KEY_PATHS_AUDIO = "Paths/Audio"

  227. CARLA_KEY_PATHS_MIDI  = "Paths/MIDI"

  228. 

  229. CARLA_KEY_PATHS_LADSPA = "Paths/LADSPA"

  230. CARLA_KEY_PATHS_DSSI   = "Paths/DSSI"

  231. CARLA_KEY_PATHS_LV2    = "Paths/LV2"

  232. CARLA_KEY_PATHS_VST2   = "Paths/VST2"

  233. CARLA_KEY_PATHS_VST3   = "Paths/VST3"

  234. CARLA_KEY_PATHS_CLAP   = "Paths/CLAP"

  235. CARLA_KEY_PATHS_SF2    = "Paths/SF2"

  236. CARLA_KEY_PATHS_SFZ    = "Paths/SFZ"

  237. CARLA_KEY_PATHS_JSFX   = "Paths/JSFX"

  238. 

  239. CARLA_KEY_WINE_EXECUTABLE      = "Wine/Executable"     # str

  240. CARLA_KEY_WINE_AUTO_PREFIX     = "Wine/AutoPrefix"     # bool

  241. CARLA_KEY_WINE_FALLBACK_PREFIX = "Wine/FallbackPrefix" # str

  242. CARLA_KEY_WINE_RT_PRIO_ENABLED = "Wine/RtPrioEnabled"  # bool

  243. CARLA_KEY_WINE_BASE_RT_PRIO    = "Wine/BaseRtPrio"     # int

  244. CARLA_KEY_WINE_SERVER_RT_PRIO  = "Wine/ServerRtPrio"   # int

  245. 

  246. CARLA_KEY_EXPERIMENTAL_PLUGIN_BRIDGES        = "Experimental/PluginBridges"       # bool

  247. CARLA_KEY_EXPERIMENTAL_WINE_BRIDGES          = "Experimental/WineBridges"         # bool

  248. CARLA_KEY_EXPERIMENTAL_JACK_APPS             = "Experimental/JackApplications"    # bool

  249. CARLA_KEY_EXPERIMENTAL_EXPORT_LV2            = "Experimental/ExportLV2"           # bool

  250. CARLA_KEY_EXPERIMENTAL_PREVENT_BAD_BEHAVIOUR = "Experimental/PreventBadBehaviour" # bool

  251. CARLA_KEY_EXPERIMENTAL_LOAD_LIB_GLOBAL       = "Experimental/LoadLibGlobal"       # bool

  252. 

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

  254. CARLA_KEY_CUSTOM_PAINTING = "UseCustomPainting" # bool

  255. 

  256. # ------------------------------------------------------------------------------------------------------------

  257. # Carla Settings defaults

  258. 

  259. # Main

  260. CARLA_DEFAULT_MAIN_PROJECT_FOLDER   = HOME

  261. CARLA_DEFAULT_MAIN_USE_PRO_THEME    = True

  262. CARLA_DEFAULT_MAIN_PRO_THEME_COLOR  = "Black"

  263. CARLA_DEFAULT_MAIN_REFRESH_INTERVAL = 20

  264. CARLA_DEFAULT_MAIN_CONFIRM_EXIT     = True

  265. CARLA_DEFAULT_MAIN_CLASSIC_SKIN     = False

  266. CARLA_DEFAULT_MAIN_SHOW_LOGS        = bool(not WINDOWS)

  267. CARLA_DEFAULT_MAIN_SYSTEM_ICONS     = False

  268. CARLA_DEFAULT_MAIN_EXPERIMENTAL     = False

  269. 

  270. # Canvas

  271. CARLA_DEFAULT_CANVAS_THEME             = "Modern Dark"

  272. CARLA_DEFAULT_CANVAS_SIZE              = "3100x2400"

  273. CARLA_DEFAULT_CANVAS_SIZE_WIDTH        = 3100

  274. CARLA_DEFAULT_CANVAS_SIZE_HEIGHT       = 2400

  275. CARLA_DEFAULT_CANVAS_USE_BEZIER_LINES  = True

  276. CARLA_DEFAULT_CANVAS_AUTO_HIDE_GROUPS  = True

  277. CARLA_DEFAULT_CANVAS_AUTO_SELECT_ITEMS = False

  278. CARLA_DEFAULT_CANVAS_EYE_CANDY         = True

  279. CARLA_DEFAULT_CANVAS_FANCY_EYE_CANDY   = False

  280. CARLA_DEFAULT_CANVAS_USE_OPENGL        = False

  281. CARLA_DEFAULT_CANVAS_ANTIALIASING      = CANVAS_ANTIALIASING_SMALL

  282. CARLA_DEFAULT_CANVAS_HQ_ANTIALIASING   = False

  283. CARLA_DEFAULT_CANVAS_INLINE_DISPLAYS   = False

  284. CARLA_DEFAULT_CANVAS_FULL_REPAINTS     = False

  285. 

  286. # Engine

  287. CARLA_DEFAULT_FORCE_STEREO          = False

  288. CARLA_DEFAULT_PREFER_PLUGIN_BRIDGES = False

  289. CARLA_DEFAULT_PREFER_UI_BRIDGES     = True

  290. CARLA_DEFAULT_MANAGE_UIS            = True

  291. CARLA_DEFAULT_UIS_ALWAYS_ON_TOP     = False

  292. CARLA_DEFAULT_MAX_PARAMETERS        = MAX_DEFAULT_PARAMETERS

  293. CARLA_DEFAULT_RESET_XRUNS           = False

  294. CARLA_DEFAULT_UI_BRIDGES_TIMEOUT    = 4000

  295. 

  296. CARLA_DEFAULT_AUDIO_BUFFER_SIZE     = 512

  297. CARLA_DEFAULT_AUDIO_SAMPLE_RATE     = 44100

  298. CARLA_DEFAULT_AUDIO_TRIPLE_BUFFER   = False

  299. 

  300. if WINDOWS:

  301.     CARLA_DEFAULT_AUDIO_DRIVER = "Windows Audio"

  302. elif MACOS:

  303.     CARLA_DEFAULT_AUDIO_DRIVER = "CoreAudio"

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

  305.     CARLA_DEFAULT_AUDIO_DRIVER = "JACK"

  306. else:

  307.     CARLA_DEFAULT_AUDIO_DRIVER = "PulseAudio"

  308. 

  309. if CARLA_DEFAULT_AUDIO_DRIVER == "JACK":

  310.     CARLA_DEFAULT_PROCESS_MODE   = ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS

  311.     CARLA_DEFAULT_TRANSPORT_MODE = ENGINE_TRANSPORT_MODE_JACK

  312. else:

  313.     CARLA_DEFAULT_PROCESS_MODE   = ENGINE_PROCESS_MODE_PATCHBAY

  314.     CARLA_DEFAULT_TRANSPORT_MODE = ENGINE_TRANSPORT_MODE_INTERNAL

  315. 

  316. # OSC

  317. CARLA_DEFAULT_OSC_ENABLED = not (MACOS or WINDOWS)

  318. CARLA_DEFAULT_OSC_TCP_PORT_ENABLED = True

  319. CARLA_DEFAULT_OSC_TCP_PORT_NUMBER  = 22752

  320. CARLA_DEFAULT_OSC_TCP_PORT_RANDOM  = False

  321. CARLA_DEFAULT_OSC_UDP_PORT_ENABLED = True

  322. CARLA_DEFAULT_OSC_UDP_PORT_NUMBER  = 22752

  323. CARLA_DEFAULT_OSC_UDP_PORT_RANDOM  = False

  324. 

  325. # Wine

  326. CARLA_DEFAULT_WINE_EXECUTABLE      = "wine"

  327. CARLA_DEFAULT_WINE_AUTO_PREFIX     = True

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

  329. CARLA_DEFAULT_WINE_RT_PRIO_ENABLED = True

  330. CARLA_DEFAULT_WINE_BASE_RT_PRIO    = 15

  331. CARLA_DEFAULT_WINE_SERVER_RT_PRIO  = 10

  332. 

  333. # Experimental

  334. CARLA_DEFAULT_EXPERIMENTAL_PLUGIN_BRIDGES        = False

  335. CARLA_DEFAULT_EXPERIMENTAL_WINE_BRIDGES          = False

  336. CARLA_DEFAULT_EXPERIMENTAL_JACK_APPS             = False

  337. CARLA_DEFAULT_EXPERIMENTAL_LV2_EXPORT            = False

  338. CARLA_DEFAULT_EXPERIMENTAL_PREVENT_BAD_BEHAVIOUR = False

  339. CARLA_DEFAULT_EXPERIMENTAL_LOAD_LIB_GLOBAL       = False

  340. 

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

  342. # Default File Folders

  343. 

  344. CARLA_DEFAULT_FILE_PATH_AUDIO = []

  345. CARLA_DEFAULT_FILE_PATH_MIDI  = []

  346. 

  347. # ------------------------------------------------------------------------------------------------------------

  348. # Default Plugin Folders (get)

  349. 

  350. DEFAULT_LADSPA_PATH = ""

  351. DEFAULT_DSSI_PATH   = ""

  352. DEFAULT_LV2_PATH    = ""

  353. DEFAULT_VST2_PATH   = ""

  354. DEFAULT_VST3_PATH   = ""

  355. DEFAULT_CLAP_PATH   = ""

  356. DEFAULT_SF2_PATH    = ""

  357. DEFAULT_SFZ_PATH    = ""

  358. DEFAULT_JSFX_PATH   = ""

  359. 

  360. if WINDOWS:

  361.     splitter = ";"

  362. 

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

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

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

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

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

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

  369. 

  370.     # Small integrity tests

  371.     if not APPDATA:

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

  373.         sys.exit(1)

  374. 

  375.     if not PROGRAMFILES:

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

  377.         sys.exit(1)

  378. 

  379.     if not COMMONPROGRAMFILES:

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

  381.         sys.exit(1)

  382. 

  383.     DEFAULT_LADSPA_PATH  = APPDATA + "\\LADSPA"

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

  385. 

  386.     DEFAULT_DSSI_PATH    = APPDATA + "\\DSSI"

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

  388. 

  389.     DEFAULT_LV2_PATH     = APPDATA + "\\LV2"

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

  391. 

  392.     DEFAULT_VST2_PATH    = PROGRAMFILES + "\\VstPlugins"

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

  394. 

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

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

  397. 

  398.     if kIs64bit:

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

  400. 

  401.     DEFAULT_VST3_PATH    = COMMONPROGRAMFILES + "\\VST3"

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

  403. 

  404.     DEFAULT_CLAP_PATH    = COMMONPROGRAMFILES + "\\CLAP"

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

  406. 

  407.     DEFAULT_SF2_PATH     = APPDATA + "\\SF2"

  408.     DEFAULT_SFZ_PATH     = APPDATA + "\\SFZ"

  409. 

  410.     if PROGRAMFILESx86:

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

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

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

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

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

  416. 

  417.     if COMMONPROGRAMFILESx86:

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

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

  420. 

  421. elif HAIKU:

  422.     splitter = ":"

  423. 

  424.     DEFAULT_LADSPA_PATH  = HOME + "/.ladspa"

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

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

  427. 

  428.     DEFAULT_DSSI_PATH    = HOME + "/.dssi"

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

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

  431. 

  432.     DEFAULT_LV2_PATH     = HOME + "/.lv2"

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

  434. 

  435.     DEFAULT_VST2_PATH    = HOME + "/.vst"

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

  437. 

  438.     DEFAULT_VST3_PATH    = HOME + "/.vst3"

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

  440. 

  441.     DEFAULT_CLAP_PATH    = HOME + "/.clap"

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

  443. 

  444. elif MACOS:

  445.     splitter = ":"

  446. 

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

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

  449. 

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

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

  452. 

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

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

  455. 

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

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

  458. 

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

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

  461. 

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

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

  464. 

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

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

  467. 

  468. else:

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

  470. 

  471.     splitter = ":"

  472. 

  473.     DEFAULT_LADSPA_PATH  = HOME + "/.ladspa"

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

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

  476. 

  477.     DEFAULT_DSSI_PATH    = HOME + "/.dssi"

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

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

  480. 

  481.     DEFAULT_LV2_PATH     = HOME + "/.lv2"

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

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

  484. 

  485.     DEFAULT_VST2_PATH    = HOME + "/.vst"

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

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

  488. 

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

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

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

  492. 

  493.     DEFAULT_VST3_PATH    = HOME + "/.vst3"

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

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

  496. 

  497.     DEFAULT_CLAP_PATH    = HOME + "/.clap"

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

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

  500. 

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

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

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

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

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

  506. 

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

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

  509. 

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

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

  512. 

  513. if not WINDOWS:

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

  515. 

  516.     if not winePrefix:

  517.         winePrefix = HOME + "/.wine"

  518. 

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

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

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

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

  523. 

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

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

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

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

  528. 

  529.     del winePrefix

  530. 

  531. # ------------------------------------------------------------------------------------------------------------

  532. # Default Plugin Folders (set)

  533. 

  534. readEnvVars = True

  535. 

  536. if WINDOWS:

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

  538.     # pylint: disable=import-error

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

  540.     # pylint: enable=import-error

  541.     _reg = ConnectRegistry(None, HKEY_CURRENT_USER)

  542. 

  543.     try:

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

  545.         CloseKey(_key)

  546.         del _key

  547.         readEnvVars = False

  548.     except:

  549.         pass

  550. 

  551.     CloseKey(_reg)

  552.     del _reg

  553. 

  554. if readEnvVars:

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

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

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

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

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

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

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

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

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

  564. 

  565. else:

  566.     CARLA_DEFAULT_LADSPA_PATH = DEFAULT_LADSPA_PATH.split(splitter)

  567.     CARLA_DEFAULT_DSSI_PATH   = DEFAULT_DSSI_PATH.split(splitter)

  568.     CARLA_DEFAULT_LV2_PATH    = DEFAULT_LV2_PATH.split(splitter)

  569.     CARLA_DEFAULT_VST2_PATH   = DEFAULT_VST2_PATH.split(splitter)

  570.     CARLA_DEFAULT_VST3_PATH   = DEFAULT_VST3_PATH.split(splitter)

  571.     CARLA_DEFAULT_CLAP_PATH   = DEFAULT_CLAP_PATH.split(splitter)

  572.     CARLA_DEFAULT_SF2_PATH    = DEFAULT_SF2_PATH.split(splitter)

  573.     CARLA_DEFAULT_SFZ_PATH    = DEFAULT_SFZ_PATH.split(splitter)

  574.     CARLA_DEFAULT_JSFX_PATH   = DEFAULT_JSFX_PATH.split(splitter)

  575. 

  576. # ------------------------------------------------------------------------------------------------------------

  577. # Default Plugin Folders (cleanup)

  578. 

  579. del DEFAULT_LADSPA_PATH

  580. del DEFAULT_DSSI_PATH

  581. del DEFAULT_LV2_PATH

  582. del DEFAULT_VST2_PATH

  583. del DEFAULT_VST3_PATH

  584. del DEFAULT_CLAP_PATH

  585. del DEFAULT_SF2_PATH

  586. del DEFAULT_SFZ_PATH

  587. 

  588. # ------------------------------------------------------------------------------------------------------------

  589. # Global Carla object

  590. 

  591. class CarlaObject():

  592.     def __init__(self):

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

  594.         self.gui      = None  # Host Window

  595.         self.nogui    = False # Skip UI

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

  597.         self.utils    = None  # Utils object

  598. 

  599. gCarla = CarlaObject()

  600. 

  601. # ------------------------------------------------------------------------------------------------------------

  602. # Set CWD

  603. 

  604. CWD = sys.path[0]

  605. 

  606. if not CWD:

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

  608. 

  609. # make it work with cxfreeze

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

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

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

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

  614.     CXFREEZE = True

  615.     if not WINDOWS:

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

  617. else:

  618.     CXFREEZE = False

  619. 

  620. # ------------------------------------------------------------------------------------------------------------

  621. # Set DLL_EXTENSION

  622. 

  623. if WINDOWS:

  624.     DLL_EXTENSION = "dll"

  625. elif MACOS:

  626.     DLL_EXTENSION = "dylib"

  627. else:

  628.     DLL_EXTENSION = "so"

  629. 

  630. # ------------------------------------------------------------------------------------------------------------

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

  632. 

  633. def countDecimalPoints(step, stepSmall):

  634.     if stepSmall >= 1.0:

  635.         return 0

  636.     if step >= 1.0:

  637.         return 2

  638. 

  639.     count = 0

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

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

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

  643.         count += 1

  644. 

  645.     return count

  646. 

  647. # ------------------------------------------------------------------------------------------------------------

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

  649. 

  650. def isNumber(value):

  651.     try:

  652.         float(value)

  653.         return True

  654.     except:

  655.         return False

  656. 

  657. # ------------------------------------------------------------------------------------------------------------

  658. # Convert a value to a list

  659. 

  660. def toList(value):

  661.     if value is None:

  662.         return []

  663.     if not isinstance(value, list):

  664.         return [value]

  665.     return value

  666. 

  667. # ------------------------------------------------------------------------------------------------------------

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

  669. 

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

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

  672. 

  673. # ------------------------------------------------------------------------------------------------------------

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

  675. 

  676. def handleInitialCommandLineArguments(file):

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

  678.     libPrefix = None

  679.     readPrefixNext = False

  680. 

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

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

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

  684. 

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

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

  687. 

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

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

  690. 

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

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

  693. 

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

  695.             readPrefixNext = True

  696. 

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

  698.             pass

  699. 

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

  701.             gCarla.nogui = True

  702. 

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

  704.             pass

  705. 

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

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

  708.             print("")

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

  710.             print("")

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

  712.             print("")

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

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

  715.                 if X_LIBDIR_X is not None:

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

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

  718.                 print("")

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

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

  721.             print("")

  722. 

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

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

  725.                 sys.exit(1)

  726. 

  727.             sys.exit(0)

  728. 

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

  730.             pathBinaries, pathResources = getPaths(libPrefix)

  731. 

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

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

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

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

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

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

  738. 

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

  740. 

  741.         elif readPrefixNext:

  742.             readPrefixNext = False

  743.             gCarla.cnprefix = arg

  744. 

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

  746.         if os.fork():

  747.             # pylint: disable=protected-access

  748.             os._exit(0)

  749.             # pylint: enable=protected-access

  750.         else:

  751.             os.setsid()

  752. 

  753.     return (initName, libPrefix)

  754. 

  755. # ------------------------------------------------------------------------------------------------------------

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

  757. 

  758. def getInitialProjectFile(skipExistCheck = False):

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

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

  761.     args = sys.argv[1:]

  762.     readPrefixNext = False

  763.     for arg in args:

  764.         if readPrefixNext:

  765.             readPrefixNext = False

  766.             continue

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

  768.             continue

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

  770.             continue

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

  772.             continue

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

  774.             continue

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

  776.             readPrefixNext = True

  777.             continue

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

  779.             continue

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

  781.             continue

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

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

  784.             return arg

  785. 

  786.     return None

  787. 

  788. # ------------------------------------------------------------------------------------------------------------

  789. # Get paths (binaries, resources)

  790. 

  791. def getPaths(libPrefix = None):

  792.     CWDl = CWD.lower()

  793. 

  794.     # adjust for special distros

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

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

  797. 

  798.     # standalone, installed system-wide linux

  799.     if libPrefix is not None:

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

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

  802. 

  803.     # standalone, local source

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

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

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

  807. 

  808.     # plugin

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

  810.         # installed system-wide linux

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

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

  813.             pathResources = CWD

  814. 

  815.         # local source

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

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

  818.             pathResources = CWD

  819. 

  820.         # other

  821.         else:

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

  823.             pathResources = CWD

  824. 

  825.     # everything else

  826.     else:

  827.         pathBinaries  = CWD

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

  829. 

  830.     return (pathBinaries, pathResources)

  831. 

  832. # ------------------------------------------------------------------------------------------------------------

  833. # Signal handler

  834. # TODO move to carla_host.py or something

  835. 

  836. def signalHandler(sig, frame):

  837.     if sig in (SIGINT, SIGTERM):

  838.         gCarla.term = True

  839.         if gCarla.gui is not None:

  840.             gCarla.gui.SIGTERM.emit()

  841. 

  842.     elif haveSIGUSR1 and sig == SIGUSR1:

  843.         if gCarla.gui is not None:

  844.             gCarla.gui.SIGUSR1.emit()

  845. 

  846. def setUpSignals():

  847.     signal(SIGINT,  signalHandler)

  848.     signal(SIGTERM, signalHandler)

  849. 

  850.     if not haveSIGUSR1:

  851.         return

  852. 

  853.     signal(SIGUSR1, signalHandler)

  854. 

  855. # ------------------------------------------------------------------------------------------------------------

  856. # QLineEdit and QPushButton combo

  857. 

  858. def getAndSetPath(parent, lineEdit):

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

  860.     if newPath:

  861.         lineEdit.setText(newPath)

  862.     return newPath

  863. 

  864. # ------------------------------------------------------------------------------------------------------------

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

  866. 

  867. def fontMetricsHorizontalAdvance(fontMetrics, string):

  868.     if QT_VERSION >= 0x50b00:

  869.         return fontMetrics.horizontalAdvance(string)

  870.     return fontMetrics.width(string)

  871. 

  872. # ------------------------------------------------------------------------------------------------------------

  873. # Custom QMessageBox which resizes itself to fit text

  874. 

  875. class QMessageBoxWithBetterWidth(QMessageBox):

  876.     def __init__(self, parent):

  877.         QMessageBox.__init__(self, parent)

  878. 

  879.     def showEvent(self, event):

  880.         fontMetrics = self.fontMetrics()

  881. 

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

  883. 

  884.         if lines:

  885.             width = 0

  886. 

  887.             for line in lines:

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

  889. 

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

  891. 

  892.         QMessageBox.showEvent(self, event)

  893. 

  894. # ------------------------------------------------------------------------------------------------------------

  895. # Custom MessageBox

  896. 

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

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

  899.                      extraText="",

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

  901.                      defButton=QMessageBox.No):

  902.     msgBox = QMessageBoxWithBetterWidth(parent)

  903.     msgBox.setIcon(icon)

  904.     msgBox.setWindowTitle(title)

  905.     msgBox.setText(text)

  906.     msgBox.setInformativeText(extraText)

  907.     msgBox.setStandardButtons(buttons)

  908.     msgBox.setDefaultButton(defButton)

  909.     return msgBox.exec_()

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

  911. 

  912. # ------------------------------------------------------------------------------------------------------------