#include <Base/QTGUI/qSlicerApplication.h>

Inheritance diagram for qSlicerApplication:

Collaboration diagram for qSlicerApplication:

Public Types
typedef qSlicerCoreApplication	Superclass

Public Types inherited from qSlicerCoreApplication
enum	ApplicationAttribute { AA_DisablePython = 1000, AA_EnableTesting }

enum	ReturnCode { ExitNotRequested = -1, ExitSuccess = EXIT_SUCCESS, ExitFailure = EXIT_FAILURE }

typedef QApplication	Superclass

Public Slots
void	confirmRestart (QString reason=QString())

QString	currentLogFile () const

int	numberOfRecentLogFilesToKeep ()
	Number of recent log files to keep. Older log files are deleted automatically. More...

void	openNodeModule (vtkMRMLNode *node)

void	pauseRender ()

QStringList	recentLogFiles ()
	Paths of recent log files. More...

void	resumeRender ()

void	setHasBorderInFullScreen (bool)

void	setRenderPaused (bool pause)

Public Slots inherited from qSlicerCoreApplication
static void	restart ()

bool	unregisterResource (int handle)

Signals
void	renderPaused (bool)

void	startupCompleted ()

Signals inherited from qSlicerCoreApplication
void	invokeEventRequested (unsigned int delay, void caller, unsigned long event, void callData)

void	mrmlSceneChanged (vtkMRMLScene *mrmlScene)

Public Member Functions
Q_INVOKABLE qSlicerCommandOptions *	commandOptions () const
	Get commandOptions. More...

Q_INVOKABLE ctkErrorLogModel *	errorLogModel () const
	Get errorLogModel. More...

Q_INVOKABLE qSlicerIOManager *	ioManager ()
	Get IO Manager. More...

Q_INVOKABLE qSlicerLayoutManager *	layoutManager () const
	Set/Get layout manager. More...

virtual Q_INVOKABLE void	logApplicationInformation () const

QMainWindow *	mainWindow () const
	Return a pointer on the main window of the application if any. More...

QString	nodeModule (vtkMRMLNode *node) const
	Return the module name that is most suitable for editing the specified node. More...

virtual bool	notify (QObject receiver, QEvent event)

	qSlicerApplication (int &argc, char **argv)

Q_INVOKABLE void	setLayoutManager (qSlicerLayoutManager *layoutManager)

Q_INVOKABLE ctkSettingsDialog *	settingsDialog () const

void	setToolTipsEnabled (bool enable)
	Enable/Disable tooltips. More...

virtual	~qSlicerApplication ()

Public Member Functions inherited from qSlicerCoreApplication
virtual QString	acknowledgment () const
	Return the acknowledgment text of Slicer. More...

Q_INVOKABLE void	addModuleAssociatedNodeType (const QString &nodeClassName, const QString &moduleName)

Q_INVOKABLE QStringList	allModuleAssociatedNodeTypes () const
	List of all node types that are associated with any module. More...

void	appendEnvironmentVariable (const QString &key, const QString &value, QChar separator=';')

Q_INVOKABLE vtkSlicerApplicationLogic *	applicationLogic () const
	Get application logic. More...

QString	arch () const

virtual QString	copyrights () const
	Return the copyrights of Slicer. More...

qSlicerCoreCommandOptions *	coreCommandOptions () const
	Get coreCommandOptions. More...

Q_INVOKABLE qSlicerCoreIOManager *	coreIOManager () const
	Get the IO manager. More...

QString	defaultExtensionsInstallPath () const
	Get slicer default extensions path. More...

QString	defaultScenePath () const

Q_INVOKABLE QSettings *	defaultSettings () const

QString	defaultTemporaryPath () const
	Get slicer default temporary directory. More...

Q_INVOKABLE QProcessEnvironment	environment () const
	Returns the current environment. More...

QString	extensionsInstallPath () const
	Get slicer extension directory. More...

void	gatherExtensionsHistoryInformationOnStartup ()

QString	intDir () const

bool	isCustomMainApplication () const
	Return if main application is custom application (not Slicer). More...

bool	isEmbeddedModule (const QString &moduleFileName) const

bool	isEnvironmentVariableValueSet (const QString &key, const QString &value)
	Returns True if environment variable identified by key is set to value. More...

bool	isInstalled () const
	Return true is this instance of Slicer is running from an installed directory. More...

QString	launcherExecutableFilePath () const
	If any, return slicer launcher executable file path. More...

