# MovieStim¶

## Attributes¶

 MovieStim(win[, filename, units, size, pos, …]) A stimulus class for playing movies (mpeg, avi, etc…) in PsychoPy. MovieStim.win The Window object in which the MovieStim.units None, ‘norm’, ‘cm’, ‘deg’, ‘degFlat’, ‘degFlatPos’, or ‘pix’ MovieStim.pos The position of the center of the stimulus in the stimulus units MovieStim.ori The orientation of the stimulus (in degrees). MovieStim.size The size (width, height) of the stimulus in the stimulus units MovieStim.opacity Determines how visible the stimulus is relative to background MovieStim.name String or None. MovieStim.autoLog Whether every change in this stimulus should be auto logged. MovieStim.draw([win]) Draw the current frame to a particular visual.Window. MovieStim.autoDraw Determines whether the stimulus should be automatically drawn on every frame flip. MovieStim.loadMovie(filename[, log]) Load a movie from file MovieStim.play([log]) Continue a paused movie from current position. MovieStim.seek(timestamp[, log]) Seek to a particular timestamp in the movie. MovieStim.pause([log]) Pause the current point in the movie (sound will stop, current frame will not advance). MovieStim.stop([log]) Stop the current point in the movie. MovieStim.setFlipHoriz([newVal, log]) If set to True then the movie will be flipped horizontally (left-to-right). MovieStim.setFlipVert([newVal, log]) If set to True then the movie will be flipped vertically (top-to-bottom).

## Details¶

class psychopy.visual.MovieStim(win, filename='', units='pix', size=None, pos=(0.0, 0.0), ori=0.0, flipVert=False, flipHoriz=False, color=(1.0, 1.0, 1.0), colorSpace='rgb', opacity=1.0, volume=1.0, name=None, loop=False, autoLog=None, depth=0.0)[source]

A stimulus class for playing movies (mpeg, avi, etc…) in PsychoPy.

Example:

mov = visual.MovieStim(myWin, 'testMovie.mp4', flipVert=False)
print(mov.duration)
# give the original size of the movie in pixels:
print(mov.format.width, mov.format.height)

mov.draw()  # draw the current frame (automagically determined)


See MovieStim.py for demo.

Parameters
filename :

a string giving the relative or absolute path to the movie. Can be any movie that AVbin can read (e.g. mpeg, DivX)

flipVertTrue or False

If True then the movie will be top-bottom flipped

flipHorizTrue or False

If True then the movie will be right-left flipped

volume :

The nominal level is 1.0, and 0.0 is silence, see pyglet.media.Player

loopbool, optional

Whether to start the movie over from the beginning if draw is called and the movie is done.

_calcPosRendered()

DEPRECATED in 1.80.00. This functionality is now handled by _updateVertices() and verticesPix.

_calcSizeRendered()

DEPRECATED in 1.80.00. This functionality is now handled by _updateVertices() and verticesPix

_getPolyAsRendered()

DEPRECATED. Return a list of vertices as rendered.

_selectWindow(win)

Switch drawing to the specified window. Calls the window’s _setCurrent() method which handles the switch.

_set(attrib, val, op='', log=None)

DEPRECATED since 1.80.04 + 1. Use setAttribute() and val2array() instead.

_updateList()

The user shouldn’t need this method since it gets called after every call to .set() Chooses between using and not using shaders each call.

_updateVertices()

Sets Stim.verticesPix and ._borderPix from pos, size, ori, flipVert, flipHoriz

autoDraw

Determines whether the stimulus should be automatically drawn on every frame flip.

Value should be: True or False. You do NOT need to set this on every frame flip!

autoLog

Whether every change in this stimulus should be auto logged.

Value should be: True or False. Set to False if your stimulus is updating frequently (e.g. updating its position every

frame) and you want to avoid swamping the log file with

messages that aren’t likely to be useful.

contains(x, y=None, units=None)

Returns True if a point x,y is inside the stimulus’ border.

Can accept variety of input options:
• two separate args, x and y

• one arg (list, tuple or array) containing two vals (x,y)

• an object with a getPos() method that returns x,y, such

as a Mouse.

Returns True if the point is within the area defined either by its border attribute (if one defined), or its vertices attribute if there is no .border. This method handles complex shapes, including concavities and self-crossings.

Note that, if your stimulus uses a mask (such as a Gaussian) then this is not accounted for by the contains method; the extent of the stimulus is determined purely by the size, position (pos), and orientation (ori) settings (and by the vertices for shape stimuli).

See Coder demos: shapeContains.py See Coder demos: shapeContains.py

depth

DEPRECATED. Depth is now controlled simply by drawing order.

draw(win=None)[source]

Draw the current frame to a particular visual.Window.

Draw to the default win for this object if not specified. The current position in the movie will be determined automatically.

This method should be called on every frame that the movie is meant to appear.

loadMovie(filename, log=None)[source]

Parameters
filename: string

The name of the file, including path if necessary

Brings up a warning if avbin is not found on the computer. After the file is loaded MovieStim.duration is updated with the movie duration (in seconds).

name

String or None. The name of the object to be using during logged messages about this stim. If you have multiple stimuli in your experiment this really helps to make sense of log files!

If name = None your stimulus will be called “unnamed <type>”, e.g. visual.TextStim(win) will be called “unnamed TextStim” in the logs.

opacity

Determines how visible the stimulus is relative to background

The value should be a single float ranging 1.0 (opaque) to 0.0 (transparent). Operations are supported. Precisely how this is used depends on the Blend Mode.

ori

The orientation of the stimulus (in degrees).

Should be a single value (scalar). Operations are supported.

Orientation convention is like a clock: 0 is vertical, and positive values rotate clockwise. Beyond 360 and below zero values wrap appropriately.

overlaps(polygon)

