Skip to content

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