Reference Guide for Task Builder 1 Zones

General Zone Settings Information

Each Zone will have a number of different setting options which appear as grey setting boxes like this: (setting)

Click on any (setting)'s box to bring up the setting's content menu. Here you input your setting content as well as choosing the content type ( StaticSpreadsheetManipulationSpreadsheet-Manipulation). Just like you would with the Zone content itself.

In this guide, for quick reference, the options available for a particular setting will be written in the setting box. See the example below for demonstration.

You can find out more about Zones in the How To: Task Builder Guide

Go To Zone Configuration Settings example:

Go To

By default, a task will always advance to the next screen in a display.

When the screen is complete, advance to screen (text)

Setting (text): Type a screen name from the current display.

When the current screen is finished, Gorilla will advance to the named screen within your current display.

Active Response

1) If a response's value matches (text), it represents the correct answer

Setting (text): Type a name of the correct answer (Static Content), or, correct answer column name (Spreadsheet Content).

Default = none; No correct answer is set, all answers will be listed as 'incorrect' in your metrics.

If set answers matching this value will be marked as 'correct' in your metrics.

2) If (1 or 0), enable sudden death (first answer recorded only). Note: Setting-1 must be set in order to use this setting.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); If the participant selects an incorrect answer the option is removed until the correct answer is chosen, at which point the participant will advance to the next screen.

If Sudden Death is set to 1 (on) the participant is only allowed a single response. Once the participant has responded the next screen is shown regardless of whether the response was correct or incorrect.

3) If (1 or 0), only score the first answer as correct Note: Setting-2 must be set to 0 for this setting to apply.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; the trial will be marked as 'correct', even if it was not the first response given.

If set to 1, trial will be marked as correct if and only if this was the first answer given.

4) Record a timeout as (text) Note: This setting only applies if a Timelimit (screen) Zone is present.

Setting (text): set the text you wish to see recorded in the metrics when the timelimit for the screen is reached before a correct response is given.

Default = none; if the timelimit is reached before a response is received, the 'response' column of your metrics will be blank.

If text is set, and the timelimit is reached before a response is received, the text is recorded under the 'response' column of your metrics.

Branching Settings

5) If correct, advance to screen (text) Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.

Upon receiving a correct response, Gorilla will advance the task to the named screen within your current display.

6) If incorrect, advance to screen (text) Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.

Upon receiving an incorrect response, Gorilla will advance the task to the named screen within your current display.

7) If timeout, advance to screen (text) Note: Setting-1 must be set in order to use this setting.

Setting (text): Type a screen name from the current display.

If there is a timelimit set and this expires before a response is received, Gorilla will advance the task to the named screen within your current display.

For worked examples and further guidance on within-task branching, see our dedicated Troubleshooting Page.

Embedded Data Settings

For a general guide to storing and using embedded data, see our walkthrough.

8) Store most recent answer as embedded data called (text)

Setting (text): Type a key-name for the embedded data.

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the most recent answer given.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching.

9) Store correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all correct responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.

10) Store incorrect answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count of all incorrect responses'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.

11) Store total answer count as embedded data called (text)

Setting (text): Type a key-name for the embedded data.

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'count total of all responses (whether correct, incorrect or timed-out)'.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.

12) Store percentage correct answers as embedded data called (text)

Setting (text): Type a key-name for the embedded data.

Default = none; No key is created, no embedded data is stored.

If set, this creates an embedded data key with the given name, this key will store the value of the 'percentage of all responses that were correct out of all total (correct, incorrect and timed-out) answers'. This value will be an integer between 0 and 100.

You can then retrieve this value later using this key name and display it in text and rich text nodes, or use it in the tree to implement conditional branching based on performance.

1) Text colour (setting)

Setting (colour): Type either a named colour (in lowercase) or a hex code to change the text colour.

Default = black.

Advanced Settings

2) Hide after (number) ms

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which the stimuli will be displayed. After this time has elapsed the stimuli will be hidden.

Default = no display time limit; The stimuli will be displayed the entire time the participant is viewing the screen containing this zone.

If set, the stimuli will be displayed until the set time has elapsed. At which point the stimuli will be hidden and no longer visible to the participant - Note: the participant will remain on the screen containing this zone until they advance to the next screen* e.g. via a Passive Response Zone.

Advanced Settings

1) Hide after (number) ms

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which the stimuli will be displayed. After this time has elapsed the stimuli will be hidden.

Default = no display time limit; The stimuli will be displayed the entire time the participant is viewing the screen containing this zone.

If set, the stimuli will be displayed until the set time has elapsed. At which point the stimuli will be hidden and no longer visible to the participant - Note: the participant will remain on the screen containing this zone until they advance to the next screen e.g. via a Passive Response Zone.

-- No Settings --

Advanced Settings

1) Hide after (number) ms

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which the stimuli will be displayed. After this time has elapsed the stimuli will be hidden.

Default = no display time limit; The stimuli will be displayed the entire time the participant is viewing the screen containing this zone.

If set, the stimuli will be displayed until the set time has elapsed. At which point the stimuli will be hidden and no longer visible to the participant - Note: the participant will remain on the screen containing this zone until they advance to the next screen e.g. via a Passive Response Zone.

2) If (setting) always show image at it's actual size.

If set, this will always display the image at its natural pixel size, rather than constraining it to the size of its containing zone. This ensures a consistent size, but may cause it to overlap other elements.

3) Set Image width to (setting) cm.

4) Set Image width to (setting) visual degrees.

1) If (1 or 0) allow participant to start media manually

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); the audio will play automatically when the participant arrives at the screen of the Web Audio Zone.

If set to 1 (on) a play button will be shown allowing the participant to manually start the media playback.

While autoplay of audio in some browsers is no longer permitted, the Web Audio zone features improved capabilities for handling this. Provided you have at least one clickable button in a screen or display prior to your audio file being played, you participants are less likely to experience disruption from Autoplay restrictions.

2) Media can be played up to (number) times

Setting (number): Type the number of times you wish the media to be re-playable.

Default = 1; the audio will play once. Note: Setting-1 must be turned on (1) in order to use this setting.

Set any number (numerical value) to limit the participant to this many plays.

If they are allowed to replay the media, a Replay button will be shown once the media has finished playing fully.

If set to 0, the media will be infinitely replayable, i.e. there is no limit to the number of times a participant can repeat this media.

3) If (1 or 0) advance when media is finished.

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

If set to 1 (on), the screen will automatically advance once the media has finished playing.

Advanced Settings

4) If (setting), provide additional metrics on audio events

Choose 1 for on or 0/unset for off. Default: 0/unset.

5) Audio format: (setting)

When playing audio files specified by embedded data, manually specify the format (usually wav or mp3) here. Default: mp3

6) Show Stop Button: (setting)

When playing audio, show a stop button allowing the audio file to be stopped. Choose 1 for on (show stop button), or 0/unset for off. Default: 0/unset

1) If (1 or 0) allow participant to start media manually

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 1 (on); the participant can manually start the media playback by clicking on the video.

If set to 0 (off); the video will play automatically when the participant arrives at the screen of the Video Zone.

Autoplay of video in some browsers is no longer permitted! To learn more about these changes and how they may affect you, review this article: Autoplay Changes

2) Media can be played up to (number) times

Setting (number): Type the number of times you wish the media to be re-playable.

Default = 1; the video will play once. Note: Setting-1 must be turned on in order to use this setting.

Set any number (numerical value) to limit the participant to this many plays.

If they are allowed to replay the media, the media can be replayed by clicking on the video once it has finished playing fully.

If set to 0, the media will be infinitely replayable, i.e. there is no limit to the number of times a participant can repeat this media.

3) If (1 or 0) advance when media is finished

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); the screen must be advanced manually by the participant via a Response Zone.

If set to 1 (on), the screen will automatically advance once the media has finished playing.

4) If (1 or 0) mute audio track in video

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); the video will not play muted.

If set to 1 (on), the video will play muted.

Note: Autoplay settings on some browsers will prevent videos with sound from playing automatically. If the video has no sound, some browsers will fail to recognise this and prevent the video from playing. If the video is explicitly muted, browsers will be less likely to prevent autoplay.

Advanced Settings

5) If (setting) , do not show the play overlay

Only applicable when using the Manual play option. If 1, will attempt to show the first frame of the video, rather than the play overlay.

6) If (setting) , loop the video once it starts playing

Choose 1 (loop) or 0. Default: 0. If set, will loop to the end of the trial - it will not respect max number of plays

7) If (setting) , provide additional metrics on video events

Choose 1 for on or 0/unset for off. Default: 0/unset. The VIDEO STARTED and VIDEO PLAYING EVENT FIRED metrics are both associated with events where the browser has either requested or thinks that the video has started playing. Following our own internal tests, we could see that this is not always the true start point for the video. ADJUSTED START TIME based on TIMEUPDATE EVENT is the true starting point for the video.

Once you turn on the additional metrics for the Video Zone, you should also receive a VIDEO ENDED EVENT FIRED metric which indicates the end of the video. However, at the moment, you have the Recording Zone advancing the screen so it could be that the video isn't actually ending.

8) Set Video width to (setting) cm

Requires Screen Calibration zone

9) Set Video width to (setting) visual degrees

Requires Screen Calibration zone

1) If (1 or 0) allow participant to start media manually

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); the video will play automatically when the participant arrives at the screen of the Embedded YouTube Zone.

If set to 1 (on) the participant can manually start the media playback by clicking on the video.

Note: If participant browser blocks autoplay then after 5 seconds the video will revert to manual play (1) method automatically.

For more details read the section 'Important Note on Autoplay' above.

2) Media can be played up to (number) times

Setting (number): Type the number of times you wish the media to be re-playable.

Default = 1; the video will play once. Note: Setting-1 must be turned on in order to use this setting.

Set any number (numerical value) to limit the participant to this many plays.

If they are allowed to replay the media, the media can be replayed by clicking on the video once it has finished playing fully.

If set to 0, the media will be infinitely replayable, i.e. there is no limit to the number of times a participant can repeat this media.

3) If (setting) mute audio track in video

Setting (1 or 0): Type 1 to mute audio track, 0 to let audio track play.

Default = 0; the video will play with audio if you do not configure this setting.

