Quick Start

SightLab experiments can be set up with a GUI, with code, or a combination of both. This QuickStart is first showing starting a quick session with the GUI. For running a session with code see the non-GUI example

Quick Start - New Scene
	Create Folder: From `Documents\SightLab2\Projects` make a copy of `BlankProject`.
	Add Assets: To add assets, place 3D models in the `resources/environments` or 360 media in`resources/media` folder. See this page for some places to gather assets (Can also access built-in ones or copy from the sample project).
	Launch GUI: Open `SightLab_VR.py` in your `BlankProject` copy folder to launch the SightLab GUI and choose hardware.
	If have any existing projects loaded, click "New." Next, name Project and click "Save Project"
	Open Editor: Click Modify in the GUI to load environments, models, or 360 media.
	Choose Assets: Can choose from the dropdown list or also drag and drop into the editor. Click "360 Media" to use 360 media.
	Add ROI or objects of interest: - For 360 Media, press Shift (in Desktop Mode) to enter ROI mode, then set ROIs by moving the virtual gaze point and pressing 1. - For 3D models, add ROIs and objects in the scene editor "Inspector" by clicking on the Edit button.
	Scene Editor: - You can also use Inspector to edit the model, add a starting point, check scale, set lighting and more (if needed). See this page for more details.
	Tag Objects: - Objects can be tagged for extra data collection, visibility as well as interactions, such as grabbing.
	Make sure to click the "refresh" button if changes were made to a 3D model or added a new one.
	Generate Trials: Enter a count and click Generate to add more trials if desired. Use Start/End Conditions (Keypress, Timer, Event, Gaze). Can choose different environments or media per trial if desired. Click Done when ready.
	Adjust Options: Set additional options such as eye tracking thresholds, randomization, per trial or combined data files, screen recordings and synchronizing with BIOPAC Acqknowledge.
	Start Session: Press "Continue" to begin the session
	Start/End Trials: Enter Participant info (unless set to bypass). Default controls use Spacebar to start/stop. See all controls here. Press the "p" key to toggle viewing the gaze point (off by default)
	Replay & Review Data: Use `SightLabReplay.py` for an interactive session replay (use Spacebar to start/stop playback); view data files in the `data` folder.
	For more, refer to the SightLab documentation and examples in the `ExampleScripts` folder to see how to add much more functionality and use templates, such as adding instructions, rating scales, using AI agents and much more.