Files
AnyImage/openspec/changes/archive/2026-09-17-improve-relief-depth-controls/tasks.md
nan 198fcbf55b
Some checks failed
Test / test (push) Has been cancelled
Initial public release
2026-09-19 21:31:36 +08:00

1.7 KiB

1. Relief depth behavior

  • 1.1 Add the public Depth Offset distance input to O Image Relief Plane, with a default of one and signed range; expose Depth Direction, Depth Offset, and Depth Scale directly below Thickness in that order.
  • 1.2 Add Depth Offset to Reference Depth before reference_plane_depth(), then replace the thickness-dependent inward limit with a zero clamp after direction adjustment and Depth Scale, preserving fixed-base and side-layer weighting.

2. Behavior verification

  • 2.1 Update Relief Plane geometry tests to verify far depths stop at Thickness, positive depths remain unrestricted, and the fixed base and side interpolation remain valid.
  • 2.2 Add positive, negative, and zero Depth Offset tests, including direction adjustment, Depth Scale = 0, and checks that Depth Offset is scaled as part of the corrected relative depth while the depth-zero height remains fixed.
  • 2.3 Update the node-group interface inventory test for Depth Direction and Depth Offset names, order, panel placement, and old base-plane clamp behavior.

3. Node asset

  • 3.1 Run uv run node-group build to rebuild and validate src/anyimage/assets/O_AnyImage.blend from the updated source and tests.
  • 3.2 Run the relevant Relief Plane and plane-object tests, then inspect the final diff for stale inward-limit nodes or old behavior references.

4. Initial depth direction

  • 4.1 Extract the robust plane-direction fit into common.depth and reuse it from Cutout Symmetry calibration.
  • 4.2 Fit the complete valid Relief depth image in local plane coordinates and initialize the new Modifier's Depth Direction.
  • 4.3 Add sloped-depth initialization and shared calibration regression tests.