Skip to content

Exhibition Tutorial

eisclimber edited this page Feb 11, 2024 · 4 revisions

Exhibition Tutorial

This tutorial will lead you through the steps of creating an example scene to teach the workflow for creating projects for presenting objects in VR. A finished version of the scene can be found at "Assets/ExPresS XR/Scenes/Exhibition Tutorial Scene.unity" or can be instanced as template via the menu option "ExPresS XR > Scenes... > Create New Exhibition Tutorial Scene".

Create and Setup Scene

  • Go to "File > New Scene" (Ctrl + N) and select the "Basic (Built In)" Or "Basic (ExPresS XR)" scene template.
  • Click "Create" and save the newly created scene via "File > Save" (Ctrl + S).
  • If the scene does not contain a XR Rig add one via the GameObject-menu "ExPresS/Rig/XR Rig - Teleport." You are of course free to chose any other rig you like.
  • Add a Skybox to the Scene by going to "Window > Rendering > Lighting", Selecting the "Environment"-tab in the popup and placing a skybox-material into the topmost "Skybox Material" slot. If you do not have one press the Circle with the dot on the side of the slot, then search and select the "WheatFieldStandUp" material. Close the popup.

Room Creation

  • Open the Room Creator via the menu option "ExPresS XR > Rooms... > Room Creator". Create a room with size (5, 3, 4) and Material Preset "Exhibition". This will create an exhibition room with dimensions 5m x 3m x 4m (width x height x depth). These dimensions create the same room as calling "ExPresS XR > Rooms... > Create Default Exhibition Room".
  • Add the window at "Assets/ExPresS XR/Tutorial Assets/Room/Window Big Plain.prefab" and set it's position to (0, 1.2, 1.95) intersecting the wall.
  • Open the ProBuilder Window if not already open via the menu option "Tools > ProBuilder > ProBuilder Window". If it is open for symbols should be present in the top-center of the "Scene"-View window as well as another dock-able "ProBuilder"-Window containing operations.
  • Select the ProBuilder's EdgeSelection-Mode (triangle top-center of the "Scene"-View window).
  • On the wall intersecting the window, select one edge then execute ProBuilder's "Insert Edge Loop"-Operation. This will create an edge wrapping around the room orthogonal to the selected edge. Move the EdgeLoop to intersect the window frame using it's gimbal.
  • Repeat with the other three edges. This will enclose the wall inside of the window with edges forming a new face which now must be deleted.
  • Change the ProBuilder's FaceSelection-Mode (triangle top-center of the "Scene"-View window). Select the face and delete it by executing ProBuilder's "Insert Edge Loop"-Operation or simply pressing the Backspace-Button.
  • Switch back to ProBuilder's ObjectSelection-Mode to be able to select GameObjects normally again.

Filling the ExhibitionDisplays

You will find a YouTube-video regarding this topic here.

  • Create two ExhibitionDisplays one for Objects and one for Images in the Hierarchy. This can be done via the GameObject-Menu "ExPresS XR/Exhibition/ExhibitionDisplay - Object" and ".../ExhibitionDisplay - Image".
  • Set the Object-Display's rotation to (0, 90, 0) and the Image-Display's to (0, 90, 0). Move them to (-2.2, 0, 0) and (2.5, 0, 0) respectively.

Filling the ExhibitionDisplay-Object

  • Add an Object to the Object-Display by dragging it into the Display's "Displayed Prefab"-Slot. For this tutorial a "Glowstick"-Prefab can be found at "Assets/ExPresS XR/Tutorial Assets/Game Objects/Prefabs/Grab Interactables/Glowstick Interactable.prefab". Any Prefab can be used, just be sure to add an (Sphere-)Collider and a XRGrabInteractable-Component. If it is big it might also has to be moved up a bit.

  • Enter a Label Text and an Info Text. For the glowstick they are

    A Blue Light
    

    and

    Mousa: What is this one?
    Rambo: It's a blue light
    Mousa: What does it do?
    Rambo: Shines blue.
    

    respectively.

  • If you want special formatting of the info text locate the Display's childe "Info Text Canvas" and enable it. You will see the "Info Text" and some other canvas objects. These are for displaying images or videos and will disabled at runtime and must not be disabled manually. Nonetheless for formatting disable all unwanted GameObjects (the "Info Image" and "Info Video Display") and format the Text.

  • Finally Enable "Spin Object" to make the glowstick spin.

Filling the ExhibitionDisplay-Image

  • The process is similar to the Object-Display with only a few alterations to the prefab and some settings.

  • Add the Sunflower at "Assets/ExPresS XR/Tutorial Assets/Room/Sunflower Display Image.prefab" to the the Display's "Displayed Prefab"-Slot. If you want to create your own create a new Empty GameObject and add a WorldSpace Canvas to it via "ExPresS XR/UI/WorldSpaceCanvas". Remove the Graphic Raycaster and Tracked Device Graphic Raycaster-Components from the Canvas and add an UI/Image as child. Set the Canvas size to fit the Display's "Frame". It's size can be found at the BaseMesh-Child's "ProBuilder MeshFilter"'s "Object Size"-Property and has a factor of 100 towards the Canvas size. Set the image's Anchor Preset so cover the whole Canvas and give the image a Sprite to display. As you probably won't pick up the image you do not need a XRGrabInteractor-Component.

  • Enter a Label Text and an Info Text. For the sunflower they are

    Sunflower
    

    and

    Pixelart of a Sunflower.
    

    respectively.

  • Finally be sure to disable "Spin Object".

ExPresS XR Wiki

Tutorial Pages

Code Documentation

Clone this wiki locally