QString	launcherRevisionSpecificUserSettingsFilePath () const
	If any, return slicer user settings file path specific to a given revision of Slicer. More...

QString	launcherSettingsFilePath () const
	If any, return slicer launcher settings file path. More...

virtual QString	libraries () const
	Return the libraries of Slicer. More...

int	mainApplicationMajorVersion () const

int	mainApplicationMinorVersion () const

QString	mainApplicationName () const
	Return the name of the main application. More...

int	mainApplicationPatchVersion () const

QString	mainApplicationRepositoryRevision () const

QString	mainApplicationRepositoryUrl () const

int	majorVersion () const
	Return the Slicer major version number. More...

int	minorVersion () const
	Return the Slicer minor version number. More...

Q_INVOKABLE qSlicerModuleManager *	moduleManager () const
	Get the module manager. More...

Q_INVOKABLE QStringList	modulesAssociatedWithNodeType (const QString &nodeClassName) const
	List of all modules that are associated with the specified node type. More...

Q_INVOKABLE vtkMRMLScene *	mrmlScene () const
	Get MRML Scene. More...

QString	os () const

void	parseArguments (bool &exitWhenDone)

QString	platform () const

void	prependEnvironmentVariable (const QString &key, const QString &value, QChar separator=';')

	qSlicerCoreApplication (int &argc, char **argv)

Q_INVOKABLE int	registerResource (const QByteArray &data)

QString	releaseType () const
	Return the release type of this instance of Slicer. More...

Q_INVOKABLE void	removeModuleAssociatedNodeType (const QString &nodeClassName, const QString &moduleName)
	Remove association between a module and a node type. More...

QString	repositoryBranch () const

QString	repositoryRevision () const

QString	repositoryUrl () const

int	returnCode () const

Q_INVOKABLE QSettings *	revisionUserSettings () const

void	setCoreCommandOptions (qSlicerCoreCommandOptions *options)

void	setCoreIOManager (qSlicerCoreIOManager *ioManager)

void	setDefaultScenePath (const QString &path)
	Set default slicer scene directory. More...

void	setEnvironmentVariable (const QString &key, const QString &value)
	Convenient function to set an environment variable. More...

void	setExtensionsInstallPath (const QString &path)
	Set slicer extension directory. More...

void	setTemporaryPath (const QString &path)
	Set slicer temporary directory. More...

Q_INVOKABLE QSettings *	settings () const

Q_INVOKABLE void	showConsoleMessage (QString message, bool error=true) const

QString	slicerDefaultSettingsFilePath () const

QString	slicerHome () const

QString	slicerRevisionUserSettingsFilePath () const

QString	slicerSharePath () const

QString	slicerUserSettingsFilePath () const

Q_INVOKABLE QProcessEnvironment	startupEnvironment () const
	Returns the environment without the Slicer specific values. More...

QString	temporaryPath () const
	Get slicer temporary directory. More...

Q_INVOKABLE QSettings *	userSettings () const

virtual	~qSlicerCoreApplication ()

Static Public Member Functions
static qSlicerApplication *	application ()
	Return a reference to the application singleton. More...

Static Public Member Functions inherited from qSlicerCoreApplication
static qSlicerCoreApplication *	application ()
	Return a reference to the application singleton. More...

static bool	loadCaCertificates (const QString &slicerHome)

static void	loadLanguage ()

static void	loadTranslations (const QString &dir)

static void	setAttribute (qSlicerCoreApplication::ApplicationAttribute attribute, bool on=true)

static bool	testAttribute (qSlicerCoreApplication::ApplicationAttribute attribute)

Protected Member Functions
virtual void	handleCommandLineArguments ()

virtual void	handlePreApplicationCommandLineArguments ()
	Reimplemented from qSlicerCoreApplication. More...

virtual void	onSlicerApplicationLogicModified ()

void	setupFileLogging ()

Protected Member Functions inherited from qSlicerCoreApplication
	qSlicerCoreApplication (qSlicerCoreApplicationPrivate pimpl, int &argc, char *argv)

virtual void	setMRMLScene (vtkMRMLScene *scene)

Additional Inherited Members
Properties inherited from qSlicerCoreApplication
QString	arch

QString	defaultScenePath

QString	extensionsInstallPath

QString	intDir

bool	isCustomMainApplication

bool	isInstalled

QString	launcherExecutableFilePath

QString	launcherSettingsFilePath

int	mainApplicationMajorVersion

int	mainApplicationMinorVersion

QString	mainApplicationName

int	mainApplicationPatchVersion

QString	mainApplicationRepositoryRevision