If your video is silent, set this setting to 1 to ensure that your video will be able to autoplay.

4) If (1 or 0) advance when media is finished

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); the screen must be advanced manually by the participant via a Response Zone.

If set to 1 (on), the screen will automatically advance once the media has finished playing.

-- No Settings --

The Continue Button Zone is a Passive Response Zone.

-- No Settings --

The Response Button (Text) Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here

1) If (1 or 0) , do not hide the button after press

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (Hide button on press); When the button is pressed, the button will be hidden and the participant will no longer be able to select this button as a response.

If set to 1 (Do not hide button on press); When the button is pressed, the button will not be hidden. Instead the button will remain on the screen and can be selected again by the participant.

Note: When set to 1, all the normal rules regarding Active Response Zones will still apply to this button. For example, if Active Response Setting(2) 'Sudden death' is set, the participant will still advance to the next screen after one response.

2) If (1 or 0) , allow unlimited responses (disables advance on correct response)

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); Participant will advance to the next screen as you have specified in the Active Response Settings.

If set to 1 (on); Participants can make unlimited responses. A correct answer (Active Response Setting-1) will not advance the participant to the next screen. Instead you must use a Continue Button or Timelimit (Screen) Zone (or a different active response zone (without unlimited responses) to advance the participant to the next screen.

Note: If this setting is turned on (set to 1) you must also turn setting-1 (do not hide button) on as well. If you do not also turn on setting-1 then the buttons will hide on first press and the participant will not be able to make unlimited responses.

3) If (setting) , do not advance the screen

Choose 1 (disable advance) or 0 (do not disable advance). Default: 0

The Response Text Paragraph Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

1) When clicked, record response as (text) (Mandatory)

Setting (text): Type the name-label you wish to be assigned as the recorded response identifier.

Default = none; the reaction time response will be recorded but there will be no response identifier recorded.

If set this name-label is what will be recorded in the metrics, if this button is selected as a response by a participant. This is also the label used for the purpose of determining whether the clicked button represents a correct or incorrect answer (setting-1 of Correct Answer Settings).

The Response Rich Text Paragraph Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

1) When clicked, record response as (text) (Mandatory)

Setting (text): Type the name-label you wish to be assigned as the recorded response identifier.

Default = none; the reaction time response will be recorded but there will be no response identifier recorded.

If set this name-label is what will be recorded in the metrics, if this button is selected as a response by a participant. This is also the label used for the purpose of determining whether the clicked button represents a correct or incorrect answer (setting-1 of Correct Answer Settings).

The Response Button (Image) Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

1) If (any), hide button border

Setting (any): Type any value name or number.

Default = 'empty' (off); The image button will have a border.

If any content is set (on), hide the border usually displayed around the button.

To re-enable the border once content has been added to this setting: Press the 'Clear Settings' button on this settings menu.

2) Show pressed button for (number) milliseconds Note: Pressed Button Image content must be uploaded and set in order to use this setting.

Setting (number): Type the number of milliseconds you wish the 'pressed button image' to be displayed for.

Default = 0; regardless of whether a 'Pressed Button Image' is set in the Zone content, it will not be displayed.

If set the 'pressed button image' will be shown for the set number of milliseconds, upon being pressed by the participant. This means that if the button would normally advance to the next screen, or else would normally disappear, there will be a delay of the set number of milliseconds while the 'pressed image' is shown.

3) If (1 or 0) , do not hide the button after press

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (Hide button on press); When the button is pressed, the button will be hidden and the participant will no longer be able to select this button as a response.

If set to 1 (Do not hide button on press); When the button is pressed, the button will not be hidden. Instead the button will remain on the screen and can be selected again by the participant.

Note: When set to 1, all the normal rules regarding Active Response Zones will still apply to this button. For example, if Active Response Setting(2) 'Sudden death' is set, the participant will still advance to the next screen after one response.

4) If (1 or 0) , allow unlimited responses (disables advance on correct response)

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); Participant will advance to the next screen as you have specified in the Active Response Settings.

If set to 1 (on); Participants can make unlimited responses. A correct answer (Active Response Setting-1) will not advance the participant to the next screen. Instead you must use a Continue Button or Timelimit (Screen) Zone (or a different active response zone (without unlimited responses) to advance the participant to the next screen.

Note: If this setting is turned on (set to 1) you must also turn setting-1 (do not hide button) on as well. If you do not also turn on setting-1 then the buttons will hide on first press and the participant will not be able to make unlimited responses.

5) If (setting) , do not advance the screen

Choose 1 (disable advance) or 0 (do not disable advance). Default: 0

The Rating Scale/Likert (Passive) Zone is a Passive Response Zone. Find out more about Passive Responses here.

1) If (1 or 0) require response

Setting (1 or clear (blank)): Type 1 to turn setting on, Press Clear Setting button to turn setting off.

Default = setting clear; Response is not required. Participant can advance to the next screen without submitting an answer.

If set to 1; Response is required. Participant cannot leave the Rating Scale/Likert unanswered. Participant must select an answer before continuing to next screen via a continue button etc.

The Rating Scale / Likert (Active) Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

1) If (1 or 0) allow unlimited responses (disables advance on correct response)

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Participant will advance to the next screen as you have specified in the Active Response Settings.

If set to 1; Participants can make unlimited responses. A correct answer (Active Response Setting-1) will not advance the participant to the next screen. Instead you must use a Continue Button or Timelimit (Screen) Zone (or a different active response zone) to advance the participant to the next screen.

Note:

• A Reaction time is recorded for each response selected.
• Each response will still be scored as 'Correct' if they match the value in the 'Correct Answer' Setting (Active Response Setting-1).
• If Active Response Setting-3 is enabled, only the first answer will be score as correct regardless of how many correct answers are submitted.

The Response Slider Zone is a Passive Response Zone. Find out more about Passive Responses here.

1) Use slider min value of (number)

Setting (number): Type a number to set the minimum value of the slider.

Default = 0

Set the minimum value for the slider (i.e. the value at the leftmost end).

2) Use slider max value of (number)

Setting (number): Type a number to set the maximum value of the slider.

Default = 100

Set the maximum value for the slider (i.e. the value at the rightmost end).

3) If (1 or 0), hide the slider handle until first click (this will override the two settings below)

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0

If set to 1; there is no visible 'handle' marking the start value of the slider. Settings-2 & setting-3 will be overwritten and the actual default starting value will be 0.

4) Start slider at (number) (min)

Setting (number): Type a number to set the minimum start value for the slider.

Default = 50

To start the slider at a single point; set only the minimum value for the starting position of the slider.

To start the slider at a random position within a range, use both setting-2 (min) and setting-3 (max) to define the range.

5) Start slider at (number) (max)

Setting (number): Type a number to set the maximum start value for the slider.

Default = none

To start the slider at a single point; set only setting-1 (min).

To start the slider at a random position within a range, use both setting-2 (min) and setting-3 (max) to define the range.

6) If (1 or 0), show the slider tooltip

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0

If set to 1, shows a tooltip with the current slider value, allowing your participants to see the exact value they are entering.

7) If (1 or 0), disable slider input

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0

If set to 1, disables any slider input, so the slider merely displays a value, rather than allowing the participant to enter a response.

This setting is typically used to present a slider as a stimuli used to influence a users subsequent response.

8) If (1 or 0), require response

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0

If set to 1, prevents participants from progressing to the next screen without moving the slider (giving a response).

Advanced Settings

9) Collect slider value every (number) ms

Setting (number): Type a number to collect

Default = No Default, when no number is set, the value of the slider is collected when the screen advances.

If set to a number, the slider value will be collected every x number of milliseconds, unless the value of the slider has not changed.

The minimum collection interval allowed is 100ms.

10) Set the slider step size to (number)

Setting (number): Type a number for the slider to be incremented in.

Default = 1

If set to a number, the slider value can be increased or decreased in minimum increments of that number.

The Effort Button is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

1) Require (setting) presses to fulfil the amount of effort.

Default: 1

Setting (any): specify the number of times you require the participant to click the Effort Button in order to continue.

Advanced Settings

2) If (setting) , hide button border.

Default: 0. Choose 1 (hide border) or 0 (do not hide border).

If set to 1, the border surrounding the response Effort Button will be hidden. If set to 0, the border surrounding the response Effort Button will remain (default setting).

3) If (setting) , hide the button once the effort is complete.

Default: 0. Choose 1 (hide) or 0 (do not hide).

If set to 1, the response Effort Button will be hidden after participants click it the required number of times (i.e. complete the effort). If set to 0, the response Effort Button will remain on the page after the effort is complete (default setting).

4) If (setting) , do not advance the screen.

Default: 0. Choose 1 (disable advance) or 0 (do not disable advance).

If set to 1, the response Effort Button screen will not advance the screen. If set to 0, the response Effort Button will advance the screen on completion (default setting).

The Dropdown Zone is an Passive Response Zone. Find out more about Passive Responses here.

-- No Settings --

The Keyboard Response (Single) Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

1) If (key) is pressed

Setting (key): Type the key mapping to be used for the response.

Default = None; No key is mapped to the Response Zone.

To map a key to a response: Enter the letter of the key you wish to detect (e.g. a for the A key). Alternatively, use any of the following special key mappings:

• space for the Space Bar key
• left for the Left Arrow key
• right for the Right Arrow key
• up for the Up Arrow key
• down for the Down Arrow key
• enter for the enter key
• backspace for the backspace key
• delete for the delete key

2) record response as (text) (Mandatory)

Setting (text): Type the name-label you wish to be assigned as the recorded response identifier.

Default = None; No response will be recorded in the metrics.

When set, this name-label (identifier) is what will be recorded in the metrics, if this key response is selected by the participant. This is also the label used for the purpose of determining whether the clicked button represents a correct or incorrect answer (setting-1 of Correct Answer Settings).

Advanced Settings

3) If (1 or 0) allow unlimited responses (disables advance on correct response)

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Participant will advance to the next screen as you have specified in the Active Response Settings.

If set to 1; Participants can make unlimited responses. A correct answer (Active Response Setting-1) will not advance the participant to the next screen. Instead you must use a Continue Button or Timelimit (Screen) Zone (or a different active response zone) to advance the participant to the next screen.

Note:

