up Inquisit Language Reference

clock element

The clock element presents a timer, stopwatch, or clock on the screen.

Syntax

<clock clockname>
/ 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, ...)
/ format = clockformat
/ mode = clockmode
/ 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
/ fontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ halign = alignment
/ height = numeric expression
/ hposition = x expression
/ monitor = integer
/ onanimate = [expression; expression; expression; ...]
/ onprepare = [expression; expression; expression; ...]
/ position = (x value, y value)
/ resetrate = rate
/ rotation = degrees
/ scale = factor
/ size = (width variable, height variable)
/ timeout = integer expression
/ txbgcolor = (red value, green value, blue value) or (transparent) or color name or color value
/ txcolor = (red value, green value, blue value) or color name or color value
/ valign = alignment
/ vposition = y expression
/ width = numeric expression
</clock>

Properties

clock.clockname.bottom
clock.clockname.currenttime
clock.clockname.dropsource
clock.clockname.droptarget
clock.clockname.dropx
clock.clockname.dropy
clock.clockname.elapsedtime
clock.clockname.erase
clock.clockname.erasecolor
clock.clockname.erasecolorblue
clock.clockname.erasecolorgreen
clock.clockname.erasecolorred
clock.clockname.fontheight
clock.clockname.height
clock.clockname.heightpct
clock.clockname.heightpx
clock.clockname.hposition
clock.clockname.left
clock.clockname.monitor
clock.clockname.name
clock.clockname.remainingtime
clock.clockname.right
clock.clockname.rotation
clock.clockname.scale
clock.clockname.skip
clock.clockname.stimulusonset
clock.clockname.textbgcolor
clock.clockname.textbgcolorblue
clock.clockname.textbgcolorgreen
clock.clockname.textbgcolorred
clock.clockname.textcolor
clock.clockname.textcolorblue
clock.clockname.textcolorgreen
clock.clockname.textcolorred
clock.clockname.timeout
clock.clockname.timestamp
clock.clockname.top
clock.clockname.typename
clock.clockname.vposition
clock.clockname.width
clock.clockname.widthpct
clock.clockname.widthpx
clock.clockname.xpct
clock.clockname.xpx
clock.clockname.ypct
clock.clockname.ypx

Functions

clock.clockname.pause
clock.clockname.resettime
clock.clockname.start

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>

Send comments on this topic:
Copyright Millisecond Software, LLC. All rights reserved.