2.1 KiB
2.1 KiB
pasted-brush-preview Specification
Purpose
TBD - created by archiving change update-pasted-brush-preview. Update Purpose after archive.
Requirements
Requirement: Texture Paint 粘贴同步笔刷预览
系统 SHALL 在 Texture Paint 模式成功绑定粘贴图片后，将当前可编辑笔刷的自定义预览更新为该图片，并刷新相关界面。
Scenario: 外部库笔刷首次粘贴
- WHEN 当前笔刷来自外部库，用户在 Texture Paint 模式粘贴图片
- THEN 创建并激活的本地笔刷副本使用该图片作为纹理和自定义预览
Scenario: 已有笔刷重复粘贴
- WHEN 用户向当前可编辑笔刷粘贴另一张图片
- THEN 同一笔刷的纹理和预览同步更新为新图片
Scenario: 其他绘制模式粘贴
- WHEN 用户在 Sculpt 或 Vertex Paint 模式粘贴图片
- THEN 系统沿用该模式现有纹理绑定行为并保留笔刷原预览
Requirement: 预览使用已打包图片并保留显示效果
系统 SHALL 支持从已打包的剪贴板图片生成预览，保持图片宽高比和透明区域；源图片像素、尺寸及打包状态 MUST 保持。
Scenario: 非正方形透明图片
- WHEN 用户粘贴已打包且原临时文件已删除的非正方形透明图片
- THEN 笔刷预览展示完整图片，保持比例和透明区域，源图片数据保持
Requirement: 预览随文件保存
笔刷自定义预览 SHALL 随当前 .blend 文件保存，在预览临时文件清理后仍可恢复。
Scenario: 保存后重新打开
- WHEN 用户成功更新笔刷预览，保存并重新打开
.blend文件 - THEN 对应本地笔刷仍显示该图片预览
Requirement: 预览失败保留可用纹理
预览更新失败时系统 SHALL 保留已绑定纹理并提示预览更新失败；预览临时文件 MUST 在成功或失败后清理。
Scenario: Blender 拒绝加载预览
- WHEN 纹理已绑定但自定义预览加载失败
- THEN 笔刷仍可使用粘贴纹理绘制，用户收到预览失败提示，临时文件被清理