Skip to content

📁 File Menu

The File Menu is your central hub for managing scenes, models, and conversions within StorySplat. It provides tools for starting new projects, loading existing work, saving progress, exporting scenes, and converting between different Gaussian Splat file formats.

🛠️ Tools Section

This section offers utilities for working with Gaussian Splat file formats.

Format Conversion

Optimize your splats or prepare them for different uses:

Tool Description Input Format Output Format SH Preservation
Convert PLY to SPLAT Transforms PLY files into the uncompressed .splat format. Useful for compatibility with some viewers, but removes Spherical Harmonics (SH). .ply .splat ❌ No
Convert PLY to SPZ Converts PLY files into the compressed .spz format using spz-js. Preserves SH data if present in the source PLY. .ply .spz ✅ Yes
Convert SPZ to PLY Converts .spz files back into the standard .ply format using spz-js. Preserves SH data. .spz .ply ✅ Yes

Auto-Conversion Setting

  • Auto-convert PLY to SPZ on load: (Toggle Checkbox) When enabled, StorySplat will automatically convert any .ply file you load into the .spz format internally before adding it to the editor. This is highly recommended if your source .ply files contain Spherical Harmonics, as it ensures this valuable lighting data is preserved throughout your editing session and in subsequent saves or exports. If disabled, .ply files are loaded as-is.

Recommendation: For the best balance of visual quality (preserving SH) and file size, enable "Auto-convert PLY to SPZ on load" if your source PLYs contain SH data, or work directly with .spz files when possible. See File Format Compatibility for more details.

💾 Local File Management

Manage your project files directly on your computer.

  • 🌐 Export Scene To HTML:
    • Creates a self-contained HTML file package (often as a .zip for local export, or directly hosted URL if using cloud save/publish).
    • Includes the splat data, necessary code, and all associated assets (waypoints, hotspots, audio, etc.).
    • The exported HTML can be easily embedded into websites or hosted independently.
    • Maintains references to cloud-hosted splats if you didn't upload a local file.
    • Requires login and saving the project first.
  • 📥 Save Scene Config (JSON):
    • Saves the configuration of your current scene (waypoints, hotspots, settings, splat URL/references, etc.) to a local .json file.
    • This acts as a backup or a way to transfer scene setups. It does not save the splat data itself, only the arrangement and settings.
  • 📤 Load Scene Config (JSON):
    • Loads a previously saved scene configuration from a .json file.
    • Requires the original splat file(s) (referenced by URL in the JSON) to be accessible.

🌍 Remote Features (Loading)

Load Gaussian Splat data hosted online.

  • Load Remote Splats (URL):
    1. Paste the direct URL to a .ply, .splat, or .spz file hosted online into the input field.
    2. Click Load.
    3. The scene will load the data from the specified URL.
    4. Note: The URL must be publicly accessible or have appropriate CORS (Cross-Origin Resource Sharing) headers configured on the server hosting the file. Use the CORS Proxy setting in the Settings Menu if you encounter loading issues.
  • Load Example Splats:
    • Quickly load pre-selected example scenes provided by StorySplat.
    • Great for getting started, testing features, or inspiration. Click the dropdown to see available examples.

⚡ Quick Actions

  • Reset All:
    • Clears the current scene entirely, removing the loaded splat, all waypoints, hotspots, and collision meshes.
    • Resets all settings in the Settings menu back to their defaults.
    • You will be prompted for confirmation if there are unsaved changes.
    • Use this for a completely fresh start.

Previous: File Format Compatibility | Next: Getting Started