以 .material(threeMaterial) 统一替换 paint,直接接收原生 Three.js 材质实例;材质是原子值,每次整体替换,不逐字段合并。保留 CSS 颜色字符串简写,它会整体选择对应几何类型的默认材质。组合体的材质覆盖整棵子树,外层优先,不修改共享模型。
Core 在调用时捕获 Three.js toJSON() 数据和已加载纹理像素,保证之后修改原生实例不改变已有模型;快照跨 worker 传递,App 通过原生加载器还原并管理材质/纹理资源。建模上下文只改变预览副本,Render 模式及 PNG 使用作者材质。STEP/3MF 保留基础颜色与透明度,STL 仅保留几何。
内置项目公开同一份 three 和类型声明,避免 Core 与作者代码加载不同实例。纹理支持已加载 image/canvas/ImageBitmap、DataTexture 和 CubeTexture,原生面 UV 归一化到每面 0–1,不构建全局 UV 展开。回调、自定义类、Three.js JSON 未支持的局部裁剪/精度/阴影面覆盖、动态纹理、压缩/分层纹理和手工 mipmaps 明确报错;shader uniform 遵守原生 JSON 支持范围。
迁移全部作者 API、快照、渲染器、导出、示例、测试和文档,删除旧入口及旧颜色存储路径。新增 /examples/materials.ts 展示物理材质、实例捕获、纹理、虚线和点材质。
实现完成,待验收。分支 issue-77-material-root-0909;预览 http://localhost:5173 ,打开 /examples/materials.ts。尚未提交或合并。
验证:Core 306 项 TS 回归与 30 项 sketch 回归通过,新增 shader 捕获后材质文件 9 项通过;App 全量 521 项中 520 项通过,唯一新增的类型闭包断言误把 WebXR 写成 WebGPU,确认当前 Three.js 的实际依赖后修正,相关包/导出/材质测试重跑 33 项全部通过。Agent/CLI 与 kernel/solver/screws 回归通过。6 项 Host Chrome 回归覆盖颜色简写、原生物理/基础/线/点材质、DataTexture 与已关闭 ImageBitmap 的像素捕获、建模/Render 切换、关系强调和 PNG 出图,并目视核对纹理截图。全部 workspace 类型检查、包构建、App 与文档站构建、Prettier 及 diff 检查通过。
对应职责与使用约定已更新 Core README、网站参考、DESIGN.md 和 PLAN.md。
以
.material(threeMaterial)统一替换paint,直接接收原生 Three.js 材质实例;材质是原子值,每次整体替换,不逐字段合并。保留 CSS 颜色字符串简写,它会整体选择对应几何类型的默认材质。组合体的材质覆盖整棵子树,外层优先,不修改共享模型。Core 在调用时捕获 Three.js
toJSON()数据和已加载纹理像素,保证之后修改原生实例不改变已有模型;快照跨 worker 传递,App 通过原生加载器还原并管理材质/纹理资源。建模上下文只改变预览副本,Render 模式及 PNG 使用作者材质。STEP/3MF 保留基础颜色与透明度,STL 仅保留几何。内置项目公开同一份
three和类型声明,避免 Core 与作者代码加载不同实例。纹理支持已加载 image/canvas/ImageBitmap、DataTexture 和 CubeTexture,原生面 UV 归一化到每面 0–1,不构建全局 UV 展开。回调、自定义类、Three.js JSON 未支持的局部裁剪/精度/阴影面覆盖、动态纹理、压缩/分层纹理和手工 mipmaps 明确报错;shader uniform 遵守原生 JSON 支持范围。迁移全部作者 API、快照、渲染器、导出、示例、测试和文档,删除旧入口及旧颜色存储路径。新增
/examples/materials.ts展示物理材质、实例捕获、纹理、虚线和点材质。实现完成,待验收。分支
issue-77-material-root-0909;预览 http://localhost:5173 ,打开/examples/materials.ts。尚未提交或合并。验证:Core 306 项 TS 回归与 30 项 sketch 回归通过,新增 shader 捕获后材质文件 9 项通过;App 全量 521 项中 520 项通过,唯一新增的类型闭包断言误把 WebXR 写成 WebGPU,确认当前 Three.js 的实际依赖后修正,相关包/导出/材质测试重跑 33 项全部通过。Agent/CLI 与 kernel/solver/screws 回归通过。6 项 Host Chrome 回归覆盖颜色简写、原生物理/基础/线/点材质、DataTexture 与已关闭 ImageBitmap 的像素捕获、建模/Render 切换、关系强调和 PNG 出图,并目视核对纹理截图。全部 workspace 类型检查、包构建、App 与文档站构建、Prettier 及 diff 检查通过。
对应职责与使用约定已更新 Core README、网站参考、DESIGN.md 和 PLAN.md。