Refactor Cutout and Image Editing Logic
- 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.
This commit is contained in:
@@ -0,0 +1,68 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Refine preserves the submitted bounds canvas
|
||||
系统 SHALL 让 BEN2 Refine 输出保持输入 RGBA 的完整矩形尺寸，并沿用提交前的 Selection bounds；Server MUST 不按生成 Alpha 紧裁切输出，也 MUST 不接收 Selection Mask。
|
||||
|
||||
#### Scenario: BEN2 output occupies only part of the bounds
|
||||
- **WHEN** BEN2 只在输入矩形的一部分生成可见 Alpha
|
||||
- **THEN** Refine 输出 SHALL 保留完整输入尺寸和透明区域，Blender SHALL 沿用提交前保存的 bounds
|
||||
|
||||
#### Scenario: Refine Job reports its files
|
||||
- **WHEN** `refine-image-selection` 或 Cutout artifact Job 完成 Refine
|
||||
- **THEN** Job SHALL 返回完整尺寸的 Refine 图片，并且 MUST 不生成或返回 Refine 后的局部 bounds 文件
|
||||
|
||||
### Requirement: Refined content Alpha combines source and BEN2
|
||||
BEN2 Refine 内容 Alpha SHALL 等于 `Source Alpha × BEN2 Alpha`，并且 Selection Mask MUST 不参与 BEN2 推理或 Server 端 Refine 输出。
|
||||
|
||||
#### Scenario: Source contains transparent pixels
|
||||
- **WHEN** BEN2 在源 Alpha 为零或半透明的像素生成前景 Alpha
|
||||
- **THEN** Refine 图片 SHALL 通过 `preserve_input_alpha` 保持源 Alpha 与 BEN2 Alpha 的乘积
|
||||
|
||||
#### Scenario: Selection excludes visible content inside bounds
|
||||
- **WHEN** bounds 内存在位于 Selection Mask 外的可见内容
|
||||
- **THEN** BEN2 与 Server Refine 输出 SHALL 仍能使用并保留该内容，不得预先乘入 Selection Mask
|
||||
|
||||
### Requirement: Cutout textures share refined content scope
|
||||
启用 Refine Selection 的 Cutout SHALL 使用同一份 `Source Alpha × BEN2 Alpha` 内容生成 Color、Normal 与 Depth 贴图，Selection Mask MUST 不限制这些贴图的生成。
|
||||
|
||||
#### Scenario: Cutout generates color and normal
|
||||
- **WHEN** Cutout 同时启用 Refine Selection 与 Normal Map
|
||||
- **THEN** Color Alpha 与 Normal 可见区域 SHALL 来自完整 Refine 图片 Alpha，不得乘入 Selection Mask
|
||||
|
||||
#### Scenario: Cutout generates depth
|
||||
- **WHEN** Refined Cutout 生成 Vector 或 Z Depth
|
||||
- **THEN** MoGe-2 黑底输入和 Depth Metadata 参考内容范围 SHALL 来自完整 Refine 图片 Alpha，不得乘入 Selection Mask
|
||||
|
||||
#### Scenario: Depth texture preserves model validity
|
||||
- **WHEN** 系统写出 Vector 或 Z Depth EXR
|
||||
- **THEN** RGB SHALL 保留完整连续 Field，Alpha SHALL 保存 MoGe-2 Validity，不得用 Refine Alpha 或 Selection Mask 覆盖
|
||||
|
||||
### Requirement: Cutout mesh combines refined content with Selection
|
||||
Cutout SHALL 只在 Blender 网格构建阶段计算 `Source Alpha × BEN2 Alpha × Selection Mask`，并使用该结果约束 BaseShape、内容空值检查和网格标定。
|
||||
|
||||
#### Scenario: BEN2 keeps content outside the user Selection
|
||||
- **WHEN** BEN2 在 Selection bounds 内保留了 Selection Mask 外的前景
|
||||
- **THEN** Color、Normal 与 Depth SHALL 保留该内容，但最终 Cutout 网格 MUST 不包含 Selection Mask 外的区域
|
||||
|
||||
#### Scenario: Combined Cutout content is empty
|
||||
- **WHEN** Refine Alpha 与 Selection Mask 相乘后没有超过 Cutout Alpha 阈值的像素
|
||||
- **THEN** Cutout SHALL 报告空内容且不创建网格
|
||||
|
||||
#### Scenario: Cutout generates only Normal or Depth
|
||||
- **WHEN** Cutout 未启用 Refine、但因 Normal 或 Depth 进入 Job
|
||||
- **THEN** 贴图 SHALL 使用完整 bounds 源 Alpha，网格 SHALL 使用 `Source Alpha × Selection Mask`
|
||||
|
||||
### Requirement: Crop Refine applies Selection in Blender
|
||||
Crop Refine SHALL 在 Blender 中计算 `Source Alpha × BEN2 Alpha × Selection Mask` 作为最终图片 Alpha，同时保持提交前的矩形尺寸和 placement bounds。
|
||||
|
||||
#### Scenario: BEN2 keeps pixels outside a Crop Selection
|
||||
- **WHEN** BEN2 在 Crop Selection Mask 外生成可见 Alpha
|
||||
- **THEN** 最终 Crop 图片 SHALL 将这些像素 Alpha 置为零，但 MUST 不改变提交前 bounds
|
||||
|
||||
#### Scenario: Crop uses one rasterized Selection
|
||||
- **WHEN** Crop 提交 Refine Job 并异步接收结果
|
||||
- **THEN** 系统 SHALL 复用提交阶段生成的 Selection Mask，不得在响应阶段重新栅格化 SelectionPath，也不得把 Mask 发送给 Server
|
||||
|
||||
#### Scenario: Combined Crop content is empty
|
||||
- **WHEN** Refine Alpha 与 Selection Mask 相乘后没有可见像素
|
||||
- **THEN** Crop SHALL 报告空内容且不创建结果 Image Empty
|
||||
Reference in New Issue
Block a user