Class: Window

core.Window(options)

new Window(options)

Window displays the various stimuli of the experiment.

It sets up a PIXI renderer, which we use to render the experiment stimuli.

Parameters:
Name Type Description
options Object
Properties
Name Type Attributes Default Description
psychoJS module:core.PsychoJS the PsychoJS instance
name string <optional>
 the name of the window
fullscr boolean <optional>
 false whether or not to go fullscreen
color Color <optional>
 Color('black') the background color of the window
units string <optional>
 'pix' the units of the window
waitBlanking boolean <optional>
 false whether or not to wait for all rendering operations to be done before flipping
autoLog boolean <optional>
 true whether or not to log
Source:

Extends

  • PsychObject

Methods

(private) _fullRefresh()

Force an update of all stimuli in this window's drawlist.
Source:

(private) _refresh()

Recompute this window's draw list and _container children for the next animation frame.
Source:

(private) _resizePixiRenderer(pjsWindow, event)

Adjust the size of the renderer and the position of the root container in response to a change in the browser's size.
Parameters:
Name Type Description
pjsWindow module:core.Window the PsychoJS Window
event
Source:

(private) _setupPixi()

Setup PIXI.

A new renderer is created and a container is added to it. The renderer's touch and mouse events are handled by the EventManager.

Source:

(private) _updateIfNeeded()

Update this window, if need be.
Source:

(private) _writeLogOnFlip()

Send all logged messages to the Logger.
Source:

adjustScreenSize()

Take the browser full screen if possible.
Source:

callOnFlip(flipCallback, …flipCallbackArgs)

Add a callback function that will run after the next screen flip, i.e. immediately after the next rendering of the Window.

This is typically used to reset a timer or clock.

Parameters:
Name Type Attributes Description
flipCallback module:core.Window~OnFlipCallback callback function.
flipCallbackArgs * <repeatable>
 arguments for the callback function.
Source:

close()

Close the window.

Note: this actually only removes the canvas used to render the experiment stimuli.

Source:

closeFullScreen()

Take the browser back from full screen if needed.
Source:

experimentEnded()

Setter for experimentEnded.
Source:

experimentEnded()

Getter for experimentEnded.
Source:

experimentHandler()

Setter for experimentHandler.
Source:

experimentHandler()

Getter for experimentHandler.
Source:

getActualFrameRate() → {number}

Estimate the frame rate.
Source:
To Do:
  • estimate the actual frame rate.
Returns:
always returns 60.0 at the moment
Type
number

logOnFlip(options, levelopt, objopt)

Log a message.

Note: the message will be time-stamped at the next call to requestAnimationFrame.

Parameters:
Name Type Attributes Default Description
options Object
Properties
Name Type Description
msg String the message to be logged
level module:util.Logger.ServerLevel <optional>
 module:util.Logger.ServerLevel.EXP the log level
obj Object <optional>
 the object associated with the message
Source:

monitorFramePeriod()

Getter for monitorFramePeriod.
Source:

render()

Render the stimuli onto the canvas.
Source:

Type Definitions

OnFlipCallback(argsopt)

Callback function for callOnFlip.
Parameters:
Name Type Attributes Description
args * <optional>
 optional arguments
Source: