responsePos

Experiments

Positions text-input response boxes (responseType = box or box*N) relative to the stimuli: above, below, left, right, or at pixel offsets from screen center. It has no effect on any other response type or on form-trial questions.

Syntax

Put one of the keywords above, below, left, or right in the cell to place the trial’s response boxes on that side of the stimuli.

The cell is a semicolon-separated list of position tokens. Each token is either one of the four keywords or a pixel offset from screen center written as two integers separated by a space, e.g. -100 50.

• One token: applies to every response box of the trial.
• Multiple tokens: the first token positions the first box, the second token the second box, and so on.

Options

Value	Effect
empty cell	Single box: one centered box (the default placement). box*N: all boxes default to the below arrangement.
above	Boxes in a horizontal container above the stimuli (or above trialText if present)
below	Boxes in a horizontal container below the stimuli
left	Boxes in a vertical container left of the stimuli bounding box
right	Boxes in a vertical container right of the stimuli bounding box
x y (e.g. 150 -80)	Any token that is not one of the four keywords is treated as a relative position: the box is centered at screen center plus (x, y) px

Defaults & missing values

• If the column is missing or the cell is left empty: plain box shows the single centered box; box*N places every box below the stimuli.
• Container geometry is derived from the visible stimuli’s bounding box; with no visible stimuli a 100 x 100 px area at screen center is assumed.

Works with

• responseType: only applies when the trial’s responseType contains box.
• trialText: with above, boxes sit above the trial text rather than the stimuli.
• Video trials take the stimuli boundaries from the video itself instead.

Examples

Three boxes, one per side arrangement (box1 above, box2 below, box3 right):

type	stimFormat	stim1	responseType	responsePos
test	.jpg	scene	box*3	above;below;right

All boxes to the left of the stimuli:

type	stimFormat	stim1	responseType	responsePos
test	.jpg	scene	box*2	left

One box offset 200 px right and 100 px up from screen center:

type	stimFormat	stim1	responseType	responsePos
test	.jpg	scene	box	200 -100

Tips & gotchas

• The keywords are above/below, not top/bottom, and there is no inline or center value.

Caution

An unknown keyword is not rejected: it is treated as a pixel offset and produces an invalid position, so a misspelled keyword silently breaks the box placement.

• With multiple tokens the mapping is strictly positional: if you give fewer tokens than boxes, the extra boxes are never placed.
• A single pixel-offset (x y) token only places the first box; any further boxes are not positioned.
• Spacing between boxes in a container is fixed (15 px per box is subtracted from the first box’s width) and not configurable.
• A pixel-offset (x y) box gets its width forced to the distance from the screen’s left edge to the leftmost stimulus; with no visible stimuli that is about half the screen width. A width:N token in responseOptions can still override it.