# DW11：UV、图像编辑与贴图/属性绘制

- stage: `modeling-assets`
- queueTask: `WBV2-P1424-001`；parent: `WBV2-P1424-000`；nextTask: `null`
- 包状态：`planned_gap_closure`（并不表示已有源码尚未实现）
- 完整交付依赖：DW06, DW07
- 工作量级：L；不表示日期承诺
- validation: `NOT_RUN`；acceptance: `NOT_CLAIMED`

## 优先复用的十多天成果

已有 WasmUVView/WasmImageView、paint 协议、图像资产和 GPU texture 路径。

既有任务：`MESH-EDITOR-COVERAGE`（记录为 implemented）、`WEBUI-SCULPT`（记录为 implemented）。按需读取一个任务结果的 summary/remaining/ownedPaths，不打开完整产品报告。

先对照当前小范围源码和最新交接保留已实现子项；只有缺功能、缺接线或缺必要依赖才新增实现。历史状态不自动当作当前缺口。

## 操作者工作流与交付

编辑 UV → 载入/新建图像 → 纹理/顶点色/权重绘制 → 图像与工程保存

UV 与绘制结果实际修改原生数据，图像文件和工程均能持久化。

## 最小生产入口

- `web/app/src/app/WasmUVView.tsx`
- `web/app/src/app/WasmImageView.tsx`
- `web/protocol/paint.ts`
- `web/protocol/mesh-authoring-commands.ts`
- `blender-5.2.0/source/blender/web_engine/web_engine_main_state.cpp`
- `blender-5.2.0/source/blender/gpu/webgl/webgl_texture.cc`

以上为聚焦入口，非要求全文加载。使用源码聚焦工具、精确 --source/--unit 和函数片段；接入新 operator 时追加其具体原生文件，单次最多 8 个精确源码文件。没有默认测试入口或要运行的 fixture；功能完成前不执行任何验证。

## 只补未完成部分

1. 补齐 seam、unwrap/project、island selection/transform/pack、同步选择、多 UV 层及属性保存的真实 operator。
2. 几何相关 UV/拓扑操作按统一 OCCT 出口落实适配，不用 Three.js UV 算法替代。
3. 图像加载/生成/重载/另存、alpha/color space、UDIM 与序列资源接原生 Image；未保存像素与工程引用分开处理。
4. 完成 texture paint、vertex color/attribute paint、weight paint 的笔划/采样/混合/遮罩和 undo。
5. 实现纹理脏区上传、brush/selection overlay 与跨编辑器更新；需要 image compute 的具体路径由 DW16 提供，不让整个普通 UV 工作被无关依赖阻塞。

## 失败边界

显示贴图不等于像素可编辑；保存 blend 不自动表示外部修改过的图像已经保存。

## 实现交接与后续使用

交付前必须具有实际入口→原生执行→消费者/结果→错误/取消→适用 history/save 的生产代码。这里是实现交付条件，不运行验收；编译成功不能替代功能。旧的已完成子项可引用并保留，不能声称本轮重新实现。

用户使用阶段的场景（现在不执行）：展开模型 UV，纹理绘制后保存图像及工程，重开检查关联并继续绘制。

每次记录保留成果、补齐断点、仍有缺口、必要构件与下一动作。共同规则见同目录 `EXECUTION.md`，首次领取时阅读；不要将完整计划作为后续执行上下文。