NAME

       Gromit-MPX - Presentation helper to make annotations on screen

SYNOPSIS

       gromit-mpx [options]

DESCRIPTION

       Gromit-MPX enables you to make multi-pointer annotations on your screen. It can run in the
       background and be activated on demand to let you draw  over  all  your  currently  running
       applications. The drawing will stay on screen as long as you want, you can continue to use
       your applications while the drawing is visible.
       Gromit-MPX is XInput-Aware, so if you have a  graphic  tablet  you  can  draw  lines  with
       different strength, colour, erase things, etc.
       Since  you  typically  want  to  use  the  program  you are demonstrating and highlighting
       something is a short interruption of you workflow, Gromit-MPX is  activated  by  either  a
       hotkey  or  a  repeated  invocation  of  Gromit-MPX  (the  latter  can  e.g. used by other
       applications or your windowmanager).

KEYBOARD CONTROL

       By default, Gromit-MPX grabs the "Pause" key, making it unavailable to other applications.
       (The use of "Pause" is Debian-specific: the upstream package uses "F9".  The hotkey can be
       changed using the "--key" option.)  The available shortcuts are:

       Pause  toggle painting

       SHIFT-Pause
              clear screen

       CTRL-Pause
              toggle visibility

       ALT-Pause
              quit Gromit-MPX

OPTIONS (STARTUP)

       A short summary of the available commandline arguments for invoking Gromit-MPX, see  below
       for the options to control an already running Gromit-MPX process:

       -a, --active
              start Gromit-MPX and immediately activate it.

       -k <keysym>, --key <keysym>
              will  change  the  key  used  to  grab the mouse. <keysym> can e.g. be "F9", "F12",
              "Control_R" or "Print". To determine the keysym for different keys you can use  the
              xev(1) command. You can specify "none" to prevent Gromit-MPX from grabbing a key.

       -K <keycode>, --keycode <keycode>
              will  change  the  key used to grab the mouse. Under rare circumstances identifying
              the key with the keysym can fail. You can then use the keycode to specify  the  key
              uniquely.  To  determine  the  keycode  for  different  keys you can use the xev(1)
              command.

       -d, --debug
              gives some debug output.

OPTIONS (CONTROL)

       A sort summary of the available  commandline  arguments  to  control  an  already  running
       Gromit-MPX process, see above for the options available to start Gromit-MPX.

       -q, --quit
              will cause the main Gromit-MPX process to quit.

       -t, --toggle
              will toggle the grabbing of the cursor.

       -v, --visibility
              will toggle the visibility of the window.

       -c, --clear
              will clear the screen.

BUGS

       When  there is no compositing manager such as Compiz or xcompmgr running, Gromit-MPX falls
       back to a legacy drawing mode. This may drastically slow down  your  X-Server,  especially
       when  you  draw very thin lines. It makes heavy use of the shape extension, which is quite
       expensive if you paint a complex pattern on screen. Especially terminal-programs  tend  to
       scroll incredibly slow if something is painted over their window.

AUTHORS

       Simon Budig <simon@gimp.org> Christian Beier <dontmind@freeshell.org>

       This  manual  page  was written by Pierre Chifflier <chifflier@cpe.fr> and Simon Budig for
       the original Gromit and extended for Gromit-MPX by Christian Beier.

                                        February 10, 2011                           GROMIT-MPX(1)