Text Stimulus

Description

A stimulus that renders user-specified text within a rectangular region

Signature

stimulus/text

Required Parameters

text

Examples
Hello, world!
"Good morning"

Text to display

font_name

Examples
Helvetica Neue
"Courier"

Font name

font_size

Example

24

Font size (points)

Optional Parameters

text_alignment

Options
left
right
center
Default

left

Text alignment

color

Default

1.0,1.0,1.0

The color of the stimulus, expressed as a comma-separated list of red, green, and blue components. Each component may be described by any valid expression, but the expression must result in a value between 0 and 1 (inclusive).

alpha_multiplier

Default

1.0

Controls the transparency of the stimulus. 1.0 is fully opaque, while 0.0 is fully tranparent.

x_size

Example

5.0

Horizontal size (degrees).

If omitted, the value of y_size is used. It is an error to omit both x_size and y_size (unless fullscreen is YES).

y_size

Example

5.0

Vertical size (degrees).

If omitted, the value of x_size is used. It is an error to omit both x_size and y_size (unless fullscreen is YES).

x_position

Default

0.0

Horizontal center position (degrees)

y_position

Default

0.0

Vertical center position (degrees)

rotation

Default

0.0

Rotation (degrees)

fullscreen

Default

NO

If YES, the stimulus is sized to fill the display. In this mode, x_size, y_size, x_position, y_position, and rotation are ignored.

deferred

Options
no
yes
explicit
Default

no

Controls when the stimulus is loaded. If no, the stimulus is loaded at experiment load time. If yes, the stimulus is loaded the first time it is queued. If explicit, the stimulus must be loaded explictly with Load Stimulus.