# Portalgraph App Creation Tutorial This page is intended for developers and explains how to create the simplest possible Portalgraph app. It covers how to use your PC's built-in camera or an external USB webcam and view the result with anaglyph (red-blue) 3D glasses. Portalgraph is capable of displaying content using a single binary regardless of the combination of hardware used — whether that is a 3D projector, 3D television, or standard monitor with red-blue glasses, and whether tracking is done via camera or VIVE Tracker. This tutorial covers the standard monitor + red-blue glasses + camera tracking setup, but apps you create will also work in other configurations. ### Requirements * A PC with a webcam capable of running Unity (with a GPU, or an Intel Core series CPU from within the past five years or equivalent) * Portalgraph runtime installed: * Portalgraph Personal * Unity 6 or later * Red-blue 3D glasses ## Asset Usage #### Creating a Project If you have not already done so, create a new project from Unity Hub. Select **Universal 3D** as the template (Built-in and HDRP are also supported).

## **Importing Assets** ### Importing Portalgraph asset From the menu, go to **Assets → Import Package → Custom Package**, select **portalgraph.unitypackage**, and import the assets into the project. ### Setting TextMesh Pro Import the Essential Resources for TextMesh Pro. From the menu, go to **Window → TextMeshPro → Import TMP Essential Resources** and click to import.

## Creating the Scene Create a scene in Unity and place the Portalgraph prefab from the Project window at coordinates **(0, 0, 0)**. Place **Assets/Portalgraph/PortalgraphURP\_2023-6** into the scene. The coordinates of **Portalgraph/ScreenCenter** will serve as the center point of the display screen.

**※ The prefab to use varies depending on your Unity version and rendering pipeline:** * **Built-in:** Portalgraph * **URP with Unity 2022 or earlier:** PortalgraphURP\_2020-22 * **URP with Unity 2023 or 6+:** PortalgraphURP\_2023-6 * **HDRP:** PortalgraphHDRP

Also, delete the Main Camera that was originally in the scene, as it is no longer needed.

Place a Cube at coordinates **(0, 0, 0)** with a size of **(0.1, 0.1, 0.1)**. ※ In Portalgraph, objects appear in the real world at the size you specify in Unity. Since displayed objects must be smaller than your PC screen, set the size to **(0.1, 0.1, 0.1)**.

### **Building** Click **File → Build Settings** from the menu.

In the **Scene List** tab, click **Add Open Scenes** to add the current scene to **Scenes in Build**, then go to the **Windows** tab and click **Build**.

Click 'Add Open Scenes' to add the current scene to 'Scenes in Build', and then click 'Build' to build.

## Running Running a Portalgraph application requires the Portalgraph runtime to be installed. After installing the runtime, run the output executable and the camera tracking app will launch automatically.

Select the webcam to use from the camera dropdown and click **"Apply"** to begin tracking your face position. Click **"Calibrate"** to start a countdown — position yourself so that your eyes are 50 cm directly in front of the camera and wait for the values to be set automatically.

Return to the screen of the app you created. If this is your first time running Portalgraph, a screen size input dialog will appear automatically. (If it does not appear, press F12 and click **"Next" → "Camera"**.) Enter the values, press **OK**, and close the next settings screen.

You now have a Portalgraph application that can be viewed in 3D from any angle. Put on your anaglyph (red-blue) 3D glasses and enjoy the experience. **Controls:** * **W A S D R F** — Move forward/back/left/right/up/down (hold Shift for slow movement) * **Q E T G Z C** — Rotate left/right, up/down, and tilt (hold Ctrl to rotate in 90° increments) * **1 2** — Change scale (hold Shift to slow down) * **3** — Reset scale Adjust the camera position, angle, and scale to suit the size and orientation of your screen. *** **Troubleshooting** **If the camera tracking app does not work**, install the latest VC++ Runtime: **If nothing is displayed:** Is the Cube placed in the scene set to a size of **(0.1, 0.1, 0.1)**? Portalgraph displays objects at their actual size, so anything larger than the screen cannot be displayed. Try pressing the **1** key to reduce the scale. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://portalgraphvr.gitbook.io/portalgraph-document-en/quick-start-developper/portalgraph-app-creation-tutorial.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.