QString	mainApplicationRepositoryUrl

int	majorVersion

int	minorVersion

QString	os

QString	platform

QString	releaseType

QString	repositoryBranch

QString	repositoryRevision

QString	repositoryUrl

QString	slicerDefaultSettingsFilePath

QString	slicerHome

QString	slicerRevisionUserSettingsFilePath

QString	slicerSharePath

QString	slicerUserSettingsFilePath

QString	temporaryPath

Protected Slots inherited from qSlicerCoreApplication
void	invokeEvent ()

void	onSlicerApplicationLogicRequest (vtkObject , void , unsigned long)

virtual void	onUserInformationModified ()

void	processAppLogicModified ()

void	processAppLogicReadData ()

void	processAppLogicWriteData ()

void	requestInvokeEvent (vtkObject caller, void callData)

void	scheduleInvokeEvent (unsigned int delay, void caller, unsigned long event, void callData)

void	terminate (int exitCode=qSlicerCoreApplication::ExitSuccess)
	Set the ReturnCode flag and call QCoreApplication::exit() More...

Protected Attributes inherited from qSlicerCoreApplication
QScopedPointer< qSlicerCoreApplicationPrivate >	d_ptr

Detailed Description

Definition at line 55 of file qSlicerApplication.h.

Member Typedef Documentation

◆ Superclass

typedef qSlicerCoreApplication qSlicerApplication::Superclass

Definition at line 60 of file qSlicerApplication.h.

Constructor & Destructor Documentation

◆ qSlicerApplication()

qSlicerApplication::qSlicerApplication	(	int &	argc,
		char **	argv
	)

◆ ~qSlicerApplication()

virtual qSlicerApplication::~qSlicerApplication ( )

virtual

Member Function Documentation

◆ application()

static qSlicerApplication* qSlicerApplication::application ( )

static

Return a reference to the application singleton.

◆ commandOptions()

Q_INVOKABLE qSlicerCommandOptions* qSlicerApplication::commandOptions ( ) const

Get commandOptions.

◆ confirmRestart

void qSlicerApplication::confirmRestart ( QString reason = QString() )

slot

Popup a dialog asking the user if the application should be restarted. If no reason is given, the text will default to ""Are you sure you want to restart?"

◆ currentLogFile

QString qSlicerApplication::currentLogFile ( ) const

slot

Path of the current log file

See also: recentLogFiles(), setupFileLogging()

◆ errorLogModel()

Q_INVOKABLE ctkErrorLogModel* qSlicerApplication::errorLogModel ( ) const

Get errorLogModel.

◆ handleCommandLineArguments()

virtual void qSlicerApplication::handleCommandLineArguments ( )

protectedvirtual

Process command line arguments atfer the applicaton event loop is started.

See also: handlePreApplicationCommandLineArguments(); qSlicerApplication::startupCompleted()

Reimplemented from qSlicerCoreApplication.

◆ handlePreApplicationCommandLineArguments()

virtual void qSlicerApplication::handlePreApplicationCommandLineArguments ( )

protectedvirtual

Reimplemented from qSlicerCoreApplication.

◆ ioManager()

Q_INVOKABLE qSlicerIOManager* qSlicerApplication::ioManager ( )

Get IO Manager.

◆ layoutManager()

Q_INVOKABLE qSlicerLayoutManager* qSlicerApplication::layoutManager ( ) const

Set/Get layout manager.

◆ logApplicationInformation()

virtual Q_INVOKABLE void qSlicerApplication::logApplicationInformation ( ) const

virtual

Log application information.

This function will log the following details:

Session start time
Slicer version
Operating system
Memory
CPU
Developer mode enabled
Prefer executable CLI
Additional module paths

Note: Starting the application with --application-information will also print the information to standard output.

See also: qSlicerCoreCommandOptions::displayApplicationInformation()

◆ mainWindow()

QMainWindow* qSlicerApplication::mainWindow ( ) const

Return a pointer on the main window of the application if any.

◆ nodeModule()

QString qSlicerApplication::nodeModule ( vtkMRMLNode * node ) const

Return the module name that is most suitable for editing the specified node.

◆ notify()

virtual bool qSlicerApplication::notify	(	QObject *	receiver,
		QEvent *	event
	)

virtual

Avoid some crashes due to exceptions thrown during inside event handlers (such as slots). When exceptions are thrown from slots, Qt generates this message:

Qt has caught an exception thrown from an event handler. Throwing exceptions from an event handler is not supported in Qt. You must reimplement QApplication::notify() and catch all exceptions there.

