Clear Stimulus Display¶
Description¶
Remove all stimuli from the display queue, and trigger a redraw of the stimulus display. On the next display refresh, only the default background will be drawn.
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/clear_stimulus_display
- Alias:
action/clear_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 |