White Noise Background

Description

White noise background stimulus.

Fills the display with random noise drawn from a uniform distribution. The experiment can re-randomize the noise via the Randomize White Noise Background action.

Signature

stimulus/white_noise_background

Optional Parameters

grayscale

Default:

YES

If YES, all three color channels (red, green, and blue) of a given noise grain will be assigned the same random value. If NO, each color channel will be set to an independent random value, thereby producing colored noise.

grain_size

Default:

0.0

Noise grain size (degrees).

The number of grains in each dimension is rounded to the nearest integer. Grain sizes less than or equal to the size of one pixel will result in per-pixel randomization.

rand_seed

Seed value for the random number generator. If omitted, the current system time in nanoseconds is used.

randomize_on_draw

Default:

NO

If YES, the stimulus will re-randomize itself every time it draws. Drawing may be triggered either explicitly (via an Update Stimulus Display action) or implicitly (e.g. at the request of a running dynamic stimulus).

To generate dynamic white noise that updates on every display refresh, use this parameter in conjuction with a Frame List Stimulus:

frame_list dynamic_noise (
    loop = true
    autoplay = true
    ) {
    white_noise_background (
        randomize_on_draw = true
        )
}

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.

display

Name of the display on which the stimulus will be presented. If omitted, the default display (if available) will be used.

Placement

Allowed at top level:

Yes

Allowed parent:

Folder, Frame List Stimulus, Layer Stimulus, List Replicator, Movie Stimulus, Range Replicator, Stimulus Group