feat: bring source and sink back for future development

tool/src/aurora_iconset_builder/__init__.py

@@ -17,6 +17,8 @@ def main() -> None:
     env = Environment(prologue)
     ctx = Context(env)
 
+    # TODO: use explicit temporary directory initializer in prologue to do this.
+    
     # create our special temporary subdirectory
     env.temporary_artifact("component").mkdir(parents=True, exist_ok=True)
 

tool/src/aurora_iconset_builder/assemblicon/geometry.py

@@ -91,7 +91,7 @@ class Rectangle:
 
     @staticmethod
     def from_padding_rect(
-        x: int, y: int, top: int, right: int, bottom: int, left: int
+        pos: Point, top: int, right: int, bottom: int, left: int
     ) -> "Rectangle":
         """
         TODO
@@ -103,7 +103,7 @@ class Rectangle:
         :param bottom: The distance from reference point to this rectangle's bottom border.
         :param left: The distance from reference point to this rectangle's left border.
         """
-        return Rectangle(Point(x - left, y - top), Point(x + right, y + bottom))
+        return Rectangle(Point(pos.x - left, pos.y - top), Point(pos.x + right, pos.y + bottom))
 
     @property
     def width(self) -> int:

tool/src/aurora_iconset_builder/assemblicon/highlevel/sink/__init__.py

@@ -0,0 +1,7 @@
+from .common import Sink
+from .tempdir_sink import TempDirSink
+
+__all__ = [
+    "Sink",
+    "TempDirSink"
+]

tool/src/aurora_iconset_builder/assemblicon/highlevel/sink/common.py

@@ -0,0 +1,11 @@
+from abc import ABC, abstractmethod
+from ..utils import Artifact
+
+class Sink(ABC):
+    """
+    Abstract base class for all sinks.
+    """
+
+    @abstractmethod
+    def push_artifact(self, art: Artifact) -> None:
+        pass

tool/src/aurora_iconset_builder/assemblicon/highlevel/sink/tempdir_sink.py

@@ -0,0 +1,12 @@
+from ..utils import Artifact
+from .common import Sink
+
+class TempDirSink(Sink):
+
+    __args: tuple[str, ...]
+
+    def __init__(self, *args: str) -> None:
+        self.__args = tuple(args)
+
+    def push_artifact(self, art: Artifact) -> None:
+        pass

tool/src/aurora_iconset_builder/assemblicon/highlevel/source/__init__.py

@@ -0,0 +1,7 @@
+from .common import Source
+from .tempdir_source import TempDirSource
+
+__all__ = [
+    "Source",
+    "TempDirSource"
+]

tool/src/aurora_iconset_builder/assemblicon/highlevel/source/common.py

@@ -0,0 +1,11 @@
+from abc import ABC, abstractmethod
+from ..utils import Artifact
+
+class Source(ABC):
+    """
+    Abstract base class for all sources.
+    """
+
+    @abstractmethod
+    def pull_artifact(self) -> Artifact:
+        pass

tool/src/aurora_iconset_builder/assemblicon/highlevel/source/tempdir_source.py

@@ -0,0 +1,12 @@
+from ..utils import Artifact
+from .common import Source
+
+class TempDirSource(Source):
+
+    __path_comps: tuple[str, ...]
+
+    def __init__(self, *args: str) -> None:
+        self.__path_comps = tuple(args)
+
+    def pull_artifact(self) -> Artifact:
+        pass

tool/src/aurora_iconset_builder/assemblicon/logger.py

@@ -5,7 +5,7 @@ class LoggerFactory:
     def __init__(self) -> None:
         # setup log format and level
         logging.basicConfig(
-            format="[%(levelname)s][%(name)s] %(message)s", level=logging.INFO
+            format="[%(levelname)s] [%(name)s] %(message)s", level=logging.INFO
         )
 
     def get_app_logger(self) -> logging.Logger:

tool/src/aurora_iconset_builder/assemblicon/lowlevel/artproc.py

@@ -1,5 +1,6 @@
 import enum
 import math
+import PIL.Image
 from .utils import Artifact
 from ..geometry import Point
 
@@ -17,29 +18,28 @@ class VerticalAnchor(enum.IntEnum):
 
 
 def anchor_to_offset(
-    oversize: Point,
+    oversize_width: int,
+    oversize_height: int,
     horizontal_anchor: HorizontalAnchor,
     vertical_anchor: VerticalAnchor,
 ) -> Point:
-    half_oversize = oversize // 2
-
     x: int
     match horizontal_anchor:
         case HorizontalAnchor.Left:
             x = 0
         case HorizontalAnchor.Center:
-            x = half_oversize.x
+            x = oversize_width // 2
         case HorizontalAnchor.Right:
