2.7 KiB
2.7 KiB
image-edit-results Specification
Purpose
TBD - created by archiving change fix-cutout-density-and-image-edit-names. Update Purpose after archive.
Requirements
Requirement: Direct image edits preserve the complete source name
Remove Background、Upscale、Crop Box、Crop Lasso、Crop Polyline 和 Crop Perspective SHALL 使用源 Image 数据块的完整名称请求结果 Image 名称,包括名称中的 .png 等格式文字,并 SHALL NOT 主动添加材质贴图后缀。
Scenario: Remove Background edits a shared image
- WHEN Remove Background 编辑一个仍被其他对象引用的 Image
- THEN 新结果以源 Image 的完整名称请求命名,唯一性数字后缀仅由 Blender 自动追加
Scenario: Upscale edits a shared image
- WHEN Upscale 编辑一个仍被其他对象引用的 Image
- THEN 新结果保留源 Image 的完整名称且不添加
_color
Scenario: Selection Crop edits a shared image
- WHEN 任一 Selection Crop 路径编辑一个仍被其他对象引用的 Image,无论是否启用 Refine Selection 或 Keep Original
- THEN 新结果保留源 Image 的完整名称且不移除名称中的格式文字
Scenario: Perspective Crop edits a shared image
- WHEN Crop Perspective 编辑一个仍被其他对象引用的 Image,无论是否启用 Keep Original
- THEN 新结果保留源 Image 的完整名称且不移除名称中的格式文字
Requirement: Image replacement follows Blender data-block identity
系统 SHALL 在源 Image 只由被编辑对象使用时以结果替换并清理旧数据,使结果最终恢复源 Image 的准确名称;源 Image 仍被共享或被 Keep Original 保留时,系统 SHALL 保留源数据并接受 Blender 自动生成的数字唯一性后缀。
Scenario: Unshared source is replaced
- WHEN 直接图片编辑替换一个没有其他用户且没有 Fake User 的源 Image
- THEN 旧 Image 被清理且结果 Image 最终使用源 Image 的准确名称
Scenario: Shared source is split
- WHEN 直接图片编辑替换一个仍有其他用户的源 Image
- THEN 其他用户继续引用源 Image,被编辑对象引用新结果,两个数据块的重名冲突由 Blender 自动解决
Requirement: Material texture naming remains separate
系统 SHALL 仅对 Plane、Depth Plane、Cutout Shape 等生成材质贴图的工作流使用 _color.png、_depth.exr、_normal.png 等业务后缀,直接图片编辑 SHALL NOT 复用这些派生贴图名称。
Scenario: Plane conversion creates material textures
- WHEN 图片被转换为需要材质贴图的 Plane 或 Cutout 结果
- THEN 其 Color、Depth 和 Normal 数据继续按对应材质贴图规则命名