← 都来码 / Dolaima← 例程索引c/3d/models/CREDITS.md 原文

c/3d/models/CREDITS.md · 8590 字节 · 下载原文

# `Examples/c/3d/` 第三方 3D 资产 —— 出处与许可(CREDITS)

> ⚠ **这个目录里的文件会进 `vml_lib.zip`(= 进 APK / IPA)**(2026-10-08 起 `scripts/make-vml-lib.sh`
> 显式收本目录;同级的 `3d/*.glb` 也在收 —— 第 3 层)。
> ⇒ **往这里放任何资产之前,先查清许可、写进本文件**,否则就是"随包分发了一个来路不明的文件"。

本文件对应 `docs/VML3D对标浏览器.md` 的 **F7「许可与署名」** —— 它此前记的是
「🅿️ 未量(待查:仓内有没有随包分发的第三方资产许可清单)……夹具许可出自任务书,**本轮在仓内找不到出处**」。
2026-10-09 逐份**读了文件自身的 glTF `asset` 块**(`asset.copyright` / `asset.generator`),
并核了 Khronos glTF-Sample-Assets 每个模型 README 的许可,结论如下。

## 现在随包分发的(全部 CC0 或无第三方权利)

⚠ **2026-10-10 整批换过**:用户口径「**例子不需要大文件,打包太大**」——
删掉 5 个 >5 MB 的(AntiqueCamera 17.5 / BoomBox 10.6 / Lantern 9.5 / WaterBottle 8.9 /
Avocado 8.1 MB)外加两个**许可本来就不该随包**的(DamagedHelmet CC BY-**NC** 禁商用、
BoxTextured 要署名且带 Cesium 商标限制 —— 两者下面那张"已删"表里早就记过),
换成 Khronos 的 **CC0** 小样例。`models/` 目录 **~69 MB → ~450 KB**。

| 文件 | 大小 | 许可 | 证据 |
|---|---|---|---|
| `AnimatedColorsCube.glb` | 15 KB | **CC0 1.0** | Khronos README(`© 2017, Public`)+**文件内自带**(`asset.copyright` = `CC0: This work has been marked as dedicated to the public domain. Model by Ed Mackey.`) |
| `TextureLinearInterpolationTest.glb` | 13 KB | **CC0 1.0** | Khronos README(CC0);文件内**无** `copyright` 字段 |
| `InterpolationTest.glb` | 8 KB | **CC0 1.0** | Khronos README(`© 2017, Public`);文件内无 `copyright` |
| `SimpleInstancing.glb` | 7 KB | **CC0 1.0** | Khronos README(`© 2023, Public`);文件内无 `copyright` |
| `AnimatedMorphCube.glb` | 7 KB | **CC0 1.0** | Khronos README(`© 2017, Public`);文件内无 `copyright` |
| `BoxVertexColors.glb` | 2 KB | **CC0 1.0** | Khronos README(`© 2023, Public`);文件内无 `copyright` |

⚠ 各语言 `Examples/<语言>/3d/box.glb` 是本目录 `BoxVertexColors.glb` 的**副本**(同一个文件、同一许可 CC0,2026-10-26 加「每门语言一个最小 3D 示例」时复制)。
| `3d/rover_cutout.glb` | 163 KB | **本仓库自制** | 文件内 `asset.generator` = `make-rover-cutout-glb.py (WayCoder/Dolaima)`;该脚本从世界常量**程序化构造** glTF,不读任何外部素材 |
| `3d/ToyCar.glb` | 5.4 MB | **CC0 1.0** | **文件内自带**(`asset.copyright` = `Public domain (CC0). Toy car model created by Guido Odendahl. Materials edited by Eric Chadwick.`)—— 一手证据,不靠 README |
| `3d/Avocado.glb` | 8.1 MB | **CC0 1.0** | Khronos `glTF-Sample-Assets` 该模型的 README(Microsoft 的 CC0 样例);文件内**无** `copyright` 字段(`generator` = `glTF Tools for Unity`)⇒ **没有可判的冲突**(README 是唯一声明) |

> ⚠ **`3d/Avocado.glb` + `3d/ToyCar.glb` 是 2026-10-15 重新入库的两份**(合计 **13.5 MB**)——
> 它们是 `3d/rover3d.c` 的**素材**(该例程的文件头自己写明"素材在 `examples/c/3d/*.glb`,随包分发"),
> 而不是"随手放在这儿的样例"。**体积代价如实记着**:这两份是**第 3 层**,
> `make-vml-lib.sh` 会**无条件收**⇒ `vml_lib.zip` 会 +13.5 MB,与 2026-10-10 那条
> 「大文件仅仅适合自己测试,不适合发行 / 删除超过 5M 的 glb」**相抵**
> (本节下面那张"删掉的"表里,Avocado 原先正是按"纯体积"删的)。
> ⇒ **要不要让它们随包,是一个还没拍板的口径选择**:留着 = rover3d 在手机上直接能跑;
> 拿掉 = 手机上的 rover3d 报 `NO_MODEL`(`adb push` 到工作区那条路不进包)。
> 见 `CHANGELOG.md` 的 v0.96.977。

⚠ CC0 **不要求**署名 —— 上面这份名单是为了"每个随包资产都能追到一条许可",不是履行署名义务。

