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 |