Application settings
Editing application settings
The application settings dialog allows users to customize application behavior.
After starting Colada, it can be accessed clicking in menu: Edit
/ Application Settings
.
General
Default directories
Scene and each type of containers are stored in separate folders. This makes convenient to load/store data.
Application startup script
Application startup script can be used to launch any custom Python code when Colada application is started.
Modules
Skip loading
Select which type of modules to not load at startup. It is also possible to start Colada by temporarily disabling those modules (not saved in settings) by passing the arguments in the command line.
For example, this command will start Colada without any CLI loaded:
Colada.exe --disable-cli-modules
Note
To see list of possible arguments type: ./Colada --help
or ./Colada.exe --help | more
on Windows.
Temporary directory
Directory where modules can store their temporary outputs if needed.
Additional module paths
List of directories scanned at startup to load additional modules. Any CLI, Loadable or scripted modules located in these paths will be loaded.
It is also possible to start Colada by temporarily adding module paths (not saved in settings) by passing the arguments in the command line.
For example this command will start Colada trying to load CLIs found in the specified directory:
Colada.exe --additional-module-paths C:\path\to\lib\Colada-X.Y\cli-modules
Modules
List of modules loaded, ignored or failed to load in Colada. An unchecked checkbox indicates that module should not be loaded (ignored) next time Colada starts. A text color code is used to describe the state of each module:
Black: module successfully loaded in Colada
Gray: module not loaded because it has been ignored (unchecked)
Red: module failed to load. There are multiple reasons why a module can fail to load.
Look at startup log outputs to have more information. If a module is not loaded in Colada (ignored or failed), all dependent modules won’t be loaded. You can verify the dependencies of a module in the tooltip of the module.
You can filter the list of modules by untoggling in the advanced (>>) panel the “To Load”, “To Ignore”, “Loaded”, “Ignored” and “Failed” buttons.
Home
Module that is shown when Colada starts up.
Favorites
List of modules that appear in the Favorites toolbar.
To add a module, drag&drop it from the Modules list above. Then use the advanced panel (>>) to reorganize/delete the modules within the toolbar.
Appearance
Style
The overall theme of Colada is controlled by the selected Style:
Colada (default): it sets the style based on theme settings set by the operating system. For example, on Windows if dark mode is turned on for apps, then the
Dark Colada
style will be used upon launching Colada. Currently, automatic detection of dark mode is not available on Linux, therefore use needs to manually selectDark Colada
style for a dark color scheme.Light Colada: application window background is bright, regardless of operating system settings.
Dark Colada: application window background is dark, regardless of operating system settings.
Developer
Developer mode
Enable some features that faciliate developer work like control for reloading, testing and editing scripted modules as well as restarting the application.
Spatial reference
To set spatial reference find one in the table and using drag&drop technique place it to input widget.
If one doesn’t want to use any spatial reference then clear current one and turn-on the checkbox Ignore coordinate transformation on failure
.
Information for Advanced Users
Settings file location
Settings are stored in *.ini files. If the settings file is found in application home directory (within organization name or domain subfolder) then that .ini file is used. This can be used for creating a portable application that contains all software and settings in a relocatable folder. Relative paths in settings files are resolved using the application home directory, and therefore are portable along with the application.
If .ini file is not found in the the application home directory then it is searched in user profile:
Windows:
%USERPROFILE%\AppData\Roaming\NA-MIC\
(typicallyC:\Users\<your_user_name>\AppData\Roaming\NA-MIC\
)Linux:
~/.config/NA-MIC/
Mac:
~/.config/www.na-mic.org/
Deleting the *.ini files restores all the settings to default.
There are two types of settings: user specific settings
and user and revision specific settings
.
User specific settings
This file is named Colada.ini
and it stores settings applying to all versions of Colada installed by the current user.
To display the exact location of this settings file, open a terminal and type:
./Colada --settings-path
On Windows:
Colada.exe --settings-path | more
or enter the following in the Python console:
slicer.app.slicerUserSettingsFilePath
User and revision specific settings
This file is named like Colada-<REVISION>.ini
and it stores settings applying to a specific revision of Colada installed by the current user.
To display the exact location of this settings file, enter the following in the Python console:
slicer.app.slicerRevisionUserSettingsFilePath
Application startup file
Each time Colada starts, it will look up for a startup script file named .slicerrc.py
. Content of this file is executed automatically at each startup of Colada.
The file is searched at multiple location and the first one that is found is used. Searched locations:
Application home folder (
slicer.app.slicerHome
)Path defined in
SLICERRC
environment variableUser profile folder (
~/.slicerrc.py
)
You can find the path to the startup script in Colada by opening in the menu: Edit / Application Settings. ‘’Application startup script’’ path is shown in the ‘’General’’ section (or running getSlicerRCFileName()
command in Colada Python console).
Runtime environment variables
The following environment variables can be set before the application is started to fine-tune its behavior:
PYTHONNOUSERSITE
: if it is set to1
then import of user site packages is disabled. For example, this will prevent Colada to reuse packages downloaded/built by Anaconda.QT_SCALE_FACTOR
: see Qt documentation. For example, font size can be reduced by runningset QT_SCALE_FACTOR=0.5
in the command console and then starting Colada in that console.QT_ENABLE_HIGHDPI_SCALING
: see Qt documentationQT_SCALE_FACTOR_ROUNDING_POLICY
: see Qt documentationQTWEBENGINE_REMOTE_DEBUGGING
: port number for Qt webengine remote debugger. Default value is1337
.SLICER_OPENGL_PROFILE
: Requested OpenGL profile. Valid values areno
(no profile),core
(core profile), andcompatibility
(compatibility profile). Default value iscompatibility
on Windows systems.SLICER_BACKGROUND_THREAD_PRIORITY
: Set priority for background processing tasks. On Linux, it may affect the entire process priority. An integer value is expected, default =20
on Linux and macOS, and-1
on Windows.SLICERRC
: Custom application startup file path. Contains a full path to a Python script. By default it is~/.slicerrc.py
(where ~ is the user profile a.k.a user home folder).SLICER_EXTENSIONS_MANAGER_SERVER_URL
: URL of the extensions manager backend with the/api
path. Default value is retrieved from the settings using the keyExtensions/ServerUrl
.SLICER_EXTENSIONS_MANAGER_FRONTEND_SERVER_URL
: URL of the extension manager frontend displaying the web page. Default value is retrieved from the settings using the keyExtensions/FrontendServerUrl
.SLICER_EXTENSIONS_MANAGER_SERVER_API
: Supported value isGirder_v1
. Default value is hard-coded toGirder_v1
.
Qt built-in command-line options
Colada application accepts standard Qt command-line arguments that specify how Qt interacts with the windowing system.
Examples of options:
-qwindowgeometry geometry
, specifies window geometry for the main window using the X11-syntax. For example:-qwindowgeometry 100x100+50+50
.-display hostname:screen_number
, switches displays on X11 and overrides theDISPLAY
environment variable.-platform windows:dpiawareness=[0|1|2]
, sets the DPI awareness on Windows.-widgetcount
, prints debug message at the end about number of widgets left undestroyed and maximum number of widgets existed at the same time.-reverse
, sets the application’s layout direction toQt::RightToLeft
.
To learn about the supported options:
Note
Since the Colada launcher is itself a Qt application and the Qt built-in command-line options are expected to only be passed to
the launched application ColadaApp-real
and not the Colada launcher, the list of arguments to filter is specified in the Main.cpp found in the commontk/AppLauncher
project.