Stimuli-Display.md

@@ -4,6 +4,60 @@ This chapter contains functions you need to use when presenting text, image stim
 
 ## initWindow
 
+function: initWindow(screenNum)
+
+**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.  
+
+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).
+
+**Inputs**
+~~~
+   screenNum		number of screen used  
+
+                        Screen 1: corresponds to the display area of the monitor with the 
+                        Windows-internal name \\.\DISPLAY1  
+
+                        Screen 2: corresponds to the display area of the monitor with the 
+                        Windows-internal name \\.\DISPLAY2  
+
+                        Screen 0: Full screen in one monitor setups or both screens in multi 
+                        monitor setups
+~~~
+
+**Inputs-optional**
+~~~
+   displayNr		the number of the monitor used for displaying stimuli
+~~~
+
+**Examples**
+~~~
+1.  initWindow(1);
+    % open stimulus window in screen 1
+~~~
+
+~~~
+2.  initWindow;
+    % open stimulus window on default screen (in one monitor setups)
+
+~~~
+
+**See also**  
+closeWindow, loadImage, showStimuli, rotateStimuli
+
 ## closeWindow
 
-## 
\ No newline at end of file
+function: closeWindow
+
+**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. 
+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.
+
+**Examples**
+~~~
+1.  closeWindow
+    ans = []
+~~~
+
+**See also**  
+initWindow, stopExperiment