OpenSesame Plug-in: Screenshot

An OpenSesame plug-in for saving screenshots of stimuli and other screens within an experiment.

Copyright, 2024, Bob Rosbag

About

This plug-in saves screenshots of stimuli and other screens within an experiment.

The screenshots are saved in the folder of the log file, in a subfolder per capture method and subject, for example screenshots_stim_psycho/subject-1/filename.png.

This plug-in has the following options:

• Verbose mode: print the path of each saved screenshot.
• Stimulus display (PsychoPy): capture the PsychoPy window, saved in screenshots_stim_psycho. Only available with the PsychoPy backend.
• Stimulus display (PIL): capture the first monitor with PIL, saved in screenshots_stim_pil.
• Composite of all displays (PIL): capture all monitors with PIL, saved in screenshots_full_pil.
• Filename: the filename with extension; the extension determines the picture format (.png, .jpg, etc.). Variables can be used, e.g. trial_[count_trial_sequence].png. The filename can't contain a folder.

Known issues

Which capture method works depends on the operating system and the display server. Check the screenshots of a test run before you rely on them.

• Linux, X11, PsychoPy: the first screenshot of the experiment can be corrupt (dark, with a diagonal line). The plugin prevents this by reading the screen once when the first screenshot item is prepared, before the stimulus is shown. This doesn't help when the first screenshot item is prepared after its stimulus was shown, e.g. a screenshot item in a loop that directly follows the stimulus. Workaround: put a screenshot item with its own filename (e.g. dummy.png) at the start of the experiment, outside the trials, and ignore its screenshot.
• Linux, Wayland, PsychoPy: all screenshots are black. Workaround: use the PIL options, or log in to an X11 session (e.g. "Ubuntu on Xorg").
• Windows, PIL: the screenshots show the desktop behind the fullscreen experiment window. Workaround: use the PsychoPy option.
• Without a graphics card (e.g. a virtual X server such as Xvfb, which uses Mesa's software renderer), PsychoPy screenshots are black too.

License

This software is distributed under the terms of the GNU General Public License 3. The full license should be included in the file COPYING, or can be obtained from:

• http://www.gnu.org/licenses/gpl.txt

This plug-in contains works of others. Icons are derivatives of the Faenza icon theme.

Documentation

Installation instructions and documentation on OpenSesame are available on the documentation website:

• http://osdoc.cogsci.nl/