SceneExplorer

The Scene Export Window can be opened from the cognitiveVR menu

menu

Prerequisites

  • cognitiveVR Plugin Installed You can follow the instructions here.
  • Blender Installed (free & available at blender.org/download)

Overview

This page will explain how to export your scene and upload this scene to SceneExplorer.com

SceneExplorer works by overlaying data on top of your exported (static) scenes. Each scene you wish to view must be exported. If you make significant changes to your scenes or levels, it is recommended that you redo this step otherwise your data could be misleading.

Scene Export

Notice the list of all scene at the top of this window. This shows the name of the scene, the last time it was uploaded, a link to view the scene online and Select. The Select button will open the scene - a convenient way to navigate between scene.

In the main part of the window is the name of the Current Scene. If the current scene has not been saved or has been saved after this window is open, you will not see the options below; you will see a Refresh Scenes button instead

Exporting Your Scene

  1. Open the scene you wish to export.
  2. Select your export quality. This controls how the mesh geometry and textures are reduced. The advanced options are explained below.
  3. Select Blender.exe. If Blender is installed in your Program Files directory, this may be located automatically.
  4. Bake your scene. This will export the geometry and textures. Blender will automatically open and reduce the mesh geometry. Depending on the complexity of your scene and the size of your textures, this may take some time.
  5. When Blender finishes, a popup should appear to upload to SceneExplorer.com. Alternatively, you can press the button Upload baked scene files to dashboard.
  6. When everything finishes successfully, you should see a popup to view your scene online.

Recording your scene

The CognitiveVR_Manager will automatically snapshot the player's position and gaze point. This is the 'Interval for Player Snapshot' at the top of the Tracker Options Window.

You can call CognitiveVR.CognitiveVR_Manager.EndPlayerRecording(); to stop recording data, such as the end of the game. Sending data OnHMDRemove is planned but not supported at this time. Sending data OnQuit works in a standalone build of your product, but may not work in the Unity Editor. For debugging, you can press Shift+F9 to stop recording data for a scene and send existing snapshots. This hotkey can also be adjusted from the Tracker Options Window.

Note

Processing and sending snapshots is fast, but it will likely disrupt your target FPS. It is recommended to only send this data when a consistent framerate is not possible or not critical, like a scene load.

Transactions

All events recorded by the Transactions API will be displayed on Scene Explorer. The positions of transactions are default to the HMD's positions (actually the Camera.main position). You can overload a transaction method to set the position.

For example:

CognitiveVR.Instrumentation.Transaction("enemy killed").beginAndEnd(transform.position);

Scene Export Quality Advanced Settings

  • Export Static Meshes Only Only export meshes marked as Static. Scene Explorer does not accept dynamic objects at this time
  • Minimum Export Size Objects with bounds smaller than this will not be exported. This is used to ignore small detail meshes like pebbles
  • Minimum Face Count Objects with fewer faces than this value will not have their geometry reduced
  • Maximum Face Count Objects with more faces than this value will have their geometry reduced to 10%. Between Minimum and Maximum Face Count, meshes reduction occurs in a linear method
  • Texture Export Quality Required textures are copied, exported and resized to Full/Half/Quater... resolution