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).

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)

alpha_multiplier

Default:1.0

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

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.

Placement

Allowed at top level: Yes
Allowed parent: Folder, List Replicator, Range Replicator, Stimulus Group