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
82
83
84
85
86
87
88
89
90
91
|
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.
% 31.12.2014 mk On Wayland, timing is expected to be good, so don't skip sync tests etc.
% 03.02.2022 mk Assume good timing also on GNOME/Ubuntu desktop with X11/Mutter.
if nargin < 1
opaqueForHID = [];
end
if isempty(opaqueForHID)
opaqueForHID = 0;
end
if nargin < 2
opacity=0.5;
end
% Can only get precise visual stimulation timing/timestamping
% on a Wayland display server for partially transparent debug windows,
% or on X11 with the Mutter desktop compositor/WM, ie. GNOME based desktop:
if ~IsWayland && ...
(isempty(strfind(getenv('XDG_CURRENT_DESKTOP'), 'GNOME')) || isempty(getenv('PSYCH_EXPERIMENTAL_NETWMTS')))
% Not Wayland or X11/Mutter/GNOME -> No good timing.
% Disable high precision timestamping:
Screen('Preference', 'VBLTimestampingMode', -1);
% Skip sync tests:
Screen('Preference', 'SkipSyncTests', 2);
end
% 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;
|
