User Reference:Operator.ini

From BCI2000 Wiki
Jump to navigation Jump to search

Operator.ini is a configuration file located in the same directory as the Operator module. It contains information such as window positions, button labels, and button scripts.

Format

Operator.ini is a typical .ini file consisting of headings ("Sections") and entries ("Values"). For individual sections, values are unique, and may appear in any order. Value names may consist of multiple levels like file system paths, with a backslash \ as a separator.

Moving between machines

It is possible to move Operator.ini files between BCI2000 installations, and computers; note however that geometry values use an internal representation provided by Qt, and may not transfer well between BCI2000 installations based on different versions of Qt. Apart from that, windows might be located at a screen position not available on a different machine, e.g. due to multiple monitors being located at different desktop coordinates. BCI2000 tries to handle such edge cases gracefully by moving windows onto the main monitor. If the result is undesired but you still want to use other settings from such an Operator.ini file, just remove all geometry values from the file, retaining the ones you want to keep.

Sections

Config

MainWindow\Geometry

The Operator's main window size and position, as provided by Qt's QWidget::saveGeometry() function.

SysLog\Geometry

The Sys Log window size and position, as provided by Qt's QWidget::saveGeometry() function.

ConfigWindow\Geometry

The Config Window window size and position, as provided by Qt's QWidget::saveGeometry() function.

WatchesWindow\Geometry

The Watches window size and position, as provided by Qt's QWidget::saveGeometry() function.

WatchesWindow\State

The Watches window's splitter position, as provided by Qt's QSplitter::saveState() function.

Scripts\AfterModulesConnected

Scripts\OnExit

Scripts\OnSetConfig

Scripts\OnResume

Scripts\OnSuspend

Scripts\OnStart

Scripts\OnShutdown

Operator scripts as configured on the Operator's Preferences Dialog.

Buttons\Button1Name

Buttons\Button2Name

Buttons\Button3Name

Buttons\Button4Name

Button names as configured on the Operator's Preferences Dialog.

Buttons\Button1Cmd

Buttons\Button2Cmd

Buttons\Button3Cmd

Buttons\Button4Cmd

Button scripts as configured on the Operator's Preferences Dialog.

Various\GlobalUserLevel

A number between 1 and 3, representing the global user level as configured on the Operator's Preferences Dialog. The numbers represent user competence in ascending order: 1: Beginner, 2: Intermediate, 3: Advanced.

Parameters

In this section, user levels for individual parameters are stored. Whenever a parameter's user level exceeds the globally set user level, it will be omitted from the parameter configuration dialog. The entries's name consists of the parameter's name, and the string "UserLevel", separated by a backslash.