SuperSplat Editor Documentation

To translate, rotate, or scale splats:

1. Select a splat in the Scene Manager.
2. Activate a gizmo via the horizontal icon bar.
3. For fine-grained control, use the TRANSFORM panel located below the Scene Manager.

Tip: Double-click anywhere in the 3D view to set the origin for the currently active gizmo.

Use the following selection tools to pick Gaussians for editing or removal:

• Picker Select: Click to select a single splat, or click and drag to perform a rectangular selection.
• Brush Select: Click and drag a selection circle. Use the [ and ] keys to resize the brush.
• Sphere Select: Activate a sphere volume to add or remove splats. Double-click a splat to reposition the sphere volume.

Once selected, press the Delete key to remove the splats.

To support a new language in the editor, you must provide a translation file and register it in the localization logic:

1. Create a new <locale>.json file and place it in the static/locales directory.
2. Register the new locale in src/ui/localization.ts.

Use the following controls to navigate the 3D view:

Tip: Double-click anywhere in the 3D view to set the target point for orbiting.

The Data Panel provides histogram displays of various scene properties.

• Open/Close: Click the panel header or press the D key.
• Selection via Histogram: Drag on the histogram view to select splats directly.
• Selection Modifiers: Use Shift to add to the current selection or Ctrl to remove from the current selection.

SuperSplat is a web application and does not require a traditional installation. You can access it directly via your browser at:

https://playcanvas.com/supersplat/editor

You can also install it as a Progressive Web App (PWA) to make it behave like a native application, which includes generating a desktop/home screen icon and associating .ply files with the app for quicker launching.

After adding a new language, you can preview it by appending the language code as a query parameter to your local development URL.

1. Start the development server using npm run develop.
2. Navigate to http://localhost:3000/?lng=<locale>, replacing <locale> with your language code (e.g., fr, de, or es).

To save your work, use the Scene > Save or Save As menu items to download a .ply file.

For optimized output, use the Scene > Export sub-menu to choose between:

• Compressed Ply: A lightweight format that quantizes data and removes spherical harmonics to significantly reduce file size.
• Splat File: An alternative compressed format (less efficient than Compressed Ply).

You can toggle between two rendering modes to inspect Gaussian geometry:

• Centers Mode: Renders a blue dot at the center of each Gaussian.
• Rings Mode: Renders a ring at the outer boundary of each Gaussian.

Controls:

• Press Space to toggle the visibility of centers or rings (depending on the active mode) to view the scene normally.
• Adjust the pixel size of center dots in the VIEW OPTIONS panel.

SuperSplat loads 3D Gaussian Splat data from .ply files. You can load files using one of these three methods:

1. Drag and Drop: Drag one or more .ply files from your file system into the SuperSplat client area.
2. Menu: Select Scene > Open and choose your .ply files.
3. URL Parameter: Append a load query parameter to the editor URL to load a specific file directly. This is useful for sharing specific scenes via links.

https://playcanvas.com/supersplat/editor?load=https://raw.githubusercontent.com/willeastcott/assets/main/dragon.compressed.ply

To develop SuperSplat locally, you need Node.js 18 or later. Follow these steps to clone the repository, install dependencies, and start the development server.

Important: When running locally, ensure network caching is disabled and application caches are cleared in your browser to avoid issues with Service Workers.

• Safari: Use Cmd+Option+e or Develop -> Empty Caches.
• Chrome: In the Application -> Service workers tab, enable "Update on reload" and "Bypass for network".