### 两条**实测**筛子(许可之外)

① **读文件自己的 `asset.copyright`,不能只信 README** —— 2026-10-10 就是这么揪出两处冲突的:
   · `Duck.glb`:README 写 **SCEA Shared Source License**(`© 2006, Sony`),而本仓一直记成 CC0;
   · `TextureCoordinateTest.glb`:README 写 CC0,文件内却写 **CC-BY 4.0**。
   两处口径不一致 = **不知道到底适用哪一条** ⇒ 都出局(换成了上面这几份:README CC0
   **且**文件内要么无声明、要么明写 CC0)。

② **装得出来才算数**:`MetalRoughSpheresNoTextures.glb`(CC0、285 KB)**装不上** ——
   引擎上限 64 个网格、它有 102 个(`gltf 装载:解析失败 —— 网格数 102 超过引擎上限 64`)⇒ 没进包。
   **加完模型必须真跑一次**(`vmlcli … glb_view.c --arg <模型>`,看 `GLTF_LOAD=1`)。

✅ **`Duck.glb` 与 `TextureCoordinateTest.glb` 已于 2026-10-10 移出**(许可两处口径冲突,
见上面那条与下面的"已删"表)—— 现在随包这 7 份**每一份都能追到一条一致的 CC0 / 自制依据**。

## 2026-10-09 / 2026-10-10 删掉的(都不满足"无版权问题",或纯因体积)

| 文件 | 许可 | 为什么删 |
|---|---|---|
| `Fox.glb` | **CC-BY 4.0**(PixelMannen / @tomkranis / @AsoboStudio with @scurest) | **要署名**,而仓里四处把它记成 CC0 ⇒ 一直**无署名**随包分发 |
| `DamagedHelmet.glb` | **CC BY-NC 4.0**(© 2016 theblueturtle_ 那一版;ctxwing 2018 的重建那层是 CC BY 4.0) | **NC = 禁商用** —— 本 App 是**收费**的(有内购),随包分发**违反 NC 条款** |
| `BoxTextured.glb` | **CC-BY 4.0**(© 2017 Cesium,另带商标限制) | 要署名(且带 `LicenseRef-LegalMark-Cesium`) |
| `AntiqueCamera.glb` | CC0 **但内嵌 UX3D logo**(须署名 + 商标限制,聚合 SPDX = `CC0-1.0 AND LicenseRef-LegalMark-UX3D`) | 保守起见不用;它同时是最大的一份(17.5 MB) |
| `BoomBox.glb` / `Lantern.glb` / `WaterBottle.glb` / `Avocado.glb` | 都是 **CC0**(许可没问题) | **纯体积**:各 8–10 MB,占 `vml_lib.zip` 的绝大部分(2026-10-10 换小模型时一并删)。⚠ **`Avocado.glb` 2026-10-15 以 `3d/` 下 rover3d 素材的身份回来了**(见上面那条)—— 另三份没回来 |
| `ToyCar.glb` | CC0 | 上面表里曾列过它,但**写本文件的那台机器上从来没有这份**(Khronos 那份实测 5.4 MB,>5 MB 线)⇒ 当时不动。⚠ **2026-10-15 在 Windows 这台机器上它一直在**(`3d/ToyCar.glb`,rover3d 素材)⇒ 已入库、已登记进上面那张表 |
| `Duck.glb` | 实为 **SCEA Shared Source License**(`© 2006, Sony`) | 2026-10-10:本仓四处把它记成 **CC0** —— **记错了**。许可两处口径不一致就不再随包分发(用户:「换掉那些版权可能有问题的文件」)。**别再把它当 CC0 用** |
| `TextureCoordinateTest.glb` | README 写 CC0、**文件内写 CC-BY 4.0** | 2026-10-10:同上 —— 口径冲突 ⇒ 出局 |

**判据(一手证据)**:`unzip -p vml_lib.zip … | python -c "读 GLB 的 JSON chunk.asset"`
(`Fox.glb` 的 `asset.copyright` 里逐字写着 `CC-BY 4.0`)。
`DamagedHelmet` / `BoxTextured` / `AntiqueCamera` 文件内**没有** `copyright` 字段 ⇒ 许可只能从
Khronos 各模型 README 核 —— 这四份都**不是** CC0,所以都出局。

⚠ **这些是"随包"的,不只是"在磁盘上"**:它们此前只存在于**打包那台机器的 `models/` 目录**里
(被本目录的 `.gitignore` 挡在仓库外),所以光看工作树**发现不了** —— 必须**解 `vml_lib.zip` 逐份查**。
本条就是这么发现的:工作树里只有 3 个模型,包里却有 9 个。

## 代价与恢复

- 删掉这四个后,`vml_lib.zip` 从 **65.6 MB → 62.4 MB**。
- 需要某个被删的模型做本地试验时:**只在本机放**,并**别提交、别让它进包**
  (`models/.gitignore` 是 `*` + 白名单,白名单里现在**只有 `CREDITS.md`**)。
  更好的一条:`adb push` 到设备的
  `/storage/emulated/0/waycoder/workspace/examples/c/3d/models/` —— **那条路不进包**。
- ⚠ 要加回 Fox(CC-BY 允许分发)也可以,**前提是先在本文件里写下完整署名**(作者 + 链接)。