nan
bdbde1a10d
- Renamed "Base Plane Depth" to "Reference Depth" across validate_cutout.py for consistency. - Introduced a new specification for Cutout mesh sampling to ensure source pixel spacing is preserved and limits are applied correctly. - Unified naming conventions for image editing results to maintain consistency across Remove Background, Upscale, and Crop operations. - Updated the handling of Refine Selection to ensure it retains the original bounds and does not apply unnecessary cropping. - Enhanced material generation logic to connect image color directly to IOR Level, improving the rendering of dark areas. - Established clear requirements for geometry depth controls and image result materials to ensure consistent behavior across different components. - Removed outdated logic and ensured all changes are documented and tested for regression.
44 lines
2.7 KiB
Markdown
44 lines
2.7 KiB
Markdown
## Purpose
|
||
|
||
规定直接编辑 Image Empty 时结果 Image 数据块的统一身份与命名，使共享引用只由 Blender 的数据块唯一性规则产生差异。
|
||
|
||
## ADDED 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 数据继续按对应材质贴图规则命名
|
||
|