Fraxinus
16.5.0-fx-rc6
An IGT application
|
In general there are two ways to customize CustusX to suit your own needs: Creating plugins and creating a new application.
The Plugin Framework is the tool to use for developers wanting to extend the system with their own features. By creating a plugin that implements some of the extension point services, the feature will be automatically added to the build system.
A new plugin in the source/plugins folder will be automatically detected and added to the build system. You might have to enable the new option in cmake:
CX_ORG_CUSTUSX_SOME_PLUGIN_NAME
Look at an existing plugin and read the documentation on OSGii before starting.
The Extension Points are used to insert features into the existing system. The simplest and most generic is the cx::GUIExtenderService, which enables you to add widgets to the cx::MainWindow.
The cx::MainWindow is the standard frontend for CustusX. However, it is possible create another frontend and rather use CustusX as a toolkit.
New applications can be added by creating a new application under source/apps.
Start out by copying the code in source/apps/CustusX and adapt it to your own needs. The system assumes that cx::LogicManager is initialized/shutdown normally. Override the GUI by inserting a cx::ApplicationComponent into the cx::LogicManager, as the CustusX application does.
The default application for the install can also be changed, by setting the two cmake variables
CX_SYSTEM_BASE_NAME CX_SYSTEM_DEFAULT_APPLICATION
Alternatively, set the variable
cxInstallData.py/Common/system_base_name
in the superbuild script.