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

@@ -6,7 +6,7 @@ These FACE attributes stay on the output mesh for the material consumer.
 """
 from mathutils import Matrix
 
-from anyimage.operators.cutout_tool.shape import CUTOUT_Z_TO_X
+from anyimage.common.object import blender_frame_rotation
 
 ROTATION_ATTRIBUTE = 'o_depth_rotation'
 FACE_ATTRIBUTE = 'o_depth_face'
@@ -38,28 +38,32 @@ def transform_object_normal_color(group, color, strength):
     decode.inputs[1].default_value = (2., 2., 2.)
     decode.inputs[2].default_value = (-1., -1., -1.)
     links.new(color, decode.inputs[0])
+    base = nodes.new('ShaderNodeVectorRotate')
+    base.rotation_type = 'EULER_XYZ'
+    base.inputs['Rotation'].default_value = Matrix(blender_frame_rotation()).to_euler()
+    links.new(decode.outputs[0], base.inputs['Vector'])
     rotate = nodes.new('ShaderNodeVectorRotate')
     rotate.rotation_type = 'EULER_XYZ'
     rotate.invert = True
-    links.new(decode.outputs[0], rotate.inputs['Vector'])
+    links.new(base.outputs[0], rotate.inputs['Vector'])
     links.new(rotation.outputs['Vector'], rotate.inputs['Rotation'])
     separate = nodes.new('ShaderNodeSeparateXYZ')
     links.new(rotate.outputs[0], separate.inputs[0])
     back = math('COMPARE', face.outputs['Fac'], 2.)
-    # Reflect the normal's Z component on the back.
-    difference = math('MULTIPLY', separate.outputs['Z'], -2.)
+    # Reflect the normal's Y component on the back.
+    difference = math('MULTIPLY', separate.outputs['Y'], -2.)
     correction = nodes.new('ShaderNodeMath')
     correction.operation = 'MULTIPLY_ADD'
     links.new(back, correction.inputs[0])
     links.new(difference, correction.inputs[1])
-    links.new(separate.outputs['Z'], correction.inputs[2])
+    links.new(separate.outputs['Y'], correction.inputs[2])
     combine = nodes.new('ShaderNodeCombineXYZ')
     links.new(separate.outputs['X'], combine.inputs['X'])
-    links.new(separate.outputs['Y'], combine.inputs['Y'])
-    links.new(correction.outputs[0], combine.inputs['Z'])
+    links.new(correction.outputs[0], combine.inputs['Y'])
+    links.new(separate.outputs['Z'], combine.inputs['Z'])
     axis_rotation = nodes.new('ShaderNodeVectorMath')
     axis_rotation.operation = 'SCALE'
-    axis_rotation.inputs[0].default_value = Matrix(CUTOUT_Z_TO_X).to_euler()
+    axis_rotation.inputs[0].default_value = Matrix.Rotation(1.5707963267948966, 4, 'Z').to_euler()
     links.new(axis.outputs['Fac'], axis_rotation.inputs['Scale'])
     orient = nodes.new('ShaderNodeVectorRotate')
     orient.rotation_type = 'EULER_XYZ'