Refactor geometry generation to standardize Blender object coordinates

- Unified the canonical local frame for generated geometries (Plane, Depth Plane, Relief Plane, Cutout, Depth Cutout) to align with Blender's object coordinate system, setting X as horizontal, Z as up, and +Y as depth.
- Removed the `Depth Axis` parameter from `O Image Cutout` and `O Image Depth Cutout`, simplifying the geometry generation process.
- Updated the depth direction defaults to use +Y instead of -Z for `O Image Relief Plane` and Depth Symmetry.
- Adjusted the geometry nodes to ensure thickness, projection, and shell displacements operate along the Y-axis.
- Implemented new capabilities for handling object space normals to align with the new canonical frame.
- Enhanced the Depth Symmetry functionality to mirror across the canonical Y-axis and perform a final rotation to maintain the correct orientation.
- Added tests to validate the new coordinate system and ensure compatibility with existing assets.

tests/support/depth_surface.py

@@ -13,7 +13,7 @@ def surface(*, step=6.0, size=1.0, resolution=2, wrapper=False):
     group = CUTOUT_BUILDERS["DEPTH_SOLID"]()
     # Two columns with a complete depth jump along their common boundary.
     points = [
-        (x * size / resolution, y * size / resolution, 0)
+        (x * size / resolution, 0, y * size / resolution)
         for y in range(resolution + 1)
         for x in range(2 * resolution + 1)
     ]
@@ -32,8 +32,8 @@ def surface(*, step=6.0, size=1.0, resolution=2, wrapper=False):
     mesh.from_pydata(points, [], faces)
     uv = mesh.uv_layers.new(name="UVMap")
     for loop in mesh.loops:
-        x, y, _ = points[loop.vertex_index]
-        uv.data[loop.index].uv = (x / (2 * size), y / size)
+        x, _y, z = points[loop.vertex_index]
+        uv.data[loop.index].uv = (x / (2 * size), z / size)
     obj = bpy.data.objects.new("Step", mesh)
     bpy.context.collection.objects.link(obj)
     image = bpy.data.images.new("Camera", width=64, height=32, float_buffer=True)
@@ -72,7 +72,6 @@ def surface(*, step=6.0, size=1.0, resolution=2, wrapper=False):
         set_value(name, value)
     if wrapper:
         set_value("Cleanup Threshold", 0.0)
-        set_value("Depth Axis", 0)
     return obj, set_value
 
 

tests/support/image_objects.py

@@ -115,11 +115,6 @@ def _add_cutout_modifier(obj, shape):
     modifier.node_group = group
     if shape in {"FLAT", "DEPTH_SOLID"}:
         object_data.set_modifier_input(modifier, object_data.modifier_input_identifier(group, "Mode"), 1)
-    object_data.set_modifier_input(
-        modifier,
-        object_data.modifier_input_identifier(group, "Depth Axis"),
-        0,
-    )
     object_data.set_modifier_input(
         modifier,
         object_data.modifier_input_identifier(group, "Cleanup Threshold"),

tests/support/planes.py

@@ -25,7 +25,7 @@ def create_surface(plane_type):
     builder = build_image_depth_plane_group if plane_type == "DEPTH" else build_image_relief_plane_group
     group = builder(plane)
     mesh = bpy.data.meshes.new("Rectangle")
-    mesh.from_pydata([(-2, -1, 0), (2, -1, 0), (2, 1, 0), (-2, 1, 0)], [], [(0, 1, 2, 3)])
+    mesh.from_pydata([(-2, 0, -1), (2, 0, -1), (2, 0, 1), (-2, 0, 1)], [], [(0, 1, 2, 3)])
     material = bpy.data.materials.new("Image")
     mesh.materials.append(material)
     obj = bpy.data.objects.new("Surface", mesh)