so we follow the pattern suggested here:

http://stackoverflow.com/questions/13878373/where-am-i-supposed-to-reimplement-qapplicationnotify-function

◆ numberOfRecentLogFilesToKeep

int qSlicerApplication::numberOfRecentLogFilesToKeep ( )

slot

Number of recent log files to keep. Older log files are deleted automatically.

◆ onSlicerApplicationLogicModified()

virtual void qSlicerApplication::onSlicerApplicationLogicModified ( )

protectedvirtual

Reimplemented from qSlicerCoreApplication.

◆ openNodeModule

void qSlicerApplication::openNodeModule ( vtkMRMLNode * node )

slot

Utility function that retrieve the best module for a node and trigger its associated QAction which eventually opens the module.

Note: qSlicerApplication is a temporary host for the function as it should be moved into a DataManager where module can register new node types/modules

◆ pauseRender

void qSlicerApplication::pauseRender ( )

slot

Equivalent to setRenderPaused(true)

See also: setRenderPaused

◆ recentLogFiles

QStringList qSlicerApplication::recentLogFiles ( )

slot

Paths of recent log files.

◆ renderPaused

void qSlicerApplication::renderPaused ( bool )

signal

Emitted when setRenderPaused() is called. This can be used by modules that manage their own viewers to pause and resume rendering.

See also: setRenderPaused

◆ resumeRender

void qSlicerApplication::resumeRender ( )

slot

Equivalent to setRenderPaused(false)

See also: setRenderPaused

◆ setHasBorderInFullScreen

void qSlicerApplication::setHasBorderInFullScreen ( bool )

slot

When turning on OpenGL and using the full screen mode, menus and tooltips are no longer visible. By enabling hasBorderInFullScreen, a one-pixel border is added around the window, which fixes the problem. Border has to be enabled before going to full screen mode. This method has only effect when using Qt5 on Windows. See http://doc.qt.io/qt-5/windows-issues.html#fullscreen-opengl-based-windows

◆ setLayoutManager()

Q_INVOKABLE void qSlicerApplication::setLayoutManager ( qSlicerLayoutManager * layoutManager )

◆ setRenderPaused

void qSlicerApplication::setRenderPaused ( bool pause )

slot

Calls setRenderPaused(pause) on the current layout manager. Emits pauseRenderRequested() if pause is true and resumeRenderRequested() if pause is false. The caller is responsible for making sure that each setRenderPaused(true) is paired with setRenderPaused(false).

See also: qMRMLLayoutManager::setRenderPaused()

◆ settingsDialog()

Q_INVOKABLE ctkSettingsDialog* qSlicerApplication::settingsDialog ( ) const

◆ setToolTipsEnabled()

void qSlicerApplication::setToolTipsEnabled ( bool enable )

Enable/Disable tooltips.

TODO See http://doc.trolltech.com/4.6/qapplication.html#commitData and http://doc.trolltech.com/4.6/qsessionmanager.html#allowsInteraction

◆ setupFileLogging()

void qSlicerApplication::setupFileLogging ( )

protected

Set up file logging. Creates and sets new log file and deletes the oldest one from the stored queue

◆ startupCompleted

void qSlicerApplication::startupCompleted ( )

signal

Emitted when the startup phase has been completed.

Startup is complete when all the modules have been initialized and the main window is shown to the user.

Note: If the application is started without the mainwindow, the signal is emitted after the modules are initialized.

See also: qSlicerAppMainWindow::initialWindowShown()

The documentation for this class was generated from the following file:

Base/QTGUI/qSlicerApplication.h

Public Types

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ Superclass

Constructor & Destructor Documentation

◆ qSlicerApplication()

◆ ~qSlicerApplication()

Member Function Documentation

◆ application()

◆ commandOptions()

◆ confirmRestart

◆ currentLogFile

◆ errorLogModel()

◆ handleCommandLineArguments()

◆ handlePreApplicationCommandLineArguments()

◆ ioManager()

◆ layoutManager()

◆ logApplicationInformation()

◆ mainWindow()

◆ nodeModule()

◆ notify()

◆ numberOfRecentLogFilesToKeep

◆ onSlicerApplicationLogicModified()

◆ openNodeModule

◆ pauseRender

◆ recentLogFiles

◆ renderPaused

◆ resumeRender

◆ setHasBorderInFullScreen

◆ setLayoutManager()

◆ setRenderPaused

◆ settingsDialog()

◆ setToolTipsEnabled()

◆ setupFileLogging()

◆ startupCompleted