Update Stimuli Display: Link & minor code adjustments authored by Fabian Berg's avatar Fabian Berg
This chapter contains functions you need to use when presenting text, image stimuli, or videos on a presentation screen. For presentation of sound stimuli these functions are not essential. Remember to store all your stimuli in the stimuli folder to get a better overview in the file structure! This chapter contains functions you need to use when presenting text, image stimuli, or videos on a presentation screen. For presentation of [sound](Sound Options) stimuli these functions are not essential. Remember to store all your stimuli in the stimuli folder to get a better overview in the file structure!
[[_TOC_]] [[_TOC_]]
## initWindow ## initWindow
function: initWindow(screenNum) function: [initWindow(screenNum)](https://gitlab.ruhr-uni-bochum.de/ikn/OTBR/-/blob/master/Screen/initWindow.m)
**Description** **Description**
Initializes a Window for displaying stimuli using the OTBR Toolbox. The function initWindow optionally takes the display number as argument to place the stimulus window on the correct monitor. Initializes a Window for displaying stimuli using the OTBR Toolbox. The function [initWindow](https://gitlab.ruhr-uni-bochum.de/ikn/OTBR/-/blob/master/Screen/initWindow.m) optionally takes the display number as argument to place the stimulus window on the correct monitor.
Tipp: When testing the toolbox it is helpful to use two monitors (one for coding one for display). In this case the Windows internal screen ID number (easiest case ‘1’ or ‘2’) needs to be used to initialize the presentation window on this specific monitor. If you use only one monitor the function can be called without argument or with a ‘0’ instead of a screen number. When using two monitors and you want to have a presentation screen over both monitors you can also call the function without argument (if the extended monitor option within windows is being used). Tipp: When testing the toolbox it is helpful to use two monitors (one for coding one for display). In this case the Windows internal screen ID number (easiest case ‘1’ or ‘2’) needs to be used to initialize the presentation window on this specific monitor. If you use only one monitor the function can be called without argument or with a ‘0’ instead of a screen number. When using two monitors and you want to have a presentation screen over both monitors you can also call the function without argument (if the extended monitor option within windows is being used).
...@@ -31,33 +31,34 @@ Tipp: When testing the toolbox it is helpful to use two monitors (one for coding ...@@ -31,33 +31,34 @@ Tipp: When testing the toolbox it is helpful to use two monitors (one for coding
~~~ ~~~
**Examples** **Examples**
~~~ ~~~matlab
1. initWindow(1); 1. initWindow(1);
% open stimulus window in screen 1 % open stimulus window in screen 1
~~~ ~~~
~~~ ~~~matlab
2. initWindow; 2. initWindow;
% open stimulus window on default screen (in one monitor setups) % open stimulus window on default screen (in one monitor setups)
~~~ ~~~
**See also** **See also**
closeWindow, loadImage, showStimuli, rotateStimuli [closeWindow](/Stimuli-Display#closewindow), [loadImage](/Image-display#loadimage), [showStimuli](/Image-display#showstimuli), rotateStimuli
## closeWindow ## closeWindow
function: closeWindow function: [closeWindow](https://gitlab.ruhr-uni-bochum.de/ikn/OTBR/-/blob/master/Screen/closeWindow.m)
**Description** **Description**
Use this function to close the stimulus window, normally at the end of your experiment. Requires global WINDOW, see initWindow.m. This function can also be used to close the toolbox-windows if the handles have accidentally been deleted. All functions of closeWindow are included in the stopExperiment function. Use this function to close the stimulus window, normally at the end of your experiment. Requires global WINDOW, see [initWindow.m]((https://gitlab.ruhr-uni-bochum.de/ikn/OTBR/-/blob/master/Screen/initWindow.m)). This function can also be used to close the toolbox-windows if the handles have accidentally been deleted. All functions of [closeWindow](https://gitlab.ruhr-uni-bochum.de/ikn/OTBR/-/blob/master/Screen/closeWindow.m) are included in the [stopExperiment](https://gitlab.ruhr-uni-bochum.de/ikn/OTBR/-/blob/master/Tools/stopExperiment.m) function.
Tipp: call closeExperiment since it also checks hardware connections and resets them. Still closeWindow can be used to ONLY close the presentation window, while the user needs to close everything else by himself.
Tipp: call closeExperiment since it also checks hardware connections and resets them. Still [closeWindow](https://gitlab.ruhr-uni-bochum.de/ikn/OTBR/-/blob/master/Screen/closeWindow.m) can be used to ONLY close the presentation window, while the user needs to close everything else by himself.
**Examples** **Examples**
~~~ ~~~matlab
1. closeWindow 1. closeWindow
ans = [] ans = []
~~~ ~~~
**See also** **See also**
initWindow, stopExperiment [initWindow]((/Stimuli-Display#initwindow)), [stopExperiment](/Initialization#stopexperiment)
\ No newline at end of file