clock element

Attributes

<clock name>
/ fontStyle = (name, height, bold, italic, underline, strikeout, quality, characterset)
/ format = clockformat
/ mode = clockmode
/ resetRate = rate
/ timeout = integer
/ timeout = expression
/ txBGColor = colorname
/ txBGColor = expression
/ txColor = colorname
/ txColor = expression
/ animation = animation(....)
/ animation = circle(duration, loopCount, start, end, xcenter, ycenter, radius)
/ animation = path(duration, loopCount, x1, y1, x2, y2, x3, y3, ...)
/ animation = points(duration, loopCount, x1, y1, x2, y2, x3, y3, ...)
/ animation = size(duration, loopCount, startWidth, startHeight, scale1, scale2, scale3, ...)
/ animation = rotation(duration, loopCount, degrees1, degrees2, degrees3, ...)
/ dropPosition = (x, y)
/ dropPosition = (xposition, yposition)
/ dropPosition = (xexpression, yexpression)
/ dropSource = boolean
/ dropSource = expression
/ dropTarget = boolean
/ dropTarget = expression
/ erase = true
/ erase = true(colorname)
/ erase = false
/ hAlign = alignment
/ height = height
/ height = expression
/ hJustify = justification
/ hPosition = x
/ hPosition = expression
/ monitor = integer
/ onAnimate = { script }
/ position = (x, y)
/ position = (xexpression, yexpression)
/ rotation = degrees
/ rotation = expression
/ scale = factor
/ size = (width, height)
/ size = (widthexpression, heightexpression)
/ vAlign = alignment
/ vJustify = justification
/ vPosition = y
/ vPosition = expression
/ width = width
/ width = expression
/ onPrepare = { script }
/ resetInterval = integer
/ selectionRate = rate
</clock>

Properties

clock.name.currentTime
clock.name.elapsedTime
clock.name.fontHeight
clock.name.remainingTime
clock.name.resetRate
clock.name.textBGColor
clock.name.textBGColorBlue
clock.name.textBGColorGreen
clock.name.textBGColorRed
clock.name.textColor
clock.name.textColorBlue
clock.name.textColorGreen
clock.name.textColorRed
clock.name.timeout
clock.name.bottom
clock.name.dropSource
clock.name.dropTarget
clock.name.dropX
clock.name.dropY
clock.name.eraseColor
clock.name.eraseColorBlue
clock.name.eraseColorGreen
clock.name.eraseColorRed
clock.name.height
clock.name.heightPct
clock.name.heightPx
clock.name.hPosition
clock.name.left
clock.name.monitor
clock.name.right
clock.name.rotation
clock.name.scale
clock.name.top
clock.name.vPosition
clock.name.width
clock.name.widthPct
clock.name.widthPx
clock.name.x
clock.name.xPct
clock.name.xPx
clock.name.y
clock.name.yPct
clock.name.yPx
clock.name.currentItem
clock.name.currentItemNumber
clock.name.erase
clock.name.playThrough
clock.name.skip
clock.name.stimulusOnset
clock.name.timestamp
clock.name.name
clock.name.typeName

Functions

clock.name.pause
clock.name.resetTime
clock.name.start
clock.name.containsPoint

Remarks

The clock element is used to display a timer, stopwatch, or clock on the screen. The clock is a convenient way to show participants how much time is left to complete the task.

Examples

The following presents a 5-minute timer spanning a block of trials with yellow letters against a black background:

<clock timer>
/ mode = timer
/ resetRate = block
/ erase = false
/ txColor = yellow
/ txBGColor = black
/ timeout = 300000
/ position = (50%, 10%)
/ format = "mm:ss"
</clock>

The following presents white stopwatch with black letters that spans a single trial:

<clock stopwatch>
/ mode = stopwatch
/ txColor = black
/ txBGColor = white
/ format = "hh:mm:ss"
/ position = (50%, 90%)
</clock>