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.

tools/nodes/common/depth_surface.py

@@ -290,7 +290,7 @@ def thicken_depth_surface(group, geometry, thickness, normal_smooth=None, *,
     row = nodes.new("FunctionNodeIntegerMath")
     row.operation = "MULTIPLY"
     row.inputs[1].default_value = 4096
-    links.new(layer_axes.outputs["Y"], row.inputs[0])
+    links.new(layer_axes.outputs["Z"], row.inputs[0])
     vertex = nodes.new("FunctionNodeIntegerMath")
     vertex.operation = "ADD"
     links.new(layer_axes.outputs["X"], vertex.inputs[0])
@@ -303,7 +303,7 @@ def thicken_depth_surface(group, geometry, thickness, normal_smooth=None, *,
     extrude.mode = "FACES"
     extrude.inputs["Individual"].default_value = False
     extrusion_offset = nodes.new("ShaderNodeCombineXYZ")
-    extrusion_offset.inputs["Z"].default_value = -1.0
+    extrusion_offset.inputs["Y"].default_value = -1.0
     links.new(extrusion_offset.outputs[0], extrude.inputs["Offset"])
     links.new(saved, extrude.inputs["Mesh"])
     sides = nodes.new("GeometryNodeSeparateGeometry")
@@ -311,7 +311,7 @@ def thicken_depth_surface(group, geometry, thickness, normal_smooth=None, *,
     links.new(extrude.outputs["Mesh"], sides.inputs["Geometry"])
     links.new(extrude.outputs["Side"], sides.inputs["Selection"])
     offset = nodes.new("ShaderNodeCombineXYZ")
-    offset.inputs["Z"].default_value = -1.0
+    offset.inputs["Y"].default_value = -1.0
     back = nodes.new("GeometryNodeSetPosition")
     links.new(saved, back.inputs["Geometry"])
     links.new(offset.outputs[0], back.inputs["Offset"])
@@ -337,9 +337,9 @@ def thicken_depth_surface(group, geometry, thickness, normal_smooth=None, *,
     if weld_zero_thickness:
         positive = _math(group, "GREATER_THAN", source_thickness, 1e-12)
         flattened = nodes.new("ShaderNodeCombineXYZ")
-        for axis in ("X", "Y"):
+        for axis in ("X", "Z"):
             links.new(layer_axes.outputs[axis], flattened.inputs[axis])
-        links.new(_math(group, "MULTIPLY", positive, layer_axes.outputs["Z"]), flattened.inputs["Z"])
+        links.new(_math(group, "MULTIPLY", positive, layer_axes.outputs["Y"]), flattened.inputs["Y"])
         collapse = nodes.new("GeometryNodeSetPosition")
         links.new(construction, collapse.inputs["Geometry"])
         links.new(flattened.outputs[0], collapse.inputs["Position"])
@@ -349,8 +349,8 @@ def thicken_depth_surface(group, geometry, thickness, normal_smooth=None, *,
     merge.inputs["Distance"].default_value = 0.1
     links.new(construction, merge.inputs["Geometry"])
     displacement = nodes.new("ShaderNodeCombineXYZ")
-    distance = _math(group, "MULTIPLY", layer_axes.outputs["Z"], source_thickness)
-    links.new(distance, displacement.inputs["Z"])
+    distance = _math(group, "MULTIPLY", layer_axes.outputs["Y"], source_thickness)
+    links.new(distance, displacement.inputs["Y"])
     restored = nodes.new("ShaderNodeVectorMath")
     restored.operation = "ADD"
     links.new(source_position, restored.inputs[0])
@@ -401,18 +401,19 @@ def project_depth_surface(
     separate = nodes.new("ShaderNodeSeparateXYZ")
     links.new(scaled.outputs["Vector"], separate.inputs["Vector"])
     relative_depth = _projection_math(nodes, "SUBTRACT")
-    links.new(reference_depth, relative_depth.inputs[0])
-    links.new(separate.outputs["Z"], relative_depth.inputs[1])
+    links.new(separate.outputs["Z"], relative_depth.inputs[0])
+    links.new(reference_depth, relative_depth.inputs[1])
     front = _projection_math(nodes, "MULTIPLY")
     links.new(relative_depth.outputs[0], front.inputs[0])
     links.new(depth_scale, front.inputs[1])
 
-    negative_y = _projection_math(nodes, "MULTIPLY")
-    negative_y.inputs[1].default_value = -1.0
-    links.new(separate.outputs["Y"], negative_y.inputs[0])
+    negative_z = _projection_math(nodes, "MULTIPLY")
+    negative_z.inputs[1].default_value = -1.0
+    links.new(separate.outputs["Y"], negative_z.inputs[0])
     projected = nodes.new("ShaderNodeCombineXYZ")
     links.new(separate.outputs["X"], projected.inputs["X"])
-    links.new(negative_y.outputs[0], projected.inputs["Y"])
+    links.new(front.outputs[0], projected.inputs["Y"])
+    links.new(negative_z.outputs[0], projected.inputs["Z"])
     current_position = nodes.new("GeometryNodeInputPosition")
     blend = nodes.new("ShaderNodeMix")
     blend.data_type = "VECTOR"
@@ -424,8 +425,8 @@ def project_depth_surface(
     links.new(blend.outputs["Result"], blended_axes.inputs["Vector"])
     surface_position = nodes.new("ShaderNodeCombineXYZ")
     links.new(blended_axes.outputs["X"], surface_position.inputs["X"])
-    links.new(blended_axes.outputs["Y"], surface_position.inputs["Y"])
-    links.new(front.outputs[0], surface_position.inputs["Z"])
+    links.new(front.outputs[0], surface_position.inputs["Y"])
+    links.new(blended_axes.outputs["Z"], surface_position.inputs["Z"])
     project_geometry = nodes.new("GeometryNodeSetPosition")
     links.new(geometry, project_geometry.inputs["Geometry"])
     links.new(surface_position.outputs["Vector"], project_geometry.inputs["Position"])