Configuration Files

The Cornerstone software uses two main configuration files: config.txt and screen.xml.

These are typically located in the user home directory, for user Joe, the directories would be:

  • OS X: /Users/Joe/Library/MultiTouch
  • Windows: c:\\Documents and Settings\Joe\Application Data\MultiTouch
  • Linux: /home/Joe/.MultiTouch

Config.txt

Config.txt contains the configuration of the computer vision parameters. The file consists of one or more Camera sections and a Globals section. One Camera section for each camera used to do the tracking. Starting from 1.5.2009 the configuration parameters are also stored in the configuration files automatically, and it contains the most up-to-date documentation.

Each Camera section contains the following parameters:

  • camera-brightness camera brightness
  • camera-gain camera gain
  • camera-gamma camera gamma
  • camera-keystone camera keystone parameters
  • camera-keystone-extra more keystone parameters
  • camera-lens-abc camera lens correction parameters
  • camera-shutter camera shutter speed
  • camera-widthcm width of the camera image in centimeters
  • device camera device, use "dummy" to enable dummy mode
  • devuid camera device uid
  • edgelimit-day edge limit in day mode
  • edgelimit-night edge limit in night mode
  • filter-drag
  • filter-radiuscm
  • hwdevice hardware device (USB port) where the controller for this camera is
  • lcd-brightness the brightness value of the LCD backlight. Usable range is currently 0-0.5 for table setups, and 0-0.7 for upright setups.
  • lumilimit-day day mode luminosity limit
  • lumilimit-night night mode luminosity limit
  • output-extension-matrix
  • output-offset output offset for tracked finger positions
  • output-size size of the output rectangle
  • processing-level
  • processing-lumiadapt
  • processing-mode = "night" current processing mode
  • processing-usebg use background model in processing

The Globals section can contain the following parameters:

  • camera-sync-fps the target frame rate the cameras are synced at
  • camera-sync-method use -1 to disable sync
  • camera-sync-source
  • xml-server-host the ip address to bind the XML server
  • xml-server-port the port to bind the XML server
  • binary-server-host the ip address to bind the binary server
  • binary-server-port the port to bind the binary server

Screen.xml

Screen.xml contains the parameters of where rendering will occur on multiple screens.

The screen.xml can be used to define the size of the graphics window that is used for rendering. The window can contain one or more areas that are used to position and correct multiple display devices. For example, in the case of multiple projectors, each projector will probably have their own area that it draws into inside the window. This way, each area can have their own separate keystone correction applied to them and a seamless large image can be achieved.