feat(cutout): implement boundary padding for cutout textures

- Introduced a new `Boundary Padding` preference in the Cutout Tool with a default of 2 px and a configurable range of 1-4 px.
- Updated the Cutout client to establish inward mapping from the final Mask, sampling in a fixed direction and processing independent material RGBA and Depth.
- Enhanced the handling of RGBA and Depth during cutout operations, ensuring proper mapping and preservation of source data.
- Added tests to validate the new boundary padding functionality and its integration with existing cutout processes.

feat(geometry): remove overall mesh smoothing from geometry nodes

- Removed the `Smooth` input from several geometry node groups to eliminate unnecessary overall mesh smoothing.
- Retained `Smooth Weight` for depth nodes while removing it from Cutout and Relief Plane nodes.
- Ensured that boundary, normal, and fill smoothing behaviors remain intact and consistent.
- Updated tests and documentation to reflect the changes in node interfaces and behaviors.

feat(normals): scale tangent normals with depth

- Reused the existing `o_normal_reduction` attribute to adjust Tangent Normal strength based on the geometry's `Depth Scale`.
- Ensured that Tangent Normal strength is consistent with the geometry depth, preserving full strength for materials that do not provide the attribute.
- Updated tests to verify the correct behavior of normal strength adjustments in both Tangent and Object Space.

tools/nodes/groups/image_cutout_symmetry.py

@@ -16,19 +16,30 @@ def _align_front(group, geometry, controls):
     nodes, links = group.nodes, group.links
     align = nodes.new('FunctionNodeAlignEulerToVector')
     align.axis = 'Z'
-    links.new(controls['Symmetry Direction'], align.inputs['Vector'])
+    links.new(controls['Direction'], align.inputs['Vector'])
     position = nodes.new('GeometryNodeInputPosition')
     rotate = nodes.new('ShaderNodeVectorRotate')
     rotate.rotation_type = 'EULER_XYZ'
     rotate.invert = True
     links.new(position.outputs[0], rotate.inputs['Vector'])
     links.new(align.outputs['Rotation'], rotate.inputs['Rotation'])
+    offset = nodes.new('ShaderNodeCombineXYZ')
+    links.new(controls['Offset'], offset.inputs['Z'])
+    offset_position = nodes.new('ShaderNodeVectorMath')
+    offset_position.operation = 'ADD'
+    links.new(rotate.outputs[0], offset_position.inputs[0])
+    links.new(offset.outputs[0], offset_position.inputs[1])
+    scale_vector = nodes.new('ShaderNodeCombineXYZ')
+    scale_vector.inputs['X'].default_value = 1
+    scale_vector.inputs['Y'].default_value = 1
+    links.new(controls['Scale'], scale_vector.inputs['Z'])
+    scale = nodes.new('ShaderNodeVectorMath')
+    scale.operation = 'MULTIPLY'
+    links.new(offset_position.outputs[0], scale.inputs[0])
+    links.new(scale_vector.outputs[0], scale.inputs[1])
     place = nodes.new('GeometryNodeSetPosition')
     links.new(geometry, place.inputs['Geometry'])
-    links.new(rotate.outputs[0], place.inputs['Position'])
-    offset = nodes.new('ShaderNodeCombineXYZ')
-    links.new(controls['Depth Offset'], offset.inputs['Z'])
-    links.new(offset.outputs[0], place.inputs['Offset'])
+    links.new(scale.outputs[0], place.inputs['Position'])
     store = nodes.new('GeometryNodeStoreNamedAttribute')
     store.data_type, store.domain = 'FLOAT_VECTOR', 'FACE'
     store.inputs['Name'].default_value = ROTATION_ATTRIBUTE
@@ -142,11 +153,13 @@ def build_image_cutout_symmetry_group():
     group.is_modifier, group.use_fake_user = True, True
     group.color_tag = 'GEOMETRY'
     interface_socket(group, 'Geometry', 'INPUT', 'NodeSocketGeometry')
-    vector_input(group, 'Symmetry Direction', (0, 0, 1), subtype='DIRECTION').description = 'Align this direction with the local symmetry axis.'
-    float_input(group, 'Depth Offset', 0, minimum=-1e10, subtype='DISTANCE').description = 'Offset the aligned geometry along the symmetry axis.'
-    bool_input(group, 'Fill Sides', True).description = 'Connect matching front and mirrored boundaries.'
-    smooth = interface_socket(group, 'Fill Smooth', 'INPUT', 'NodeSocketInt')
-    smooth.default_value, smooth.min_value, smooth.max_value = 2, 0, 20
+    vector_input(group, 'Direction', (0, 0, 1), subtype='DIRECTION').description = 'Align this direction with the local symmetry axis.'
+    float_input(group, 'Offset', 0, minimum=-10, maximum=10, subtype='DISTANCE').description = 'Offset geometry along the aligned symmetry axis before scaling.'
+    float_input(group, 'Scale', 1, maximum=2).description = 'Scale the offset geometry along the aligned symmetry axis.'
+    options = group.interface.new_panel(name='Options', default_closed=True)
+    bool_input(group, 'Fill Sides', True, parent=options).description = 'Connect matching front and mirrored boundaries.'
+    smooth = interface_socket(group, 'Fill Smooth', 'INPUT', 'NodeSocketInt', options)
+    smooth.default_value, smooth.min_value, smooth.max_value = 2, 0, 16
     smooth.description = 'Smooth only the generated wall interiors. Zero keeps straight walls.'
     interface_socket(group, 'Geometry', 'OUTPUT', 'NodeSocketGeometry')
     nodes, links = group.nodes, group.links