Tags

v3.4.0

OTBR Toolbox v3.4.0 — Several presentation windows

Brings stimuli on several monitors into the normal functions and makes
opening a window quieter and more honest.

Highlights:
- Several windows: a further initWindow opens an extra window on another
  monitor; showStimuli and closeWindow work on all windows, with 'Screen' on
  one. Tested on Windows with two monitors.
- showStimuli places several images with 'x' and 'y' and draws them with one
  call. The old showManyStimuli and the three extra-window functions still
  work as wrappers.
- initWindow shows no welcome image and no warning sign by default; the new
  entry screenVerbosity in myHardwareSetup brings them back. One failed sync
  test no longer affects the rest of the session.
- The guide Getting started explains what a measured time means and what to
  use when timing has to be exact.

Upgrade notes:
- myHardwareSetup needs no change; old experiments keep running without the
  welcome image and the warning sign.
- showStimuli needs exactly one position per image; otherwise it stops with an
  error.
- initWindow on a monitor that already has a window stops with an error.
- rt of getAnswer with 'wait4release' now ends at the key press.
- getTime returns only the time as a double.

See CHANGELOG.md [3.4.0] and docs/public_api.md for the full inventory.

v3.3.0

OTBR Toolbox v3.3.0 — Network and documentation

Reworks the network functions for remote computers such as the Raspberry
Pi and ships the documentation inside the toolbox.

Highlights:
- Network: reconnect after a broken connection without restarting the
  Raspberry Pi; no more hangs in sendCommand2Host, getKeyBufferResult and
  connect2ControlComputer; sendCommand2Host returns a status per
  computer; keyBuffer with 'remoteStop' records every response on time;
  after disconnectFromHost the Raspberry Pi waits for the next control
  computer (new option 'quit' ends it); sendExperiment2Host keeps the
  folder Result. Tested on Raspberry Pi 3 B, also with two Raspberry Pis
  and a touchscreen.
- Documentation: open docs/html/index.html in a browser, offline, also
  for Octave users. A page per public function and seven guides; it
  replaces the GitLab wiki.

Upgrade notes:
- Update the toolbox on the control computer and on every Raspberry Pi.
- The functions of the control computer check their inputs; calls that
  were wrong before now stop with an error.
- disconnectFromHost(h) no longer ends connect2ControlComputer on the
  Raspberry Pi; use disconnectFromHost(h, 'quit') for that.
- sendExperiment2Host keeps the folder Result; -1 deletes it.

See CHANGELOG.md [3.3.0] and docs/public_api.md for the full inventory.

v3.2.0

OTBR Toolbox v3.2.0 — Consistency completed, open trigger counters

Completes the v3.1 consistency work and opens up the MRI trigger counters.

Highlights:
- The Sound and Video modules, getMousePos, getButtonClick, createButton,
  inputTextBox, startQuestionnaire, nBackBuffer, changeTextSettings and the
  MRI functions follow the v3.1 conventions, with many bug fixes found on
  the way (controlSound device and stop, loadSound resampling, initWindow
  under Octave on Windows, ...).
- New: checkSound and checkVideo measure sound and video playback on a
  machine; new options in loadVideo, startVideo and plotScale.
- MRI: the source code of all three trigger counters (Keyboard, Parallel,
  Network) ships with new triggerCounter3 programs; initMRIChatPart1 no
  longer starts a run whose triggers nobody counts.
- Fixes reported by users of 3.1.0: keyBuffer and getAnswer accept Inf as
  duration again; keyBuffer with 'feedbackBad' no longer crashes.

Upgrade notes:
- initMRIChatPart1 stops with an error if the trigger counter is missing,
  misspelt or empty in trigger mode.
- initOTBR rejects stimuli that reach past the edge of the screen.
- All trigger counters need libusb-1.0.dll next to the program.
- Examples need initOTBR.m and VERSION copied from the top level
  (Examples/README.txt).

See CHANGELOG.md [3.2.0] and docs/public_api.md for the full inventory.

v3.1.0

OTBR Toolbox v3.1.0 — Phase 2: Consistency

Phase 2 of the v3 modernization. Tested on Windows and Raspberry Pi, under
both MATLAB and Octave.

Highlights:
- Consistent input validation across the Tier-1 API (validateattributes for
  invalid values; error for missing values; OTBR:UnknownArgument warning for
  unknown argument names — never a hard error mid-experiment).
- Standardized v3.1 help/version headers with pointers to CHANGELOG.md.
- Cross-platform fixes: platform-aware ESC key code and bIO KbCheck mapping
  (Windows vs Raspberry Pi); Octave fixes (time built-in shadowing, errorSave
  msgbox skip, Octave-on-Windows PTB paths, GStreamer trailing slash).
- Latent-bug fixes (shuffleVectorRestricted swap-restart, touchBuffer
  nrFrames, fixationCross/showInstructions/closeWindow, ...).

No breaking API changes; existing paradigm scripts run unchanged.
See CHANGELOG.md [3.1.0] for the full per-function list.

v3.0.1

OTBR Toolbox v3.0.1 — PTB 3.0.19 font compatibility patch

Compatibility patch for Psychtoolbox 3.0.19, which switched to the
fontconfig library (bundled with GStreamer). Under that configuration,
the Geneva font is no longer available on Windows. initWindow.m now
selects Arial at 46pt on PTB >= 3.0.19 and keeps Geneva at 35pt on
older PTB versions so that existing experiments render visually
identically.

No public-API changes. See CHANGELOG.md section [3.0.1] for full notes.

v2-final

This is the final version 2 of the OTBR-Toolbox.

v3.0.0