AnyImage/openspec/changes/refine-cutout-symmetry-seam/specs/cutout-symmetry-seam/spec.md at c62ec2cd4863a5ef7883c9b01d9888a8ec5be7ba

Files

nan c62ec2cd48 Refactor depth surface handling and unify depth sampling rules

- Removed the `always_vertex` parameter from `build_surface_camera` to streamline depth sampling for cutouts and ensure consistent behavior across depth plane and panorama.
- Updated depth sampling logic to ensure that all free boundary points, including the original frame of the depth plane, use neighboring face depth instead of their own texture sampling.
- Adjusted the depth mask deletion process to operate on faces rather than points, eliminating the need for additional cleanup of dangling edges.
- Ensured that the cutout rules are consistently applied across all relevant nodes, removing exceptions and simplifying the logic.
- Updated tests to verify the new behavior, ensuring that cutout points follow the depth of adjacent faces and that the original frame maintains its depth sampling.
- Refactored geometry handling in multiple depth-related nodes to improve clarity and maintainability.

2026-09-16 16:30:56 +08:00

5.1 KiB

Raw Blame History

ADDED Requirements

Requirement: 切口落在对称面上

对称节点 SHALL 让切口边缘落在对称面上，零厚度与非零厚度输入走同一条折叠路径：越过对称面的顶点 SHALL 拉回对称面，只删除因此整体落在对称面上的面，并删除折叠后仍邻接两个面的内部贴平边及其邻接面。保留几何中不得存在越过对称面的顶点，也不得留下整体落在对称面上的面或四面共边。

Scenario: 折叠过界部分

WHEN 输入几何的一部分穿过对称面
THEN 跨界面的面保留，越界顶点对称轴坐标归零，界内顶点位置不变
AND 保留几何中不存在越过对称面的顶点

Scenario: 清理内部贴平边

WHEN 折叠后出现落在对称面上、且仍邻接两个面的边
THEN 这条边及其邻接面被删除，切口重新成为边界边
AND 输出中不存在四面共边

Scenario: 不同厚度得到同一切边位置

WHEN 同一 Cutout 分别以零厚度与非零厚度连接到对称节点
THEN 两种情况都折叠并把切口边缘归零，切边落在对称面上
AND 两侧顶点关于对称面对称，且都不越过对称面的几何尺度派生容差

Scenario: 裁切后不留平面面片

WHEN 切口边缘归零使某个面完全落到对称面上，或输入本身存在这类面
THEN 该面不出现在输出中

Scenario: 几何全部位于界外

WHEN 输入几何整体越过对称面
THEN 输出为空几何，节点不报错

Requirement: 接缝由镜像合并自焊

对称节点 SHALL 在镜像之前完成切口归零，使两侧切口顶点重合，并 SHALL 在合并后形成共享边。开启 Fill Sides 时输出网格 SHALL 封闭，且边与顶点流形。

Scenario: 开启补面的封闭结果

WHEN Fill Sides 开启且输入包含跨对称面的几何
THEN 输出的每条边恰好邻接两个面，顶点与边满足流形性，面绕序一致
AND 两侧顶点关于对称面对称

Scenario: 关闭补面

WHEN Fill Sides 关闭
THEN 切口仍吸附到对称面并完成自焊
AND 开边只出现在没有侧壁的外轮廓处

Requirement: 补面只覆盖不落在对称面上的边界边

Fill Sides 生成的侧壁 SHALL 只连接不落在对称面上的边界边，落在对称面上的切口环 SHALL 不生成侧壁几何。补面选择 SHALL 按顶点是否越过对称面容差判断。

Scenario: 切口处不生成侧壁

WHEN Fill Sides 开启且切口环顶点归零后落在对称面上
THEN 输出中不存在顶点全部落在对称面上的补面面片
AND 切口环在合并后为共享边

Scenario: 外轮廓仍生成侧壁

WHEN 输入外轮廓的边界顶点不落在对称面上
THEN 这些边界按现有直壁或平滑侧壁构成连接
AND Fill Sides 关闭时不生成侧壁

Requirement: 切边平滑独立控制

Seam Smooth SHALL 控制切口环的面内平滑次数，Fill Smooth SHALL 控制 front 衔接带的面内平滑次数。两者都只移动面内分量并锁定对称轴坐标。侧壁细分 SHALL 始终存在，不以 Fill Smooth > 0 为开关。Seam Smooth 为 0 SHALL 保持原始切口，Fill Smooth 为 0 SHALL 保持原始轮廓；两个参数 SHALL 互不影响，且都与 Fill Sides 独立。

Seam Smooth 按切口环的两圈渐变衰减，切口环按 pinned-geometry-smoothing 的 Pin Boundary 与 Pin Sharp 处理。Fill Smooth 的锚点 SHALL 是 front 的完整边界带，即界外轮廓与对称面上的切缝，SHALL 按四圈渐变衰减并覆盖对称轴上的点；衔接处不是网格边界，因此 MUST NOT 套用 Pin Boundary，只保留 Pin Sharp。

Scenario: 切边平滑保持切口落在对称面

WHEN Seam Smooth 大于 0
THEN 切口环顶点的对称轴坐标保持在容差内，镜像对称关系成立
AND 平滑位移从切口环起按两圈渐变衰减，两圈之外保留表面顶点位置不变

Scenario: 两个平滑参数互不影响

WHEN 只改变 Fill Smooth 或只改变 Seam Smooth
THEN 前者只改变衔接带及其侧壁，后者只改变切口环及其两圈渐变范围
AND Seam Smooth 为 0 时切口保持原始形态，Fill Smooth 为 0 时轮廓保持原始形态且侧壁仍保持细分

Scenario: 衔接带覆盖对称轴

WHEN Fill Smooth 大于 0
THEN 界外轮廓与对称轴上的点都产生面内位移
AND 位移从完整边界带向内按四圈渐变衰减

Scenario: 关闭补面仍可平滑切边

WHEN Fill Sides 关闭且 Seam Smooth 大于 0
THEN 切口环仍按该参数平滑，侧壁不生成，Fill Smooth 无可作用的轮廓

Requirement: 节点不引入布尔与裁切

对称节点 SHALL 沿用现有节点集合完成切口，不新增布尔、裁切或细分节点。

Scenario: 检查构建结果

WHEN 检查构建出的 O Image Cutout Symmetry 节点组
THEN 节点图中不存在布尔类节点
AND 接口在原有输入之外只新增 Seam Smooth

5.1 KiB Raw Blame History Unescape Escape