Add comprehensive tests for image processing and mask functionalities

- Introduced tests for color image handling, ensuring source preservation and premultiplied alpha usage.
- Implemented tests for brush stroke operations, validating segment boundaries and brush anti-aliasing.
- Added tests for frame anti-aliasing, confirming correct rendering behavior with various alpha values and depth settings.
- Created tests for frame projection, ensuring accurate overlap calculations and half-plane clipping.
- Developed tests for image premultiplied retention, verifying behavior during loading and packing processes.
- Added undo functionality tests for mask operations, ensuring single transaction behavior during edits.

src/anyimage/operators/cutout_tool/object.py

@@ -4,7 +4,7 @@ from enum import StrEnum
 
 import bpy
 
-from ...common.image import color_data_name
+from ...common.image import color_data_name, configure_color_alpha
 from ...common.depth import camera_depth_values, depth_uniform_scale
 from ...common.material import (
     IMAGE_MATERIAL_NODE_GROUP_NAME,
@@ -31,7 +31,7 @@ from .geometry import (
 from .shape import (
     BALLOON_ATTRIBUTE_NAME,
     BALLOON_CUTOUT_SHAPES,
-    CUTOUT_AXIS_TO_SOURCE,
+    CUTOUT_X_TO_Z,
     CUTOUT_NODE_GROUP_NAME,
     CUTOUT_SHAPE_INDICES,
     DEPTH_CUTOUT_SHAPES,
@@ -55,13 +55,13 @@ def _cutout_world_matrix(source_matrix, crop_center, inward_axis):
     center_x, center_y = (float(value) for value in crop_center)
     matrix = source_matrix @ Matrix.Translation((center_x, center_y, 0.0))
     if CutoutInwardAxis(inward_axis) == CutoutInwardAxis.POSITIVE_X:
-        matrix @= Matrix(CUTOUT_AXIS_TO_SOURCE)
+        matrix @= Matrix(CUTOUT_X_TO_Z)
     return matrix
 
 
 def orient_object_normal_image(image, inward_axis):
-    """Convert internal +X Cutout normals to the selected object axes."""
-    if CutoutInwardAxis(inward_axis) == CutoutInwardAxis.POSITIVE_X:
+    """Convert native Z-axis Cutout normals to the selected object axes."""
+    if CutoutInwardAxis(inward_axis) == CutoutInwardAxis.NEGATIVE_Z:
         return image
     import numpy as np
 
@@ -70,7 +70,7 @@ def orient_object_normal_image(image, inward_axis):
     rgba = pixels.reshape((-1, 4))
     normal = rgba[:, :3] * 2.0 - 1.0
     rgba[:, :3] = np.column_stack(
-        (-normal[:, 1], normal[:, 2], -normal[:, 0])
+        (-normal[:, 2], -normal[:, 0], normal[:, 1])
     ) * 0.5 + 0.5
     image.pixels.foreach_set(pixels)
     image.update()
@@ -120,7 +120,7 @@ def create_cropped_color_image(source_object, crop_bounds, source_rgba):
     )
     try:
         image.colorspace_settings.name = source.colorspace_settings.name
-        image.alpha_mode = source.alpha_mode
+        configure_color_alpha(image)
         image.pixels.foreach_set(np.flipud(cropped).ravel())
         image.pack()
         image.update()