shape element

The shape element defines a single shape stimulus and specifies how the shape is presented.

Syntax

<shape shapename>
/ animation = circle(duration, loopcount, start, end, xcenter, ycenter, radius) or path(duration, loopcount, x1, y1, x2, y2, x3, y3, ...) or points(duration, loopcount, x1, y1, x2, y2, x3, y3, ...) or size(duration, loopcount, startwidth, startheight, scale1, scale2, scale3, ...) or rotation(duration, loopcount, degrees1, degrees2, degrees3, ...)
/ color = (red value, green value, blue value) or color name or color value
/ dropposition = (x value, y value) or (x constant, y constant)
/ dropsource = value or boolean
/ droptarget = property or boolean
/ erase = true(red value, green value, blue value) or true(color value) or true(color name) or false
/ halign = alignment
/ height = numeric expression
/ hposition = x expression
/ monitor = integer
/ onanimate = [expression; expression; expression; ...]
/ onprepare = [expression; expression; expression; ...]
/ position = (x value, y value)
/ rotation = degrees
/ scale = factor
/ shape = shapename
/ size = (width variable, height variable)
/ valign = alignment
/ vposition = y expression
/ width = numeric expression
</shape>

Properties

shape.shapename.bottom
shape.shapename.color
shape.shapename.colorblue
shape.shapename.colorgreen
shape.shapename.colorred
shape.shapename.dropsource
shape.shapename.droptarget
shape.shapename.dropx
shape.shapename.dropy
shape.shapename.erase
shape.shapename.erasecolor
shape.shapename.erasecolorblue
shape.shapename.erasecolorgreen
shape.shapename.erasecolorred
shape.shapename.height
shape.shapename.heightpct
shape.shapename.heightpx
shape.shapename.hposition
shape.shapename.left
shape.shapename.monitor
shape.shapename.name
shape.shapename.resetinterval
shape.shapename.right
shape.shapename.rotation
shape.shapename.scale
shape.shapename.skip
shape.shapename.stimulusonset
shape.shapename.timestamp
shape.shapename.top
shape.shapename.typename
shape.shapename.vposition
shape.shapename.width
shape.shapename.widthpct
shape.shapename.widthpx
shape.shapename.xpct
shape.shapename.xpx
shape.shapename.ypct
shape.shapename.ypx

Functions

None.

Remarks

Button stimuli provide a convenient means of overwriting previously presented stimuli during a presentation sequence, or for drawing background to be presented behind other stimuli.

Examples

The following defines a blue circle that appears on the right side of the screen:

<shape bluecircle>
/ shape = circle
/ color = (0, 0, 200)
/ position = (80%, 50%)
</shape>