Refactor Cutout and Image Editing Logic

- Renamed "Base Plane Depth" to "Reference Depth" across validate_cutout.py for consistency.
- Introduced a new specification for Cutout mesh sampling to ensure source pixel spacing is preserved and limits are applied correctly.
- Unified naming conventions for image editing results to maintain consistency across Remove Background, Upscale, and Crop operations.
- Updated the handling of Refine Selection to ensure it retains the original bounds and does not apply unnecessary cropping.
- Enhanced material generation logic to connect image color directly to IOR Level, improving the rendering of dark areas.
- Established clear requirements for geometry depth controls and image result materials to ensure consistent behavior across different components.
- Removed outdated logic and ensured all changes are documented and tested for regression.

tests/test_cutout_interaction.py

@@ -81,7 +81,7 @@ def test_cutout_pie_uses_two_local_shapes_without_ai(monkeypatch):
     )
     assert not any(call[2].refine_selection for call in window_manager.pie.calls)
     assert not any(call[2].generate_normal for call in window_manager.pie.calls)
-    assert all(call[2].mesh_resolution == 64 for call in window_manager.pie.calls)
+    assert all(call[2].point_spacing == 32 for call in window_manager.pie.calls)
     assert all(call[2].inward_axis == "NEGATIVE_Z" for call in window_manager.pie.calls)
 
 
@@ -134,7 +134,7 @@ def test_cutout_pie_passes_image_lasso_options_to_all_ai_shapes(monkeypatch):
         SelectionPath.from_json(call[2].selection_path_json).invert
         for call in window_manager.pie.calls
     )
-    assert all(call[2].mesh_resolution == 256 for call in window_manager.pie.calls)
+    assert all(call[2].point_spacing == 16 for call in window_manager.pie.calls)
     assert all(call[2].inward_axis == "POSITIVE_X" for call in window_manager.pie.calls)
 
 
@@ -146,12 +146,6 @@ def test_cutout_normal_space_is_derived_from_shape():
     assert cutout_main.normal_mode_for_shape("DEPTH_SURFACE", True) == "OBJECT"
 
 
-def test_cutout_mesh_detail_tracks_the_source_long_edge_and_clamps():
-    assert interaction.cutout_mesh_resolution((4096, 2048), 32) == 128
-    assert interaction.cutout_mesh_resolution((16, 8), 4) == 4
-    assert interaction.cutout_mesh_resolution((65536, 32768), 4) == 1024
-
-
 def test_cutout_mesh_detail_maps_to_denser_sampling():
     assert [
         interaction.cutout_mesh_detail_spacing(detail)
@@ -207,7 +201,7 @@ def test_cutout_reuses_image_lasso_gesture_and_double_click_selects_all(monkeypa
         (65536, 32768),
         (0, 32768),
     )
-    assert window_manager.pie.calls[0][2].mesh_resolution == 1024
+    assert window_manager.pie.calls[0][2].point_spacing == 32
     assert not hasattr(cutout_main, "pending_selection")