- Introduced the two-times upscale specification detailing requirements for unified output, fixed model presets, arbitrary dimensions, and consistent job behavior. - Added scenarios for existing models, repeated upscale, and handling of alpha preservation. - Created the unified depth plane specification outlining geometry modes, stable interface, and asset evaluation. - Defined scenarios for mode switching, relief and camera preservation, and validation of delivered assets.
28 lines
1.5 KiB
Markdown
28 lines
1.5 KiB
Markdown
# geometry-depth-controls Specification
|
||
|
||
## Purpose
|
||
TBD - created by archiving change refine-image-output-semantics. Update Purpose after archive.
|
||
## Requirements
|
||
### Requirement: Geometry depth groups expose Reference Depth
|
||
系统 SHALL 在 `O Image Depth Plane`、`O Image Cutout`、Depth Balloon 与 Depth Surface 的 Geometry Nodes 接口中使用 `Reference Depth` 表示深度纹理的参考距离,并且 MUST 不再公开 `Base Plane Depth`。
|
||
|
||
#### Scenario: Depth Plane initializes its reference
|
||
- **WHEN** 系统根据 `depth.json` 创建 Depth Plane Modifier
|
||
- **THEN** `reference_depth × uniform_scale` SHALL 写入 `Reference Depth`
|
||
|
||
#### Scenario: Depth Cutout initializes its reference
|
||
- **WHEN** 系统根据最终网格内容标定 Depth Balloon 或 Depth Surface
|
||
- **THEN** 标定结果 SHALL 写入主 Cutout 与对应子组的 `Reference Depth`
|
||
|
||
#### Scenario: Node asset exposes the current interface only
|
||
- **WHEN** 系统构建并验证 `O_AnyImage.blend`
|
||
- **THEN** 所有相关节点组、面板、依赖连线和 Modifier 输入 SHALL 只包含 `Reference Depth`,不得保留旧名称或兼容 socket
|
||
|
||
### Requirement: Reference Depth keeps existing geometry meaning
|
||
`Reference Depth` SHALL 继续作为采样 Depth 的运算基准,不改变 Depth Plane、Depth Balloon 或 Depth Surface 的几何方向、尺度、厚度和位移公式。
|
||
|
||
#### Scenario: Reference control changes relative depth
|
||
- **WHEN** 用户修改 `Reference Depth`
|
||
- **THEN** Geometry Nodes SHALL 使用 `Reference Depth - sampled depth` 的既有相对深度关系更新几何
|
||
|