Quickstart
Run a demo to try Rotatrix camera and object controls. Start with the hosted browser demo, or run a local demo in the language you intend to use. All four language demos share the same scene and controls.
Before you start
Section titled “Before you start”For device input, connect a Rotatrix device and start the Rotatrix desktop app. See Rotatrix compatibility for the required version. Keep the desktop app running while you use the demo. You can also explore the scene with mouse controls without a device.
Open the browser demo
Section titled “Open the browser demo”Open the hosted demo in a browser with WebGL. No build tools are needed. Continue to Controls.
Run a demo locally
Section titled “Run a demo locally”To build a local demo, obtain a source checkout and install Node 22.12 or newer and the pnpm version declared in package.json. Install the additional tools for your chosen language:
| Demo | Additional requirements | Build and platform details |
|---|---|---|
| Browser (TypeScript) | A browser with WebGL | TypeScript README |
| Python | uv, the Python environment manager; the launcher prepares Python 3.11 and dependencies | Python README |
| C++ | CMake 3.24+, a C++17 compiler and desktop OpenGL | C++ README |
| C# | .NET 8 SDK or newer | C# README |
From the OpenAxis checkout root:
pnpm install --frozen-lockfilepnpm demoChoose 1 Browser, 2 Python, 3 C++, or 4 C#. The launcher builds and starts the demo; the browser choice opens a local URL. Enter q to stop it. The Rotatrix desktop app runs separately.
Controls
Section titled “Controls”Rotatrix automatically selects its navigation control configuration, called a profile. You do not need to import a profile for the demo. The Rotatrix controls below are the profile defaults; if you have customized them, check your assigned controls in Rotatrix.
The demo connects to Rotatrix automatically and reconnects if it restarts. Click inside the demo so it receives input.
Hold Win (Windows), Ctrl (Mac), or Super (Linux) while moving the ball to orbit around the model. Button 4 pans, and Shift swaps orbit and pan. Orbit rotates the viewpoint around a pivot; pan moves it sideways or up and down. The scene should remain visible as you move.
Left-drag pans; middle- or right-drag rotates. Shift swaps these actions, and the wheel zooms.
- Change the display
Press O to switch between perspective (distant objects appear smaller) and orthographic (size does not diminish with distance). Navigation should work in both and after resizing the window. R resets the camera and all objects.
Press D to toggle diagnostics: an overlay showing scene information and camera updates used during navigation. A green marker shows the pivot when Rotatrix supplies one.
- Select and edit objects
Click an object to select it. Camera navigation remains active, so you can try orbiting with that selection. Double-click or press Enter to edit it.
In edit mode, left-drag moves the object, middle/right-drag rotates it, and the wheel changes depth. Left-click or Enter accepts; right-click or Esc cancels and restores the object. Both deselect it. U undoes an accepted edit. See the object editing recipe for integration details.
- If nothing moves
Confirm Rotatrix is running, the demo receives input, and the active profile has the expected controls. Then check the connection and use diagnostics to inspect scene information and updates.
Build your integration
Section titled “Build your integration”Continue with the Integration walkthrough to understand how the demo connects the SDK to camera and scene APIs.