• A Reaction time is recorded for each response selected.
• Each response will still be scored as 'Correct' if they match the value in the 'Correct Answer' Setting (Active Response Setting-1).
• If Active Response Setting-3 is enabled, only the first answer will be score as correct regardless of how many correct answers are submitted.

The Keyboard Response (Multi) Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

1 & 3) If (key) is pressed

Setting (key): Type the key mapping to be used for the response.

Default = None; No key is mapped to the Response Zone.

To map a key to a response: Enter the letter of the key you wish to detect (e.g. a for the A key). Alternatively, use any of the following special key mappings:

• space for the Space Bar key
• left for the Left Arrow key
• right for the Right Arrow key
• up for the Up Arrow key
• down for the Down Arrow key
• enter for the enter key
• backspace for the backspace key
• delete for the delete key

2 & 4) record response as (text) (Mandatory)

Setting (text): Type the name-label you wish to be assigned as the recorded response identifier.

Default = None; No response will be recorded in the metrics.

When set, this name-label (identifier) is what will be recorded in the metrics, if this key response is selected by the participant. This is also the label used for the purpose of determining whether the clicked button represents a correct or incorrect answer (setting-1 of Correct Answer Settings).

Advanced Settings

5) If (1 or 0) allow unlimited responses (disables advance on correct response)

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Participant will advance to the next screen as you have specified in the Active Response Settings.

If set to 1; Participants can make unlimited responses. A correct answer (Active Response Setting-1) will not advance the participant to the next screen. Instead you must use a Continue Button or Timelimit (Screen) Zone (or a different active response zone) to advance the participant to the next screen.

Note:

• A Reaction time is recorded for each response selected.
• Each response will still be scored as 'Correct' if they match the value in the 'Correct Answer' Setting (Active Response Setting-1).
• If Active Response Setting-3 is enabled, only the first answer will be score as correct regardless of how many correct answers are submitted.

The Keyboard Space to Continue Zone is a Passive Response Zone. Find out more about Passive Responses here.

-- No Settings --

The Response Text Entry Zone is an Active Response Zone. Find out more about active responses and their corresponding 'Active Response' Configuration Setting Options here.

1) If (1 or 0) disable the Enter key

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Normally, the participant presses the Enter key to submit their response.

If Set to 1; the Enter key is disabled for response submission. Instead use a Continue Button Zone or a Timelimit (Screen) Zone to allow the participant to manually advance to the next screen. In this case, the value entered in to the Response Text Entry Zone will be collected as a Passive Response Zone.

2) If (1 or 0) collect reaction times after first key press (only valid if using enter key) Note: To use this, Setting-1 must be turned off (0).

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; When the answer is submitted via the entry key, the Reaction Time and Value is recorded in the metrics at this point.

If set to 1; The Reaction Time is recorded upon the first key press. Use this option when you wish to know the reaction time for a participants time to start responding.

3) If (setting) record separate metrics for first key stroke and final submission (only valid if using enter key)

Choose 1 (record separate metrics) or 0. Default: 0

4) If (1 or 0) require response

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Response is not required. Participant can submit blank/empty entries and advance the screen without submitting an answer.

If set to 1; Response is required. Participant cannot leave the response text field blank/empty. Participant must type an answer before continuing to next screen via a continue button etc.

The Response Text Entry (Multi) Zone is a Passive Response Zone. Find out more about Passive Responses here.

-- No Settings --

The Response Text Entry Area Zone is a Passive Response Zone. Find out more about Passive Responses here.

1) Number of rows to be used in the text area: (number)

Setting (number): Set the number of rows used in the text area.

Default = None. This setting must be set manually.

2) If (1 or 0) require response

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0; Response is not required. Participant can submit blank/empty entries and advance the screen without submitting an answer.

If set to 1; Response is required. Participant cannot leave the response text area blank/empty. Participant must type an answer before continuing to next screen via a continue button etc.

1) Progress bar colour (blue, grey, green, red) (colour)

Setting (colour): Type one of the 4 colours (blue, grey, green, red) you wish for your progress bar to appear.

Default = blue; the progress bar colour will be blue.

If this setting is also set to be controlled by a spreadsheet, colour can be varied between displays.

1) If (1 or 0) show feedback when response is correct

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 'Off' (0); No feedback is displayed.

If set to 1, turns on feedback: displays feedback when a correct answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.

2) If 1 or 0 show feedback when response is incorrect

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 'Off' (0). No feedback is displayed.

If set to 1, turns on feedback: displays feedback when an incorrect answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.

3) Show feedback for (number) milliseconds (Mandatory)

Setting (number): Type a numerical value for the amount of time, in milliseconds (ms), you wish feedback to be shown for.

Default = 0; No feedback will be displayed.

When set, feedback will be displayed for the specified amount of time once a response is selected by the participant.

If the screen would normally advance once the response has been entered; there will be a delay of this amount of time for the feedback to be shown before the screen is advanced. **i.e. Active Response Setting 'Sudden death' is turned on (set to 1) If the response would not normally advance the screen: the feedback will be shown for this length of time and then hidden again.

Advanced Settings

4) Percentage honesty in feedback when a response is correct (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage of honesty for 'correct' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives a correct answer, then the correct answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'correct answer' feedback presented, upon a correct answer being recorded, will be honest the specified % of time.

In the metrics: A correct response will always be recorded as correct. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.

Note 1: If you wish to use Feedback Honesty setting, you MUST turn on Sudden Death in your Active Response Settings. i.e. Active Response Setting-2 (sudden death) must be turned on (set to 1).

Note 2: Feedback Honest will not work correctly with unlimited responses - although feedback provided to participants will be dishonest (if sudden death is turned on) the dishonesty will not be recorded in the metrics.

5) Percentage honesty in feedback when response is incorrect (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage of honesty for 'incorrect' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives an incorrect answer, then the incorrect answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'incorrect answer' feedback presented, upon a incorrect answer being recorded, will be honest the specified % of time.

In the metrics: A incorrect response will always be recorded as incorrect. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.

Note 1: If you wish to use Feedback Honesty setting, you MUST turn on Sudden Death in your Active Response Settings. i.e. Active Response Setting-2 (sudden death) must be turned on (set to 1).

Note 2: Feedback Honest will not work correctly with unlimited responses - although feedback provided to participants will be dishonest (if sudden death is turned on) the dishonesty will not be recorded in the metrics.

1) If (yes or no) give feedback when response is correct

Setting (yes or no): Type yes to turn setting on, Type no to turn setting off.

Default = 'Off' (no); No feedback is displayed.

If set to yes, turns on feedback: displays feedback when a correct answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.

2) If (yes or no) give feedback when response is incorrect

Setting (yes or no): Type yes to turn setting on, Type no to turn setting off.

Default = 'Off' (no). No feedback is displayed.

If set to yes, turns on feedback: displays feedback when an incorrect answer is selected by the participant.

Note: You must have set up a correct answer in the 'Active Response Correct Answer' configuration settings for this to work.

3) Delay of (number) ms after audio feedback ends

Setting (number): Type a numerical value for the amount of time, in milliseconds (ms), you wish to delay after the audio feedback has ended.

Default = 0; No delay after feedback has finished playing, if the screen would advance it does so immediately.

When set if the screen would normally advance once the response has been entered; there will be a delay of this amount of time, after the audio feedback has finished playing, before the screen is advanced. **i.e. Active Response Setting 'Sudden death' is turned on (set to 1)

Advanced Settings

4) Percentage honesty in feedback when a response is correct (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage of honesty for 'correct' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives a correct answer, then the correct answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'correct answer' feedback presented, upon a correct answer being recorded, will be honest the specified % of time.

In the metrics: A correct response will always be recorded as correct. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.

Note 1: If you wish to use Feedback Honesty setting, you MUST turn on Sudden Death in your Active Response Settings. i.e. Active Response Setting-2 (sudden death) must be turned on (set to 1).

Note 2: Feedback Honest will not work correctly with unlimited responses - although feedback provided to participants will be dishonest (if sudden death is turned on) the dishonesty will not be recorded in the metrics.

5) Percentage honesty in feedback when response is incorrect (number)%

Setting (number): Type a numerical value between 0 and 100 to set the percentage of honesty for 'incorrect' answer feedback.

Default = 100; feedback is always (100%) honest. If the participant gives an incorrect answer, then the incorrect answer feedback will be presented 100% of the time.

If set to any value between 0 and 100 then the percentage of 'incorrect answer' feedback presented, upon a incorrect answer being recorded, will be honest the specified % of time.

In the metrics: A incorrect response will always be recorded as incorrect. The column 'dishonest' will have a 1 if the participant received dishonest feedback - and a 0 if the participant received honest feedback.

Note 1: If you wish to use Feedback Honesty setting, you MUST turn on Sudden Death in your Active Response Settings. i.e. Active Response Setting-2 (sudden death) must be turned on (set to 1).

Note 2: Feedback Honest will not work correctly with unlimited responses - although feedback provided to participants will be dishonest (if sudden death is turned on) the dishonesty will not be recorded in the metrics.

6) Audio Format (filetype)

When playing audio files that are specified by embedded data, manually specify the format of these files here. This is commonly .wav or .mp3

Default:mp3

1) If no response after (number) milliseconds, show feedback

Setting (number): Type a numerical value for the time (in milliseconds) at which feedback will be displayed if the participant has not given a correct response.

Default = 0; Feedback will not be displayed.

If set, this represents the amount of time to allow participant to respond before showing the feedback text.

2) Display feedback for (number) milliseconds (Mandatory)

Setting (number): Type a numerical value for the amount of time (in milliseconds) the feedback should be displayed for.

Default = 0; Feedback will not be displayed.

If set, this represents the duration for which a participant will be shown the feedback text.

3) If (1 or 0) end the current trial without a response

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off.

Default = 0 (off); Feedback (Speed) Zone will not auto-advance the participant to the next screen.

If set to 1, the screen will automatically advance once the feedback text has finished being displayed.

1) Show fixation cross for (number) milliseconds [Mandatory]

Setting (number): Type a value for the number of milliseconds (ms).

Amount of time the fixation cross is displayed for

2) Before and after showing the fixation cross, pause for (number) milliseconds

Setting (number): Type a value for the number of milliseconds (ms).

