Skip to content

360 Moving Regions of Interest

Overview

This workflow shows how to record and replay a dynamic path for a Region of Interest (ROI) in a 360° video scene. First, you define a static ROI in the GUI, then trace your desired movement path using a debug ball. Next, you capture keyframes with the replay tool, which generates a CSV file. Finally, you replay the path in your main script and can fine tune scale if needed.

Note: As of SightLab 2.5, there is also a separate folder for adding multiple moving regions of interest, such as each moving football player on the field (this requires repeating the below workflow once per region and giving the name of each new .csv file to create for the paths)

Workflow Steps

Define your initial ROI

  1. Launch 360_moving_RegionsOfInterest.py and select your 360° video in the GUI.
  2. Add a starting region (“ROI”) where you want the path to begin by clicking the "Add" button, moving the gaze point over your selected area and then pressing the 1 key to set a region.

Trace the desired movement path

  1. Run:360_moving_RegionsOfInterest.py

  2. In the Vizard window, use your mouse (and the green debug ball) to follow the path you want your ROI to take. Ignore that the initial region is static at this point.

Capture keyframe points

  1. Run:360_moving_RegionsOfInterest_Tagging.py

  2. Press keys 1–9 to record keyframe positions as you scrub through the video timeline.

  3. Drag the slider along the bottom to navigate to segments where direction or speed change significantly, then set additional keyframes as needed (note you may need to uncheck "ROIs" so they don't create a distraction).

Save the replay data

  • When you exit the replay tool, it automatically writes your keyframes into moving_regions.csv in the current directory.

Replay and verify

  1. Re-run: 360_moving_RegionsOfInterest.py

  2. The ROI will now move along the captured path. To visualize it, set:

REGION_ALPHA = 0.5

  1. Observe the movement and ensure it aligns with your intended trajectory.

Adjust path timing

  • If you need to tweak timing edit the Time Difference column in moving_regions.csv.

Fine‑tune region scale

  • If the ROI appears too large or small at certain keyframes, edit the Scale values in the CSV (e.g., [1,1,1] → [0.8,0.8,0.8]).

Run Session and Collect Data

Run Standard Replay with Visualizations

  • Afterwards run Replay.py to view the standard replay with visualizations like heatmaps and scan paths.
Was this page helpful?