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/reference_plane.py

@@ -1,5 +1,6 @@
 """Build the direction-adjusted reference depth field."""
 from .nodes import math_node
+from .direction import legacy_direction_to_canonical
 
 
 def reference_plane_depth(group, direction, reference_depth):
@@ -8,23 +9,24 @@ def reference_plane_depth(group, direction, reference_depth):
     normal = nodes.new("ShaderNodeVectorMath")
     normal.operation = "NORMALIZE"
     links.new(direction, normal.inputs[0])
+    remapped = legacy_direction_to_canonical(group, normal.outputs["Vector"])
     normal_components = nodes.new("ShaderNodeSeparateXYZ")
-    links.new(normal.outputs["Vector"], normal_components.inputs["Vector"])
+    links.new(remapped, normal_components.inputs["Vector"])
     position = nodes.new("GeometryNodeInputPosition")
     position_components = nodes.new("ShaderNodeSeparateXYZ")
     links.new(position.outputs["Position"], position_components.inputs["Vector"])
     x_term = math_node(nodes, "MULTIPLY")
     links.new(position_components.outputs["X"], x_term.inputs[0])
     links.new(normal_components.outputs["X"], x_term.inputs[1])
-    y_term = math_node(nodes, "MULTIPLY")
-    links.new(position_components.outputs["Y"], y_term.inputs[0])
-    links.new(normal_components.outputs["Y"], y_term.inputs[1])
+    z_term = math_node(nodes, "MULTIPLY")
+    links.new(position_components.outputs["Z"], z_term.inputs[0])
+    links.new(normal_components.outputs["Z"], z_term.inputs[1])
     point_dot = math_node(nodes, "ADD")
     links.new(x_term.outputs[0], point_dot.inputs[0])
-    links.new(y_term.outputs[0], point_dot.inputs[1])
+    links.new(z_term.outputs[0], point_dot.inputs[1])
     divide = math_node(nodes, "DIVIDE")
     links.new(point_dot.outputs[0], divide.inputs[0])
-    links.new(normal_components.outputs["Z"], divide.inputs[1])
+    links.new(normal_components.outputs["Y"], divide.inputs[1])
     plane = math_node(nodes, "ADD")
     links.new(reference_depth, plane.inputs[0])
     links.new(divide.outputs[0], plane.inputs[1])