def gui_qt(*, startup_logo=False):
"""Start a Qt event loop in which to run the application.
Parameters
----------
startup_logo : bool
Show a splash screen with the napari logo during startup.
Notes
-----
This context manager is not needed if running napari within an interactive
IPython session. In this case, use the ``%gui qt`` magic command, or start
IPython with the Qt GUI event loop enabled by default by using
``ipython --gui=qt``.
"""
splash_widget = None
app = QApplication.instance()
if not app:
# if this is the first time the Qt app is being instantiated, we set
# the name, so that we know whether to raise_ in Window.show()
app = QApplication(sys.argv)
app.setApplicationName('napari')
if startup_logo:
logopath = join(dirname(__file__), '..', 'resources', 'logo.png')
splash_widget = QSplashScreen(QPixmap(logopath).scaled(400, 400))
splash_widget.show()
yield app
# if the application already existed before this function was called,
# there's no need to start it again. By avoiding unnecessary calls to
# ``app.exec_``, we avoid blocking.
if app.applicationName() == 'napari':
if splash_widget and startup_logo:
splash_widget.close()
app.exec_()
def gui_qt(*, startup_logo=False, gui_exceptions=False):
"""Start a Qt event loop in which to run the application.
Parameters
----------
startup_logo : bool, optional
Show a splash screen with the napari logo during startup.
gui_exceptions : bool, optional
Whether to show uncaught exceptions in the GUI, by default they will be
shown in the console that launched the event loop.
Notes
-----
This context manager is not needed if running napari within an interactive
IPython session. In this case, use the ``%gui qt`` magic command, or start
IPython with the Qt GUI event loop enabled by default by using
``ipython --gui=qt``.
"""
splash_widget = None
app = QApplication.instance()
if not app:
# automatically determine monitor DPI.
# Note: this MUST be set before the QApplication is instantiated
QApplication.setAttribute(Qt.AA_EnableHighDpiScaling)
# if this is the first time the Qt app is being instantiated, we set
# the name, so that we know whether to raise_ in Window.show()
app = _create_application(sys.argv)
app.setApplicationName('napari')
if startup_logo:
logopath = join(dirname(__file__), '..', 'resources', 'logo.png')
pm = QPixmap(logopath).scaled(360, 360, Qt.KeepAspectRatio,
Qt.SmoothTransformation)
splash_widget = QSplashScreen(pm)
splash_widget.show()
app._splash_widget = splash_widget
else:
app._existed = True
# instantiate the exception handler
exception_handler = ExceptionHandler(gui_exceptions=gui_exceptions)
sys.excepthook = exception_handler.handle
try:
yield app
except Exception:
exception_handler.handle(*sys.exc_info())
# if the application already existed before this function was called,
# there's no need to start it again. By avoiding unnecessary calls to
# ``app.exec_``, we avoid blocking.
# see also https://github.com/napari/napari/pull/2016
# we add 'magicgui' so that anyone using @magicgui *before* calling gui_qt
# will also have the application executed. (a bandaid for now?...)
if app.applicationName() in ('napari', 'magicgui'):
if splash_widget and startup_logo:
splash_widget.close()
app.exec_()
def gui_qt(*, startup_logo=False, gui_exceptions=False, force=False):
"""Start a Qt event loop in which to run the application.
Parameters
----------
startup_logo : bool, optional
Show a splash screen with the napari logo during startup.
gui_exceptions : bool, optional
Whether to show uncaught exceptions in the GUI, by default they will be
shown in the console that launched the event loop.
force : bool, optional
Force the application event_loop to start, even if there are no top
level widgets to show.
Notes
-----
This context manager is not needed if running napari within an interactive
IPython session. In this case, use the ``%gui qt`` magic command, or start
IPython with the Qt GUI event loop enabled by default by using
``ipython --gui=qt``.
"""
splash_widget = None
app = get_app()
if startup_logo and app.applicationName() == 'napari':
pm = QPixmap(NAPARI_ICON_PATH).scaled(360, 360, Qt.KeepAspectRatio,
Qt.SmoothTransformation)
splash_widget = QSplashScreen(pm)
splash_widget.show()
app._splash_widget = splash_widget
# instantiate the exception handler
exception_handler = ExceptionHandler(gui_exceptions=gui_exceptions)
sys.excepthook = exception_handler.handle
try:
yield app
except Exception:
exception_handler.handle(*sys.exc_info())
# if the application already existed before this function was called,
# there's no need to start it again. By avoiding unnecessary calls to
# ``app.exec_``, we avoid blocking.
# we add 'magicgui' so that anyone using @magicgui *before* calling gui_qt
# will also have the application executed. (a bandaid for now?...)
# see https://github.com/napari/napari/pull/2016
if app.applicationName() in ('napari', 'magicgui'):
if splash_widget and startup_logo:
splash_widget.close()
run(force=force, _func_name='gui_qt')
def gui_qt(*, startup_logo=False):
"""Start a Qt event loop in which to run the application.
Parameters
----------
startup_logo : bool
Show a splash screen with the napari logo during startup.
Notes
-----
This context manager is not needed if running napari within an interactive
IPython session. In this case, use the ``%gui qt`` magic command, or start
IPython with the Qt GUI event loop enabled by default by using
``ipython --gui=qt``.
"""
splash_widget = None
app = QApplication.instance()
if not app:
# automatically determine monitor DPI.
# Note: this MUST be set before the QApplication is instantiated
QApplication.setAttribute(Qt.AA_EnableHighDpiScaling)
# if this is the first time the Qt app is being instantiated, we set
# the name, so that we know whether to raise_ in Window.show()
app = _create_application(sys.argv)
app.setApplicationName('napari')
if startup_logo:
logopath = join(dirname(__file__), '..', 'resources', 'logo.png')
pm = QPixmap(logopath).scaled(360, 360, Qt.KeepAspectRatio,
Qt.SmoothTransformation)
splash_widget = QSplashScreen(pm)
splash_widget.show()
app._splash_widget = splash_widget
else:
app._existed = True
# instantiate the exception handler
exception_handler = ExceptionHandler()
sys.excepthook = exception_handler.handle
yield app
# if the application already existed before this function was called,
# there's no need to start it again. By avoiding unnecessary calls to
# ``app.exec_``, we avoid blocking.
if app.applicationName() == 'napari':
if splash_widget and startup_logo:
splash_widget.close()
app.exec_()
def gui_qt(*, startup_logo=False):
"""Start a Qt event loop in which to run the application.
Parameters
----------
startup_logo : bool
Show a splash screen with the napari logo during startup.
Notes
-----
This context manager is not needed if running napari within an interactive
IPython session. In this case, use the ``%gui qt`` magic command, or start
IPython with the Qt GUI event loop enabled by default by using
``ipython --gui=qt``.
"""
app = QApplication.instance() or QApplication(sys.argv)
if startup_logo:
logopath = join(dirname(__file__), '..', 'resources', 'logo.png')
splash_widget = QSplashScreen(QPixmap(logopath).scaled(400, 400))
splash_widget.show()
yield
if startup_logo:
splash_widget.close()
app.exec_()
