Plays a movie file (avi, mov, etc.). By default ends on its own when the file ends (so you don't need to set property end unless you want it to end earlier). You can set repeat if you want to change this. Note Psychtoolbox needs GStreamer (runtime) to play movies. You can download it here.

For any trial you define in an experiment script, you can make one or more 


 objects using function 


Object and input them to addTrial.

For any trial you define in an experiment script, you can make one or more 


 objects using function 


Object and input them to addTrial.

Input properties

Adjustable properties

You can allow the subject to adjust the following input properties of an object of this type during the experiment using an adjuster element. If you need to make other properties adjustable, you can copy the element type using newPbType and edit it.





No default

A string that is name of movie file to show. Include path if the file is not in the MATLAB current folder or search path (or not the first file with that name on the search path). File can be any format and codec GStreamer accepts, which should include all the major ones.


Default: 1 px in movie file = 1 px on screen

A number that is height on screen to show at (deg).

OR a string setting overall size of the movie on screen:

<cds>"fit"  <cds> – fit movie to window
<cds>"fitw" <cds> – fit movie width to window
<cds>"fith" <cds> – fit movie height to window
<cds>"fill" <cds> – fill window with movie
<cds>"px"   <cds> – native resolution: 1 pixel in movie file = 1 pixel on screen (scaled down if you use a partial screen window)

All the fit and fill options assume the movie is centered in the window.


Defaults: show whole movie image

crop is a 1x4 vector <cd>[x_tl y_tl x_br y_br]<cd> setting part of the movie image to show. + = right/down, <cd>[0 0]<cd> = top left of image. Units are px in the movie file (independent of your screen). For right and bottom you can use <cd>inf<cd> to mean that edge of the image (e.g. <cd>[0 0 inf inf]<cd> = show whole image). crop applies before properties height/position/rotation, i.e. they apply to the cropped part.


mask is the same except except it applies after properties height/position/rotation, i.e. they apply to the whole movie image and then anything outside the masked part is just not shown.


Default: start at start of file

Time in movie to start at (sec). 0 = start.


Default: normal

Play speed: +1 = normal, −1 = backward, etc. Not all play speeds are possible for all movie formats—see Psychtoolbox Screen('PlayMovie') for more information.


Default: element ends on its own when movie file ends

<cd>true<cd>/<cd>false<cd>: play indefinitely by repeating until a cue you set in property end occurs. If <cd>false<cd>, the element ends on its own at end of movie file. Or a number > 1 for more options—see Psychtoolbox Screen('PlayMovie').


Default: current system volume

A number between 0–1: 0 = no sound, 1 = current system volume. This scales the volume in your system sound settings. Mainly useful if you want different movie elements to play at different volumes.

Input properties all visual elements have


Input properties all adjuster elements have


Input properties all objects have


Record properties

PsychBench uses record properties to record information during experiments. You can't set record properties but you can see them in experiment results using input property report.