sound element

The sound element defines a set of sound stimuli.

Syntax

<sound soundname>
/ erase = true(red value, green value, blue value) or true(color value) or true(color name) or false
/ items = itemname or ("item", "item", "item",... ) or ("path", "path", "path",... )
/ loop = boolean
/ onanimate = [expression; expression; expression; ...]
/ onprepare = [expression; expression; expression; ...]
/ pan = integer
/ playthrough = boolean
/ resetinterval = integer
/ select = integer or selectionmode or selectionmode(pool) or dependency(stimulusname) or dependency(listname) or listname
/ volume = integer
</sound>

Properties

sound.soundname.currentindex
sound.soundname.currentitem
sound.soundname.currentvalue
sound.soundname.erase
sound.soundname.itemcount
sound.soundname.items
sound.soundname.loop
sound.soundname.name
sound.soundname.nextindex
sound.soundname.nextvalue
sound.soundname.pan
sound.soundname.playthrough
sound.soundname.resetinterval
sound.soundname.selectedcount
sound.soundname.skip
sound.soundname.stimulusonset
sound.soundname.timestamp
sound.soundname.typename
sound.soundname.unselectedcount
sound.soundname.volume

Functions

sound.soundname.appenditem
sound.soundname.clearitems
sound.soundname.insertitem
sound.soundname.item
sound.soundname.removeitem
sound.soundname.resetselection
sound.soundname.setitem

Remarks

The sound element determines how individual items are selected on each trial (e.g. serially through item list, random selection without replacement, linked to the selection of items from another stimulus element) and how those items should be presented (e.g., left/right pan and volume).

Examples

The following defines a set of sounds to be presented to the left speaker:

<sound rock>
/ items = ("beatles.wav", "stones.wav", "thewho.wav")
/ pan = -10000
</sound>