Default = 0; The fixation cross is shown immediately. There is no pause time before or after showing the fixation cross. Once the fixation time (setting-1) is reached the next screen appears immediately.

If set, a pause time in milliseconds will be applied to the fixation zone. The pause time will appear as a blank screen and will be displayed before and after the fixation cross.

1) Automatically advance to the next screen after (number) milliseconds [Mandatory]

Setting (number): Type a time, as a number of milliseconds (ms), for the total duration of the time-limit.

The participant will be automatically advanced to the next screen after the set amount of time has elapsed.

2) Display countdown for the last (number) milliseconds

Setting (number): Type a time, as a number of milliseconds (ms), for which a countdown clock is displayed.

Default = 0; no countdown clock is displayed.

If set to anything >0; Displays a clock and pulsing countdown for the specified amount of remaining time (to the nearest second).

Note: This time must be equal to, or less than, the overall screen timelimit set in setting-1.

1) Automatically advance to the next section after (number) milliseconds [Mandatory]

Setting (number): Type a time, in milliseconds (ms), for the total duration of the time-limit.

Default = 30000; The maximum amount of time a participant can spend on the section is 30s (30,000 ms).

Set the maximum amount of time a participant can spend on the section. Once the duration of the timelimit has elapsed, and the current screen has been finished, the participant will progress to the next display in the spreadsheet outside the time limited section.

2) Use strict timelimit mode: (setting)

Set to Yes for task to immediately advance when the timelimit expires. Default: No

1) When the screen is complete, advance to screen (text)

Setting (text): Type a screen name from the current display.

Default = None; Screen will advance as normal to the next screen in the display.

Set a screen name (within the same display). When the current screen is finished, Gorilla will then advance to the named screen within your current display.

1) When this screen is complete, jump to spreadsheet row (number)

Setting (number): Type a number of a row in your task spreadsheet.

Default = none; The task will continue as normal and will not jump to any row in the spreadsheet.

If set to anything >0; On completion of the screen the task will immediately jump to this row number.

The participant will be presented with the display contained in this row and will continue through the task spreadsheet row by row from this point onward (unless a Jump to Row Zone is met).

Note: The row number must exist in your task spreadsheet for the Jump to Row Zone to be able to function. Check the Spreadsheet Tab of your Task to check the row number you wish to reference.

2) When this screen is complete, jump (number) rows. Use negative integer to jump 'back' to a previous spreadsheet row

Setting (number): Type a number of rows in your task spreadsheet.

Default = none; The task will continue as normal and will not jump any number of rows in the spreadsheet.

If set to anything other than 0; On completion of the screen the task will immediately jump this number of rows.

The participant will be presented with the display contained in the row jumped to and will continue through the task spreadsheet row by row from this point onward (unless a Jump to Row Zone is met).

Note: The row you intend the participant to jump to must exist in your task spreadsheet for the Jump to Row Zone to be able to function.

Check the Spreadsheet Tab of your Task to check the row number you wish to reference.

Note: If setting 1 is set, setting 2 will be ignored.

1) Store an early exit as Embedded Data called (text)

Setting (text): Type a key-name for the embedded data.

Default = earlyExit; The key-name given to the embedded data will be earlyExit.

If the text is changed from the default then your new text will become the key-name of the embedded data.

Embedded data & the Branch Node: When using the embedded data from the Early Exit Zone within a Branch Node. Set the Property field to be the key-name (e.g. earlyExit) and the Value field to be True. This will allow you to branch any participant who has clicked the early exit button within your task.

Note: The early exit zone will only generate embedded data if a participant has clicked the early exit button during the task. If you also wish to branch participants who have not clicked an Early Exit button then simply create a branch with both branch node fields left empty and set this as your default branch. This will allow you to separate out participants who clicked the early exit button from those who completed the task.

See the linked examples below for a demonstration of experimental set ups using the Early Exit Zone embedded data.

-- No Settings --

1) Share the following URL (mandatory)

Setting (text): Type the URL you wish to be entered into the Facebook post.

Default = no default; If this setting is not set, the Share to Facebook button will not appear to the participant.

When this is set, the URL you give will automatically appear in the Facebook popup post area.

2) Set button label to (text)

Setting (text): Type the name-label you wish the button to have.

Default = If this setting is not set, the button will read 'Share on Facebook'.

1) Share the following URL (url) [Mandatory]

Setting (text): Type the URL you wish to be entered into the tweet.

Default = no default; If this setting is not set, the Share to Twitter button will not appear to the participant.

When this is set, the URL you give will automatically appear in the Twitter popup post area.

2) Set default tweet message to (text)

Setting (text): Type the tweet text you’d like the participant to post (this is editable by the participant).

Default = Gorilla; The word ‘Gorilla’ will precede the URL.

1) Show change blindness image for (number) milliseconds

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which each image stimuli will be displayed. Default = 0; The image stimuli will not be displayed.

When set, the image stimuli used within the Change Blindness Zone will be displayed for this duration.

2) how change blindness mask for (number) milliseconds

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which the mask image stimuli will be displayed. Default = 0; The mask stimuli will not be displayed.

When set, the mask stimuli used within the Change Blindness Zone will be displayed for this duration.

Advanced Settings

3) Set Image width to (setting) cm

Requires Screen Calibration zone

4) Set Image width to (setting) visual degrees

Requires Screen Calibration zone

1) Limit number of clicks to (number) [Mandatory]

Setting (number): Type a number to set the number of times a participant needs to click on the Image.

Default = none.

Once the participant has clicked on the image the specified number of times, Gorilla will automatically advance the participant to the next screen.

After the last click, a wait time of 250ms is implemented: This allows the participant to view the position of their last click before being moved on to the next screen.

Only clicks on the click painting zone will be recorded.

Note: If a number is not configured in this setting then the Zone will not function.

2) Click colour (red, yellow, blue or green) (string) [Mandatory]

Setting (string): Type the name, chosen from the available options (red, yellow, blue or green), for the colour you wish the dot to be.

Default = none.

When the participant clicks on the image a dot will appear, centred at the position where the participant clicked.

The dots will stay upon the image until the click limit is reached.

You must set a numerical value for the dot-size in configuration setting-3 for the dot to be visible.

Note: If a colour option is not configured in this setting then the Zone will not function.

3) Size of click (in pixels) (number)

Setting (number): Type a number to set the pixel size of the dot to be.

Default = none: When the participant clicks on the image no dot will be shown. The coordinates of the click point will still be recorded in your metrics.

Set to a number, which represents the size, in pixels, of the dot which appear on the image at the location the participant clicks.

Note that the (x,y) coordinates, recorded in your metrics, will always represent the centre of the dot. As the centre of the dot is the co-ordinates used, the dot size will not affect your data.

Click Scoring Regions

4) Scoring regions (list of pixel values)

Setting (list of pixel values): Type a comma-separated list of 5 pixel values defining the left, top, right, and bottom boundaries of the click scoring region. The fifth value is the tolerance, in pixels, for this region. The tolerance defines the distance in pixels outside each boundary that a click can fall and still be considered correct. Clicks that fall within the region defined by the boundaries plus the tolerance will be automatically marked as correct. If you wish to define multiple regions, type multiple sets of 5 values and separate the sets with semi-colons.

Default = none; by default, no regions will be marked as correct.

The top left of the image is 0,0. Therefore, a region encompassing a 10-pixel square at the top left of the image, with a 2-pixel tolerance, would be defined as follows: 0,0,10,10,2.

Screen Calibration Settings

5) Set image width to (number) cm

Setting (number): Type the number of cm you want to set the width of the Click Painting image to. To use this setting, you will need to include a Screen Calibration Zone earlier in your task.

Default = none; by default, the image will be scaled automatically according to Gorilla's defaults.

6) Set image width to (number) visual degrees

Setting (number): Type the number of visual degrees you want to set the width of the Click Painting image to. To use this setting, you will need to include a Screen Calibration Zone earlier in your task.

Default = none; by default, the image will be scaled automatically according to Gorilla's defaults.

1) Show Go No Go image for (number) milliseconds

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for which the main image stimuli will be displayed. Default = 500; The image will be shown for 500 milliseconds.

When set, the image stimuli used within the main-section of the Go/No-Go Zone will be displayed for the specified duration.

2) Wait time after image of (number) milliseconds

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration for the wait time after the main image stimuli has been shown. Default = 500; The screen will wait for 500 milliseconds.

Note: If a 'wait image' or fixation cross (setting-3) is set, then this value instead represents the duration for which the wait image or fixation cross will be shown.

If set, after the main image duration has elapsed, the 'wait image' or 'fixation cross' will be displayed for this duration. Otherwise, if no 'wait image' or fixation cross is being used, the screen will wait for this duration.

3) If (1 or 0) show a fixation cross during the wait time

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off. Default = 1 (on); A fixation cross will be shown for the duration of the wait time (Setting-2).

Note: If you wish to use this setting you must leave the content for the 'wait image' section empty.

If set to 0 (off); (and the content for the 'wait image' Zone section is empty) then nothing will be shown during the wait time.

4) Record response as (text) for No Go

Setting (text): Type a name which will be used to record a 'No-Go' response. Default = nogo; When the participant inhibits responding during a trial, the response will be recorded in the 'Response' column of your metrics as 'nogo'

For example, if you wish to mark your participants 'No-Go' response as correct for a particular trial, then in this instance you would use 'nogo' as your correct answer value in your 'ANSWER' Column for the trial in your spreadsheet. Check out the examples and tutorials below to see this in action!

5) If (1 or 0) complete full image display and wait time after user input

Setting (1 or 0): Type 1 to turn setting on, Type 0 to turn setting off. Default = 1 (on); A users response will not instantly end the trial, instead the image durations are honoured in full. i.e. Regardless of whether the participant responds or not, the 'main image' and 'wait image' (Settings 1 & 2) will be shown for their full durations.

If set to 0; then a users response will instantly end the trial and they will be advanced to the next screen within your task.

Advanced Settings

6) Set Image width to (setting) cm

Requires Screen Calibration zone

7) Set Image width to (setting) visual degrees

Requires Screen Calibration zone

1) Record response as (text) for No Go

Setting (text): Type a name which will be used to record a 'No-Go' response.

Default = none; The participants No-Go response will not be recorded.

