Stereo video

OKO Web Client 2.24.1 - CSP 4.19.0

This guide details how to use stereo video in your OKO space.

There are two approaches – both methods require setting up a video component.

Instructions 

Preliminary: setting up a video component

1. Add a video asset to your space by dragging a video to the Assets tab in the bottom panel.

2. Add a video component to your space.

3. With your video component selected, open the Properties panel (on the right-hand side of the screen) and open the video component by selecting “Video” from the hierarchy on that side.

4. You'll see various properties, including transformations and video sources. For “Asset”, select the video asset you want to use.

At this stage, your video component will show the first frame without any stereo handling.

Using a video component

This approach is recommended if you need to display a video in your scene. The video component itself will display the video.

1. Select the video component you added in “Preliminary: Setting up a video component”.

2. For “Stereo video type”, select the option that best represents how your stereo video is laid out.

   1. Top/Bottom: Use this for videos which appear as two frames, one above the other.

   2. Side-by-side: Use this for videos which appear as two frames, one beside the other.

3. You’ll notice that the video component will display the video as one frame, typically the left or top frame by default. You can change this by selecting “Stereo flipped” in the same properties panel.

Using a custom material

This approach is recommended if you need more advanced functionality, such as displaying your video on multiple in-space surfaces or on custom surfaces and assets.

1. In the bottom panel, open the Materials tab.

2. Click the “Add” button to add a custom material and select “Default PBR”.

3. You will see various material options in the right-hand panel, including sections for each texture channel. For now, let's use “Base Texture.

4. There are two drop-down options directly underneath “Base Texture”. For the first one, select “Video”.

5. The second drop-down will now list any video components that exist in your scene. Select the one previously created.

6. Click the “UV Settings” drop-down to show further settings for this texture channel.

7. For “Stereo mode”, select the option which represents how your stereo video is laid out.

   1. Top/Bottom: Use this for videos which appear as two frames, one above the other.

   2. Side-by-side: Use this for videos which appear as two frames, one beside the other.

8. Click “Save” to save changes to the material.

9. Drag the material from the Materials panel onto any objects in the scene to see the result.

10. You’ll notice that the object you applied the material to will display the video as one frame, typically the left or top by default. You can change this (for all objects using this material) by selecting “stereo flipped” in the custom material properties → Base Texture -> UV Settings.

Important notes

You can use both techniques at the same time. However, keep in mind that the custom material will override the video component settings for any assets using it. For example, a video component set to “side-by-side” will continue to play that way. But if the custom material is set to “top/bottom”, any surfaces using that custom material will display in top/bottom, without affecting the video component.

You’ll need a stereo rendering device to see the stereoscopic effect; other devices will only see one half of the video frame, depending on the modes selected.

That’s it for stereo video!