SHARP · IMAGE TO 3D
SHARP Demo:查看真实效果
先查看 Apple 的单图视角合成样例,再在本地将自己的照片生成 3D Gaussian 表示。
浏览官方效果对比样例
这里是预先渲染的研究样例,可以交互选择场景和对比方法。它不会上传你的照片,也不会在浏览器执行 SHARP 推理。
用自己的图片生成场景
安装 SHARP
Python 3.13 · official SHARP CLI
conda create -n sharp python=3.13 -y
conda activate sharp
git clone https://github.com/apple-aiml-research/ml-sharp.git
cd ml-sharp
python -m pip install -r requirements.txt
sharp --help 将一张或多张照片放入 input 目录,然后执行预测。首次运行会自动下载 checkpoint。
Predict
sharp predict -i ./input -o ./output 成功后,output 目录会生成 3D Gaussian .ply 文件,可使用兼容的 Gaussian Splat 查看器打开。结果支持邻近视角,不代表完整重建了场景中不可见的部分。
选择运行设备
- 生成 Gaussian 表示
- CPU、CUDA 或 Apple MPS
- 渲染相机轨迹视频
- 官方渲染器要求 CUDA GPU
可选:在 CUDA 设备渲染视频
CUDA
sharp predict -i ./input -o ./output --render
# Or render previously generated Gaussians:
sharp render -i ./output -o ./renderings 遇到问题时
- 首次运行较慢:需要下载 checkpoint 并初始化,请查看终端进度。
- Mac 无法渲染视频:预测支持 MPS,但官方 --render 路径要求 CUDA。
- 其他查看器中朝向异常:SHARP 使用 OpenCV 坐标约定,需检查查看器的缩放和旋转设置。
官方代码与样例 · 核对于 2026-09-12