Regions/Areas of Interest for 360 Video

Note: For Sightlab 1.9.2 and earlier see this page

To add regions of interest, first you must run a session within the Vizard IDE (so you can see the interactive window), and press the 'r' key on your keyboard when you are looking at the area you wish to collect data on. If wearing an HMD, you can toggle on the gaze point to more easily see where you are looking by pressing the ‘p’ key. 

When you press 'r' the coordinates will print out in the Vizard interactive window. You can then copy and paste the coordinates into the settings.py file

Open up the settings.py file in the Vizard editor and update the x,y,z coordinates in the code next to REGION_1_POSITION, REGION_2_POSITION, etc.

Next, you just need to toggle on or off the fixation regions in the GUI. You can also choose to view/debug the regions to make sure they are placed correctly (you will want to turn this off when running with a participant). 

Optionally, you can change the color of the fixation (when you are viewing it for debugging and increase the radius (or size) of the sphere. 

If you wish to use a different shape other than a sphere, change the code after “vizshape.”. If you start typing in “add”, you’ll see a list of shape options to choose from. If you are not using the sphere, also remove the code referring to “radius”, and for a cube you would use “size = “ instead). 

Adjusting the time a fixation object/region becomes active

You can adjust at what time a fixation object/region is active by adding this line of code in the “experiment” function directly above where you turn the visibility of the fixation objects/regions on, where “4” is the number of seconds to wait after the experiment starts. To turn them off use the same code, but change “viz.ON” to “viz.OFF”. 

Animating/Moving a fixation region to track a moving object

To track a moving object, use the same process, but make sure to keep your eyes on the moving target, then note the x,y,z position at the start of the movement and at the end. You can then animate the movement of the fixation shape by using Vizard’s built in actions with the vizact library (such as “moveTo”). See this page in the documentation for more information on how to use that. 

import vizact

 #Use a moveTo action to move to the point [0,0,25] at 2 meters per second

moveToPoint = vizact.moveTo([0,0,25],speed=2)

fixation1.addAction(moveToPoint)

To change the fixation threshold (the time at which it designates a fixation happened when you are viewing that region), change line 69, where the number after “threshold” is the amount of time in milliseconds of a fixation. 

 gazeTime = eye_tracker_utils.GazeTime(gazeObjectsDict, threshold=0.5)