Big-Bro222 / MRvis

Master thesis source code

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


Logo

MRVis Documentation

External AR for Digital display and Remote AR collaborative system
Explore the docs »

View Demo · Report Bug

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. License
  5. Contact

About The Project

This project is done in 2020 from March to September as a research result at Inria. The project includes two unity projects. One for the monitor application and remote room. The other is for the HoloLens application.

The main function for this project is to build a visualization system in HoloLens and another debug application for remote user testing.

Built With

This project is using Vuforia library for Augmented reality calibration and Photon Pun for building up the network.

Getting Started

Prerequisites

To get start, first remember to install Unity later than version 2018.4.26f. Version mismatch may cause issue.User should have a basic understanding of Unity development and HoloLens deployment.

Installation

  1. Clone the repo
    git clone https://github.com/Big-Bro222/MRvis.git
  2. Open the "DeskTop" Folder and "HoloLens Project" Folder seperately in Unity. Note: open them together may cause crash, it's highly recommand to open one project once at a time.

Usage

1.Build the HoloLens project folder. Add the starting scene and visualization scene in the Unity's build settings. Build HoloLens application

2.Follow the instruction of build and deployment on Mircosoft website.

3.To build the monitor application and virtual room, first open the Desktop Folder

4.To build the monitor application, add the starting scene and MonitorView scene in the Unity's build settings. Build Monitor application

5.Similar approach for the virtual room application. Note: there should be at least one virtual room, but can have multiple virtual rooms for different users Build Virtual room application

For further usage of the applications, please refer to the Instruction document. For documentation and better understanding the software struture, please refer to the documentation document.

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Ze Qi - Ze.Qi@outlook.com

Portfolio - qi-uxportfolio.com

Project Link: https://github.com/Big-Bro222/MRvis

About

Master thesis source code


Languages

Language:C# 96.6%Language:ShaderLab 2.4%Language:CSS 0.4%Language:SCSS 0.2%Language:GLSL 0.2%Language:HLSL 0.1%Language:Objective-C 0.1%Language:HTML 0.1%Language:Batchfile 0.0%