PsychDebugWindowConfiguration

Psychtoolbox › PsychOneliners

Switch PTB's onscreen window into a display mode suitable for easy debugging on single-screen setups.

This function allows to setup Screen onscreen windows to be
half-transparent, so one can simultaneously see the stimulus display and
the Matlab window and other GUI windows.

Usage: PsychDebugWindowConfiguration([opaqueForHID=0][, opacity=0.5])

To enable: Call PsychDebugWindowConfiguration before the Screen('OpenWindow',...) call!
To disable: Type "clear Screen"

The optional parameter 'opaqueForHID' if set to a non-zero value will
disallow mouse clicks and other mouse actions to "get through" to the
GUI, ie., it will make the onscreen window opaque to the mouse pointer.

A setting of -1 will disable the debug mode again.

The optional parameter 'opacity' controls how opaque the onscreen window
is, in a range of 0.0 to 1.0 for 0% to 100% opacity. By default the
window is 50% opaque (or 50% transparent if you like).

Stimulus onset timing and timestamping will be inaccurate in this mode
and graphics performance will be reduced! Don't use for timing tests or
during real experiment sessions!

This feature will only work reliably - or at all - if your operating
system is running with a compositing window manager installed and
enabled. This is the case for Windows Vista, Windows-7 and later MS
operating systems, MacOS/X, and GNU/Linux distributions that have the
Compiz window manager installed and enabled, e.g., Ubuntu-9.1 and later.

Keyboard and mouse input may not work as expected under all conditions,
i.e., it may by impaired in either Psychtoolbox, or for the other running
applications. Good luck!