Add new functionality for image rectification and depth metadata handling

- Implemented a preview tool for rectifying images with interactive aspect controls in `preview.py`.
- Added tests for depth metadata loading to ensure consistent schema usage in `test_depth_metadata.py`.
- Developed comprehensive tests for cutout calibration processes in `test_cutout_calibration.py`, including stability checks and depth calibration.
- Created tests for frame compositing operations in `test_frame_compositing.py`, ensuring correct handling of depth and transparency.
- Introduced material slot inheritance functionality in `material_slots.py` to manage geometry material assignments.
- Built shared shader nodes for material processing in `shader.py`, including roughness and bump mapping setups.

tools/nodes/groups/image_depth_balloon.py

@@ -110,21 +110,22 @@ def build_image_depth_balloon_group():
     group = bpy.data.node_groups.new(name, 'GeometryNodeTree')
     group.is_modifier, group.use_fake_user = (True, True)
     group.color_tag = 'GEOMETRY'
-    group['anyimage_asset_revision'] = 12
+    group['anyimage_asset_revision'] = 14
     interface_socket(group, 'Geometry', 'INPUT', 'NodeSocketGeometry')
-    float_input(group, 'Thickness', 1.0).description = 'Balloon profile multiplier; zero returns the sheet'
+    float_input(group, 'Thickness', 1.0).description = 'Control how much the surface bulges. Zero removes the bulge.'
     float_input(group, 'Depth Scale', 1.0)
     bool_input(group, 'Double Sided', True)
     iterations = interface_socket(group, 'Smooth', 'INPUT', 'NodeSocketInt')
+    iterations.description = 'Set the number of mesh smoothing passes. Higher values smooth the surface more but may soften details. Zero disables smoothing.'
     iterations.default_value = 0
     iterations.min_value, iterations.max_value = (0, 20)
     options = group.interface.new_panel(name='Options', default_closed=True)
     float_input(group, 'Cleanup Threshold', 0.0, parent=options)
-    float_input(group, 'Smooth Weight', 1.0, maximum=1, subtype='FACTOR', parent=options)
+    float_input(group, 'Smooth Weight', 1.0, maximum=1, subtype='FACTOR', parent=options).description = 'Control the strength of each mesh smoothing pass. Higher values move vertices more.'
     float_input(group, 'Reference Depth', 1.0, subtype='DISTANCE', parent=options)
+    interface_socket(group, 'Depth Axis', 'INPUT', 'NodeSocketMenu', options).menu_expanded = True
     vector_input(group, 'Depth Direction', (0, 0, 1), subtype='DIRECTION', parent=options)
     data = group.interface.new_panel(name='Data', default_closed=True)
-    interface_socket(group, 'Inward Axis', 'INPUT', 'NodeSocketMenu', data).hide_in_modifier = True
     float_input(group, 'Uniform Scale', 1.0, parent=data).hide_in_modifier = True
     interface_socket(group, 'Depth Image', 'INPUT', 'NodeSocketImage', data).hide_in_modifier = True
     interface_socket(group, 'Geometry', 'OUTPUT', 'NodeSocketGeometry')
@@ -145,7 +146,7 @@ def build_image_depth_balloon_group():
     orient = group.nodes.new('GeometryNodeTransform')
     orient.inputs['Rotation'].default_value = Matrix(CUTOUT_Z_TO_X).to_euler()
     group.links.new(geometry, orient.inputs['Geometry'])
-    axis = menu_switch(group, 'Inward Axis', ('-Z', '+X'), 'GEOMETRY')
+    axis = menu_switch(group, 'Depth Axis', ('-Z', '+X'), 'GEOMETRY')
     group.links.new(geometry, axis.inputs['-Z'])
     group.links.new(orient.outputs[0], axis.inputs['+X'])
     _shade_output(group, axis.outputs[0])
@@ -155,8 +156,6 @@ def build_image_depth_balloon_group():
             continue
         if item.name == 'Mode':
             item.default_value = 'Balloon'
-        elif item.name == 'Inward Axis':
+        elif item.name == 'Depth Axis':
             item.default_value = '-Z'
-        elif item.name == 'Uniform Thickness':
-            item.name = 'Thickness'
     return group