If set to any text value: When the participant inhibits responding during a trial, the response will be recorded in the 'Response' column of your metrics as your text.

For example, if you wish to mark your participants 'No-Go' response as correct for a particular trial, then in this instance you would use 'nogo' as your correct answer value in your 'ANSWER' Column for the trial in your spreadsheet. Check out the image examples above for a demonstration of this set-up.

2) Wait time after audio (setting) ms Use this setting to add additional time after the audio has finished, before advancing the screen.

Default: 0.

3) If (yes or no) continue to end of audio stimuli after user input

Setting (yes or no): Type yes to turn setting on, Type no to turn setting off.

Default = yes (on); A users response will not instantly end the trial, instead the audio file durations are honoured in full. i.e. Regardless of whether the participant responds or not, the audio file stimuli will play to their full durations.

If set to no; then a users response will instantly end the trial and they will be advanced to the next screen within your task.

Advanced Settings

1) Audio format (filetype)

Use this setting when playing audio files specified by embedded data, to manually specify the format. This is usually .wav or.mp3

Default: .mp3

1) Record response as (text) for No Go

Setting (text): Type a name which will be used to record a 'No-Go' response.

Default = none; The participants No-Go response will not be recorded.

If set to any text value: When the participant inhibits responding during a trial, the response will be recorded in the 'Response' column of your metrics as your text.

For example, if you wish to mark your participants 'No-Go' response as correct for a particular trial, then in this instance you would use 'nogo' as your correct answer value in your 'ANSWER' Column for the trial in your spreadsheet. See the Active Response Zone settings for more information.

2) If (setting) continue to end of video stimuli after user response.

Set to Yes to continue. Default: No.

If setting is set to Yes, the video will play till the end even after participant has responded (Go).

If set to No, the video will cut off immediately upon participant's response and the task will move onto the next screen/display.

3) If (setting) mute audio track in video.

If set to 1, the video will be muted.

If 0 (default), the video will be displayed with the sound.

Advanced Settings

1) If (setting) , provide additional metrics on video events

Choose 1 for on or 0/unset for off. Default: 0/unset.

If set to 1, you will find additional information on video events in your downloaded data. These will include:

VIDEO STARTED,

VIDEO PLAYING EVENT FIRED,

VIDEO TIMEUPDATE EVENT FIRED,

ADJUSTED START TIME based on TIMEUPDATE EVENT

You might find these useful for your analysis or might want to skip them if you only need information on participant's response (Go or No Go).

If set to 0, you will not receive these additional information regarding video events.

2) Set Video width to (setting) cm

If you wish to use this setting, you will need to include a Screen Calibration zone.

3) Set Video width to (setting) visual degrees

If you wish to use this setting, you will need to include a Screen Calibration zone.

1) Use (Hold or Release) mode (either 'Hold' or 'Release') [Mandatory]

Setting (Hold or Release): Type either 'Hold' or 'Release' to choose the operation mode for the Zone. Default = none; The Zone is not set to any mode and will not listen for key presses or key releases.

If set to Hold; the Zone will listen for 'Held' key presses of the key specified in setting-2.

If set to Release; the Zone will listen for 'Released' key presses of the key specified in setting-2.

2) If (key) is pressed

Setting (key): Type the key mapping to be used for the response. Default = None; No key is mapped to the Response Zone.

To map a key to a response: Enter the letter of the key you wish to detect (e.g. a for the A key). Alternatively, use any of the following special key mappings:

• space for the Space Bar key
• left for the Left Arrow key
• right for the Right Arrow key
• up for the Up Arrow key
• down for the Down Arrow key
• enter for the enter key
• backspace for the backspace key
• delete for the delete key

3) Record response as (text)

Setting (text): Type the name-label you wish to be assigned as the recorded response identifier. Default = none; the reaction time response will be recorded but there will be no response identifier recorded.

If set this name-label is what will be recorded in the metrics, if this key is pressed/release as a response by a participant.

4) Hold button for (number) ms before advancing

Setting (number): Type a numerical value for the amount of time, in milliseconds (ms), the key should be held for before the screen will advance. Default = 0; The screen will advance immediately upon the required key being pressed. This will act like the regular keyboard response zone.

If set, the key must be held for the specified length of time, in milliseconds (ms), before the screen will advance. If the participant releases the key before the required time has elapsed an alert message will be displayed asking the participant to keep the key pressed.

1) Run as neutral trials (yes, no)

Default = no; image can be moved up and down with zooming effect.

If set to yes, images can be moved left and right (with no zooming effect) rather than up and down.

2) Run as practice trials (yes, no)

Default = no; feedback will not be displayed

If set to yes, feedback will be displayed during the trial.

3) Feedback text (yes, no)

Default = incorrect; the text displayed on an incorrect answer will be 'incorrect'.

If set to any other value, that text will be displayed instead.

4) Feedback text size ()px

Default = 14; text will be displayed at a size of 14px

If set to any other number, text will be displayed at that pixel size instead.

1) Use the (test or record) mode (choose 'test' or 'record')

Setting (test or record): Type either test or record to choose the operation mode for the Zone. Default = test; If no mode is set the Audio Recording Zone will default to the 'test' mode.

Test: In test mode the Audio Recording Zone will record audio, and allow the participant to replay the audio to check that their microphone is functioning correctly. Test mode records no metrics.

Record: In record mode the Audio Recording Zone will record participant audio and return the recorded audio to the Audio Recording Zone Metrics.

2) If (1 or 0) automatically begin recording on screen start.

Setting (1 or 0): Type either 1 to turn the setting on, or 0 to turn the setting off. Default = 0; By default, the Audio Recording Zone will begin recording when the 'Start Recording' button is pressed.

If set to 1; The Audio Recording Zone will begin recording when the screen starts.

If set to 0; The Audio Recording Zone will only begin recording when the 'Start Recording' is pressed.

3) If (1 or 0) automatically advance to the next screen when recording is complete.

Setting (1 or 0): Type either 1 to turn the setting on, or 0 to turn the setting off. Default = 1; By default, the Audio Recording Zone will automatically advance to the next screen when either the 'Stop Recording' button is pressed or the maximum recording time is reached (Configuration Setting-5).

Note: If set to 0, The screen will not advance when the participant has finished recording nor when the maximum recording time has been reached. Instead, you must also include an advancement zone (e.g. Continue Button or Timelimit (screen) Zone) or response zone on the same screen so that participants can advance the screen manually.

4) Prefix filename with (text) for captured audio

Setting (text): Type a name to identify the recorded audio file. Default = audioFile; By default, the Audio Recording Zone will produce an audio file with the filename audioFile-1-3, or similar.

If set to any text string; this changes the filename of the recorded audio file e.g. if set to TaskAudio, the file will be named TaskAudio-1-3.

Note: only use alpha-numeric characters in your file names. Do not use special characters as this could prevent you from retrieving data files.

You will likely wish to use this setting with spreadsheet 'source' if you wish to uniquely identify your recorded audio files on a 'per-trial' basis.

5) Set max recording time to (number) ms (Maximum: 120000 ms, i.e. 2min)

Setting (number): Type a duration in milliseconds (ms) to set the maximum recording time. Default = 120000; By default, the maximum recording time equals the allowed maximum of 120000 milliseconds (2 minutes).

When set, this restricts the length of an audio recording to the number of milliseconds you enter. Once the maximum recording time has been reached the Audio Recording Zone will stop recording. Maximum possible recording length is 120000 ms (2 minutes). If you need to record for longer than 2 minutes, use Setting-9 below.

This setting is particularly useful when you have set the screen to auto-record and auto-advance, as it stops the recording at the duration set allowing the screen to progress at a set time.

Advanced Settings

6) Always show stop button

Setting (text): Type Yes to always show the 'Stop Recording' button, regardless of other settings. For example, by default, if you specify a max recording time using Setting-5, the 'Stop recording' button will not be shown. You can override this default and show the 'Stop recording' button by typing Yes for this setting.

7) Store URL as embedded data called (text)

Setting (text): Type a key-name for the embedded data. Default = none; No key is created, no embedded data is stored.

If set to any text-string, this will store the recorded audio as embedded data under the given key name.

You can then retrieve this audio file later using this key name. Enter your key name as embedded data - e.g. $${myEmbeddedDataKeyName} - into a Web Audio Zone to replay the recorded audio back to the participant.

Note: Audio embedded data cannot be retrieved on a screen directly after it is recorded. There must be an intermediary screen of at least 550ms.

8) If (1 or 0) transcode audio to mp3

Setting (1 or 0): Type either 1 to turn the setting on, or 0 to turn the setting off. By default, the Audio Recording Zone will not transcode audio to mp3. Audio will be saved in .weba format.

Note: turning this setting on can be CPU intensive and may affect the timing of future trials or result in longer upload times.

9) Download to Disk

Setting (text): Type On to have the audio file automatically download and save to disk at the end of recording, instead of uploading to the Gorilla servers. By default, the Audio Recording Zone will upload recorded files to the Gorilla servers instead of downloading to disk.

This setting is useful if you need audio files to be longer than two minutes.

10) Echo cancellation

Setting (Yes or No): Type either a Yes to use Echo Cancellation (if available) or a No to turn the setting off. By default, it is off.

This setting is useful if you want to prevent other audio streams (such as from an Audio or Video zone) from entering a participant's audio recording.

1 ) Prefix filename with (text) for captured data.

Setting (text): Type a name to identify the canvas_painting image file. Default prefix: canvas_paint The full default file name will be: task-NODEKEY-XXXXXX-canvas_paint-A-B

If set to any text string; The text highlighted in bold, in the default filenames above, will be replaced with your chosen filename.

Note: only use alpha-numeric characters in your file names. Do not use special characters as this could prevent you from retrieving data files.

You will likely wish to use this setting with spreadsheet 'source' if you wish to uniquely identify your canvas painting images on a 'per-trial' basis.

Review the metrics section above for details on the default file name structure.

2) Paint brush size (in pixels): (number).

Setting (number): Type a number to set the pixel size of the paint brush. Default = 20; By default, the paint bush size will be a 20 x 20 pixel square.

If set to any number, the paint brush size will be created with a length and height matching the set value. i.e. if set to 10 the brush size will be a 10 x 10 pixel square, if set to 25 the brush size will be a 25 x 25 pixel square.

