Skip to content

GUI Overview

Using the GUI Editor

Note: If the GUI you are using looks different, you may be on SightLab 2.3 or earlier. Download latest version here.

  1. Open the SightLab VR Script:

    • Double-click SightLab_VR.py in your project folder
    • This will launch the GUI editor.

    Note: If other Python editors are installed on your system, ensure that the file opens in the Vizard Python environment. If the GUI doesn't load, right-click on the script and choose "Open With - Vizard 7" or "Vizard 8" (found at C:\Program Files\WorldViz\Vizard\<versionNumber>\bin\winviz.exe).

  2. Create a New Project:

    • Click New.
    • Enter a name for your project.
    • Click Save Project.

    Additional Options:
    - Load existing .stlb files (SightLab experiment files).
    - Edit your Python script by clicking Edit [filename].
    - Open your project folder by clicking the folder icon.

Managing 3D Models and Media

  1. View Available Models and Media:

  2. Click the Environment dropdown to see available 3D models.

  3. Select 360 Media for 360 media files.

  4. Change Working Environment:

  5. Click Change to switch the directory within your project.

  6. Click Built-In to use SightLab's included assets.

Note: to get to this screen with SightLab 2.3 or earlier need to click the "Modify" button

Editor Controls Overview

  • Left Shift: Toggle scene lock/ROI selection mode (360 media).
  • . (Period)/F1: Hide/show the menu.
  • Mouse: Look around.
  • WASD/Arrow Keys: Move (left/right/forward/backward).
  • Z/X: Move down/up (or PageUp/PageDown).
  • Q/E: Rotate left/right.
  • R: Reset viewpoint.
  • /: Take screenshot.
  • ;: Toggle mouse lock.
  • ,: Toggle scene display.
  • F2: Toggle fullscreen.
  • F3: Toggle rendering/wireframe modes.
  • F4: Show frame rate/performance metrics.
  • Escape: Exit.
  • Ctrl + F6: Dock/undock with code.
  • Spacebar: Toggle media playback (360 media).
  • 1: Select ROIs (360 media).
  • IJKL: Move virtual gaze point (or use mouse).
  • Alt + I: Float window and activate Vizard IDE interactive input.

Editing Models

  1. Open Models in Inspector:

  2. Click Edit in the Experiment Options editor to open a model in Inspector.

  3. Use Inspector to add objects, tag ROIs, set starting points, adjust lighting, etc.
  4. For Inspector workflow see this page

Saving Changes

  • File > Save your work in Inspector.
  • Refresh in SightLab to apply changes.

Working with 360 Media

Switching to 360 Media Mode

  • Select 360 Media in the Experiment Options editor.

Selecting Media

  • View media in the resources/media folder.
  • Use Change to switch directories.
  • Use Built-In for default 360 media.

Media Options

  • Choose media type (video/image).
  • Select stereo or mono format.

Adding ROIs to 360 Media

  • Press Add or Left Shift to enter ROI mode.

Tip: Press ; to lock the mouse cursor.

Placing and Customizing ROIs

  • Move the virtual gaze point and press 1 to set ROIs.
  • Customize region name, scale, opacity, and color.
  • Use the i,j,k,l,u & o keys to move the region or fgh and Shift FGH to scale in x,y or z (use the slider to scale in )

Tip: Lower opacity to hide ROIs during the experiment.

Refer to this YouTube Tutorial for more information.

Configuring Trials

  1. Generate Trials: Enter a count and click Generate.
  2. Current Trial: Use the dropdown to edit individual trials.

Trial Parameters

  • Label: Enter trial-specific labels.
  • Start/End Conditions:
    • Key/button press
    • Timer
    • Custom Event
    • Media end
    • Gaze Event (specify object name)
    • None (specified in code)

Finalizing Your Project

  1. Name your project.
  2. Click Save Config.
  3. Use Randomize to randomize the trial order.
  4. Choose combined or per-trial data file saving.

Note: For advanced randomization, use the code.

Thresholds and Options

  • Dwell Time Threshold: Default 500ms (modifiable).
  • Fixation Duration: Default 100ms.
  • Dispersion Angle: Default 1 degree.
  • Noise Reduction: Adjust frame averaging.

Options

  • Screen Record: Records session videos.
  • BIOPAC Markers: Synchronize with Biopac's AcqKnowledge.

Running the Project

Click Continue to test your project. See "Running a Session Single User" or "Running a Session Multi-User"

Choose Your Hardware Mode:

Was this page helpful?