linearDotMask

 elements

A mask consisting of dots moving with random linear motion on a transparent background. Various masks are possible ranging from direction coherence masks to more completely randomized masks. Dots move in straight lines with initial positions, directions, speeds, ages, and lifetimes randomized for each dot. If a dot reaches the edge of the mask area it wraps around to the opposite side. If a dot reaches the end of its lifetime it disappears and reappears with new random position, velocity, and lifetime (and age 0).

Note that since masks are randomized and have a transparent background you can layer multiple masks on top of each other if you need one mask that has a mix of properties.

For any trial you define in an experiment script, you can make one or more 

linearDotMask

 objects using function 

linearDotMask

Object and input them to addTrial.

For any trial you define in an experiment script, you can make one or more 

linearDotMask

 objects using function 

linearDotMask

Object and input them to addTrial.

Input properties

Adjustable properties

You can allow the subject to adjust the following input properties of an object of this type during the experiment using an adjuster element. If you need to make other properties adjustable, you can copy the element type using newPbType and edit it.

position
nn_eyes
rotation
opacity
numDots

position
nn_eyes
rotation
opacity

(None)

(None)

size

Default: square with sides 15 deg

A number that is side length for a square mask area, or a vector [width height] for a rectangle (deg).

numDots

Default: 250

Number of dots. Can = 0.

dotDirection

Default: <cd>[0 180]<cd> = dots move in random directions

Dot motion direction clockwise, 0 = right (deg). Or a vector [direction, delta] setting direction ± delta to randomize for each dot.

dotSpeed

Default: <cd>[2 1]<cd> = dots move randomized between 1–3 deg/sec

Dot speed (deg/sec). Or a vector [speed, delta] setting speed ± delta to randomize for each dot.

dotLifetime

Default: <cd>[1.5 0.5]<cd> = dots last randomized between 1–2 sec

Dot lifetime (sec). <cd>inf<cd> = no limit. Or a vector [lifetime, delta] setting lifetime ± delta to randomize for each dot.

dotSize

Default: 0.2 deg

Dot diameter (deg).

color

Default: white

A 1×3 RGB vector with numbers between 0–1.

Input properties all visual elements have

position

Input properties all adjuster elements have

adjust

Input properties all objects have

report
info

Record properties

PsychBench uses record properties to record information during experiments. You can't set record properties but you can see them in experiment results using input property report.