3) Colour options (Max 15): (RGB colour value).

Setting (RGB colour value): Type up to 15 RGB colour values separated by semicolons. Default = 0,255,0; (green); By default, the participant will be presented with one colour option for the brush which is RGB value '0,255,0;' representing the colour green.

Enter an individual RGB colour as three numbers separated by commas (e.g. 128,128,128;).

You can set up to 15 individual colours to form a colour palette for your participant to select from. Separate multiple colours by semi-colons. The colour palette will appear at the bottom of the Canvas, allowing participants to select the colour they wish to paint with.

See the image example above for more details on setting multiple colours including how this appears to the participant.

1) Limit number of clicks to (number)

Setting (number): Type a number to set the number of times a participant needs to click on the video. Default = 1. By default, participants will only be allowed to click once on the video.

Once the participant has clicked on the video the specified number of times, Gorilla will automatically advance the participant to the next screen.

After the last click a wait time of 250ms is implemented: This allows the participant to view the position of their last click before being moved on to the next screen.

Only clicks on the click painting zone will be recorded.

2) Click colour (red, yellow, blue or green) (string) [Mandatory]

Setting (string): Type the name, chosen from the available options (red, yellow, blue or green), for the colour you wish the dot to be.

Default = red.

When the participant clicks on the video a dot will appear, centred at the position where the participant clicked.

The dots will stay upon the video until the click limit is reached.

3) Size of click (in pixels) (number)

Setting (number): Type a number to set the pixel size of the dot to be. Default = 20: if this setting is not configured, the dot will be 20 pixels in size.

Set to a number, which represents the size, in pixels, of the dot which appear on the video at the location the participant clicks.

Note that the (x,y) coordinates, recorded in your metrics, will always represent the centre of the dot. As the centre of the dot is the co-ordinates used, the dot size will not affect your data.

Video settings

4) Allow participants to start video manually (1 or 0)

Setting (1 or 0): Type either 1 if you want the participant to click to start the video manually, or 0 if you want the video to start automatically when the screen starts.

Default = 1; by default, the participant will have to start the video manually.

5) Advance when media finishes (1 or 0)

Setting (1 or 0): Type either 1 if you want the screen to advance when the video has finished, or 0 if not.

Default: 1; by default, the screen will advance when the video has finished, even if the maximum number of clicks has not yet been reached.

Note that once the maximum number of clicks has been reached, the screen will advance even if the video has not finished playing.

6) Mute audio track (1 or 0)

Setting (1 or 0): Type either 1 if you want the audio track of the video to be muted, or 0 if you want the audio track to play.

Default: 1; by default, the audio track of any video displayed in a Click Painting (Video) Zone will be muted.

7) Add additional video metrics (1 or 0)

Setting (1 or 0): Type either 1 if you want to record additional metrics related to the video, or 0 if you do not want to record these additional metrics.

Default: 1; by default, additional video metrics will be recorded.

8) Maximum play count (number)

Setting (number): Type the number of times you want to allow the video to be played. If set to 0, the video will loop indefinitely until the maximum number of clicks is reached.

Default: 1; by default, the video will play once.

Click Scoring Regions

9) Scoring regions (list of pixel values)

Setting (list of pixel values): Type a comma-separated list of 5 pixel values defining the left, top, right, and bottom boundaries of the click scoring region. The fifth value is the tolerance, in pixels, for this region. The tolerance defines the distance in pixels outside each boundary that a click can fall and still be considered correct. Clicks that fall within the region defined by the boundaries plus the tolerance will be automatically marked as correct. If you wish to define multiple regions, type multiple sets of 5 values and separate the sets with semi-colons.

Default = none; by default, no regions will be marked as correct.

The top left of the video is 0,0. Therefore, a region encompassing a 100-pixel square at the top left of the video, with a 20-pixel tolerance, would be defined as follows: 0,0,100,100,20.

Screen Calibration Settings

10) Set image width to (number) cm

Setting (number): Type the number of cm you want to set the width of the Click Painting video to. To use this setting, you will need to include a Screen Calibration Zone earlier in your task.

Default = none; by default, the video will be scaled automatically according to Gorilla's defaults.

11) Set image width to (number) visual degrees

Setting (number): Type the number of visual degrees you want to set the width of the Click Painting video to. To use this setting, you will need to include a Screen Calibration Zone earlier in your task.

Default = none; by default, the video will be scaled automatically according to Gorilla's defaults.

1) Animation type is (choose 'Static', 'Rotation' or 'Phase')

Setting (Static or Rotation or Phase): Type either 'Static', 'Rotation' or 'Phase' to choose the Patch Type for the Zone. Default = Static; The Gabor Patch type produced will be a static image with a fixed orientation and phase.

Static - This type of Gabor Patch produces a static image with a fixed orientation and phase. Rotation - This type of Gabor Patch produces an image with a cycling orientation, so the patch rotates in place. Phase - This type of Gabor Patch produces an image where the phase changes, so the lines appear to move in a single direction.

2) Spatial frequency is (number) cycles per degree

Setting (number): Type an integer (whole number) to represent the number of cycles per visual degree on screen. Default = 1; represents a spatial frequency of 1 cycle per visual degree.

This determines the number of cycles per visual degree on screen. The number of cycles per visual degree determines how many oriented lines will be visible within the patch, and the width of these lines. The higher this value, the more lines are displayed and the more compact they will be.

You can choose any positive integer for this (so 1 not 1.2 or 0.8) if you do use a decimal number it will be rounded down to an integer.

3) Size is (number) visual degrees.

Setting (number): Type a whole number to set size of the patch in visual degrees. Default = 15; The Gabor patch will be displayed as a square of size 15 VD (visual degrees).

This determines the size, in visual degrees, that the Gabor Patch will appear on the participants screen. Note Gabor Patches will always be square so the size determines both it's height and width.

4) Gaussian SD is (number) visual degrees.

Setting (number): Type a number to set the size of the Gaussian Window in visual degrees. Default = 2; The Standard Deviation of the Gaussian Window imposed over the patch will be 2 Visual Degrees.

This setting controls the size and 'blurriness' of the Gaussian 'window' imposed over the patch. This window appears as a circular view port with a blurry edge.

The standard deviation of this window (sized in visual degrees) determines how large and blurry the window's edge will be - a higher number will lead to a larger and more blurred edge.

Note the minimum window that can be imposed is 1 VD.

5) Background RGB is (RGB color code).

Setting (number): Enter a background colour as a RGB color code. Default = 128,128,128; The Gabor patch background colour will be Grey as determined by the RGB color code 128,128,128.

This determines the background colour for the Gabor Patch which will appear behind the Gabor Patch.

You must set the color using an RGB color code where each Red, Green and Blue value is separated using a comma (','). (e.g. 128,128,128)

Note that an individual RGB value will always be a single number between 0 and 255.

6) Orientation is (number) degrees.

Setting (number): Type a number of degrees to determine the orientation of the patch lines. Default = 90; The orientation of the lines in the Gabor Patch will be at 90 degrees or vertical.

This determines the orientation of the Gabor Patch, in degrees. This is most noticeable as determining the initial direction the lines of Gabor Patch appear to be orientated.

Rotating and Phase specific settings

7) Rotation Speed is (number) degrees per second. [Rotation Patch Type Only]

Setting (number): Type a number of angular degrees for the rotation speed. Default = 10; The patch will rotate at 10 angular degrees per second.

Rotation Speed determines how fast the patch rotates. The number set represents the Rotation Speed in angular degrees per second. Or else described as the angle the patch will change per second.

The higher the Rotation Speed the faster the patch will appear to rotate. Note Patches rotate about their center point.

8) Phase speed is (number) phase fractions per second. [Phase Patch Type Only]

Setting (number): Type a number of phase fractions for the phase speed. Default = 1; The patch will move at a rate of 1 phase fraction per second.

The Phase speed determines how fast the patch moves. The number set represents the Phase Speed in phase fractions per second. Or else described as the number of cycles (or lines) that will move per second.

The higher the Phase Speed the faster the lines in the patch will appear to move.

9) Direction is (1 or 0).

Setting (1 or 0): Choose 1 or 0 to set the Rotation or Phase direction. Default = 1; The patch will rotate in an anti-clockwise (or right-phase) direction.

Set to 0 for clockwise (rotation) or left (phase). Set to 1 for anticlockwise (rotation) or right (phase).

1) If (1 or 0) continue recording after the end of this screen. Only set this if you are recording data across multiple screens, and ensure that the last screen does not have this set. Use 1 to continue recording and 0 to stop recording.

Setting (1 or 0): Type either 1 or 0 to select if the Mouse Tracking Zone should continue recording.

Default = 0; By default, the Mouse Tracking Zone will stop collecting data when the screen is advanced, producing a unique Mouse Tracking data file for this screen.

If set to 1; The Mouse Tracking Zone will continue to record the mouse movements of the participant between screens containing an Mouse Tracking Zone.

If set to 0; The Mouse Tracking Zone will stop recording once the screen has been advanced and a unique metrics file containing the Mouse Tracking data will be created.

2) Prefix filename with(text) for captured data.

Setting (text): Type a name to identify the mouse tracking data file.

Default = mousetracking; By default, the Mouse Tracking Zone will produce data with the filename mousetracking-1-3, or similar.

When set to any text, this changes the filename of the Mousetracking data i.e. if set to 'MouseTask', the file might be named 'MouseTask-1-3'.

Note: Only use alpha-numeric characters in your file names. Do not use special characters as this could prevent you from retrieving data files.

1) Record left/right mouse click as (setting).

To use the left/right mouse click as a response option, this value MUST be set. Default: none.

You will notice when you add the zone that left click will automatically be assigned to the LEFT static value and right click to the RIGHT static value. These can be changed by clicking on the values, selecting the source and typing the name of the value you wish to use for each click.

2) If (setting) allow unlimited responses (disables advance on correct response).

Choose 1 (allow unlimited) or 0. Default: 0

When set to 1, participants will be able to give unlimited responses and their response will not progress the screen onto the next one. If using this, you should add a zone that will allow for the screen to progress e.g. a Timelimit (Screen) zone or a Continue Button - otherwise participants will not be able to advance.

1) Pacing is (Paced or Selfpaced).

