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

912 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 HAIKU:

  297.     CARLA_DEFAULT_AUDIO_DRIVER = "SDL"

  298. elif MACOS:

  299.     CARLA_DEFAULT_AUDIO_DRIVER = "CoreAudio"

  300. elif WINDOWS:

  301.     CARLA_DEFAULT_AUDIO_DRIVER = "Windows Audio"

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

  303.     CARLA_DEFAULT_AUDIO_DRIVER = "JACK"

  304. else:

  305.     CARLA_DEFAULT_AUDIO_DRIVER = "PulseAudio"

  306. 

  307. if CARLA_DEFAULT_AUDIO_DRIVER == "JACK":

  308.     CARLA_DEFAULT_PROCESS_MODE   = ENGINE_PROCESS_MODE_MULTIPLE_CLIENTS

  309.     CARLA_DEFAULT_TRANSPORT_MODE = ENGINE_TRANSPORT_MODE_JACK

  310. else:

  311.     CARLA_DEFAULT_PROCESS_MODE   = ENGINE_PROCESS_MODE_PATCHBAY

  312.     CARLA_DEFAULT_TRANSPORT_MODE = ENGINE_TRANSPORT_MODE_INTERNAL

  313. 

  314. # OSC

  315. CARLA_DEFAULT_OSC_ENABLED = not (MACOS or WINDOWS)

  316. CARLA_DEFAULT_OSC_TCP_PORT_ENABLED = True

  317. CARLA_DEFAULT_OSC_TCP_PORT_NUMBER  = 22752

  318. CARLA_DEFAULT_OSC_TCP_PORT_RANDOM  = False

  319. CARLA_DEFAULT_OSC_UDP_PORT_ENABLED = True

  320. CARLA_DEFAULT_OSC_UDP_PORT_NUMBER  = 22752

  321. CARLA_DEFAULT_OSC_UDP_PORT_RANDOM  = False

  322. 

  323. # Wine

  324. CARLA_DEFAULT_WINE_EXECUTABLE      = "wine"

  325. CARLA_DEFAULT_WINE_AUTO_PREFIX     = True

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

  327. CARLA_DEFAULT_WINE_RT_PRIO_ENABLED = True

  328. CARLA_DEFAULT_WINE_BASE_RT_PRIO    = 15

  329. CARLA_DEFAULT_WINE_SERVER_RT_PRIO  = 10

  330. 

  331. # Experimental

  332. CARLA_DEFAULT_EXPERIMENTAL_PLUGIN_BRIDGES        = False

  333. CARLA_DEFAULT_EXPERIMENTAL_WINE_BRIDGES          = False

  334. CARLA_DEFAULT_EXPERIMENTAL_JACK_APPS             = False

  335. CARLA_DEFAULT_EXPERIMENTAL_LV2_EXPORT            = False

  336. CARLA_DEFAULT_EXPERIMENTAL_PREVENT_BAD_BEHAVIOUR = False

  337. CARLA_DEFAULT_EXPERIMENTAL_LOAD_LIB_GLOBAL       = False

  338. 

  339. # ------------------------------------------------------------------------------------------------------------

  340. # Default File Folders

  341. 

  342. CARLA_DEFAULT_FILE_PATH_AUDIO = []

  343. CARLA_DEFAULT_FILE_PATH_MIDI  = []

  344. 

  345. # ------------------------------------------------------------------------------------------------------------

  346. # Default Plugin Folders (get)

  347. 

  348. DEFAULT_LADSPA_PATH = ""

  349. DEFAULT_DSSI_PATH   = ""

  350. DEFAULT_LV2_PATH    = ""

  351. DEFAULT_VST2_PATH   = ""

  352. DEFAULT_VST3_PATH   = ""

  353. DEFAULT_CLAP_PATH   = ""

  354. DEFAULT_SF2_PATH    = ""

  355. DEFAULT_SFZ_PATH    = ""

  356. DEFAULT_JSFX_PATH   = ""

  357. 

  358. if WINDOWS:

  359.     splitter = ";"

  360. 

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

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

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

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

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

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

  367. 

  368.     # Small integrity tests

  369.     if not APPDATA:

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

  371.         sys.exit(1)

  372. 

  373.     if not PROGRAMFILES:

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

  375.         sys.exit(1)

  376. 

  377.     if not COMMONPROGRAMFILES:

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

  379.         sys.exit(1)

  380. 

  381.     DEFAULT_LADSPA_PATH  = APPDATA + "\\LADSPA"

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

  383. 

  384.     DEFAULT_DSSI_PATH    = APPDATA + "\\DSSI"

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

  386. 

  387.     DEFAULT_LV2_PATH     = APPDATA + "\\LV2"

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

  389. 

  390.     DEFAULT_VST2_PATH    = PROGRAMFILES + "\\VstPlugins"

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

  392. 

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

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

  395. 

  396.     if kIs64bit:

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

  398. 

  399.     DEFAULT_VST3_PATH    = COMMONPROGRAMFILES + "\\VST3"

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

  401. 

  402.     DEFAULT_CLAP_PATH    = COMMONPROGRAMFILES + "\\CLAP"

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

  404. 

  405.     DEFAULT_SF2_PATH     = APPDATA + "\\SF2"

  406.     DEFAULT_SFZ_PATH     = APPDATA + "\\SFZ"

  407. 

  408.     if PROGRAMFILESx86:

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

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

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

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

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

  414. 

  415.     if COMMONPROGRAMFILESx86:

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

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

  418. 

  419. elif HAIKU:

  420.     splitter = ":"

  421. 

  422.     DEFAULT_LADSPA_PATH  = HOME + "/.ladspa"

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

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

  425. 

  426.     DEFAULT_DSSI_PATH    = HOME + "/.dssi"

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

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

  429. 

  430.     DEFAULT_LV2_PATH     = HOME + "/.lv2"

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

  432. 

  433.     DEFAULT_VST2_PATH    = HOME + "/.vst"

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

  435. 

  436.     DEFAULT_VST3_PATH    = HOME + "/.vst3"

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

  438. 

  439.     DEFAULT_CLAP_PATH    = HOME + "/.clap"

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

  441. 

  442. elif MACOS:

  443.     splitter = ":"

  444. 

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

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

  447. 

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

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

  450. 

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

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

  453. 

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

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

  456. 

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

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

  459. 

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

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

  462. 

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

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

  465. 

  466. else:

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

  468. 

  469.     splitter = ":"

  470. 

  471.     DEFAULT_LADSPA_PATH  = HOME + "/.ladspa"

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

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

  474. 

  475.     DEFAULT_DSSI_PATH    = HOME + "/.dssi"

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

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

  478. 

  479.     DEFAULT_LV2_PATH     = HOME + "/.lv2"

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

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

  482. 

  483.     DEFAULT_VST2_PATH    = HOME + "/.vst"

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

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

  486. 

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

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

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

  490. 

  491.     DEFAULT_VST3_PATH    = HOME + "/.vst3"

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

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

  494. 

  495.     DEFAULT_CLAP_PATH    = HOME + "/.clap"

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

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

  498. 

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

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

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

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

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

  504. 

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

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

  507. 

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

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

  510. 

  511. if not WINDOWS:

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

  513. 

  514.     if not winePrefix:

  515.         winePrefix = HOME + "/.wine"

  516. 

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

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

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

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

  521. 

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

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

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

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

  526. 

  527.     del winePrefix

  528. 

  529. # ------------------------------------------------------------------------------------------------------------

  530. # Default Plugin Folders (set)

  531. 

  532. readEnvVars = True

  533. 

  534. if WINDOWS:

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

  536.     # pylint: disable=import-error

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

  538.     # pylint: enable=import-error

  539.     _reg = ConnectRegistry(None, HKEY_CURRENT_USER)

  540. 

  541.     try:

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

  543.         CloseKey(_key)

  544.         del _key

  545.         readEnvVars = False

  546.     except:

  547.         pass

  548. 

  549.     CloseKey(_reg)

  550.     del _reg

  551. 

  552. if readEnvVars:

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

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

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

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

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

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

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

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

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

  562. 

  563. else:

  564.     CARLA_DEFAULT_LADSPA_PATH = DEFAULT_LADSPA_PATH.split(splitter)

  565.     CARLA_DEFAULT_DSSI_PATH   = DEFAULT_DSSI_PATH.split(splitter)

  566.     CARLA_DEFAULT_LV2_PATH    = DEFAULT_LV2_PATH.split(splitter)

  567.     CARLA_DEFAULT_VST2_PATH   = DEFAULT_VST2_PATH.split(splitter)

  568.     CARLA_DEFAULT_VST3_PATH   = DEFAULT_VST3_PATH.split(splitter)

  569.     CARLA_DEFAULT_CLAP_PATH   = DEFAULT_CLAP_PATH.split(splitter)

  570.     CARLA_DEFAULT_SF2_PATH    = DEFAULT_SF2_PATH.split(splitter)

  571.     CARLA_DEFAULT_SFZ_PATH    = DEFAULT_SFZ_PATH.split(splitter)

  572.     CARLA_DEFAULT_JSFX_PATH   = DEFAULT_JSFX_PATH.split(splitter)

  573. 

  574. # ------------------------------------------------------------------------------------------------------------

  575. # Default Plugin Folders (cleanup)

  576. 

  577. del DEFAULT_LADSPA_PATH

  578. del DEFAULT_DSSI_PATH

  579. del DEFAULT_LV2_PATH

  580. del DEFAULT_VST2_PATH

  581. del DEFAULT_VST3_PATH

  582. del DEFAULT_CLAP_PATH

  583. del DEFAULT_SF2_PATH

  584. del DEFAULT_SFZ_PATH

  585. 

  586. # ------------------------------------------------------------------------------------------------------------

  587. # Global Carla object

  588. 

  589. class CarlaObject():

  590.     def __init__(self):

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

  592.         self.gui      = None  # Host Window

  593.         self.nogui    = False # Skip UI

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

  595.         self.felib    = None  # Frontend lib object

  596.         self.utils    = None  # Utils object

  597. 

  598. gCarla = CarlaObject()

  599. 

  600. # ------------------------------------------------------------------------------------------------------------

  601. # Set CWD

  602. 

  603. CWD = sys.path[0]

  604. 

  605. if not CWD:

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

  607. 

  608. # make it work with cxfreeze

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

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

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

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

  613.     CXFREEZE = True

  614.     if not WINDOWS:

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

  616. else:

  617.     CXFREEZE = False

  618. 

  619. # ------------------------------------------------------------------------------------------------------------

  620. # Set DLL_EXTENSION

  621. 

  622. if WINDOWS:

  623.     DLL_EXTENSION = "dll"

  624. elif MACOS:

  625.     DLL_EXTENSION = "dylib"

  626. else:

  627.     DLL_EXTENSION = "so"

  628. 

  629. # ------------------------------------------------------------------------------------------------------------

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

  631. 

  632. def countDecimalPoints(step, stepSmall):

  633.     if stepSmall >= 1.0:

  634.         return 0

  635.     if step >= 1.0:

  636.         return 2

  637. 

  638.     count = 0

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

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

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

  642.         count += 1

  643. 

  644.     return count

  645. 

  646. # ------------------------------------------------------------------------------------------------------------

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

  648. 

  649. def isNumber(value):

  650.     try:

  651.         float(value)

  652.         return True

  653.     except:

  654.         return False

  655. 

  656. # ------------------------------------------------------------------------------------------------------------

  657. # Convert a value to a list

  658. 

  659. def toList(value):

  660.     if value is None:

  661.         return []

  662.     if not isinstance(value, list):

  663.         return [value]

  664.     return value

  665. 

  666. # ------------------------------------------------------------------------------------------------------------

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

  668. 

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

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

  671. 

  672. # ------------------------------------------------------------------------------------------------------------

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

  674. 

  675. def handleInitialCommandLineArguments(file):

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

  677.     libPrefix = None

  678.     readPrefixNext = False

  679. 

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

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

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

  683. 

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

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

  686. 

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

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

  689. 

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

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

  692. 

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

  694.             readPrefixNext = True

  695. 

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

  697.             pass

  698. 

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

  700.             gCarla.nogui = True

  701. 

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

  703.             pass

  704. 

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

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

  707.             print("")

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

  709.             print("")

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

  711.             print("")

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

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

  714.                 if X_LIBDIR_X is not None:

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

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

  717.                 print("")

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

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

  720.             print("")

  721. 

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

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

  724.                 sys.exit(1)

  725. 

  726.             sys.exit(0)

  727. 

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

  729.             pathBinaries, pathResources = getPaths(libPrefix)

  730. 

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

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

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

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

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

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

  737. 

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

  739. 

  740.         elif readPrefixNext:

  741.             readPrefixNext = False

  742.             gCarla.cnprefix = arg

  743. 

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

  745.         if os.fork():

  746.             # pylint: disable=protected-access

  747.             os._exit(0)

  748.             # pylint: enable=protected-access

  749.         else:

  750.             os.setsid()

  751. 

  752.     return (initName, libPrefix)

  753. 

  754. # ------------------------------------------------------------------------------------------------------------

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

  756. 

  757. def getInitialProjectFile(skipExistCheck = False):

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

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

  760.     args = sys.argv[1:]

  761.     readPrefixNext = False

  762.     for arg in args:

  763.         if readPrefixNext:

  764.             readPrefixNext = False

  765.             continue

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

  767.             continue

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

  769.             continue

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

  771.             continue

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

  773.             continue

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

  775.             readPrefixNext = True

  776.             continue

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

  778.             continue

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

  780.             continue

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

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

  783.             return arg

  784. 

  785.     return None

  786. 

  787. # ------------------------------------------------------------------------------------------------------------

  788. # Get paths (binaries, resources)

  789. 

  790. def getPaths(libPrefix = None):

  791.     CWDl = CWD.lower()

  792. 

  793.     # adjust for special distros

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

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

  796. 

  797.     # standalone, installed system-wide linux

  798.     if libPrefix is not None:

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

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

  801. 

  802.     # standalone, local source

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

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

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

  806. 

  807.     # plugin

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

  809.         # installed system-wide linux

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

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

  812.             pathResources = CWD

  813. 

  814.         # local source

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

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

  817.             pathResources = CWD

  818. 

  819.         # other

  820.         else:

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

  822.             pathResources = CWD

  823. 

  824.     # everything else

  825.     else:

  826.         pathBinaries  = CWD

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

  828. 

  829.     return (pathBinaries, pathResources)

  830. 

  831. # ------------------------------------------------------------------------------------------------------------

  832. # Signal handler

  833. # TODO move to carla_host.py or something

  834. 

  835. def signalHandler(sig, frame):

  836.     if sig in (SIGINT, SIGTERM):

  837.         gCarla.term = True

  838.         if gCarla.gui is not None:

  839.             gCarla.gui.SIGTERM.emit()

  840. 

  841.     elif haveSIGUSR1 and sig == SIGUSR1:

  842.         if gCarla.gui is not None:

  843.             gCarla.gui.SIGUSR1.emit()

  844. 

  845. def setUpSignals():

  846.     signal(SIGINT,  signalHandler)

  847.     signal(SIGTERM, signalHandler)

  848. 

  849.     if not haveSIGUSR1:

  850.         return

  851. 

  852.     signal(SIGUSR1, signalHandler)

  853. 

  854. # ------------------------------------------------------------------------------------------------------------

  855. # QLineEdit and QPushButton combo

  856. 

  857. def getAndSetPath(parent, lineEdit):

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

  859.     if newPath:

  860.         lineEdit.setText(newPath)

  861.     return newPath

  862. 

  863. # ------------------------------------------------------------------------------------------------------------

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

  865. 

  866. def fontMetricsHorizontalAdvance(fontMetrics, string):

  867.     if QT_VERSION >= 0x50b00:

  868.         return fontMetrics.horizontalAdvance(string)

  869.     return fontMetrics.width(string)

  870. 

  871. # ------------------------------------------------------------------------------------------------------------

  872. # Custom QMessageBox which resizes itself to fit text

  873. 

  874. class QMessageBoxWithBetterWidth(QMessageBox):

  875.     def __init__(self, parent):

  876.         QMessageBox.__init__(self, parent)

  877. 

  878.     def showEvent(self, event):

  879.         fontMetrics = self.fontMetrics()

  880. 

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

  882. 

  883.         if lines:

  884.             width = 0

  885. 

  886.             for line in lines:

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

  888. 

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

  890. 

  891.         QMessageBox.showEvent(self, event)

  892. 

  893. # ------------------------------------------------------------------------------------------------------------

  894. # Custom MessageBox

  895. 

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

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

  898.                      extraText="",

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

  900.                      defButton=QMessageBox.No):

  901.     msgBox = QMessageBoxWithBetterWidth(parent)

  902.     msgBox.setIcon(icon)

  903.     msgBox.setWindowTitle(title)

  904.     msgBox.setText(text)

  905.     msgBox.setInformativeText(extraText)

  906.     msgBox.setStandardButtons(buttons)

  907.     msgBox.setDefaultButton(defButton)

  908.     return msgBox.exec_()

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

  910. 

  911. # ------------------------------------------------------------------------------------------------------------