Skip to content

⚙️ Settings Menu

The Settings Menu provides controls to fine-tune the visual appearance and behavior of the StorySplat editor and the camera navigation experience.

Accessing the Settings Menu

  1. In the StorySplat editor, locate the vertical toolbar on the left.
  2. Click the "Settings" button (⚙️ icon).
  3. The Settings panel will appear (or expand if already open).

Settings Explained

Scene & Loading

  • Auto Frame Scene:
    • (Checkbox) When enabled, the camera will automatically adjust its position and zoom to fit the entire loaded model or splat within the viewport immediately after loading.
    • When disabled, the camera will load at its default starting position or the first waypoint's position, regardless of the model's size or location. Useful if you want a specific initial view.

Camera Movement & Navigation

  • Scroll Speed:
    • (Slider) Controls how quickly the camera moves along the defined waypoint path when using the scroll wheel or trackpad in Tour and Hybrid modes. Higher values mean faster movement per scroll increment.
    • (Value range: 0.01 to 0.5)
  • Camera Free Fly Speed:
    • (Slider) Adjusts the base movement speed of the camera when using keyboard controls (W, A, S, D, Q, E) in Explore, Hybrid, and Walk modes.
    • (Value range: 0.01 to 10.0)
  • Camera Rotation Friction (Sensitivity):
    • (Slider) Controls the sensitivity or responsiveness of camera rotation when looking around with the mouse (in Explore, Hybrid, Walk, and Edit modes). Higher values mean less sensitivity (slower rotation), while lower values mean more sensitivity (faster rotation).
    • (Value range: 1000 to 100000)
  • Camera Swing Dampening:
    • (Slider) Affects the smoothness of camera rotation interpolation when following the path in Tour or Hybrid (auto) modes. Lower values result in tighter following of the path's rotation, while higher values allow for more "swing" or overshoot before settling onto the target rotation.
    • (Value range: 0.0 to 1.0)
  • Player Height:
    • (Slider) Sets the virtual height of the camera above the ground specifically in Walk Mode. This requires a "Floor" type collision mesh to function correctly. It determines the eye-level perspective during walking.
    • (Value range: 0.5 to 3.0 meters)

Loading & Rendering

  • Use CORS Proxy:
    • (Checkbox) Enables a proxy service to bypass Cross-Origin Resource Sharing (CORS) restrictions when loading models or assets from external URLs that don't have the necessary CORS headers.
    • CORS Proxy URL (Input): Specify the URL of the CORS proxy service to use (defaults to a public one, but you can host your own).
    • Use this if you encounter errors loading assets hosted on other domains.
  • Use Splat Fade Effect (Node Material):
    • (Checkbox) Toggles an experimental visual effect for Gaussian Splats (.splat, .ply, .spz). When enabled, splats appear to materialize from the ground up using a special node material upon loading or swapping. When disabled, splats appear instantly.
    • Note: This effect does not apply to traditional mesh models (.glb, .gltf). May have minor performance implications.
  • Invert X Scale:
    • (Checkbox) Flips the loaded splat model horizontally along the X-axis. Useful for correcting orientation issues from certain capture sources.
  • Invert Y Scale:
    • (Checkbox) Flips the loaded splat model vertically along the Y-axis. Often needed for models from sources like Scaniverse PLY.
  • Splat Scale:
    • (Slider) Adjusts the overall uniform scale of the loaded Gaussian Splat model. Useful for resizing the entire splat relative to other scene elements (like custom meshes).
    • (Value range: 0.1 to 5.0)

Camera Viewport

  • Field of View (FOV):
    • (Slider) Controls the camera's lens angle, determining how much of the scene is visible (similar to a camera's zoom). Wider FOV shows more but can introduce distortion; narrower FOV focuses the view. Can also be set per waypoint.
    • (Value range: ~10° to ~120°)
  • Near Clipping Distance:
    • (Slider) Sets the closest distance objects can be to the camera before they start getting cut off (clipped). Lower values allow seeing very close objects.
    • (Value range: 0.01 to 1.0)
  • Far Clipping Distance:
    • (Slider) Sets the furthest distance the camera can see. Objects beyond this distance will not be rendered. Increase this for very large scenes.
    • (Value range: 10 to 100,000)
  • Invert Camera Rotation:
    • (Checkbox) Reverses the vertical mouse look direction (e.g., moving the mouse up makes the camera look down). Standard control is unchecked.

UI Customization

  • UI Color:
    • (Color Picker) Allows you to select a custom accent color for various UI elements like progress bars, selected buttons, and potentially other highlights in exported scenes.

Saving Settings

All settings configured in this menu are automatically included when you:

  • Save the scene configuration (.json).
  • Upload the scene to your StorySplat account.
  • Export the scene to HTML.

This ensures your customized viewing experience is preserved when sharing or revisiting your project.

Previous: Scroll Post Message Functionality | Next: Sharing and Export