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.
6473 Commits
16 Branches
334MB
Tree: 5db10df8be
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '5db10df8be'
${ noResults }
Carla/source/frontend/pluginlist/pluginlistrefreshdialog.py

472 lines
20KB
Raw Blame History 

  1. #!/usr/bin/env python3

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

  3. 

  4. # Carla plugin host

  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. 

  24. from PyQt5.QtCore import pyqtSlot, Qt, QT_VERSION

  25. from PyQt5.QtGui import QPixmap

  26. from PyQt5.QtWidgets import QDialog, QWidget

  27. 

  28. # ---------------------------------------------------------------------------------------------------------------------

  29. # Imports (Carla)

  30. 

  31. from carla_shared import (

  32.     HAIKU,

  33.     LINUX,

  34.     MACOS,

  35.     WINDOWS,

  36.     gCarla,

  37.     getIcon,

  38.     kIs64bit,

  39. )

  40. 

  41. from utils import QSafeSettings

  42. 

  43. # ---------------------------------------------------------------------------------------------------------------------

  44. # Imports (Local)

  45. 

  46. from .discovery import killDiscovery

  47. from .discoverythread import SearchPluginsThread

  48. from .pluginlistrefreshdialog_ui import Ui_PluginRefreshW

  49. 

  50. # ---------------------------------------------------------------------------------------------------------------------

  51. # Plugin Refresh Dialog

  52. 

  53. class PluginRefreshW(QDialog):

  54.     def __init__(self, parent: QWidget, host, useSystemIcons: bool, hasLoadedLv2Plugins: bool):

  55.         QDialog.__init__(self, parent)

  56.         self.host = host

  57.         self.ui = Ui_PluginRefreshW()

  58.         self.ui.setupUi(self)

  59. 

  60.         # -------------------------------------------------------------------------------------------------------------

  61.         # Internal stuff

  62. 

  63.         toolNative = "carla-discovery-native.exe" if WINDOWS else "carla-discovery-native"

  64.         hasNative  = os.path.exists(os.path.join(host.pathBinaries, toolNative))

  65.         hasPosix32 = os.path.exists(os.path.join(host.pathBinaries, "carla-discovery-posix32"))

  66.         hasPosix64 = os.path.exists(os.path.join(host.pathBinaries, "carla-discovery-posix64"))

  67.         hasWin32   = os.path.exists(os.path.join(host.pathBinaries, "carla-discovery-win32.exe"))

  68.         hasWin64   = os.path.exists(os.path.join(host.pathBinaries, "carla-discovery-win64.exe"))

  69. 

  70.         self.fThread = SearchPluginsThread(self, host.pathBinaries)

  71. 

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

  73.         # Set-up Icons

  74. 

  75.         if useSystemIcons:

  76.             self.ui.b_start.setIcon(getIcon('arrow-right', 16, 'svgz'))

  77.             self.ui.b_close.setIcon(getIcon('window-close', 16, 'svgz'))

  78.             if QT_VERSION >= 0x50600:

  79.                 size = int(16 * self.devicePixelRatioF())

  80.             else:

  81.                 size = 16

  82.             self.fIconYes = QPixmap(getIcon('dialog-ok-apply', 16, 'svgz').pixmap(size))

  83.             self.fIconNo  = QPixmap(getIcon('dialog-error', 16, 'svgz').pixmap(size))

  84.         else:

  85.             self.fIconYes = QPixmap(":/16x16/dialog-ok-apply.svgz")

  86.             self.fIconNo  = QPixmap(":/16x16/dialog-error.svgz")

  87. 

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

  89.         # Set-up GUI

  90. 

  91.         # FIXME remove LRDF

  92.         self.ui.ico_rdflib.setPixmap(self.fIconNo)

  93. 

  94.         self.ui.b_skip.setVisible(False)

  95. 

  96.         if HAIKU:

  97.             self.ui.ch_posix32.setText("Haiku 32bit")

  98.             self.ui.ch_posix64.setText("Haiku 64bit")

  99.         elif LINUX:

  100.             self.ui.ch_posix32.setText("Linux 32bit")

  101.             self.ui.ch_posix64.setText("Linux 64bit")

  102.         elif MACOS:

  103.             self.ui.ch_posix32.setText("MacOS 32bit")

  104.             self.ui.ch_posix64.setText("MacOS 64bit")

  105. 

  106.         if hasPosix32 and not WINDOWS:

  107.             self.ui.ico_posix32.setPixmap(self.fIconYes)

  108.         else:

  109.             self.ui.ico_posix32.setPixmap(self.fIconNo)

  110.             self.ui.ch_posix32.setEnabled(False)

  111. 

  112.         if hasPosix64 and not WINDOWS:

  113.             self.ui.ico_posix64.setPixmap(self.fIconYes)

  114.         else:

  115.             self.ui.ico_posix64.setPixmap(self.fIconNo)

  116.             self.ui.ch_posix64.setEnabled(False)

  117. 

  118.         if hasWin32:

  119.             self.ui.ico_win32.setPixmap(self.fIconYes)

  120.         else:

  121.             self.ui.ico_win32.setPixmap(self.fIconNo)

  122.             self.ui.ch_win32.setEnabled(False)

  123. 

  124.         if hasWin64:

  125.             self.ui.ico_win64.setPixmap(self.fIconYes)

  126.         else:

  127.             self.ui.ico_win64.setPixmap(self.fIconNo)

  128.             self.ui.ch_win64.setEnabled(False)

  129. 

  130.         if WINDOWS:

  131.             if kIs64bit:

  132.                 hasNonNative = hasWin32

  133.                 self.ui.ch_win64.setEnabled(False)

  134.                 self.ui.ch_win64.setVisible(False)

  135.                 self.ui.ico_win64.setVisible(False)

  136.                 self.ui.label_win64.setVisible(False)

  137.             else:

  138.                 hasNonNative = hasWin64

  139.                 self.ui.ch_win32.setEnabled(False)

  140.                 self.ui.ch_win32.setVisible(False)

  141.                 self.ui.ico_win32.setVisible(False)

  142.                 self.ui.label_win32.setVisible(False)

  143. 

  144.             self.ui.ch_posix32.setEnabled(False)

  145.             self.ui.ch_posix32.setVisible(False)

  146.             self.ui.ch_posix64.setEnabled(False)

  147.             self.ui.ch_posix64.setVisible(False)

  148.             self.ui.ico_posix32.hide()

  149.             self.ui.ico_posix64.hide()

  150.             self.ui.label_posix32.hide()

  151.             self.ui.label_posix64.hide()

  152.             self.ui.ico_rdflib.hide()

  153.             self.ui.label_rdflib.hide()

  154. 

  155.         else:

  156.             if kIs64bit:

  157.                 hasNonNative = bool(hasPosix32 or hasWin32 or hasWin64)

  158.                 self.ui.ch_posix64.setEnabled(False)

  159.                 self.ui.ch_posix64.setVisible(False)

  160.                 self.ui.ico_posix64.setVisible(False)

  161.                 self.ui.label_posix64.setVisible(False)

  162.             else:

  163.                 hasNonNative = bool(hasPosix64 or hasWin32 or hasWin64)

  164.                 self.ui.ch_posix32.setEnabled(False)

  165.                 self.ui.ch_posix32.setVisible(False)

  166.                 self.ui.ico_posix32.setVisible(False)

  167.                 self.ui.label_posix32.setVisible(False)

  168. 

  169.                 if not (LINUX or hasWin32 or hasWin64):

  170.                     self.ui.ch_vst3.setEnabled(False)

  171.                     self.ui.ch_vst3.setVisible(False)

  172. 

  173.         if MACOS:

  174.             self.setWindowModality(Qt.WindowModal)

  175.         else:

  176.             self.ui.ch_au.setEnabled(False)

  177.             self.ui.ch_au.setVisible(False)

  178. 

  179.         if hasNative:

  180.             self.ui.ico_native.setPixmap(self.fIconYes)

  181.         else:

  182.             self.ui.ico_native.setPixmap(self.fIconNo)

  183.             self.ui.ch_native.setEnabled(False)

  184.             self.ui.ch_sf2.setEnabled(False)

  185.             if not hasNonNative:

  186.                 self.ui.ch_ladspa.setEnabled(False)

  187.                 self.ui.ch_dssi.setEnabled(False)

  188.                 self.ui.ch_vst.setEnabled(False)

  189.                 self.ui.ch_vst3.setEnabled(False)

  190. 

  191.         if not hasLoadedLv2Plugins:

  192.             self.ui.lv2_restart_notice.hide()

  193. 

  194.         self.setWindowFlags(self.windowFlags() & ~Qt.WindowContextHelpButtonHint)

  195. 

  196.         # -------------------------------------------------------------------------------------------------------------

  197.         # Load settings

  198. 

  199.         self.loadSettings()

  200. 

  201.         # -------------------------------------------------------------------------------------------------------------

  202.         # Hide bridges if disabled

  203. 

  204.         # NOTE: We Assume win32 carla build will not run win64 plugins

  205.         if (WINDOWS and not kIs64bit) or not host.showPluginBridges:

  206.             self.ui.ch_native.setChecked(True)

  207.             self.ui.ch_native.setEnabled(False)

  208.             self.ui.ch_native.setVisible(False)

  209.             self.ui.ch_posix32.setChecked(False)

  210.             self.ui.ch_posix32.setEnabled(False)

  211.             self.ui.ch_posix32.setVisible(False)

  212.             self.ui.ch_posix64.setChecked(False)

  213.             self.ui.ch_posix64.setEnabled(False)

  214.             self.ui.ch_posix64.setVisible(False)

  215.             self.ui.ch_win32.setChecked(False)

  216.             self.ui.ch_win32.setEnabled(False)

  217.             self.ui.ch_win32.setVisible(False)

  218.             self.ui.ch_win64.setChecked(False)

  219.             self.ui.ch_win64.setEnabled(False)

  220.             self.ui.ch_win64.setVisible(False)

  221.             self.ui.ico_posix32.hide()

  222.             self.ui.ico_posix64.hide()

  223.             self.ui.ico_win32.hide()

  224.             self.ui.ico_win64.hide()

  225.             self.ui.label_posix32.hide()

  226.             self.ui.label_posix64.hide()

  227.             self.ui.label_win32.hide()

  228.             self.ui.label_win64.hide()

  229.             self.ui.sep_format.hide()

  230. 

  231.         elif not (WINDOWS or host.showWineBridges):

  232.             self.ui.ch_win32.setChecked(False)

  233.             self.ui.ch_win32.setEnabled(False)

  234.             self.ui.ch_win32.setVisible(False)

  235.             self.ui.ch_win64.setChecked(False)

  236.             self.ui.ch_win64.setEnabled(False)

  237.             self.ui.ch_win64.setVisible(False)

  238.             self.ui.ico_win32.hide()

  239.             self.ui.ico_win64.hide()

  240.             self.ui.label_win32.hide()

  241.             self.ui.label_win64.hide()

  242. 

  243.         # Disable non-supported features

  244.         features = gCarla.utils.get_supported_features() if gCarla.utils else ()

  245. 

  246.         if "sf2" not in features:

  247.             self.ui.ch_sf2.setChecked(False)

  248.             self.ui.ch_sf2.setEnabled(False)

  249. 

  250.         if MACOS and "juce" not in features:

  251.             self.ui.ch_au.setChecked(False)

  252.             self.ui.ch_au.setEnabled(False)

  253. 

  254.         # -------------------------------------------------------------------------------------------------------------

  255.         # Resize to minimum size, as it's very likely UI stuff was hidden

  256. 

  257.         self.resize(self.minimumSize())

  258. 

  259.         # -------------------------------------------------------------------------------------------------------------

  260.         # Set-up connections

  261. 

  262.         self.finished.connect(self.slot_saveSettings)

  263.         self.ui.b_start.clicked.connect(self.slot_start)

  264.         self.ui.b_skip.clicked.connect(self.slot_skip)

  265.         self.ui.ch_native.clicked.connect(self.slot_checkTools)

  266.         self.ui.ch_posix32.clicked.connect(self.slot_checkTools)

  267.         self.ui.ch_posix64.clicked.connect(self.slot_checkTools)

  268.         self.ui.ch_win32.clicked.connect(self.slot_checkTools)

  269.         self.ui.ch_win64.clicked.connect(self.slot_checkTools)

  270.         self.ui.ch_ladspa.clicked.connect(self.slot_checkTools)

  271.         self.ui.ch_dssi.clicked.connect(self.slot_checkTools)

  272.         self.ui.ch_lv2.clicked.connect(self.slot_checkTools)

  273.         self.ui.ch_vst.clicked.connect(self.slot_checkTools)

  274.         self.ui.ch_vst3.clicked.connect(self.slot_checkTools)

  275.         self.ui.ch_au.clicked.connect(self.slot_checkTools)

  276.         self.ui.ch_sf2.clicked.connect(self.slot_checkTools)

  277.         self.ui.ch_sfz.clicked.connect(self.slot_checkTools)

  278.         self.ui.ch_jsfx.clicked.connect(self.slot_checkTools)

  279.         self.fThread.pluginLook.connect(self.slot_handlePluginLook)

  280.         self.fThread.finished.connect(self.slot_handlePluginThreadFinished)

  281. 

  282.         # -------------------------------------------------------------------------------------------------------------

  283.         # Post-connect setup

  284. 

  285.         self.slot_checkTools()

  286. 

  287.     # -----------------------------------------------------------------------------------------------------------------

  288. 

  289.     def loadSettings(self):

  290.         settings = QSafeSettings("falkTX", "CarlaRefresh2")

  291. 

  292.         check = settings.value("PluginDatabase/SearchLADSPA", True, bool) and self.ui.ch_ladspa.isEnabled()

  293.         self.ui.ch_ladspa.setChecked(check)

  294. 

  295.         check = settings.value("PluginDatabase/SearchDSSI", True, bool) and self.ui.ch_dssi.isEnabled()

  296.         self.ui.ch_dssi.setChecked(check)

  297. 

  298.         check = settings.value("PluginDatabase/SearchLV2", True, bool) and self.ui.ch_lv2.isEnabled()

  299.         self.ui.ch_lv2.setChecked(check)

  300. 

  301.         check = settings.value("PluginDatabase/SearchVST2", True, bool) and self.ui.ch_vst.isEnabled()

  302.         self.ui.ch_vst.setChecked(check)

  303. 

  304.         check = settings.value("PluginDatabase/SearchVST3", True, bool) and self.ui.ch_vst3.isEnabled()

  305.         self.ui.ch_vst3.setChecked(check)

  306. 

  307.         if MACOS:

  308.             check = settings.value("PluginDatabase/SearchAU", True, bool) and self.ui.ch_au.isEnabled()

  309.         else:

  310.             check = False

  311.         self.ui.ch_au.setChecked(check)

  312. 

  313.         check = settings.value("PluginDatabase/SearchSF2", False, bool) and self.ui.ch_sf2.isEnabled()

  314.         self.ui.ch_sf2.setChecked(check)

  315. 

  316.         check = settings.value("PluginDatabase/SearchSFZ", False, bool) and self.ui.ch_sfz.isEnabled()

  317.         self.ui.ch_sfz.setChecked(check)

  318. 

  319.         check = settings.value("PluginDatabase/SearchJSFX", True, bool) and self.ui.ch_jsfx.isEnabled()

  320.         self.ui.ch_jsfx.setChecked(check)

  321. 

  322.         check = settings.value("PluginDatabase/SearchNative", True, bool) and self.ui.ch_native.isEnabled()

  323.         self.ui.ch_native.setChecked(check)

  324. 

  325.         check = settings.value("PluginDatabase/SearchPOSIX32", False, bool) and self.ui.ch_posix32.isEnabled()

  326.         self.ui.ch_posix32.setChecked(check)

  327. 

  328.         check = settings.value("PluginDatabase/SearchPOSIX64", False, bool) and self.ui.ch_posix64.isEnabled()

  329.         self.ui.ch_posix64.setChecked(check)

  330. 

  331.         check = settings.value("PluginDatabase/SearchWin32", False, bool) and self.ui.ch_win32.isEnabled()

  332.         self.ui.ch_win32.setChecked(check)

  333. 

  334.         check = settings.value("PluginDatabase/SearchWin64", False, bool) and self.ui.ch_win64.isEnabled()

  335.         self.ui.ch_win64.setChecked(check)

  336. 

  337.         self.ui.ch_do_checks.setChecked(settings.value("PluginDatabase/DoChecks", False, bool))

  338. 

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

  340. 

  341.     @pyqtSlot()

  342.     def slot_saveSettings(self):

  343.         settings = QSafeSettings("falkTX", "CarlaRefresh2")

  344.         settings.setValue("PluginDatabase/SearchLADSPA", self.ui.ch_ladspa.isChecked())

  345.         settings.setValue("PluginDatabase/SearchDSSI", self.ui.ch_dssi.isChecked())

  346.         settings.setValue("PluginDatabase/SearchLV2", self.ui.ch_lv2.isChecked())

  347.         settings.setValue("PluginDatabase/SearchVST2", self.ui.ch_vst.isChecked())

  348.         settings.setValue("PluginDatabase/SearchVST3", self.ui.ch_vst3.isChecked())

  349.         settings.setValue("PluginDatabase/SearchAU", self.ui.ch_au.isChecked())

  350.         settings.setValue("PluginDatabase/SearchSF2", self.ui.ch_sf2.isChecked())

  351.         settings.setValue("PluginDatabase/SearchSFZ", self.ui.ch_sfz.isChecked())

  352.         settings.setValue("PluginDatabase/SearchJSFX", self.ui.ch_jsfx.isChecked())

  353.         settings.setValue("PluginDatabase/SearchNative", self.ui.ch_native.isChecked())

  354.         settings.setValue("PluginDatabase/SearchPOSIX32", self.ui.ch_posix32.isChecked())

  355.         settings.setValue("PluginDatabase/SearchPOSIX64", self.ui.ch_posix64.isChecked())

  356.         settings.setValue("PluginDatabase/SearchWin32", self.ui.ch_win32.isChecked())

  357.         settings.setValue("PluginDatabase/SearchWin64", self.ui.ch_win64.isChecked())

  358.         settings.setValue("PluginDatabase/DoChecks", self.ui.ch_do_checks.isChecked())

  359. 

  360.     # -----------------------------------------------------------------------------------------------------------------

  361. 

  362.     @pyqtSlot()

  363.     def slot_start(self):

  364.         self.ui.progressBar.setMinimum(0)

  365.         self.ui.progressBar.setMaximum(100)

  366.         self.ui.progressBar.setValue(0)

  367.         self.ui.b_start.setEnabled(False)

  368.         self.ui.b_skip.setVisible(True)

  369.         self.ui.b_close.setVisible(False)

  370.         self.ui.group_types.setEnabled(False)

  371.         self.ui.group_options.setEnabled(False)

  372. 

  373.         if gCarla.utils:

  374.             if self.ui.ch_do_checks.isChecked():

  375.                 gCarla.utils.unsetenv("CARLA_DISCOVERY_NO_PROCESSING_CHECKS")

  376.             else:

  377.                 gCarla.utils.setenv("CARLA_DISCOVERY_NO_PROCESSING_CHECKS", "true")

  378. 

  379.         native, posix32, posix64, win32, win64 = (self.ui.ch_native.isChecked(),

  380.                                                   self.ui.ch_posix32.isChecked(), self.ui.ch_posix64.isChecked(),

  381.                                                   self.ui.ch_win32.isChecked(), self.ui.ch_win64.isChecked())

  382. 

  383.         ladspa, dssi, lv2, vst, vst3, au, sf2, sfz, jsfx = (self.ui.ch_ladspa.isChecked(), self.ui.ch_dssi.isChecked(),

  384.                                                             self.ui.ch_lv2.isChecked(), self.ui.ch_vst.isChecked(),

  385.                                                             self.ui.ch_vst3.isChecked(), self.ui.ch_au.isChecked(),

  386.                                                             self.ui.ch_sf2.isChecked(), self.ui.ch_sfz.isChecked(),

  387.                                                             self.ui.ch_jsfx.isChecked())

  388. 

  389.         self.fThread.setSearchBinaryTypes(native, posix32, posix64, win32, win64)

  390.         self.fThread.setSearchPluginTypes(ladspa, dssi, lv2, vst, vst3, au, sf2, sfz, jsfx)

  391.         self.fThread.start()

  392. 

  393.     # -----------------------------------------------------------------------------------------------------------------

  394. 

  395.     @pyqtSlot()

  396.     def slot_skip(self):

  397.         killDiscovery()

  398. 

  399.     # -----------------------------------------------------------------------------------------------------------------

  400. 

  401.     @pyqtSlot()

  402.     def slot_checkTools(self):

  403.         enabled1 = bool(self.ui.ch_native.isChecked() or

  404.                         self.ui.ch_posix32.isChecked() or self.ui.ch_posix64.isChecked() or

  405.                         self.ui.ch_win32.isChecked() or self.ui.ch_win64.isChecked())

  406. 

  407.         enabled2 = bool(self.ui.ch_ladspa.isChecked() or self.ui.ch_dssi.isChecked() or

  408.                         self.ui.ch_lv2.isChecked() or self.ui.ch_vst.isChecked() or

  409.                         self.ui.ch_vst3.isChecked() or self.ui.ch_au.isChecked() or

  410.                         self.ui.ch_sf2.isChecked() or self.ui.ch_sfz.isChecked() or

  411.                         self.ui.ch_jsfx.isChecked())

  412. 

  413.         self.ui.b_start.setEnabled(enabled1 and enabled2)

  414. 

  415.     # -----------------------------------------------------------------------------------------------------------------

  416. 

  417.     @pyqtSlot(float, str)

  418.     def slot_handlePluginLook(self, percent, plugin):

  419.         self.ui.progressBar.setFormat(plugin)

  420.         self.ui.progressBar.setValue(int(percent))

  421. 

  422.     # -----------------------------------------------------------------------------------------------------------------

  423. 

  424.     @pyqtSlot()

  425.     def slot_handlePluginThreadFinished(self):

  426.         self.ui.progressBar.setMinimum(0)

  427.         self.ui.progressBar.setMaximum(1)

  428.         self.ui.progressBar.setValue(1)

  429.         self.ui.progressBar.setFormat(self.tr("Done"))

  430.         self.ui.b_start.setEnabled(True)

  431.         self.ui.b_skip.setVisible(False)

  432.         self.ui.b_close.setVisible(True)

  433.         self.ui.group_types.setEnabled(True)

  434.         self.ui.group_options.setEnabled(True)

  435. 

  436.     # -----------------------------------------------------------------------------------------------------------------

  437. 

  438.     def closeEvent(self, event):

  439.         if self.fThread.isRunning():

  440.             self.fThread.stop()

  441.             killDiscovery()

  442.             #self.fThread.terminate()

  443.             self.fThread.wait()

  444. 

  445.         if self.fThread.hasSomethingChanged():

  446.             self.accept()

  447.         else:

  448.             self.reject()

  449. 

  450.         QDialog.closeEvent(self, event)

  451. 

  452. # ---------------------------------------------------------------------------------------------------------------------

  453. # Testing

  454. 

  455. if __name__ == '__main__':

  456.     import sys

  457.     # pylint: disable=ungrouped-imports

  458.     from PyQt5.QtWidgets import QApplication

  459.     # pylint: enable=ungrouped-imports

  460. 

  461.     class _host:

  462.         pathBinaries = ""

  463.         showPluginBridges = False

  464.         showWineBridges = False

  465.     _host = _host()

  466. 

  467.     _app = QApplication(sys.argv)

  468.     _gui = PluginRefreshW(None, _host, True, False)

  469.     _app.exec_()

  470. 

  471. # ---------------------------------------------------------------------------------------------------------------------