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.
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