text element

Attributes

<text name>
/ color = colorname
/ color = expression
/ fontStyle = (name, height, bold, italic, underline, strikeout, quality, characterset)
/ items = itemname
/ items = (item, item, item,... )
/ txBGColor = colorname
/ txBGColor = expression
/ txColor = colorname
/ txColor = expression
/ voiceOver = boolean(language, gender, age, rate)
/ 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, ...)
/ borderColor = colorname
/ borderColor = expression
/ borderWidth = width
/ borderWidth = expression
/ 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
/ select = selectmode(stimulus)
/ select = selectmode(list)
/ select = selectmode(integer, integer, integer, ...)
/ select = list
/ select = selectmode
/ select = index
/ selectionRate = rate
</text>

Properties

text.name.fontHeight
text.name.textBGColor
text.name.textBGColorBlue
text.name.textBGColorGreen
text.name.textBGColorRed
text.name.textColor
text.name.textColorBlue
text.name.textColorGreen
text.name.textColorRed
text.name.voiceOver
text.name.borderColor
text.name.borderWidth
text.name.bottom
text.name.dropSource
text.name.dropTarget
text.name.dropX
text.name.dropY
text.name.eraseColor
text.name.eraseColorBlue
text.name.eraseColorGreen
text.name.eraseColorRed
text.name.height
text.name.heightPct
text.name.heightPx
text.name.hPosition
text.name.left
text.name.monitor
text.name.right
text.name.rotation
text.name.scale
text.name.top
text.name.vPosition
text.name.width
text.name.widthPct
text.name.widthPx
text.name.x
text.name.xPct
text.name.xPx
text.name.y
text.name.yPct
text.name.yPx
text.name.currentIndex
text.name.currentItem
text.name.currentItemNumber
text.name.currentValue
text.name.erase
text.name.itemCount
text.name.items
text.name.nextIndex
text.name.nextValue
text.name.playThrough
text.name.resetInterval
text.name.selectedCount
text.name.selectedIndex
text.name.selectedValue
text.name.skip
text.name.stimulusOnset
text.name.timestamp
text.name.unselectedCount
text.name.name
text.name.typeName

Functions

text.name.containsPoint
text.name.appendItem
text.name.clearItems
text.name.insertItem
text.name.item
text.name.removeItem
text.name.resetSelection
text.name.setItem

Remarks

The text element is used to display text stimuli on the screen. Typically, a single text element consists of a set of text items, and it specifies the method by which a given item is selected for presentation on a trial (e.g., randomly, in sequential order, linked to a different stimulus element, etc.). The text element also controls the appearance of the text on the screen, including font, size, color, justification, and location.

Examples

The following presents white text on a blue background:

<text myText>
/ items = ("inquisit rocks")
/ txColor = (0, 0, 255)
/ txBGColor = (255, 255, 255)
</text>

The following defines a set of text items to be selected in sequential order:

<text presidents>
/ items = ("George Washington", "John Adams", "Thomas Jefferson")
/ select = sequence
</text>