# Marble 全景图生成3D场景：从全景图生成可走入场景，分开检查外观和碰撞网格

从全景图生成可探索世界，导出时区分Gaussian外观、全景图片与供碰撞使用的几何体。

## 练习边界

本包没有调用收费平台或登录账号。官方图片仅作署名的教学功能示例；作者原生文件、合成声音和imagegen参考均按身份标明，不是目标平台实测结果。

## 七步操作

1. **检查全景输入**

   使用2:1的author-room-equirectangular.png查看完整环视与接缝。它是作者实际原生全景渲染，不是Marble生成结果。

2. **建立Marble世界**

   按当前Marble入口提交符合条件的全景输入和描述，先确认账号计划、额度与生成范围。

3. **进入世界走动**

   生成后观察不同位置的遮挡和空间连贯性。全景图围绕单点好看，不保证可走动空间都正确。

4. **确认导出权限**

   查看当前计划：免费生成不等于可导出；官方当前Standard和Pro的导出格式、质量与商用范围不同。

5. **分别导出三类资产**

   按实际可用权限导出Gaussian Splat、Panorama和Collider；需要高质量纹理GLB时核对Pro等条件。

6. **测试外观与碰撞**

   在目标引擎分别加载视觉资产与碰撞体，测试门洞和地板。页面作者GLB与collider是已知原生参考，未声称Marble导出。

7. **保存格式说明**

   记录每个文件的作用、单位、坐标和许可。不要只交一张全景图片却称作完整可编辑、可碰撞的3D世界。

## 文件

- README.md
- asset-identity.json
- author-room-collider.glb
- author-room-equirectangular.png
- author-room-scene.glb
- collider.png
- native-world.png
- operation-plan.json
- panorama.png
- room-dimensions.json

## 配图身份

- panorama.png：作者真实2:1等距柱状全景渲染，不是Marble输出。
- native-world.png：作者同一原生房间的透视参考，可编辑几何与全景用途不同。
- collider.png：作者独立房间碰撞几何的实际边线渲染，未由Marble导出。

## 官方来源

- [Exporting from Marble](https://docs.worldlabs.ai/marble/export/gaussian-splat)
- [Marble plans and generation inputs](https://marble.worldlabs.ai/pricing)