MLSharp Help - 3DGS Viewer & Generator

3 min read Original article ↗

Next-Gen 3D Graphics

Single-view High-quality AI Reconstruction Pipeline

Overview

MLSharp is a premium macOS application that transforms 2D images into immersive 3D Gaussian Splatting (3DGS) models using state-of-the-art AI. Experience your photos in full spatial 3D with our integrated stereo viewer.

Download

Download Installer (mlsharp002.dmg)

Smart Drag & Drop

The main area supports direct drag-and-drop for various file types:

  • 🖼️ 2D Images (JPG/PNG): Loads the image and prepares for 3D reconstruction. Click "Generate" to start the AI process.
  • 📦 3DGS Files (PLY/SPLAT/SPZ): Immediately opens the 3D viewer to inspect the content.

Quick AI Setup

Prepare the high-performance AI engine with a single click.

1. Open Settings

Go to the sidebar and find the "Download AI Model" button.

2. Start Download

Click the button to download the optimized Core ML model (approx. 2.67GB) directly from Hugging Face.

3. Automatic Setup

MLSharp automatically installs the model in your Application Support folder. Once finished, you are ready to generate 3D content.

Batch Conversion

Process multiple images or entire folders at once using the Batch feature.

Click the "Stacked Squares" icon next to the Settings title to open the Batch Sheet. You can select multiple files, choose an output folder, and manage naming conflicts (Overwrite/Skip) before starting a sequential processing queue.

Viewing Modes

SHARP Mode Optimized for viewing 3DGS generated by MLSharp. This mode fixes the camera to the original capture point, providing the best spatial depth experience.

General (Object) Mode A standard 3D viewing mode where you can orbit and rotate the 3DGS model like a standalone object from any angle.

Navigation

Use your Mouse or Trackpad to explore the 3D space:

  • 🖱️ Left Click + Drag: Rotate view
  • 🖱️ Right Click + Drag: Pan view
  • 🖱️ Mouse Wheel: Adjusts distance to subject in General mode, and FOV in SHARP mode for zooming.

Control Panel Guide

Fine-tune your viewing experience using the controls in the sidebar:

  • 🔘 Stereo Format: Change the 3D display format (SBS, LR/RL, Anaglyph, etc.).
  • ⇄ Swap L/R: Swaps the left and right images. (Also reflected in saved images)
  • ↕️ Depth Slider: Adjusts the overall depth perception in stereo mode.
  • 🎯 Focus Slider: Adjusts the depth (focus) where the left and right images match perfectly.
  • 🔄 Reset: Restores camera position, zoom, focus, and depth to default values. (Stereo mode and Swap L/R status remain unchanged)
  • 📸 Save Image: Saves the currently displayed rendering. To save at high resolution, enter full-screen mode (Enter key), hide the control panel (C key) for maximum display, and press the S key to save.

Keyboard Shortcuts

Enter Toggle between Full Screen and Windowed view

C Toggle Control Panel (Sidebar) Visibility

X Swap Left/Right

S Save Image

Command + Q Quit Application