circle

 elements

One or more circles or ellipses. Options for border and solid or transparent fill also allow circular/elliptical frames (rings).

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

circle

 objects using function 

circle

Object and input them to addTrial.

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

circle

 objects using function 

circle

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

(None)

(None)

size

Default: a circle with diameter 5 deg

A number that is diameter for a circle, or a vector [width height] for an ellipse (deg). Or you can use multiple rows (a column vector or matrix) for different sizes for multiple shapes—see positions below.

showFill
color

Default: showFill: solid shape
Default: color: white

showFill is <cd>true<cd>/<cd>false<cd>. <cd>false<cd> = inside is transparent but you can still show a border for a circular frame effect (property showBorder below). Or a 1×n vector for different values for multiple shapes—see positions below.

color is a 1×3 RGB vector with numbers between 0–1 setting fill color. Or an n×3 matrix for different colors for multiple shapes—see positions below.

showBorder
borderWidth
borderColor

Default: showBorder: no border
Default: borderWidth: 0.1 deg
Default: borderColor: white

showBorder = <cd>true<cd>/<cd>false<cd>. If you show a border the dimensions set in .size above are its outer dimensions. Or a 1×n vector for different values for multiple shapes—see positions below. Note currently to show a border the element must be a circle (property size = one number).

borderWidth is a number (deg). Or a 1×n vector for different border widths for multiple shapes—see positions below.

borderColor is a 1×3 RGB vector with numbers between 0–1. Or an n×3 matrix for different border colors for multiple shapes—see positions below.

positions

Default: show one shape centered at element position

If you want to show multiple shapes, you can set that here. This is more efficient than using separate circle elements with the same timing. positions is a 2-column matrix setting centers for the shapes, with rows corresponding to shapes and columns to [x y] coordinates (deg). Positions are relative to element position, which you can set in position (default screen center).

If you set multiple shapes then for each of the other properties above, you can continue to specify one value for all of them. OR you can specify multiple values if you want different values for different shapes. To specify multiple values, the property becomes a vector or matrix—see above.

<cd>[]<cd> = show one shape centered at element position.

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.