Expanding Igloo Toolkit with Advanced 3D Projection Plugin

Igloo’s advanced 3D projection plugin fixes an issue that has been found within the current Igloo Toolkit. This problem is evident on floor based 3D systems, and can be rectified by outputting the textures in a different way.

Open

Prerequisites

• Unity 2018+

• Igloo Unity Toolkit installed and functioning correctly.

• Download the Advanced 3D Projection plugin from HERE

Installation

1. The zip file that was downloaded will contain two components.

   1. A folder called StreamingAssets which contains 2 scripts that tell the camera system how to operate.

   2. A Unity AssetPackage to import into Unity Directly.

2. Open your Unity project that contains the current IglooToolkit

3. Open your library in Windows Explorer and copy in the StreamingAssets folder into the asset root of the project. This will add both files at the same time
   
   

   Open

   

   Copying StreamingAssets into the projects root assets folder

4. Return to the Unity Editor and drag the Asset Package onto your Library, this will start the import process.

4. Select Import
   
   

Placing the Prefab

1. In the newly created folder called Igloo Advanced 3D Projection, drag the Igloo Custom Cubemap prefab into your scene.
   
   

2. Select the IglooCustomCubemap prefab within your scene, and click Add Component

3. Type FollowObjectTransform and add that component
   
   

4. Change the Follow Type to MAIN_CAMERA and Follow Position to True
   
   

Adjusting the IglooSettings.xml

In your IglooSettings.xml file which can be found in your StreamingAssets folder Open it with your code editor of choice, and edit the following values:

1. Remove all DisplayItems, leaving only the <Displays> brackets remaining
   
   

2. Change TextureShareMode to 0, and useEquirectangular to false
   
   

3. Save this file and return to the Unity Editor

Adjusting the DisplayManager.cs

If you decided to press Play now and run the program, it would stop due to an error.

1. To bypass this error, a single line of code is needed in the Igloo DisplayManager.cs file.

2. You can search in the Project Library for this file, by typing DisplayManager into the search bar
   There looks like two files, but one is an editor file.

3. If you open this file in your code editor of choice, and navigate to around line 241, and add the following line into the function, as below.

   if (displayItems == null) return;

4. Save this file, and return to the editor. You can now press Play.

If there are any errors during play mode that are related to the Igloo camera package, please contact myadvocate@igloovision.com with your issue, and screenshots of the errors.