topRight

Experiments

topRight displays a text overlay in the top-right corner of the display screen for the duration of a trial (status text, score, block info; dynamic %...% variables supported). Display-only; nothing reads it as a response option. It renders on all main trial types: single-screen image trials, single-screen word trials, and multi-screen trials, where it is shown once at trial start. The same corner is used by the built-in CFPT countdown, so avoid the column on CFPT trials (see Works with).

Syntax

Type the text you want in the top-right corner, for example Block 2 of 4.

Any free text is accepted, and HTML markup in the cell is rendered as markup.

Dynamic variables are substituted before the text is shown: %response%, %rt%, %correct%, %responseCode%, aggregate forms such as .avg, .perc and .sum, participant details, and your own user variables. Text without % is shown exactly as typed. Because the overlay is drawn at the start of the trial, these values refer to trials already completed, not to the current one.

Options

Value	Effect
any non-empty text/HTML	Shown top-right for the trial after variable substitution
text containing %var%	Variables substituted before display
empty cell	Nothing displayed

There are no keywords: any value you enter is treated as text.

Defaults & missing values

Leave the column out of the trial file, or leave a cell empty, and nothing is displayed in the top-right corner for that trial.

Column headers are matched case-insensitively, so topright works too.

Works with

• test set to CFPT: these trials run a countdown in the top-right corner, counting down the presTime duration in minutes and seconds, turning red under 10 seconds and showing “Time up!” at zero. Any topRight text you set is replaced by the countdown within a second.
• timer: a trial timer positioned topright (also its default position) is drawn separately from this column, but in the same corner, so the two visually overlap. Move the timer to another corner if you also use topRight text.
• topLeft: the matching overlay for the opposite corner.
• The overlay disappears when the trial ends.
• The overlay is right-aligned near the top of the display at a fixed size; you cannot reposition or resize it from the trial file.

Examples

Static block indicator:

test	stim1	key	topRight
recognition	face_01	f	Block 2 of 4

Last response’s reaction time from the previous trial:

test	stim1	key	topRight
recognition	face_02	j	Last RT: %rt% ms

Score display with aggregate variable:

test	stim1	key	topRight
learn	word_a		Score: %correct.sum[1	0]%

Tips & gotchas

Caution

On CFPT trials the column is effectively unusable: the countdown rewrites that corner every second, so your text vanishes almost immediately. Use topLeft instead on those trials.

• This is display-only text, never a response option or a click target.
• Cell text is treated as HTML, so a stray < or > can swallow part of your label. Escape them if you need the literal characters.
• The text is drawn once per trial, including on multi-screen trials, and does not update between screens.

Common combinations

topRight appears in these worked recipes:

• Running score display: Keep a points tally in the corner of the screen that updates after every scored trial.