Using Portalgraph Applications

In this guide, we'll explain how to use a Portalgraph application that enables 3D viewing on your PC's main screen through webcam-based head tracking and red-blue 3D glasses.

Requirements

  • Operating System: Windows 10 or later

  • Portalgraph Runtime Installation: Download here

  • Webcam

  • Red-Blue(Cyan) 3D Glasses:

Important Note

If camera tracking does not work, please install the latest VC++ runtime. You can download it here.

Instructions

In this example, we’ll use the Unity-chan Live Stage! for Portalgraph demo, which is freely available, as a sample application. This setup uses webcam tracking and red-blue glasses for 3D viewing. If you're using VIVE trackers instead, please refer to the VIVE Tracker Setup Guide.

Unity-chan Live Stage! for Portalgraph

When you launch the application, the camera tracking software will automatically start.

Camera Tracking App

From the camera dropdown, select the webcam you want to use and click "Apply" to start tracking your face coordinates. The default settings are calibrated for the field of view (FOV) of typical built-in PC webcams. However, if your camera has a wide-angle lens or different FOV, click "Calibrate." A countdown will start; position yourself so your eyes are directly in front of the camera at a distance of 50 cm (20 inches), and the values will automatically adjust.

For additional settings, please refer to the options below.

Main Software Settings

Return to the Unity-chan Live Stage window and press the F12 key to open the settings menu.

For details on each setting, refer to the Portalgraph Application Settings Guide. In this example, proceed without making any changes by clicking Next (N) to open the calibration screen.

Clicking on "Camera" opens the camera tracking setting screen.

If your camera is positioned directly above the center of the screen, facing straight forward, and your PC screen has a 16:9 aspect ratio, simply enter the screen size (in inches) and click OK to complete the setup. If this setup does not match your configuration, check "Advanced Mode" for further options.

Measure the size of your monitor and enter the screen size in meters. For the camera position, select its location relative to the screen using the dropdown options for up, down, left, or right, then enter the coordinates in meters. The XYZ axes use positive directions as follows: X is to the right, Y is up, and Z is forward (away from the screen). If your camera is not perpendicular to the screen, adjust the camera angle as needed. Once all values are entered, click OK to complete the setup. Close the settings screen, and as you look at the display, you should see the 3D space unfold within the screen.

The Portalgraph application supports the following key controls by default:

  • WASDRF - Move forward, backward, left, right, up, and down (hold Shift for slower movement)

  • QE, TG, ZC - Rotate left/right, up/down, and tilt (hold Ctrl for 90-degree rotation)

  • 1 / 2 - Adjust scale

  • 3 - Reset scale

Adjust the camera position, angle, and scale to match the screen size and orientation for optimal 3D viewing.

Last updated