MovieStim
¶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 stimulus will be rendered by default. |
MovieStim.units |
None, ‘norm’, ‘cm’, ‘deg’, ‘degFlat’, ‘degFlatPos’, or ‘pix’ |
MovieStim.pos |
The position of the center of the stimulus in the stimulus |
MovieStim.ori |
The orientation of the stimulus (in degrees). |
MovieStim.size |
The size (width, height) of the stimulus in the stimulus |
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). |
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)¶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: |
|
---|
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.
two separate args, x and y
one arg (list, tuple or array) containing two vals (x,y)
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)¶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)¶Load a movie from file
Parameters: |
|
---|
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)¶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)¶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)¶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)¶Add or remove a stimulus from the list of stimuli that will be automatically drawn on each flip
Parameters: |
|
---|
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
()¶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)¶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)¶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)¶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)¶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)
verticesPix
¶This determines the coordinates of the vertices for the current stimulus in pixels, accounting for size, ori, pos and units
win
¶Window
object in which theExample, 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)