Holo-SDK Documentation

Holo-SDK Documentation

  • Get Holo-SDK

›Get Started

Holo-SDK Manual

  • Holo-SDK Overview
  • System Requirements
  • Manage License
  • Folder Structure
  • Unity Components
  • Parameters Settings
  • Tips for Unity Developers

Get Started

  • Overview
  • Setup Desktop AR system
  • Create a free license
  • Creating your first project
  • Running your first project

Tutorials

  • Make Holographic Santa Claus
  • Make Holographic Dancer
  • Make 3D Objects from Photos

Guides

  • Guide to 3D displays
  • FAQ

Running your first project

This section is the 4th and last step of the Get Started guide to create a Unity Desktop AR app using Holo-SDK. Visit Get Started to see the overview of how to make Desktop AR applications with Holo-SDK from the beginning.

Now that we have a Unity project working in the Holo-SDK from the previous section. Follow steps in this page to run your application.

Activate License in Unity Project

To run your Holo-APP, you need a Holo-SDK license. You can generate a free license and use it during the development process. You should have a license key, Product Name and Company Name ready from the Create a free license section. If not, head to the Create a free license section and follow the tutorial there to get a free Holo-SDK license key.

Now that you have the license key, Product Name and Company Name ready, let's continue and run your project.

  1. In your Unity project, navigate to the HoloCamera Inspector, and paste your license key in the KeyID input field.

Input field for Holo-SDK license key in HoloCamera game object

  1. On the top of the editor, go to Project Settings-->Player, enter your Product Name and Company Name, make sure that these names are identical to the names you enter in the website.

Setting company name and product name in Holo-SDK Unity project

  1. Make sure you are connected to internet connection before running your application. So that the Holo-SDK can verify your license key when the application starts.

  2. Run the application in the editor or build the application and run it as a standalone application. Note that Holo-APP with a free license can only be run with a limited time. If you want run your Holo-APP with no time limit, you can purchase a deploy license at the pricing page in the Holo-SDK website.

Running your Holo-APP the first time

When you run your project the first time, you will be required to input parameters needed for the Holo-SDK to function properly. The setting wizard included in Holo-SDK will guide you how to set these parameters.

  1. Enter Interpupillary Distance (IPD) -- The first required parameters is the Interpupillary Distance (IPD) or the distance between the center of your eyes. You can measure your own IPD using a ruler and set it into the setting wizard. The average values for male is 6.4 and female is 6.17 cm. However, it is highly recommended that you measure your own IPD and enter an exact value for the best viewing experience. Read more about IPD at Holo-SDK Manual : Interpupillary Distance.

IPD setting input field in the wizard setting of Holo-SDK

  1. Enter Display Size -- The next parameters is the diagonal size of your monitor, the width and height of the display is calculated automatically. You can also set a custom width and height, see Holo-SDK Manual : Custom Monitor Size.

Display size setting input field in the wizard setting of Holo-SDK

  1. Choose Active Camera -- Choose the active camera from the drop down menu. Also, select the position of your active camera from the drop down menu. The position of the camera is used in the calculation in the Holo-SDK, a wrong input will result in the incorrect 3D model being rendered.

Chosing active camera for Desktop AR application from Holo-SDK

  1. Select Shaders for Anaglyph Mode -- Wear your red and blue glasses and select a shader from the drop down menu. Choose the shader that you can best see the sample picture. The Holo-SDK is also compatible with other types of 3D displays (e.g. active/passive 3D displays) via a side-by-side output format. Learn more about setting an output format at Guides : Guide to 3D Displays

Selecting an Anaglyph shader that best suit a user red-blue glasses and display

That is it! Your webcam should now turn on when your Holo-APP starts. Put on the red and blug 3D glasses and enjoy the holgraphic experience! If you like to learn more about how to develop more advanced Desktop AR applications, go to the Tutorials section (see the side menu) and select any tutorial there. We recommend the How to make Holographic Santa Claus app as your first starting application.

← Creating your first projectMake Holographic Santa Claus →
  • Activate License in Unity Project
  • Running your Holo-APP the first time
Holo-SDK Documentation
Documentation
Get StartedHolo-SDK ManualTutorialsGuides
Holo-SDK
DevelopPricingSample Apps
More
About Us
Copyright © 2021 Perception Codes