Setting (Paced or Selfpaced): Type either 'Paced' or 'Selfpaced' to choose the operation mode for the Zone. Default = Paced; Each segment of the text content will be presented sequentially at an even rate.

Paced: In Paced mode the Reading Zone will automatically display each text segment, sequentially, at an even rate which is determined by the Paced Settings: Configuration Setting-6. In this mode the participant does not need to interact with the Reading Zone. The Reading Zone functions purely to control the style and how quickly the content is presented.

Selfpaced: In Selfpaced mode the Reading Zone will only display the next text segment upon receiving a trigger input from the participant. For the Selfpaced mode to function it is mandatory that Selfpaced Setting: Configuration Setting-7 - the trigger input method - is also set.

Note: If Selfpaced mode is chosen and no trigger method is configured the participant will not be able to interact with the Reading Zone nor advance the task.

Selfpaced mode has additional configuration settings which can be found under the Selfpaced Settings section.

2) Presentation is (Progressive or Isolation).

Setting (Progressive or Isolation): Type either 'Progressive' or 'Isolation' to choose the presentation style for the Zone. Default = Progressive; Text segments are presented sequentially in a cumulative fashion.

Progressive: Each text segment is presented sequentially in a cumulative fashion such that when the last text segment is reached the full text content (i.e. all text segments) will be visible on the screen.

Use this method when you wish to build up a sentence word by word using the Reading Zone.

Isolation: Each text segment is presented individually one segment at a time. When the last text segment is reached only the last text segment will be visible on the screen.

Use this method when you wish to show a sentence one word at a time; where each word is shown in isolation from the rest of the sentence.

3) Content location is (Centre or Relative).

Setting (Centre or Relative): Type either 'Centre' or 'Relative' to choose how content should be positioned upon presentation. Default = Centre; Visible content will always be presented in the centre of the Reading Zone.

Centre: When presenting the text segments all visible content will always be presented as centred within the Reading Zone.

Relative: When presenting the text segments each visible text segment will be presented at the position it occupies within the full text Content. With certain zone configurations this will appear as text content moving across the screen from left to right.

This setting is best demonstrated by viewing the task examples below.

4) Content mask is (On or Off).

Setting (On or Off): Type either 'On' or 'Off' to choose whether to mask content or not. Default = Off; content will not be masked.

On: Content will be masked. Only visible content will appear non-masked. Which content counts as 'visible' will depend upon the setup of Configuration Setting-2.

Note: Configuration Setting-3 must be set to 'Relative' for Masking to be applied to the text Content.

Off: Regardless of other Zone Configuration Settings content will not be masked.

5) Reaction time metric is (Individual or Cumulative).

Setting (Individual or Cumulative): Type either 'Individual' or 'Cumulative' to choose the operation mode for the Zone. Default = Individual; Reaction time recorded for each text segment will represent the total time that the text segment was presented on the screen.

Individual: Each text segment will produce a single row in your metrics. For each text segment, the reaction time that is recorded, represents the time that the individual text segment was visible for. For the full series of metrics produced by the Reading Zone, reaction times will appear as a list of unique individual reaction times one for each text segment

Cumulative: The recorded reaction time will be relative to the start of the screen. Each text segment will produce a single row in your metrics. The reaction time that is recorded, for each text segment, represents the time taken from the start of the screen. For the full series of metrics produced by the Reading Zone, reaction times will appear a cumulative list of reaction times; with the reaction time increasing with each successive text segment.

Paced settings

6) If Paced, content appears every (number) ms.

Setting (number): Type a time, as a number of milliseconds (ms), to represent the total duration each text segment should be presented for. Default = 500ms; Each text segment will be presented for 500 ms.

If set, each text segment will be presented for the specified amount of time. When the specified duration is reached the next text segment is shown. If there are no more text segments left to be presented Gorilla will auto advance the participant to the next screen in the task.

Selfpaced settings

7) If Selfpaced, content is triggered by (Keyboard or Mouse).

Setting (Keyboard or Mouse): Type either 'Keyboard' or 'Mouse' to choose the trigger method for selfpaced mode. Default = None.

Note: If Selfpaced mode is chosen it is mandatory that this setting is configured. If Selfpaced mode is chosen and no trigger method is configured the participant will not be able to use the Reading Zone nor advance the task.

Keyboard: If Keyboard is selected, the participant can trigger the presentation of each text segment by using the Space Bar Key on their keyboard. Each press of the space bar Key will trigger the progression of the text content presentation and advance the task.

Mouse: If Mouse is selected, the participant can trigger the presentation of each text segment by using a Left Mouse Button Click. Each press of the Left Mouse Button will trigger the progression of the text content presentation and advance the task. For Mac users clicking the Mouse button will trigger the progression of the text content presentation and advance the task.

8) If Selfpaced, set minimum content duration of (number) ms.

Setting (number): Type a time, as a number of milliseconds (ms), for the minimum length of time a text segment should be displayed for. Default = None; No minimum content duration is set. The next text segment will be displayed immediately when triggered by the participant.

If set; the minimum content duration ensures each text segment is seen by the participant for a specified minimum amount of time.

9) If Selfpaced, set maximum content duration of (number) ms.

Setting (number): Type a time, as a number of milliseconds (ms), for the maximum length of time a text segment should be displayed for. Default = None; No maximum content duration is set. The next text segment will be displayed only if triggered by the participant.

If set; the maximum content duration ensures each text segment is only seen by the participant for a specified maximum amount of time. If the participant does not interact with the Reading Zone before the maximum amount of time has elapsed the next text segment will be displayed automatically.

The maximum duration adds back in a pacing element to a Selfpaced task set up - allowing the creation of pseudo-paced tasks.

Advanced Settings

1) Screen distance calculation is (On, Off)

Set this as On to define stimuli size in Visual Angle (Degrees). Participants will be asked how far from the screen they are sat.

If Off, visual stimuli can be defined in centimetres only.

1) Use the (calibrate or collect) mode (choose 'calibrate' or 'collect')

Setting (calibrate or collect): Type either 'calibrate' or 'collect' to choose the operation mode for the Zone. Default = calibrate; If no mode is set the Eye Tracking Zone will default to the 'calibrate' mode.

Calibrate: In calibrate mode the Eye Tracking Zone will perform a routine calibration and validation test. Note Calibration mode requires the Eye Tracking Zone to take up the full size of the Screen - see image example above.

Collect: In collect mode the Eye Tracking Zone will detect a participant's gaze and return the screen coordinates of the participant's predicted gaze to the Eye Tracking metrics.

2) Prefix filename with (text) for captured data

Setting (text): Type a name to identify the eye tracking data file.

Defaults: In calibrate mode the default file name will be: task-NODEKEY-XXXXXX-eyetracking_calibration-A-B

In collect mode the default file name will be: task-NODEKEY-XXXXXX-eyetracking_collection-A-B

If set to any text string; eyetracking_collection will be replaced with your chosen prefix. Note this only affects files generated in collect mode; calibration files will retain the default file name.

Note: only use alpha-numeric characters in your file name prefixes. Do not use special characters as this could prevent you from retrieving data files.

You will likely wish to use this setting with spreadsheet 'source' if you wish to uniquely identify your eye tracking data files on a 'per-trial' basis.

3) If (setting) or more calibration points fail, retry calibration. A calibration point is considered failed if the validation prediction for that point is closer to another calibration point.

Setting (number): Type a number of calibration points whose failure will trigger calibration to retry.

Default: If you leave this setting blank, calibration will not be retried.

Advanced Calibration Settings

4) If (1 or 0) use long mode for calibrating, which uses 9 points instead of 5. [Calibrate mode ONLY]

Setting (1 or 0): Type either 1 to select long-mode calibration (which uses 9 calibration points), or 0 to select short-mode calibration (which uses 5). Default = 0; By default, the Eye Tracking Zone will use short-mode calibration.

5) If (1 or 0) show the dot while calibrating. This is useful for testing, but not recommended for participants. Use 1 to show the dot, otherwise 0. [Calibrate Mode ONLY]

Setting (1 or 0): Type either 1 or 0 to select if a 'predicted gaze' dot should be shown during calibration mode. Default = 0; By default, the Eye Tracking Zone will not show a red dot during calibration mode.

If set to 1; The Eye Tracking Zone will show a red dot during calibration mode which represents the position of the 'predicted gaze' of the participant.

If set to 0; The Eye Tracking Zone will not show a red dot during calibration.

6) If (1 or 0) show the validation plot after calibrating. This is useful for testing, but not recommended for participants. Use 1 to show the plot, otherwise 0. [Calibrate Mode ONLY]

Setting (1 or 0): Type either 1 or 0 to select if the Eye Tracking Zone should show an additional screen, containing calibration and validation results, after calibration has completed. Default = 0; By default, the Eye Tracking Zone will automatically advance to the next Screen/Display in your task, once the calibration has completed.

If set to 1; The Eye Tracking Zone will add an additional static screen at the end of the calibration. This screen will contain a visual representation of the eye tracking calibration and validation results. The screen will appear directly after calibration has completed. It will present with an 'End Calibration' button which allows the participant/researcher to advance to the next screen manually in their own time.

If set to 0; The Eye Tracking Zone will not present with the additional calibration/validation results screen. Instead, once the calibration has been completed the participant will be automatically advanced to the next Screen/Display in your task.

We recommend adding a calibration 'finished' screen for your participants to remind them to limit head movement as much as possible for the subsequent trials. This also acts to let them know the eye tracking calibration stage has finished.

7) If (1 or 0) continue recording after the end of this screen. Only set this if you are recording data across multiple screens, and ensure that the last screen does not have this set. Use 1 to continue recording and 0 to stop recording.

Setting (1 or 0): Type either 1 or 0 to select if the Eye Tracking Zone should continue recording. Default = 0; By default, the Eye Tracking Zone will stop collecting data when the screen is advanced, producing a unique Eye Tracking data file for this screen.

If set to 1; The Eye Tracking Zone will continue to poll and record the gaze of the participant between screens containing an Eye Tracking Zone.

If set to 0; The Eye Tracking Zone will stop recording once the screen has been advanced and a unique metrics file containing the Eye Tracking data will be created.

Advanced Data Collection Settings

8) If (1 or 0) collect detailed eyetracking data. If you need to do advanced analysis on the raw eyetracking data, enable this option to collect it.

