AnyImage/openspec/changes/optimize-cutout-geometry-nodes/specs/cutout-attribute-lifecycle/spec.md at c681d51fd10e112892baa7b2934fe575200d4439

Files

nan 7f878a2f3f Optimize Cutout Geometry Nodes

- Refactor Depth Cutout to reuse the projected outline field, reducing redundant boundary calculations and improving performance.
- Derive the center field from shared low-frequency fields, eliminating an unnecessary blur operation.
- Implement triangle-only strip cleanup for Depth Cutout, as the input is confirmed to be triangulated.
- Short-circuit zero-thickness branches in both Cutout and Depth Cutout to avoid unnecessary geometry generation.
- Standardize internal attribute naming with a new `_o_` prefix and implement wildcard cleanup for temporary attributes.
- Update relevant tests to ensure functionality remains consistent and validate changes against existing behavior.

2026-09-16 09:11:25 +08:00

2.2 KiB

Raw Blame History

ADDED Requirements

Requirement: Internal Cutout attributes use the `_o_` prefix

Attributes that exist only inside the Cutout geometry node lifecycle and are removed before output SHALL use the _o_ prefix. The system SHALL NOT use the previous .o_anyimage_* prefix for new internal attributes.

Scenario: Split marker is stored as an internal attribute

WHEN Depth Cutout or another depth surface stores the split marker during edge separation
THEN the stored name starts with _o_ and is removed before the node group output

Scenario: Old internal marker names are not emitted

WHEN a Cutout node group is evaluated
THEN no .o_anyimage_depth_cut or .o_anyimage_original_boundary attribute remains on the output geometry

Requirement: Public Cutout attributes keep the `o_` prefix

Attributes that are part of the Cutout shape, normal, or material protocol SHALL keep the o_ prefix and SHALL NOT be removed by internal cleanup.

Scenario: Public shape and normal attributes survive cleanup

WHEN Cutout or Depth Cutout outputs geometry
THEN o_balloon, o_normal_reduction, and existing o_depth_* public protocol attributes remain available according to their current contracts

Scenario: UVMap and user attributes survive cleanup

WHEN input geometry contains UVMap and user attributes
THEN internal cleanup preserves those attributes without renaming them

Requirement: Internal attributes are removed by a single wildcard operation

Each depth surface group SHALL remove its _o_* internal attributes with one Remove Named Attribute node using wildcard mode before output. It SHALL NOT remove internal attributes one by one.

Scenario: Wildcard cleanup removes all internal attributes

WHEN a depth surface group evaluates with Split or Thickness enabled
THEN every _o_* attribute is absent from the output geometry

Scenario: Wildcard cleanup is safe when no internal attribute exists

WHEN a depth surface group evaluates with the corresponding internal path disabled
THEN the wildcard removal produces no missing-attribute warning and leaves public attributes unchanged

2.2 KiB Raw Blame History