The syntax of mevislab.prefs
is as described in the
MDL Reference.
All settings must be contained in a "Settings" element like this (example):
Settings { // show windows when network is loaded RestorePanels = YES // autoreload the MDL/script files when a window of a module is opened AutoReload = YES // autosave networks when changed AutoSave = YES }
The settings file can contain any variable name. The value of a variable can be
queried from scripting with MLAB.hasVariable
,
MLAB.variable
, and MLAB.variableIsTrue
.
Variable names are case-sensitive. Besides self-defined variables, there are some
pre-defined variables for various - sometimes very specialized - purposes, which are
listed in the following table. This list does not include (with some exceptions)
variables that can also be set from the
Preferences dialog in MeVisLab.
Name | Type | Description | |||
---|---|---|---|---|---|
Development | |||||
PackagePaths | Complex |
This allows for the definition of additional user packages that should be available in MeVisLab. This attribute has two subattributes: Example: PackagePaths { pathRoot = "C:/Users/a_user/Documents/Packages" path = MyPackageGroup/MyPackage pathRoot = "C:/Users/a_user/Documents/Development/MeVisLab" path = MyOrganization/Package1 path = MyOrganization/Package2 } | |||
Logfile | File path |
Writes all console output to the specified file. You can use $(LOCAL) to reference files relative to the settings file. | |||
RestorePanels | Bool |
Shows module panels when the network is loaded. It is also available from the Preferences dialog. | |||
AutoReload | Bool |
Automatically reloads the MDL/script files of a module when a module panel is opened (recommended for fast prototyping; no explicit module "reload" is required). It is also available from Preferences dialog. | |||
AutoSave | Bool |
Automatically saves networks when changed. It is also available from Preferences dialog. | |||
VerboseScripting | Bool |
Prints messages when entering and leaving command-handling scripting functions. | |||
ShowModulesByUser | Bool |
By default, deprecated modules (or modules in other hidden module groups) do not appear in the module search. If this option is set, modules by the current user will always be shown.
| |||
ExternalDocumentationUrl | URL |
Overrides the location of the MeVisLab documentation, giving the base path
as a URL. A suitable default is, e.g.:
| |||
UserSpellcheckFile | File path |
MeVisLab has an integrated spell checker (based on Hunspell) for English text in the module help editor. With this option, users can include an extra dictionary file. | |||
PreloadModule | Module name |
With this option, modules can be loaded at startup of the IDE (created in an invisible network), which can in turn execute code and, for example, initialize preference variables. This tag can be specified multiple times. | |||
disableImmediateDebugOutputConsoleRefresh | Bool |
The MeVisLab debug console, by default, refreshes immediately after each output to remain up-to-date (for example, in the case of crashes). However, this can lead to problems with event handling and may slow down performance. Disable immediate refreshes by setting to YES; then the console is only updated when MeVisLab is idle or processes events for other reasons. | |||
General | |||||
ExtraDllLoadPaths | Directory path |
Windows only. Sets additional directories from which to load DLLs. Multiple paths can be specified, separated by “;”; this entry can also be provided more than once. It is also possible to reference environment variables in a path with
| |||
MLCacheSizeInMB | Integer |
Sets the cache size for the ML image processing (in MB). It is also available from Preferences dialog. | |||
OverrideCursorDirectory | Directory path |
Allows the specification of a directory that can contain alternative mouse cursors to be used in Inventor scenes.
See the comments in | |||
View2DEnableQtFontRendering | Bool |
Use Qt for rendering fonts in SoView2D and similar viewers if set to YES (default). Otherwise, it uses a simpler font rendering engine that lacks Unicode support. | |||
GL2DFont_DefaultSystemFont | Name |
Sets the font to use for font rendering. | |||
GLDefaultSystemFontProportional | Name |
Same as above, but only affects the simpler, not Qt-based font rendering. | |||
GlobalScaleFactor | Float |
Scales all MDL panels with this factor. Default is 1. | |||
qmlStyle | Name |
Defines the QML style to be used in the QuickView control. | |||
Deployment | |||||
ReleaseOptimized | Bool |
If set to YES, MeVisLab will not look for updated MDL/script files after the initial load. It is used for application deployment (defaults to YES for applications and NO for IDE). | |||
LowPriority | Bool |
Runs MeVisLab with a low process priority. | |||
SplashPenColor | Hex value |
Sets the color with which text is drawn on the splash screen. It must be a 6-digit hex value (without '#'). | |||
SplashHideMessages | Bool |
Hides initialization messages on the splash screen. | |||
Advanced | |||||
PythonMultiThreading | Bool |
If set to NO, it disables Python multi-threading support. Disable this in case of issues. | |||
MLRestrictMaxNumThreads | Integer |
Sets the maximum number of threads to be used by the ML image processing pipeline for standard image processing. The default is the number of virtual cores in the system. | |||
CoreMaxNumThreads | Integer |
Sets the maximum number of threads to use by the GVR framework. The default is the number of virtual cores in the system. It is also available from Preferences dialog. | |||
EnableHighPrecisionLoggingTimeStamps | Bool |
If enabled, time stamps in the log will be printed with a higher precision (the actual precision depends on the system). This can be useful if the exact timing of events is important. | |||
DisableModuleWindowsPersistence | Bool |
If this option is ON, | |||
FullscreenFlickerFix | Bool |
If set to ON, it fixes flickering of fullscreen panels with OpenGL content (for some setups). | |||
PreferReleaseModeExecutables | Bool |
If set to NO, Debug mode tools (according to the debug suffix of the executable name) will be called from MeVisLab if MeVisLab is in Debug mode. Otherwise, the faster release mode variant will always be preferred. The default is YES. | |||
StoreModuleCacheInUserLibrary | Bool |
Sets whether to store the module cache files in a directory outside the installation directory. Default is NO. | |||
DontShowIconsInMenus | Bool |
If this option is set, pop-up menus do not show icons for their entries (on some platforms this is a no-op, as there are no icons shown anyway). | |||
DisableLicenseExpirationWarning | Bool |
If this option is set, MeVisLab (and applications based on MeVisLab) will not display a warning if the current license is about to expire. |
© 2025 MeVis Medical Solutions AG