Implement arrangement framework for node groups

- Introduced `frames.py` to manage field complex calculations and their arrangement within node groups.
- Added functionality to create and remove field frames based on node arrangements.
- Developed `passages.py` to find unobstructed paths for connections around calculation frames.
- Implemented `references.py` to route shared results on peripheral tracks, ensuring efficient distribution of outputs.
- Created `sections.py` to reserve space for field calculations adjacent to geometry consumers.
- Added `sources.py` to position shared calculation sources effectively beside their distribution channels.
- Enhanced outline smoothing with `outline_smoothing.py` to adapt camera depth along original outlines.

tools/nodes/groups/image_depth_plane.py

@@ -25,7 +25,7 @@ def build_image_depth_plane_group(image_plane_group):
         "GeometryNodeTree",
     )
     group.is_modifier = True
-    group["anyimage_asset_revision"] = 14
+    group["anyimage_asset_revision"] = 16
     geometry = _interface_socket(group, "Geometry", "INPUT", "NodeSocketGeometry")
     geometry.structure_type = "SINGLE"
     subdivide = _interface_socket(group, "Subdivide", "INPUT", "NodeSocketInt")
@@ -40,35 +40,18 @@ def build_image_depth_plane_group(image_plane_group):
     depth_scale = _interface_socket(group, "Depth Scale", "INPUT", "NodeSocketFloat")
     depth_scale.default_value = 1.0
     depth_scale.min_value = 0.0
-    float_input(group, "Split Threshold", 0.0, maximum=1, subtype="FACTOR")
+    float_input(group, "Split Threshold", 0.1, maximum=1, subtype="FACTOR")
     iterations = _interface_socket(group, "Smooth", "INPUT", "NodeSocketInt")
     iterations.default_value = 0
     iterations.min_value, iterations.max_value = 0, 20
     valid_only = _interface_socket(group, "Valid Only", "INPUT", "NodeSocketBool")
     valid_only.default_value = True
     options = group.interface.new_panel(name="Options", default_closed=True)
+    float_input(group, "Smooth Weight", 1.0, maximum=1, subtype="FACTOR", parent=options)
+    float_input(group, "Reference Depth", 1.0, subtype="DISTANCE", parent=options)
     boundary_smooth = _interface_socket(group, "Boundary Smooth", "INPUT", "NodeSocketInt", parent=options)
-    boundary_smooth.default_value, boundary_smooth.min_value, boundary_smooth.max_value = 5, 0, 20
+    boundary_smooth.default_value, boundary_smooth.min_value, boundary_smooth.max_value = 2, 0, 20
     boundary_smooth.description = "Smooth boundary depth and cut-edge geometry while preserving the original image border"
-    base_plane_depth = _interface_socket(
-        group,
-        "Reference Depth",
-        "INPUT",
-        "NodeSocketFloat",
-        parent=options,
-    )
-    base_plane_depth.default_value = 1.0
-    base_plane_depth.min_value = 0.0
-    base_plane_depth.subtype = "DISTANCE"
-    normal_smooth = _interface_socket(
-        group, "Normal Smooth", "INPUT", "NodeSocketInt", parent=options,
-    )
-    normal_smooth.default_value, normal_smooth.min_value, normal_smooth.max_value = 50, 0, 50
-    normal_smooth.description = "Smooth the shell thickness direction"
-    smooth_weight = _interface_socket(group, "Smooth Weight", "INPUT", "NodeSocketFloat", parent=options)
-    smooth_weight.default_value = 1.0
-    smooth_weight.min_value, smooth_weight.max_value = 0.0, 1.0
-    smooth_weight.subtype = "FACTOR"
     validity_threshold = _interface_socket(group, "Validity Threshold", "INPUT", "NodeSocketFloat", parent=options)
     validity_threshold.default_value = 0.9
     validity_threshold.min_value, validity_threshold.max_value = 0.0, 1.0
@@ -134,9 +117,10 @@ def build_image_depth_plane_group(image_plane_group):
     links.new(culled, cull.inputs["True"])
     links.new(protected, cull.inputs["False"])
     split_input = _group_input(nodes, {"Split Threshold"})
+    reference_input = _group_input(nodes, {"Reference Depth"})
     geometry, corner_camera, cut_vertex = split_depth_surface(
         group, cull.outputs["Output"], sample_face_camera(group, texture_input.outputs["Depth Image"]),
-        split_input.outputs["Split Threshold"], scale_input.outputs["Uniform Scale"],
+        split_input.outputs["Split Threshold"], reference_input.outputs["Reference Depth"],
     )
     camera = build_surface_camera(
         group, texture.outputs["Color"], corner_camera, cut_vertex,
@@ -150,10 +134,10 @@ def build_image_depth_plane_group(image_plane_group):
         depth_input.outputs["Depth Scale"], split_input.outputs["Split Threshold"],
     )
     surface = smooth_cut_boundary(group, surface, original_boundary)
-    shell_input = _group_input(nodes, {"Thickness", "Normal Smooth"})
+    shell_input = _group_input(nodes, {"Thickness"})
     shell = thicken_depth_surface(
         group, surface, shell_input.outputs["Thickness"],
-        normal_smooth=shell_input.outputs["Normal Smooth"],
+        normal_smooth=100,
     )
     positive = nodes.new("ShaderNodeMath")
     positive.operation = "GREATER_THAN"