Locate and understand the configuration file

ConfigurationConfigure your input devices

Location of config file

Your configuration file is located in a platform dependant directory:

  • Linux and OSX: ~/.pymt/config
  • Windows: ...\Documents and Settings\.pymt\config

If you don't see the directory, check if you can see hidden files

Simple configuration

pymt-config-screenshot

A PyMT GUI configuration tool is available by issuing the following command from the command line :

python -m pymt.tools.config -n

The tool is not designed to handle all the input providers. This means you can't really configure your input devices except TUIO. If you are trying to use wm_touch, wm_pen, or custom inputs, please refer to the supplemental and subtly more advanced (but not at really difficult) inputs configuration documentation.

Below we give a list of all available configuration tokens and their values and meaning.

Available tokens

SectionNameDefault valueDescriptionVersion
pymtshow_fps0Display FPS information on screen
pymtlog_levelinfoSet logger level (can be "debug", "info", "warning", "error", "critical")
pymtdouble_tap_time250Maximum time to detect a double tap
pymtdouble_tap_distance20Maximum distance to detect a double tap
pymtretain_time150Maximum time to reuse an "up" touch
pymtretain_distance0Maximum distance to detect and reuse an "up" touch
pymtjitter_ignore_devices(empty)Ids of devices to not apply devices. (List of ids separated with comma, eg: "wm_touch,wm_pen")0.5
pymtjitter_distance0Maximum distance to remove jittering0.5
pymtgl_error_check1Activate error checking after each OpenGL operation
pymtlog_dirlogsDefault directory for log files
pymtlog_namepymt_m-_.txtDefault name format for log (using strftime format)
pymtlog_enable1Enable log output in files
pymtignore[] 
graphicsfbohardwareIndicate which fbo to use (can be "hardware", "software", "force-hardware")
graphicsfullscreen1Show pymt in a fullscreen window
graphicswidth640Width of the window
graphicsheight480Height of the window
graphicsvsync1Force vertical sync on the window
graphicsdisplay-1Indicate which display to use (-1 is current display, 0 is the first, 1 the second...)
graphicsline_smooth1Use line smoothing (0=disabled, 1=fastest, 2=niceest).
graphicsshow_cursor1Show cursor on fullscreen
inputdefaulttuio,127.0.0.1:3333Default TUIO provider
dumpenabled0Activate dump frame
dumpprefiximg_Prefix of dump frame
dumpformatjpegFormat of dump frame (can be "jpeg" or "png")
widgetslist_trigger_distance5Maximum distance allowed to trigger event on children in MTList widget. If the distance is more than the value, no event will be dispatched.0.5
widgetslist_friction10Friction factor for MTList0.5
widgetslist_friction_bound20Friction factor when a bound have been hit (top/down/left/right) for MTList0.5
widgetskeyboard_typevirtualCan be "real" or "virtual". If "real", virtual keyboard will be not showed by default.0.5

Removed tokens

SectionNameDefault valueDescription
pymtshow_eventstats0Show number of event call at exit
pymtfixccv0Activate anti-CCV bug (:p)