Setting (1 or 0): Type either 1 or 0 to select if you want the Eye Tracking Zone to collect detailed eyetracking data, i.e., the full raw coordinate data from the task. Default = 0; By default, the Eye Tracking Zone will not collect detailed raw eyetracking data.

If set to 1, the Eye Tracking Zone will give you the full raw coordinate data.

If set to 0, the Eye Tracking Zone will give you information on the absolute and percentage time the participants' gaze was in each half and each quadrant of the task screen.

1) Use the (calibrate, record, or upload) mode (choose 'calibrate', 'record', or 'upload')

Setting (calibrate, record, upload): Type either 'calibrate', 'record', or 'upload' to choose the operation mode for the Zone. Default = calibrate; If no mode is set the Eye Tracking 2 Zone will default to the 'calibrate' mode.

Calibrate: In calibrate mode, the Eye Tracking 2 Zone will perform a routine calibration and validation test. Note Calibration mode requires the Eye Tracking 2 Zone to take up the full size of the Screen - see image example above.

Record: In record mode, the Eye Tracking 2 Zone will detect a participant's gaze and return the screen coordinates of the participant's predicted gaze to the Eye Tracking metrics.

Upload: Upload mode allows you to generate a single data file containing all eye tracking data from an entire block or task. On all screens where you want to record eye tracking data, add an Eye Tracking 2 Zone with this setting set to 'record', and Record Setting-11 below (continue recording after the end of this screen) set to 1. Then, on a separate screen at the end of the block or task, add an Eye Tracking 2 Zone with this setting set to 'upload'. This will generate one eye tracking data file for the whole block or task.

2) Prefix filename with (text) for captured data

Setting (text): Type a name to identify the eye tracking data file.

Defaults: In calibrate mode the default file name will be: task-NODEKEY-XXXXXX-eyetracking_calibration-A-B

In record mode the default file name will be: task-NODEKEY-XXXXXX-eyetracking_collection-A-B

If set to any text string; eyetracking_collection will be replaced with your chosen prefix. Note this only affects files generated in record mode; calibration files will retain the default file name.

Note: only use alpha-numeric characters in your file name prefixes. Do not use special characters as this could prevent you from retrieving data files.

You will likely wish to use this setting with spreadsheet 'source' if you wish to uniquely identify your eye tracking data files on a 'per-trial' basis.

3) If (1 or 0) collect detailed eyetracking data. If you need to do advanced analysis on the raw eyetracking data, enable this option to collect it.

Setting (1 or 0): Type either 1 or 0 to select if you want the Eye Tracking 2 Zone to collect detailed eyetracking data, i.e., the full raw coordinate data from the task. Default = 0; By default, the Eye Tracking 2 Zone will not collect detailed raw eyetracking data.

If set to 1, the Eye Tracking 2 Zone will give you the full raw coordinate data.

If set to 0, the Eye Tracking 2 Zone will give you information on the absolute and percentage time the participants' gaze was in each half and each quadrant of the task screen.

Calibration Settings

4) If (1 or 0) use long mode for calibrating, which uses 9 points instead of 5. [Calibrate mode ONLY]

Setting (1 or 0): Type either 1 to select long-mode calibration (which uses 9 calibration points), or 0 to select short-mode calibration (which uses 5). Default = 0; By default, the Eye Tracking 2 Zone will use short-mode calibration.

5) If (1 or 0) show the dot while calibrating. This is useful for testing, but not recommended for participants. Use 1 to show the dot, otherwise 0. [Calibrate Mode ONLY]

Setting (1 or 0): Type either 1 or 0 to select if a 'predicted gaze' dot should be shown during calibration mode. Default = 0; By default, the Eye Tracking 2 Zone will not show a red dot during calibration mode.

If set to 1; The Eye Tracking 2 Zone will show a red dot during calibration mode which represents the position of the 'predicted gaze' of the participant.

If set to 0; The Eye Tracking 2 Zone will not show a red dot during calibration.

6) If (1 or 0) show the validation plot after calibrating. This is useful for testing, but not recommended for participants. Use 1 to show the plot, otherwise 0. [Calibrate Mode ONLY]

Setting (1 or 0): Type either 1 or 0 to select if the Eye Tracking 2 Zone should show an additional screen, containing calibration and validation results, after calibration has completed. Default = 0; By default, the Eye Tracking 2 Zone will automatically advance to the next Screen/Display in your task, once the calibration has completed.

If set to 1; The Eye Tracking 2 Zone will add an additional static screen at the end of the calibration. This screen will contain a visual representation of the eye tracking calibration and validation results. The screen will appear directly after calibration has completed. It will present with an 'End Calibration' button which allows the participant/researcher to advance to the next screen manually in their own time.

If set to 0; The Eye Tracking 2 Zone will not present with the additional calibration/validation results screen. Instead, once the calibration has been completed the participant will be automatically advanced to the next Screen/Display in your task.

We recommend adding a calibration 'finished' screen for your participants to remind them to limit head movement as much as possible for the subsequent trials. This also acts to let them know the eye tracking calibration stage has finished.

7) If (setting) or more calibration points fail, retry calibration. A calibration point is considered failed if the validation prediction for that point is closer to another calibration point.

Setting (number): Type a number of calibration points whose failure will trigger calibration to retry.

Default: If you leave this setting blank, calibration will not be retried.

8) If (setting) calibration failures in row, skip over calibration.

Setting (number): Type the maximum number of times you want the Eye Tracking 2 Zone to retry calibration.

Default: If you leave this setting blank, this will allow calibration to repeat indefinitely.

9) On maximum calibration failures, set embedded data named (setting) to the text value "true"

Setting (text): Type the name you want to give to an embedded data value indicating whether this participant has failed calibration. Use this if, for example, you want to branch participants down different paths in the experiment tree based on whether or not they completed calibration successfully. In your Branch Node, for the Group that failed calibration, the Property would be the name given to this setting, and the Value would equal true.

Default: If you leave this setting blank, the embedded data will not be saved.

10) On maximum calibration failures, send participant to screen named (setting) in the current display.

Setting (text): Type the name of a screen in the current display. Participants who reach the maximum number of calibration failures will be sent to this screen. You could add text to this screen explaining that calibration has failed, and then use an Early Exit button on this screen to eject the participant from the task.

Default: If you leave this setting blank, the participant will not be redirected to another screen on failing calibration.

Record Settings

11) If (1 or 0) continue recording after the end of this screen. Only set this if you are recording data across multiple screens, and ensure that the last screen does not have this set. Use 1 to continue recording and 0 to stop recording.

Setting (1 or 0): Type either 1 or 0 to select if the Eye Tracking 2 Zone should continue recording. Default = 0; By default, the Eye Tracking 2 Zone will stop collecting data when the screen is advanced, producing a unique Eye Tracking data file for this screen.

If set to 1; The Eye Tracking 2 Zone will continue to poll and record the gaze of the participant between screens containing an Eye Tracking 2 Zone. Only set this to 1 if you are recording data across multiple screens, and ensure that the last screen does not have this set (i.e. the last screen is set to 0). Otherwise, Gorilla won't know when to upload your data file.

If set to 0; The Eye Tracking 2 Zone will stop recording once the screen has been advanced and a unique metrics file containing the Eye Tracking 2 data will be created.

Note: If you are planning to upload all your eye tracking data on a separate screen at the end of the block or task (see configuration setting-1 above), you should set this setting to 1 on all screens where you record eye tracking data.

1) Use the (setting) mode.

Setting (record or upload : Type either 'record' or 'upload' to choose the operation mode for the Zone. Default = record; If no mode is set the MouseView Zone will default to the 'record' mode.

Record: In record mode, the MouseView Zone will record participant mouse movements and return the recorded mouse movements to the MouseView Zone Metrics. Use this setting on all screens where you want to record mouse movements.

Upload: Upload mode allows you to generate a single data file containing all mouse movements from an entire block or task. On all screens where you want to record mouse movements, add a MouseView Zone with this setting set to 'record', and setting 3 below (continue recording after the end of this screen) set to 1. Then, on a separate screen at the end of the block or task, add a MouseView Zone with this setting set to 'upload'. This will generate one mouse tracking data file for the whole block or task.

2) Prefix filename with (setting) for captured data

Setting (text): Type a name to identify the mouse tracking data file.

Default = mouseview; By default, the MouseView Zone will produce data with the filename mouseview-1-3, or similar.

When set to any text, this changes the filename of the MouseView data i.e. if set to 'MouseTask', the file might be named 'MouseTask-1-3'.

Note: Only use alpha-numeric characters in your file names. Do not use special characters as this could prevent you from retrieving data files.

3) If (setting) continue recording after the end of this screen.

Only set this if you are recording data across multiple screens, and ensure that the last screen does not have this set (unless you are planning to upload your data on a separate screen at the end of the block or task - see setting 1 above). Choose 1 (continue recording) or 0 (stop recording). Default: 0

Mouseview specific settings

1) Overlay Colour: (setting).

Enter the colour for the overlay as a colour name or hex code. Default: black

2) Overlay Alpha: (setting).

Enter the alpha (transparency) value for the overlay as a float between 0.0 and 1.0. Default: 0.8

3) Overlay Gaussian Blur: (setting) pixels.

Enter the standard deviation, as a number of pixels, for the Gaussian Blur. Higher numbers = more blur. Default: 20

4) Aperture Size: (setting) % of screen space.

Enter the size of the viewing aperture as a number representing percentage of screen. Default: 5 (i.e. 5%)

1) Use the (test or record) mode (choose 'test' or 'record')

Setting (test or record): Type either 'test' or 'record' to choose the operation mode for the Zone. Default = test; If no mode is set the Video Recording Zone will default to the 'test' mode.

Test: In test mode the Video Recording Zone will record video, and allow the participant to replay the video to check that their webcam is functioning correctly. Test mode records no metrics.

Record: In record mode the Video Recording Zone will record participant video and return the recorded video to the Video Recording Zone Metrics.

2) If (1 or 0) record audio as well as video

Setting (1 or 0): Type either 1 to turn the setting on, or 0 to turn the setting off.

If set to 1; The Video Recording Zone will record audio as well as video.

If set to 0; The Video Recording Zone will only record video.