/usr/share/psychtoolbox-3/PsychOneliners/PsychDebugWindowConfiguration.m is in psychtoolbox-3-common 3.0.11.20131230.dfsg1-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 | function PsychDebugWindowConfiguration(opaqueForHID, opacity)
% 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
% partially 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" or "clear all".
%
% 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 transparency again, but *keep all timing tests
% and timestamping disabled*.
%
% 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/8 and later MS
% operating systems, as well as MacOS/X, and most GNU/Linux distributions
% which have a compositing desktop installed and enabled, e.g., KDE,
% GNOME-2/3, Compiz, Unity.
%
% 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!
%
% History:
% 30.07.2009 mk Written.
% 15.11.2009 mk Now also for Windows and Linux.
% 22.08.2013 mk Disable any high-precision timestamping on all operating systems.
% 09.09.2013 mk No special case handling for OSX needed anymore.
if nargin < 1
opaqueForHID = [];
end
if isempty(opaqueForHID)
opaqueForHID = 0;
end
if nargin < 2
opacity=0.5;
end
% Disable high precision timestamping:
Screen('Preference', 'VBLTimestampingMode', -1);
% Skip sync tests:
Screen('Preference', 'SkipSyncTests', 2);
% Map range 0.0 - 1.0 to 0 - 499:
opacity = floor(opacity * 499);
opacity = max(min(opacity, 499), 0);
if opaqueForHID
% Set windows to be transparent, but not for mouse and keyboard:
Screen('Preference', 'WindowShieldingLevel', 1500 + opacity);
else
% Set windows to be transparent, also for mouse and keyboard:
Screen('Preference', 'WindowShieldingLevel', 1000 + opacity);
end
if opaqueForHID == -1
% Set windows to be normal, i.e., completely opaque:
Screen('Preference', 'WindowShieldingLevel', 2000);
end
return;
|