Returns True if this stimulus intersects another one.

If polygon is another stimulus instance, then the vertices and location of that stimulus will be used as the polygon. Overlap detection is typically very good, but it can fail with very pointy shapes in a crossed-swords configuration.

Note that, if your stimulus uses a mask (such as a Gaussian blob) then this is not accounted for by the overlaps method; the extent of the stimulus is determined purely by the size, pos, and orientation settings (and by the vertices for shape stimuli).

See coder demo, shapeContains.py

pause(log=None)[source]

Pause the current point in the movie (sound will stop, current frame will not advance). If play() is called again both will restart.

play(log=None)[source]

Continue a paused movie from current position.

pos

The position of the center of the stimulus in the stimulus units

value should be an x,y-pair. Operations are also supported.

Example:

stim.pos = (0.5, 0)  # Set slightly to the right of center
stim.pos += (0.5, -1)  # Increment pos rightwards and upwards.
Is now (1.0, -1.0)
stim.pos *= 0.2  # Move stim towards the center.
Is now (0.2, -0.2)


Tip: If you need the position of stim in pixels, you can obtain it like this:

from psychopy.tools.monitorunittools import posToPix posPix = posToPix(stim)

seek(timestamp, log=None)[source]

Seek to a particular timestamp in the movie.

NB this does not seem very robust as at version 1.62, may crash!

setAutoDraw(val, log=None)[source]

Add or remove a stimulus from the list of stimuli that will be automatically drawn on each flip

Parameters
• val: True/False

True to add the stimulus to the draw list, False to remove it

setAutoLog(value=True, log=None)

Usually you can use ‘stim.attribute = value’ syntax instead, but use this method if you need to suppress the log message.

setContrast()[source]

Not yet implemented for MovieStim.

setDKL(newDKL, operation='')

DEPRECATED since v1.60.05: Please use the color attribute

setDepth(newDepth, operation='', log=None)

Usually you can use ‘stim.attribute = value’ syntax instead, but use this method if you need to suppress the log message

setFlipHoriz(newVal=True, log=None)[source]

If set to True then the movie will be flipped horizontally (left-to-right). Note that this is relative to the original, not relative to the current state.

setFlipVert(newVal=True, log=None)[source]

If set to True then the movie will be flipped vertically (top-to-bottom). Note that this is relative to the original, not relative to the current state.

setLMS(newLMS, operation='')

DEPRECATED since v1.60.05: Please use the color attribute

setMovie(filename, log=None)[source]

See ~MovieStim.loadMovie (the functions are identical). This form is provided for syntactic consistency with other visual stimuli.

setOpacity(newOpacity, operation='', log=None)

Usually you can use ‘stim.attribute = value’ syntax instead, but use this method if you need to suppress the log message

setOri(newOri, operation='', log=None)

Usually you can use ‘stim.attribute = value’ syntax instead, but use this method if you need to suppress the log message

setPos(newPos, operation='', log=None)

Usually you can use ‘stim.attribute = value’ syntax instead, but use this method if you need to suppress the log message.

setRGB(newRGB, operation='', log=None)

DEPRECATED since v1.60.05: Please use the color attribute

setSize(newSize, operation='', units=None, log=None)

Usually you can use ‘stim.attribute = value’ syntax instead, but use this method if you need to suppress the log message

setUseShaders(value=True, log=None)

Usually you can use ‘stim.attribute = value’ syntax instead, but use this method if you need to suppress the log message

size

The size (width, height) of the stimulus in the stimulus units

Value should be x,y-pair, scalar (applies to both dimensions) or None (resets to default). Operations are supported.

Sizes can be negative (causing a mirror-image reversal) and can extend beyond the window.

Example:

stim.size = 0.8  # Set size to (xsize, ysize) = (0.8, 0.8)
print(stim.size)  # Outputs array([0.8, 0.8])
stim.size += (0.5, -0.5)  # make wider and flatter: (1.3, 0.3)


Tip: if you can see the actual pixel range this corresponds to by looking at stim._sizeRendered

stop(log=None)[source]

Stop the current point in the movie.

The sound will stop, current frame will not advance. Once stopped the movie cannot be restarted - it must be loaded again. Use pause() if you may need to restart the movie.

units

None, ‘norm’, ‘cm’, ‘deg’, ‘degFlat’, ‘degFlatPos’, or ‘pix’

If None then the current units of the Window will be used. See Units for the window and stimuli for explanation of other options.

Note that when you change units, you don’t change the stimulus parameters and it is likely to change appearance. Example:

# This stimulus is 20% wide and 50% tall with respect to window
stim = visual.PatchStim(win, units='norm', size=(0.2, 0.5)

# This stimulus is 0.2 degrees wide and 0.5 degrees tall.
stim.units = 'deg'

useShaders

Should shaders be used to render the stimulus (typically leave as True)

If the system support the use of OpenGL shader language then leaving this set to True is highly recommended. If shaders cannot be used then various operations will be slower (notably, changes to stimulus color or contrast)

property verticesPix

This determines the coordinates of the vertices for the current stimulus in pixels, accounting for size, ori, pos and units

win
The Window object in which the

stimulus will be rendered by default. (required)

Example, drawing same stimulus in two different windows and display simultaneously. Assuming that you have two windows and a stimulus (win1, win2 and stim):

   stim.win = win1  # stimulus will be drawn in win1
stim.draw()  # stimulus is now drawn to win1
stim.win = win2  # stimulus will be drawn in win2
stim.draw()  # it is now drawn in win2
win1.flip(waitBlanking=False)  # do not wait for next
# monitor update
win2.flip()  # wait for vertical blanking.

Note that this just changes **default** window for stimulus.
You could also specify window-to-draw-to when drawing::

stim.draw(win1)
stim.draw(win2)