slidertrial element

The slidertrial element is a specialized trial element for gathering ratings using a slider are input.

Syntax

<slidertrial slidertrialname>
/ beginresponseframe = integer expression
/ beginresponsetime = integer expression
/ branch = [if expression then event]
/ buttonlabel = "string"
/ correctmessage = false or true(stimulusname, duration)
/ correctresponse = ("character", "character",...) or (scancode, scancode, ...) or (stimulusname, stimulusname, ...) or (mouseevent, mouseevent, ...) or (joystickevent, joystickevent, ...) or ("word", "word", ...) or (keyword) or (property, property, ...)
/ datastreams = (eyetracker) or eyetracker or false
/ defaultresponse = "text" or property or expression
/ errormessage = false or true(stimulusname, duration)
/ increment = integer
/ iscorrectresponse = [expression; expression; expression; ...]
/ isvalidresponse = [expression; expression; expression; ...]
/ labels = ("label", "label", "label", ...)
/ monkeyresponse = ("string", "string",...) or (scancode, scancode, ...) or (property, property, ...) or [expression; expression; expression;...]
/ navigationbuttonfontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ numframes = integer
/ ontrialbegin = [expression; expression; expression; ...]
/ ontrialend = [expression; expression; expression; ...]
/ orientation = layout
/ position = (x value, y value)
/ posttrialpause = integer expression
/ posttrialsignal = (modality, signal) or (mouse, stimulusname) or (mouse, mouseevent)
/ pretrialpause = integer expression
/ pretrialsignal = (modality, signal) or (mouse, stimulusname) or (mouse, mouseevent)
/ quit = [expression; expression; expression; ...]
/ range = (minimum, maximum)
/ recorddata = boolean
/ required = boolean
/ response = responsename or timeout(milliseconds) or window(center, width, stimulusname) or responsemode
/ responsefontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ responseinterrupt = mode
/ responsemessage = (responsevalue, stimulusname, duration)
/ responsetrial = (response, trialname)
/ screencapture = boolean
/ showmousecursor = boolean
/ showticks = boolean
/ size = (width variable, height variable)
/ skip = [expression; expression; expression; ...]
/ stimulusframes = [framenumber = stimulusname, stimulusname, ...; framenumber = stimulusname, ...] or [framenumber = list.name] or [framenumber = selectionmode(stimulusname, stimulusname, stimulusname, ...)]
/ stimulustimes = [time = stimulusname, stimulusname, ...; time = stimulusname, ...] or [time = list.name] or [time = selectionmode(stimulusname, stimulusname, stimulusname, ...)]
/ stop = [expression; expression; expression; ...]
/ timeout = integer expression
/ trialduration = integer expression
/ txcolor = (red value, green value, blue value) or color name or color value
/ validresponse = ("character", "character",...) or (scancode, scancode, ...) or (stimulusname, stimulusname, ...) or (mouseevent, mouseevent, ...) or (joystickevent, joystickevent, ...) or ("word", "word", ...) or (keyword) or (property, property, ...)
</slidertrial>

Properties

Functions

slidertrial.slidertrialname.clearstimulusframes
slidertrial.slidertrialname.insertstimulusframe
slidertrial.slidertrialname.insertstimulustime
slidertrial.slidertrialname.removestimulusframe
slidertrial.slidertrialname.removestimulustime
slidertrial.slidertrialname.resetstimulusframes
slidertrial.slidertrialname.setstimulusframe
slidertrial.slidertrialname.setstimulustime
slidertrial.slidertrialname.stimulusframe
slidertrial.slidertrialname.stimulustime

Remarks

The slidertrial element controls the timing and the content of stimulus presentation as well as how responses are obtained. Every time a slidertrial element is executed, a line of data is written to the raw data file.

The respondent can advance past this trial by placing the slider and hitting ENTER or clicking the response button if response input is set to mouse.

Examples

The following displays a text entry box at the bottom of the screen, sets the line length to 40 characters, and the total number of lines in the box to 3:

<slidertrial question>
/ stimulusframes=[1=sometext]
/ position = (50, 90)
/ linelength = 40
/ numlines = 3
</slidertrial>