Update Stimulus Display

Description

Commit pending changes to the display queue, and trigger a redraw of the stimulus display. On the next display refresh, any stimuli that have been queued will be drawn, and any stimuli that have been dequeued will not be drawn (and thus will be erased if they were previously visible).

Note: Before completing, this action waits for all drawing commands to be submitted to the graphics hardware. However, it does not wait for the actual display update to occur. If your experiment must coordinate other actions with the actual display update, it will need to wait until the time provided by predicted_output_time.

Signature

action/update_stimulus_display

Alias:

action/update_display

Optional Parameters

display

Name of the display. If omitted, the default display (if available) will be used.

predicted_output_time

Name of a variable in which to store the predicted output time of the frame in which the action will take effect. This time is the operating system’s best guess for when the rendered frame will start to appear on screen.

Placement

Allowed at top level:

No

Allowed parent:

Block, Conditionally Execute Actions (if), List, On Exit, Protocol, Render Actions, Repeat Actions (while), Schedule Actions, Task System State, Trial, Unconditionally Execute Actions (else), Variable