c/3d/models/.gitignore · 3852 字节 · 下载原文

# 夹具目录：**大**模型文件不进仓库（每个 ~10 MB 的二进制）。
# Fixture directory: **large** model files stay out of the repo (each is a ~10 MB binary).
# 例程 `gltf_demo.c` 在这里找 BoomBox.glb / Avocado.glb / Fox.glb（都没放就打一行 GLTF_SKIP，不是 PASS）。
# The example `gltf_demo.c` looks for BoomBox.glb / Avocado.glb / Fox.glb here (with none of them it prints GLTF_SKIP, not PASS).
# ⚠⚠ **这里放的文件会进 `vml_lib.zip`（= 进 APK）** —— 2026-10-08 起 `scripts/make-vml-lib.sh`
#   显式收了本目录（它的第 4 层第二条规则：`Examples/<语言>/3d/models/*`），好让 `glbview.c`
#   / `foxcatch.c` 在**手机上**也找得到模型。实测：下 7 个样例模型（~57 MB）进本目录后，
#   随包 `vml_lib.zip` 8 MB → 65 MB、APK 83 MB → 140 MB。
#   ⇒ **别把大模型随手丢这儿**（想只在本机试，就用 `adb push` 推到设备的
#   `/storage/emulated/0/waycoder/workspace/examples/c/3d/models/`，那条路不进包）。
#   ⚠ 本注释此前写的是"第 4 层不进包" —— 那句**自 2026-10-08 起就是错的**（E168：注释是给用户
#   看的文档，写错就是教错人；实测 7 个模型全进了 zip，条目 3693 → 3700）。
#   ⚠ 2026-10-10 复查（用户：「例子不需要大文件，打包太大」）：本目录**又瘦回来了** ——
#   大模型全删、换成 Khronos 的 CC0 小样例（AnimatedColorsCube 15 KB /
#   TextureLinearInterpolationTest 13 KB / InterpolationTest 8 KB / SimpleInstancing 7 KB /
#   AnimatedMorphCube 7 KB / BoxVertexColors 2 KB），**本目录 ~69 MB → ~55 KB**。
#   ⚠ 随后又换掉两份**许可口径冲突**的（`Duck` 实为 SCEA、`TextureCoordinateTest` 文件内写
#   CC-BY 而 README 写 CC0）—— 逐份许可与理由见 `CREDITS.md`。
#   ⇒ 上面那句"zip 会涨到 65 MB"记的是事故当时的量，现在不是这样；**别再放大文件**这条不变。
#   Re-checked 2026-10-10: big models dropped for small CC0 ones (~69 MB -> ~450 KB here).
# ⚠⚠ **Files here DO end up in `vml_lib.zip` (i.e. in the APK)**: since 2026-10-08
#   `scripts/make-vml-lib.sh` explicitly packs this directory (its depth-4 rule #2:
#   `Examples/<lang>/3d/models/*`) so `glbview.c` / `foxcatch.c` can find models on device.
#   Measured: 7 sample models (~57 MB) here took the packed zip from 8 MB to 65 MB and the
#   APK from 83 MB to 140 MB. **Don't drop big models here** - for local-only testing use
#   `adb push` to `/storage/emulated/0/waycoder/workspace/examples/c/3d/models/` instead.
*
!.gitignore
!CREDITS.md
# ⚠⚠ **别再往这里加白名单放第三方模型** —— 先读同目录 `CREDITS.md`（哪个能随包发、要不要署名）。
#   2026-10-09：原先放行的 `Fox.glb` **已删**。它文件内自带的 `asset.copyright` 写的是
#   **CC-BY 4.0**（**要求署名**：PixelMannen / tomkranis / AsoboStudio / scurest），
#   而本文件与 `CHANGELOG.md` 都把它**记成了 CC0** ⇒ 它一直在**无署名**地随 `vml_lib.zip` 进 APK。
#   ⚠⚠ **Don't whitelist third-party models here again** — read `CREDITS.md` first (what may ship, what needs attribution).
#   `Fox.glb` was removed on 2026-10-09: its own `asset.copyright` says **CC-BY 4.0** (attribution required),
#   while this file and `CHANGELOG.md` recorded it as CC0 — so it shipped **unattributed** inside `vml_lib.zip`.
#   代价（已量）：全新 clone 上本目录**不再有任何模型** ⇒ `gltf_demo` / `foxcatch` / `glbview` 打的是
#   `GLTF_SKIP` 或一行"没找到"提示（**不是 PASS**）。恢复覆盖的三条路写在 `CREDITS.md` 里。
#   Cost (measured): a fresh clone now has **no model here** ⇒ those examples print `GLTF_SKIP` (**not** PASS).