DINO-Unity Homepage
<!DOCTYPE html>
HoloLens 2 & Detection for Infrared Navigation with OST AR headsets
Overview • Requirements • Getting Started • Acknowledgements
Overview
This repository supplies you with a sample Unity project which consumes the DINO-DLL project and creates a Unity app for the HoloLens 2 to position virtual models based on infrared tracking data.
User app experience recorded with Mixed Reality Capture
DINO-Unity has been developed and released with 3 LTS versions of Unity: 2019.4.22f1, 2020.3.42f1, and 2021.3.2f1.
At the time of release of this project (2023), Microsoft's recommendation for a Unity version is the Unity 2021.3 LTS release.
Note: The main branch of this repo is just a landing page, if you want to take a look at implementations for the three major versions of Unity, use links below:
To get up and running on your own machine, follow the instructions in Getting Started.
Getting Started
-
Determine which major version of Unity you're targeting (let's assume it's 2021).
-
Clone the repo and switch to the relevant branch (e.g. Unity 2021).
git clone https://github.com/HL2-DINO/DINO-Unity cd DINO-Unity git checkout unity-21You should now have a local copy of the source code needed to open and your chosen version of the
DINO-Unityapp using the Unity Editor. -
Read the relevant README file for detailed instructions on building and deploying the Unity application to your HoloLens 2. You can read it locally on your machine, or access them from here:
-
Read the docs/wiki for more info on how to use and customise the app.
License
This project is licensed under the BSD License.
Acknowledgements
-
If this project is useful for your research or work, please considering citing the following publication[1]:
@inproceedings{Iqbal2022, author = {Hisham Iqbal and Ferdinando Rodriguez y Baena}, journal = {2022 IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS 2022)}, title = {Semi-Automatic Infrared Calibration for Augmented Reality Systems in Surgery}, year = {2022}, } -
A note of thanks for:
- Prof Ferdinando Rodriguez y Baena: for project supervision and for being a source of great advice
- Andreas Keller: for kindly helping out with testing software compilation. See Andreas's excellent HoloLens2-IRTracking project for an alternative setup which achieves similar goals.
-
The project structure for consuming a C++/WinRT component and logic for handling incoming DLL data was inspired by HoloLens2-ResearchMode-Unity by petergu684. Check it out for a very good insight into how you can visualise other sensor-streams from the HoloLens 2.
[^1]: Iqbal H., Rodriguez y Baena, F. (2022) Semi‑Automatic Calibration for Augmented Reality Systems in Surgery. 2022 IEEE/RSJ International Conference on Intelligent Robots and Systems dx.doi.org/10.1109/IROS47612.2022.9982215