Files
AnyImage/openspec/specs/image-edit-results/spec.md
nan 198fcbf55b
Some checks failed
Test / test (push) Has been cancelled
Initial public release
2026-09-19 21:31:36 +08:00

2.7 KiB
Raw Blame History

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 数据继续按对应材质贴图规则命名