For text displays, the first line must read
number text
For picture file displays, the first line must read
number picture
For text displays, the format of following lines is
decimal number + tab character
+ sentence
For picture displays, the format of following lines is
decimal number + tab character
+ picture_file_name
The picture_file_name
must be alphanumeric,
and can contain understroke and period characters, but nothing else.
Other lines are ignored.
The sound files must be WAV files, named
qn.wav
where n is the number of the associated sentence. They must be in the same directory as the input text file.
If the experimenter operates the program, a second monitor can be used.
(Display window should appear, showing first sentence)
In case the input file has been pre-randomized, the user may choose to turn this off.
During this delay, a further sound can’t be played, and the displayed sentence can’t be advanced. The idea is to enforce a period of time in which the subject is to answer.
If there are multiple screens attached to the computer, this number will specify which screen the display is to appear.
The preferences settings are remembered from one run of the program to the next.
(If it is necessary to pause at this point, use the Esc key.)
There is a configurable delay after the sound finishes during which the Enter and Space keys are disabled.
A progress bar shows how much time is left.
(but the sound must be played at least once before going to the next sentence: otherwise they will get an error dialog)
The log file primarily records which sentences, in what order, were presented to the user.
Log files are written into a sub-directory logs of the input text file’s directory, with a file name reflecting the subject’s name, followed by a time stamp. (If the subject name field is left blank, the log file name will begin with “anonymous“)
It also records the user information in the header, as well as a time stamp, and the path of the input sentence file that was used to generate the list of sentences for the experiment.
The log file columns are
sequence # sentence # millisec sentence
The sequence #
is the index of the sentence among the randomized
list of sentences. It will usually just increase. If the order of the
sentences is altered (as by using the Previous sentence
command), the change in order will be reflected in this column.
The millisec
column is the (approximate) number of milliseconds
from the opening of the log file to the time the sentence is displayed.
This is meant to aid with synchronization with recordings.
The sentence #
indicates which sentence was displayed and which
sound played. The sentence column is a redundant indicator of the displayed
sentence.
When an input text file is opened, it is read, then its directory is scanned for sound files corresponding to the numbered sentences. If any is missing, the operator is warned and the display file is not opened.
Before opening the display window (with the Go button), all the sentences are checked for support with system fonts. If no font on the system supports all characters in all the sentence, an alert window will come up, explaining in which sentence and which character, the problem is first recognized. If fonts are found that support all the sentences, by default, the first such font found by Java will be the one used.
If the text is displayed in nonsense characters, check that the input file has UTF-8 encoding. (It is possible that your text editor displays the characters correctly but doesn’t save the text as UTF-8.)
If a problem occurs with a single sentence, the left-arrow key can be used to go back in the sequence of sentences. All viewings of the sentence are recorded in the log file. The sequence number in the log file will show that the user backed up.
The current sequence number can be displayed from the display window pop-up menu. It can also be changed in this way, but the sense of the experiment may be altered by such action.
If the display window needs to be closed during an experiment, the Go button of the main window will re-start the same sequence from the last sentence whose sound has not played, so long as Open has not been used to open a new sentence file. A new log file will be started, with its sequence number continuing from the last in the previous log file.