-            x = oversize.x
+            x = oversize_width
 
     y: int
     match vertical_anchor:
         case VerticalAnchor.Top:
             y = 0
         case VerticalAnchor.Center:
-            y = half_oversize.y
+            y = oversize_height // 2
         case VerticalAnchor.Bottom:
-            y = oversize.y
+            y = oversize_height
 
     return Point(x, y)
 
@@ -65,7 +65,8 @@ def aspect_ratio_scale_and_crop(
     scaled = art.resize((scaled_width, scaled_height), scale_resample)
 
     crop = anchor_to_offset(
-        Point(scaled_width - target_width, scaled_height - target_height),
+        scaled_width - target_width,
+        scaled_height - target_height,
         crop_horizontal_anchor,
         crop_vertical_anchor,
     )
@@ -73,6 +74,13 @@ def aspect_ratio_scale_and_crop(
     return scaled.crop((crop_x, crop_y, crop_x + target_width, crop_y + target_height))
 
 
+def default_art_resize(art: Artifact, width: int, height: int) -> Artifact:
+    """
+    Resize given artifact with default resample (LANCZOS).
+    """
+    return art.resize((width, height), PIL.Image.Resampling.LANCZOS)
+
+
 def art_anchor_to_offset(
     art: Artifact,
     horizontal_anchor: HorizontalAnchor,
@@ -88,9 +96,7 @@ def art_anchor_to_offset(
         anchors this is the corresponding edge; for Right/Bottom anchors
         this is just outside the artifact (the exact corner coordinate).
     """
-    return anchor_to_offset(
-        Point.from_tuple(art.size), horizontal_anchor, vertical_anchor
-    )
+    return anchor_to_offset(*art.size, horizontal_anchor, vertical_anchor)
 
 
 def align_paste(

tool/src/aurora_iconset_builder/nostd_icons/action_icons.py

@@ -1,8 +1,11 @@
-import PIL.Image
 from ..types import AuroraContext, AuroraEnvironment
 from ..assemblicon.highlevel.environment import FdContext
+from ..assemblicon.highlevel.utils import VART_HW
+from ..assemblicon.geometry import Rectangle
 from ..assemblicon.lowlevel.artproc import (
     art_anchor_to_offset,
+    anchor_to_offset,
+    default_art_resize,
     align_paste,
     align_alpha_composite,
     VerticalAnchor,
@@ -14,20 +17,20 @@ def register(ctx: AuroraContext) -> None:
     ctx.register(
         "nostd/action/image-properties",
         ("nostd/mimetype/image-jpeg", "std/status/dialog-infomation"),
-        _build_image_properties_icon,
+        build_image_properties_icon,
     )
     ctx.register(
         "nostd/action/image-zoom-original",
         ("nostd/mimetype/image-jpeg", "component/triangles"),
-        _build_image_zoom_original_icon,
+        build_image_zoom_original_icon,
     )
 
 
-def _build_image_properties_icon(env: AuroraEnvironment) -> None:
+def build_image_properties_icon(env: AuroraEnvironment) -> None:
     art = env.load_temporary_artifact("image-jpeg.png")
 
     info_mark = env.load_temporary_artifact("dialog-infomation.png")
-    resized_info_mark = info_mark.resize((500, 500), PIL.Image.Resampling.LANCZOS)
+    resized_info_mark = default_art_resize(info_mark, 500, 500)
 
     align_alpha_composite(
         art,
@@ -42,27 +45,29 @@ def _build_image_properties_icon(env: AuroraEnvironment) -> None:
     env.save_fd_artifact(art, FdContext.Actions, "image-properties")
 
 
-def _build_image_zoom_original_icon(env: AuroraEnvironment) -> None:
+def build_image_zoom_original_icon(env: AuroraEnvironment) -> None:
     # load triangle assets
-    tri_left = env.load_temporary_artifact("component", "triangle-left.png").resize(
-        (300, 300), PIL.Image.Resampling.LANCZOS
+    TRI_SIZE = (200, 200)
+    tri_left = default_art_resize(
+        env.load_temporary_artifact("component", "triangle-left.png"), *TRI_SIZE
     )
-    tri_down = env.load_temporary_artifact("component", "triangle-down.png").resize(
-        (300, 300), PIL.Image.Resampling.LANCZOS
+    tri_down = default_art_resize(
+        env.load_temporary_artifact("component", "triangle-down.png"), *TRI_SIZE
     )
-    tri_right = env.load_temporary_artifact("component", "triangle-right.png").resize(
-        (300, 300), PIL.Image.Resampling.LANCZOS
+    tri_right = default_art_resize(
+        env.load_temporary_artifact("component", "triangle-right.png"), *TRI_SIZE
     )
-    tri_up = env.load_temporary_artifact("component", "triangle-up.png").resize(
-        (300, 300), PIL.Image.Resampling.LANCZOS
+    tri_up = default_art_resize(
+        env.load_temporary_artifact("component", "triangle-up.png"), *TRI_SIZE
     )
 
     # load inner image
     inner = env.load_temporary_artifact("image-jpeg.png")
-    resized_inner = inner.resize((570, 570), PIL.Image.Resampling.LANCZOS)
+    resized_inner = default_art_resize(inner, 680, 680)
 
     # composite this icon
     icon = env.new_artifact()
+
     align_paste(
         icon,
         resized_inner,
@@ -71,28 +76,51 @@ def _build_image_zoom_original_icon(env: AuroraEnvironment) -> None:
             resized_inner, HorizontalAnchor.Center, VerticalAnchor.Center
         ),
     )
+
+    tri_rect = Rectangle.from_margin_rect(VART_HW, VART_HW, 100, 0, 100, 0)
     align_alpha_composite(
         icon,
         tri_left,
-        art_anchor_to_offset(icon, HorizontalAnchor.Left, VerticalAnchor.Center),
+        anchor_to_offset(
+            tri_rect.width,
+            tri_rect.height,
+            HorizontalAnchor.Left,
+            VerticalAnchor.Center,
+        )
+        + tri_rect.pos1,
         art_anchor_to_offset(tri_left, HorizontalAnchor.Left, VerticalAnchor.Center),
     )
     align_alpha_composite(
         icon,
         tri_right,
-        art_anchor_to_offset(icon, HorizontalAnchor.Right, VerticalAnchor.Center),
+        anchor_to_offset(
+            tri_rect.width,
+            tri_rect.height,
+            HorizontalAnchor.Right,
+            VerticalAnchor.Center,
+        )
+        + tri_rect.pos1,
         art_anchor_to_offset(tri_right, HorizontalAnchor.Right, VerticalAnchor.Center),
     )
     align_alpha_composite(
         icon,
         tri_up,
-        art_anchor_to_offset(icon, HorizontalAnchor.Center, VerticalAnchor.Top),
+        anchor_to_offset(
+            tri_rect.width, tri_rect.height, HorizontalAnchor.Center, VerticalAnchor.Top
+        )
+        + tri_rect.pos1,
         art_anchor_to_offset(tri_up, HorizontalAnchor.Center, VerticalAnchor.Top),
     )
     align_alpha_composite(
         icon,
         tri_down,
-        art_anchor_to_offset(icon, HorizontalAnchor.Center, VerticalAnchor.Bottom),
+        anchor_to_offset(
+            tri_rect.width,
+            tri_rect.height,
+            HorizontalAnchor.Center,
+            VerticalAnchor.Bottom,
+        )
+        + tri_rect.pos1,
         art_anchor_to_offset(tri_down, HorizontalAnchor.Center, VerticalAnchor.Bottom),
     )
 

tool/src/aurora_iconset_builder/nostd_icons/application_icons.py

@@ -3,6 +3,7 @@ from ..types import AuroraContext, AuroraEnvironment
 from ..assemblicon.highlevel.environment import FdContext, WinCategory, MacCategory
 from ..assemblicon.lowlevel.artproc import (
     art_anchor_to_offset,
+    default_art_resize,
     align_paste,
     VerticalAnchor,
     HorizontalAnchor,
@@ -24,7 +25,7 @@ def build_sarasacw_picture_icons(env: AuroraEnvironment) -> None:
     )
 
     inner = env.load_temporary_artifact("image-jpeg.png")
-    resized_inner = inner.resize((990, 990), PIL.Image.Resampling.LANCZOS)
+    resized_inner = default_art_resize(inner, 990, 990)
 
     align_paste(
         app,

tool/src/aurora_iconset_builder/nostd_icons/mimetype_icons.py

@@ -13,7 +13,9 @@ from ..assemblicon.lowlevel.artproc import (
 
 def register(ctx: AuroraContext) -> None:
     ctx.register("component/image-base", (), build_image_base_icon)
-    ctx.register("nostd/mimetype/image-jpeg", ("component/image-base",), build_jpg_icon)
+    ctx.register(
+        "nostd/mimetype/image-jpeg", ("component/image-base",), build_image_jpeg_icon
+    )
 
 
 IMAGE_INNER_RECT = Rectangle(Point(20 * 4, 52 * 4), Point(236 * 4, 204 * 4))
@@ -26,7 +28,7 @@ def build_image_base_icon(env: AuroraEnvironment) -> None:
     )
 
 
-def build_jpg_icon(env: AuroraEnvironment) -> None:
+def build_image_jpeg_icon(env: AuroraEnvironment) -> None:
     jpg_image = env.load_temporary_artifact("component", "image-base.png")
 
     jpg_image_inner = env.load_input_bitmap_artifact(

tool/src/aurora_iconset_builder/std_icons/action_icons.py

@@ -10,11 +10,6 @@ def register(ctx: AuroraContext) -> None:
     ctx.register("std/action/object-flip-*", (), build_object_flip_icons)
     ctx.register("std/action/object-rotate-*", (), build_object_rotate_icons)
 
-    ctx.register(
-        "component/triangles",
-        ("component/generic-background",),
-        build_zoom_triangle_icons,
-    )
     ctx.register(
         "std/action/zoom-[original|fit-best]",
         ("component/triangles",),
@@ -67,34 +62,6 @@ def build_object_rotate_icons(env: AuroraEnvironment) -> None:
         env.save_fd_artifact(art, FdContext.Actions, "object-rotate-right")
 
 
-def build_zoom_triangle_icons(env: AuroraEnvironment) -> None:
-    # load triangle and background assets
-    tri = env.render_svg_then_load(env.input_artifact("component", "triangle.svg"))
-    bg = env.load_temporary_artifact("component", "generic-background.png")
-
-    # create 4 triangle icons for following building
-    tri_left = env.new_artifact()
-    tri_left.paste(bg, (0, 0), tri)
-    tri = tri.transpose(PIL.Image.Transpose.ROTATE_90)
-
-    tri_down = env.new_artifact()
-    tri_down.paste(bg, (0, 0), tri)
-    tri = tri.transpose(PIL.Image.Transpose.ROTATE_90)
-
-    tri_right = env.new_artifact()
-    tri_right.paste(bg, (0, 0), tri)
-    tri = tri.transpose(PIL.Image.Transpose.ROTATE_90)
-
-    tri_up = env.new_artifact()
-    tri_up.paste(bg, (0, 0), tri)
-
-    # save them for reuse
-    env.save_temporary_artifact(tri_left, "component", "triangle-left.png")
-    env.save_temporary_artifact(tri_down, "component", "triangle-down.png")
-    env.save_temporary_artifact(tri_right, "component", "triangle-right.png")
-    env.save_temporary_artifact(tri_up, "component", "triangle-up.png")
-
-
 def build_zoom_origin_and_fit_best_icons(env: AuroraEnvironment) -> None:
     # load triangle assets
     tri_left = env.load_temporary_artifact("component", "triangle-left.png")
@@ -126,9 +93,9 @@ def build_zoom_fit_best_icon(
     tri_right: Artifact,
     tri_up: Artifact,
 ) -> None:
-    # TODO: finihs this in future
     pass
 
 
 def build_zoom_in_out_icons(env: AuroraEnvironment) -> None:
+    # TODO: finihs this in future
     pass

tool/src/aurora_iconset_builder/std_icons/components.py

@@ -4,6 +4,11 @@ from ..types import AuroraContext, AuroraEnvironment
 
 def register(ctx: AuroraContext) -> None:
     ctx.register("component/generic-background", (), build_generic_background)
+    ctx.register(
+        "component/triangles",
+        ("component/generic-background",),
+        build_triangle_icons,
+    )
 
 
 def build_generic_background(env: AuroraEnvironment) -> None:
@@ -11,3 +16,31 @@ def build_generic_background(env: AuroraEnvironment) -> None:
         env.input_artifact("component", "generic-background.svg"),
         env.temporary_artifact("component", "generic-background.png"),
     )
+
+
+def build_triangle_icons(env: AuroraEnvironment) -> None:
+    # load triangle and background assets
+    tri = env.render_svg_then_load(env.input_artifact("component", "triangle.svg"))
+    bg = env.load_temporary_artifact("component", "generic-background.png")
+
+    # create 4 triangle icons for following building
+    tri_left = env.new_artifact()
+    tri_left.paste(bg, (0, 0), tri)
+    tri = tri.transpose(PIL.Image.Transpose.ROTATE_90)
+
+    tri_down = env.new_artifact()
+    tri_down.paste(bg, (0, 0), tri)
+    tri = tri.transpose(PIL.Image.Transpose.ROTATE_90)
+
+    tri_right = env.new_artifact()
+    tri_right.paste(bg, (0, 0), tri)
+    tri = tri.transpose(PIL.Image.Transpose.ROTATE_90)
+
+    tri_up = env.new_artifact()
+    tri_up.paste(bg, (0, 0), tri)
+
+    # save them for reuse
+    env.save_temporary_artifact(tri_left, "component", "triangle-left.png")
+    env.save_temporary_artifact(tri_down, "component", "triangle-down.png")
+    env.save_temporary_artifact(tri_right, "component", "triangle-right.png")
+    env.save_temporary_artifact(tri_up, "component", "triangle-up.png")