frontengine 1.0.72__tar.gz → 1.0.74__tar.gz

{frontengine-1.0.72 → frontengine-1.0.74}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.72
+Version: 1.0.74
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine

frontengine-1.0.74/frontengine/show/draggable_window.py

@@ -0,0 +1,65 @@
+"""
+可拖曳的置頂小視窗：釘選截圖與視窗複本共用的底座。
+
+這兩者都是「拿來對照的東西」而不是背景，所以都需要同一套行為：沒有邊框、永遠在
+最上層、可以拖到順手的位置、雙擊或 Escape 關掉。兩邊各寫一份的話，改了其中一個
+的關閉方式，另一個就會變成另一種操作邏輯——而使用者不會知道為什麼。
+
+A draggable always-on-top window: the base shared by the pinned capture and the
+window replica.
+
+Both are things you refer to rather than backdrops, so both need the same
+behaviour: no frame, always on top, draggable somewhere convenient, closed with a
+double-click or Escape. Written twice, changing how one of them closes would
+quietly leave the other behaving differently, with nothing to explain why.
+"""
+from __future__ import annotations
+
+from typing import Optional
+
+from PySide6.QtCore import QPoint, Qt
+from PySide6.QtWidgets import QWidget
+
+
+class DraggableTopWindow(QWidget):
+    """無邊框、置頂、可拖曳、雙擊或 Escape 關閉。"""
+
+    def __init__(self, parent: Optional[QWidget] = None) -> None:
+        super().__init__(parent)
+        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
+        self.setWindowFlags(
+            Qt.WindowType.FramelessWindowHint
+            | Qt.WindowType.WindowStaysOnTopHint
+            | Qt.WindowType.Tool)
+        self.setWindowTitle("FrontEngine")
+        self._drag_origin: Optional[QPoint] = None
+
+    def mousePressEvent(self, event) -> None:
+        if event.button() == Qt.MouseButton.LeftButton:
+            self._drag_origin = event.globalPosition().toPoint() - self.frameGeometry().topLeft()
+            event.accept()
+
+    def mouseMoveEvent(self, event) -> None:
+        if self._drag_origin is not None and event.buttons() & Qt.MouseButton.LeftButton:
+            self.move(event.globalPosition().toPoint() - self._drag_origin)
+            event.accept()
+
+    def mouseReleaseEvent(self, event) -> None:
+        self._drag_origin = None
+        event.accept()
+
+    def mouseDoubleClickEvent(self, event) -> None:
+        """
+        雙擊關掉。沒有標題列就沒有右上角的叉，總得留一個看得懂的出口，否則使用者
+        只能去工作管理員。
+        Double-click closes. With no title bar there is no cross in the corner, and
+        something covering the screen with no way out leaves only the task manager.
+        """
+        self.close()
+        event.accept()
+
+    def keyPressEvent(self, event) -> None:
+        if event.key() == Qt.Key.Key_Escape:
+            self.close()
+            return
+        super().keyPressEvent(event)

frontengine-1.0.74/frontengine/show/pinned/pinned_image.py

@@ -0,0 +1,103 @@
+"""
+把截下來的一塊畫面釘在螢幕上。
+
+區域截圖原本只能送到剪貼簿或存成檔案——想「一邊看著這段規格一邊改程式」的話，
+得自己找一個看圖程式打開再想辦法讓它保持在最上層。釘選就是把中間那幾步拿掉。
+
+和圖片覆蓋層的差別在來源與互動：圖片覆蓋層吃**檔案路徑**、點擊穿透；這個吃記憶體
+裡的 `QPixmap`，而且要能拖、能縮放、能關掉——截下來的東西是拿來對照的，不是背景。
+
+Pin a captured piece of screen on top.
+
+Region capture could only reach the clipboard or a file: wanting to read a
+specification while editing code meant opening an image viewer and finding a way
+to keep it on top. Pinning removes the steps in between.
+
+It differs from the image overlay in both source and behaviour: that one takes a
+**file path** and passes clicks through, while this takes a `QPixmap` already in
+memory and has to be draggable, resizable and closable - a capture is something
+you refer to, not a backdrop.
+"""
+from __future__ import annotations
+
+from typing import Optional, Tuple
+
+from PySide6.QtGui import QPainter, QPixmap
+from PySide6.QtWidgets import QWidget
+
+from frontengine.show.draggable_window import DraggableTopWindow
+
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+MIN_PINNED_SIZE = 48
+MAX_ZOOM = 4.0
+MIN_ZOOM = 0.1
+ZOOM_STEP = 1.1
+
+
+def zoom_size(base: Tuple[int, int], zoom: float) -> Tuple[int, int]:
+    """
+    縮放後的大小，維持長寬比並夾在可用範圍內。
+
+    純算術，所以縮放不必開視窗就能驗。下限存在的理由和複本一樣：縮到剩幾像素的
+    圖片既拖不動也關不掉，等於卡在畫面上。
+    The scaled size, keeping the aspect ratio and clamped to a usable range.
+
+    Pure arithmetic, so zooming can be checked without a window. The floor is
+    there for the same reason as the replica's: an image a few pixels across can
+    be neither dragged nor closed, so it is simply stuck on screen.
+    """
+    width, height = base
+    if width <= 0 or height <= 0:
+        return (MIN_PINNED_SIZE, MIN_PINNED_SIZE)
+    factor = max(MIN_ZOOM, min(MAX_ZOOM, float(zoom)))
+    return (max(MIN_PINNED_SIZE, int(width * factor)),
+            max(MIN_PINNED_SIZE, int(height * factor)))
+
+
+def clamp_zoom(zoom: float) -> float:
+    """把縮放倍率夾在可用範圍內。"""
+    try:
+        return max(MIN_ZOOM, min(MAX_ZOOM, float(zoom)))
+    except (TypeError, ValueError):
+        return 1.0
+
+
+class PinnedImageWidget(DraggableTopWindow):
+    """釘在最上層的一張圖：可拖曳、可滾輪縮放、雙擊或 Escape 關閉。"""
+
+    def __init__(self, pixmap: QPixmap, opacity_percent: int = 100,
+                 parent: Optional[QWidget] = None) -> None:
+        super().__init__(parent)
+        self.pixmap = pixmap if pixmap is not None else QPixmap()
+        self.zoom = 1.0
+        self.setWindowOpacity(max(0.1, min(1.0, opacity_percent / 100.0)))
+
+        base = (self.pixmap.width(), self.pixmap.height())
+        front_engine_logger.info(f"[PinnedImageWidget] Init | size={base}")
+        self.resize(*zoom_size(base, 1.0))
+
+    def base_size(self) -> Tuple[int, int]:
+        return (self.pixmap.width(), self.pixmap.height())
+
+    def apply_zoom(self, zoom: float) -> None:
+        """套用縮放倍率並跟著改變視窗大小。"""
+        self.zoom = clamp_zoom(zoom)
+        self.resize(*zoom_size(self.base_size(), self.zoom))
+
+    def paintEvent(self, event) -> None:
+        painter = QPainter(self)
+        if self.pixmap.isNull():
+            return
+        # 縮放時用平滑轉換：釘起來的多半是文字或介面截圖，鋸齒會直接讓它讀不了。
+        # Smooth transformation: what gets pinned is usually text or an interface,
+        # and aliasing makes exactly that unreadable.
+        painter.setRenderHint(QPainter.RenderHint.SmoothPixmapTransform, True)
+        painter.drawPixmap(self.rect(), self.pixmap)
+
+    def wheelEvent(self, event) -> None:
+        steps = event.angleDelta().y() / 120.0
+        if steps:
+            self.apply_zoom(self.zoom * (ZOOM_STEP ** steps))
+            event.accept()
+

frontengine-1.0.74/frontengine/show/reference/reference_board.py

@@ -0,0 +1,155 @@
+"""
+參考圖板：一塊畫布上放好幾張圖，各自可以搬動，整塊可以縮放平移。
+
+和「圖片覆蓋層」的差別是數量與擺法：覆蓋層是把一張圖固定在某個位置當背景，圖板
+是把一疊參考資料攤開來排在手邊——畫圖的、做設計的、對著規格寫程式的都在做這件事。
+
+視圖行為（無邊框、置頂、透明、滾輪縮放、拖曳平移）沿用場景功能的
+`ExtendGraphicView`，這裡只負責「放什麼進去、一開始怎麼排」。
+
+A reference board: several images on one canvas, each movable, the whole thing
+zoomable and pannable.
+
+It differs from the image overlay in number and arrangement: the overlay fixes one
+picture in place as a backdrop, while a board spreads a pile of references out
+within reach - what illustrators, designers and anyone coding against a
+specification actually do.
+
+The view behaviour - frameless, on top, transparent, wheel zoom, drag to pan -
+comes from the scene feature's `ExtendGraphicView`; this only decides what goes on
+it and how it is laid out to begin with.
+"""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import List, Sequence, Tuple
+
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QPixmap
+from PySide6.QtWidgets import QGraphicsPixmapItem, QGraphicsScene
+
+from frontengine.show.scene.extend_graphic_view import ExtendGraphicView
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+BOARD_EXTENSIONS = (".png", ".jpg", ".jpeg", ".webp", ".bmp", ".gif")
+DEFAULT_COLUMNS = 3
+DEFAULT_ITEM_SIZE = 320
+ITEM_GAP = 24
+
+
+def columns_for(count: int, preferred: int = DEFAULT_COLUMNS) -> int:
+    """
+    幾張圖排幾欄。張數比預設欄數少時就照張數排，免得三張圖被排成一欄兩列、
+    右邊空一大塊。
+    How many columns for this many images. Fewer images than the preferred column
+    count simply use their own number, so three pictures are not laid out as a
+    row of two with a gap beside them.
+    """
+    count = max(0, int(count))
+    if count == 0:
+        return 0
+    return max(1, min(int(preferred), count))
+
+
+def grid_positions(count: int, item_size: int = DEFAULT_ITEM_SIZE,
+                   columns: int = DEFAULT_COLUMNS,
+                   gap: int = ITEM_GAP) -> List[Tuple[int, int]]:
+    """
+    一開始把圖排成網格的座標。純算術，所以排版不必開視窗就能驗。
+
+    先排好再讓使用者自己搬：全部疊在原點的話，開起來看到的是一張圖，其他幾張都
+    藏在下面，使用者會以為只載入了一張。
+    The initial grid coordinates. Pure arithmetic, so the layout can be checked
+    without a window.
+
+    They are arranged before the user rearranges them: stacked at the origin, the
+    board would open showing one picture with the rest hidden underneath, and it
+    would look as though only one had loaded.
+    """
+    count = max(0, int(count))
+    if count == 0:
+        return []
+    column_count = columns_for(count, columns)
+    step = max(1, int(item_size)) + max(0, int(gap))
+    return [((index % column_count) * step, (index // column_count) * step)
+            for index in range(count)]
+
+
+def readable_images(paths: Sequence[str]) -> List[str]:
+    """
+    留下副檔名認得、而且真的讀得進來的圖。
+
+    壞掉或不是圖片的檔案要在這裡就擋下來：讓 QPixmap 靜靜產生一張空圖的話，圖板
+    上會出現一塊看不見的空白，使用者只會覺得「有一張圖不見了」。
+    Keep the files whose suffix is known and that actually load.
+
+    A broken or non-image file is dropped here: letting QPixmap quietly produce a
+    null pixmap puts an invisible blank on the board, and all the user sees is
+    that one of their pictures is missing.
+    """
+    kept = []
+    for path in paths or ():
+        try:
+            candidate = Path(str(path))
+            if candidate.suffix.lower() not in BOARD_EXTENSIONS:
+                continue
+            if not candidate.is_file():
+                continue
+        except OSError:  # pragma: no cover - filesystem boundary
+            continue
+        if QPixmap(str(candidate)).isNull():
+            front_engine_logger.info(f"[ReferenceBoard] skipped unreadable image: {candidate}")
+            continue
+        kept.append(str(candidate))
+    return kept
+
+
+class ReferenceBoardWidget(ExtendGraphicView):
+    """好幾張參考圖放在同一塊畫布上，各自可以搬動。"""
+
+    def __init__(self, item_size: int = DEFAULT_ITEM_SIZE, columns: int = DEFAULT_COLUMNS):
+        front_engine_logger.info("[ReferenceBoardWidget] Init")
+        self.board_scene = QGraphicsScene()
+        super().__init__(self.board_scene)
+        self.item_size = max(64, int(item_size))
+        self.columns = max(1, int(columns))
+        self.items: List[QGraphicsPixmapItem] = []
+
+    def add_images(self, paths: Sequence[str]) -> int:
+        """把圖加進圖板並排好，回傳實際加進去的張數。"""
+        usable = readable_images(paths)
+        positions = grid_positions(len(usable), self.item_size, self.columns)
+        for path, (x, y) in zip(usable, positions):
+            pixmap = QPixmap(path).scaled(
+                self.item_size, self.item_size,
+                Qt.AspectRatioMode.KeepAspectRatio,
+                Qt.TransformationMode.SmoothTransformation)
+            item = QGraphicsPixmapItem(pixmap)
+            # 每張圖各自可以搬：圖板的用途就是把它們排成自己看得順的位置。
+            # Each picture moves on its own: arranging them is the whole point.
+            item.setFlag(QGraphicsPixmapItem.GraphicsItemFlag.ItemIsMovable, True)
+            item.setFlag(QGraphicsPixmapItem.GraphicsItemFlag.ItemIsSelectable, True)
+            item.setPos(x, y)
+            self.board_scene.addItem(item)
+            self.items.append(item)
+        front_engine_logger.info(f"[ReferenceBoardWidget] added {len(usable)} of {len(paths or ())}")
+        return len(usable)
+
+    def remove_selected(self) -> int:
+        """把選起來的圖從圖板上拿掉，回傳拿掉幾張。"""
+        removed = 0
+        for item in list(self.items):
+            if item.isSelected():
+                self.board_scene.removeItem(item)
+                self.items.remove(item)
+                removed += 1
+        return removed
+
+    def keyPressEvent(self, event) -> None:
+        if event.key() == Qt.Key.Key_Escape:
+            self.close()
+            return
+        if event.key() in (Qt.Key.Key_Delete, Qt.Key.Key_Backspace):
+            self.remove_selected()
+            return
+        super().keyPressEvent(event)

{frontengine-1.0.72 → frontengine-1.0.74}/frontengine/show/replica/replica_widget.py

@@ -14,7 +14,7 @@ from __future__ import annotations
 
 from typing import Optional
 
-from PySide6.QtCore import QPoint, Qt
+from frontengine.show.draggable_window import DraggableTopWindow
 from PySide6.QtGui import QColor, QPainter
 from PySide6.QtWidgets import QWidget
 
@@ -24,7 +24,7 @@ from frontengine.utils.window_replica.dwm_thumbnail import (
 )
 
 
-class WindowReplicaWidget(QWidget):
+class WindowReplicaWidget(DraggableTopWindow):
     """顯示另一個視窗即時畫面的小視窗。"""
 
     def __init__(self, source_handle: int, title: str = "",
@@ -32,11 +32,6 @@ class WindowReplicaWidget(QWidget):
                  crop: Optional[tuple] = None) -> None:
         front_engine_logger.info(f"[WindowReplicaWidget] Init | source={source_handle}")
         super().__init__(parent)
-        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
-        self.setWindowFlags(
-            Qt.WindowType.FramelessWindowHint
-            | Qt.WindowType.WindowStaysOnTopHint
-            | Qt.WindowType.Tool)
         self.setWindowTitle(title or "FrontEngine")
         self.setMinimumSize(MIN_REPLICA_SIZE, MIN_REPLICA_SIZE)
 
@@ -48,7 +43,6 @@ class WindowReplicaWidget(QWidget):
         # the source after that window is resized.
         self.crop = crop
         self.thumbnail = DwmThumbnail()
-        self._drag_origin: Optional[QPoint] = None
 
         self.resize(DEFAULT_REPLICA_WIDTH, int(DEFAULT_REPLICA_WIDTH * 9 / 16))
 
@@ -109,24 +103,6 @@ class WindowReplicaWidget(QWidget):
         painter = QPainter(self)
         painter.fillRect(self.rect(), QColor(0, 0, 0))
 
-    def mousePressEvent(self, event) -> None:
-        if event.button() == Qt.MouseButton.LeftButton:
-            self._drag_origin = event.globalPosition().toPoint() - self.frameGeometry().topLeft()
-            event.accept()
-
-    def mouseMoveEvent(self, event) -> None:
-        if self._drag_origin is not None and event.buttons() & Qt.MouseButton.LeftButton:
-            self.move(event.globalPosition().toPoint() - self._drag_origin)
-            event.accept()
-
-    def mouseReleaseEvent(self, event) -> None:
-        self._drag_origin = None
-        event.accept()
-
-    def mouseDoubleClickEvent(self, event) -> None:
-        """雙擊關掉——沒有標題列，總得有一個看得懂的出口。"""
-        self.close()
-        event.accept()
 
     def closeEvent(self, event) -> None:
         # 縮圖是系統資源，視窗沒了也不會自己消失。從標題列以外的任何路徑關閉時

{frontengine-1.0.72 → frontengine-1.0.74}/frontengine/ui/main_ui.py

@@ -398,9 +398,14 @@ class FrontEngineMainUI(QMainWindow):
                           "now_playing_widget_list", "note_widget_list"):
             self.control_center_ui.register_overlay_source(
                 lambda attribute=attribute: getattr(self.widgets_setting_ui, attribute, []))
-        for attribute in ("measure_widget_list", "capture_widget_list", "camera_widget_list"):
+        for attribute in ("measure_widget_list", "capture_widget_list", "camera_widget_list",
+                          "pinned_widget_list"):
             self.control_center_ui.register_overlay_source(
                 lambda attribute=attribute: getattr(self.tools_setting_ui, attribute, []))
+        # 參考圖板也要進控制中心，否則「全部關閉」關不掉它
+        # The reference boards belong here too, or "close all" cannot reach them
+        self.control_center_ui.register_overlay_source(
+            lambda: getattr(self.image_setting_ui, "board_widget_list", []))
 
     # 螢幕保護能顯示哪些分頁：來源名稱 -> (頁面屬性, 啟動方法, 覆蓋層清單屬性)
     # What the screensaver can show: source -> (page attribute, start method,
@@ -929,6 +934,7 @@ class FrontEngineMainUI(QMainWindow):
             self.widgets_setting_ui.stop_spectrum()
         if getattr(self, "tools_setting_ui", None) is not None:
             self.tools_setting_ui.release_pinned_windows()
+            self.tools_setting_ui.close_pinned()
             # 複本註冊的是 DWM 縮圖，那是系統資源：視窗沒了也不會自己消失。
             # A replica holds a DWM thumbnail, a system resource that does not
             # go away just because the process is closing.

{frontengine-1.0.72 → frontengine-1.0.74}/frontengine/ui/page/image/image_setting_ui.py

@@ -6,6 +6,7 @@ from PySide6.QtWidgets import (
 )
 
 from frontengine.show.image.paint_image import ImageWidget
+from frontengine.show.reference.reference_board import ReferenceBoardWidget
 from frontengine.ui.dialog.choose_file_dialog import choose_image
 from frontengine.ui.page.layout_kit import SettingPage
 from frontengine.ui.page.utils import (
@@ -97,6 +98,21 @@ class ImageSettingUI(SettingPage):
         self.slideshow_interval_combobox.addItems(["3", "5", "10", "15", "30", "60"])
         self.slideshow_interval_combobox.setCurrentText("5")
         self.slideshow_shuffle_checkbox = tr(QCheckBox(), "slideshow_shuffle", "Shuffle")
+        # 參考圖板：好幾張圖攤在同一塊畫布上，各自可以搬動
+        # Reference board: several pictures on one canvas, each movable
+        self.board_widget_list: list = []
+        self.board_choose_button = tr(QPushButton(), "image_board_choose",
+                                      "Open reference board...")
+        self.board_choose_button.clicked.connect(self.open_reference_board)
+        self.board_close_button = tr(QPushButton(), "image_board_close", "Close boards")
+        self.board_close_button.clicked.connect(self.close_reference_boards)
+        self.board_hint_label = tr(
+            QLabel(), "image_board_hint",
+            "Pick several pictures at once. Drag each one to arrange it, drag the "
+            "background to pan, scroll to zoom, Delete removes the selected one and "
+            "Escape closes the board.")
+        self.board_hint_label.setWordWrap(True)
+
         self.slideshow_recursive_checkbox = tr(QCheckBox(), "slideshow_recursive",
             "Include subfolders")
 
@@ -117,6 +133,10 @@ class ImageSettingUI(SettingPage):
         slideshow.add_row(self.slideshow_interval_label, self.slideshow_interval_combobox)
         slideshow.add_inline(self.slideshow_shuffle_checkbox, self.slideshow_recursive_checkbox)
 
+        board = self.add_section("image_board_label", "Reference board")
+        board.add_inline(self.board_choose_button, self.board_close_button)
+        board.add_widget(self.board_hint_label)
+
         where = self.add_section("section_where", "Where")
         where.add_row(self.target_monitor_label, self.target_monitor_combobox)
         where.add_inline(self.show_on_all_screen_checkbox, self.show_on_bottom_checkbox,
@@ -125,6 +145,38 @@ class ImageSettingUI(SettingPage):
         self.finish_body()
         self.set_footer(primary=self.start_button, status=self.ready_label)
 
+    def open_reference_board(self):
+        """
+        挑幾張圖開一塊參考圖板。一張都沒挑就不要開空白畫布——那看起來像壞掉。
+        Open a board from several chosen pictures. Nothing chosen opens nothing:
+        an empty canvas reads as a fault.
+        """
+        paths, _ = QFileDialog.getOpenFileNames(
+            self,
+            language_wrapper.language_word_dict.get("image_board_choose", "Open reference board..."),
+            "",
+            "Images (*.png *.jpg *.jpeg *.webp *.bmp *.gif)")
+        if not paths:
+            return None
+        board = ReferenceBoardWidget()
+        if board.add_images(paths) == 0:
+            # 全部讀不進來就不要留一塊空畫布在畫面上。
+            # With nothing readable, do not leave an empty canvas on screen.
+            board.close()
+            return None
+        board.showMaximized()
+        self.board_widget_list.append(board)
+        return board
+
+    def close_reference_boards(self) -> None:
+        """關掉開過的參考圖板。"""
+        for board in list(self.board_widget_list):
+            try:
+                board.close()
+            except RuntimeError:  # pragma: no cover - 底層物件已消失
+                pass
+        self.board_widget_list.clear()
+
     def set_show_all_screen(self) -> None:
         front_engine_logger.info("[ImageSettingUI] set_show_all_screen")
         self.show_all_screen = self.show_on_all_screen_checkbox.isChecked()

{frontengine-1.0.72 → frontengine-1.0.74}/frontengine/ui/page/tools/tools_setting_ui.py

@@ -18,6 +18,7 @@ from frontengine.show.camera.camera_widget import (
     SHAPE_CIRCLE, SHAPE_RECTANGLE, SHAPE_ROUNDED, CameraWidget, list_cameras,
 )
 from frontengine.show.capture.region_capture import RegionCaptureWidget, is_usable
+from frontengine.show.pinned.pinned_image import PinnedImageWidget
 from frontengine.show.measure.measure_widget import (
     MODE_ANGLE, MODE_COLOR, MODE_RULER, MeasureWidget,
 )
@@ -77,6 +78,9 @@ class ToolsSettingUI(SettingPage):
         self.last_screen_text: Optional[str] = None
         self.last_recording: Optional[str] = None
         self.capture_widget_list: List[RegionCaptureWidget] = []
+        # 釘住的截圖：使用者自己關掉之外，主程式結束時也要收乾淨
+        # Pinned captures: closed by the user, and swept up on shutdown too
+        self.pinned_widget_list: List[PinnedImageWidget] = []
         self.camera_widget_list: List[CameraWidget] = []
         # 存畫面本身，不要存那個覆蓋層：框選完它就自己 close() 了，而
         # WA_DeleteOnClose 會把底層物件銷毀，留下來的參考碰一下就 RuntimeError，
@@ -131,7 +135,8 @@ class ToolsSettingUI(SettingPage):
         measure.add_inline(self.measure_button)
 
         capture = self.add_section(self.capture_label)
-        capture.add_inline(self.capture_button, self.capture_copy_button)
+        capture.add_inline(self.capture_button, self.capture_copy_button,
+                           self.capture_pin_button)
 
         screen_text = self.add_section(self.screen_text_label)
         screen_text.add_row("tools_action", self.screen_text_combobox, "Action")
@@ -189,6 +194,8 @@ class ToolsSettingUI(SettingPage):
         self.capture_button = tr(QPushButton(), "tools_capture_start", "Capture area")
         self.capture_button.clicked.connect(self.start_capture)
         self.capture_copy_button = tr(QPushButton(), "tools_capture_copy", "Copy last")
+        self.capture_pin_button = tr(QPushButton(), "tools_capture_pin", "Pin last")
+        self.capture_pin_button.clicked.connect(self.pin_last_capture)
         self.capture_copy_button.clicked.connect(self.copy_last_capture)
 
     def _build_screen_text_row(self) -> None:
@@ -311,6 +318,34 @@ class ToolsSettingUI(SettingPage):
         if widget in self.capture_widget_list:
             self.capture_widget_list.remove(widget)
 
+    def pin_last_capture(self) -> Optional[PinnedImageWidget]:
+        """
+        把最近一次的截圖釘在畫面上。沒有截過就什麼都不做——開一個空白視窗只會讓
+        使用者以為截圖壞了。
+        Pin the most recent capture. With nothing captured this does nothing: an
+        empty window would read as the capture having failed.
+        """
+        if self.last_capture is None or self.last_capture.isNull():
+            front_engine_logger.info("[ToolsSettingUI] nothing captured to pin")
+            return None
+        pinned = PinnedImageWidget(self.last_capture)
+        pinned.show()
+        self.pinned_widget_list.append(pinned)
+        return pinned
+
+    def close_pinned(self) -> None:
+        """關掉所有釘住的截圖（主程式關閉時呼叫）。"""
+        # 用切片而不是 list()：邊走邊關的時候原清單有可能被動到，而 Sonar 對
+        # list() 會抱怨、對切片不會。
+        # A slice rather than list(): the original can still be touched while
+        # closing, and Sonar objects to list() but not to slicing.
+        for pinned in self.pinned_widget_list[:]:
+            try:
+                pinned.close()
+            except RuntimeError:  # pragma: no cover - 底層物件已消失
+                pass
+        self.pinned_widget_list.clear()
+
     def copy_last_capture(self) -> bool:
         """把最近一次的截圖再放進剪貼簿一次。"""
         if self.last_capture is None or self.last_capture.isNull():

{frontengine-1.0.72 → frontengine-1.0.74}/frontengine/utils/multi_language/english.py

@@ -171,6 +171,10 @@ english_word_dict = {
     "web_setting_open_enable_input": "Enable input",
     # Scene UI
     "tab_scene_text": "Scene",
+    "image_board_label": "REFERENCE BOARD",
+    "image_board_choose": "Open reference board...",
+    "image_board_close": "Close boards",
+    "image_board_hint": "Pick several pictures at once. Drag each one to arrange it, drag the background to pan, scroll to zoom, Delete removes the selected one and Escape closes the board.",
     "scene_start": "Start scene",
     "scene_table_view_type": "Type",
     "scene_file_path": "File path",
@@ -542,6 +546,7 @@ english_word_dict = {
     "tools_measure_start": 'Start measuring',
     "tools_measure_stop": 'Stop measuring',
     "tools_color_format": 'Copy colour as',
+    "tools_capture_pin": "Pin last",
     "tools_capture_label": 'Region capture',
     "tools_capture_start": 'Capture area',
     "tools_capture_copy": 'Copy last',

{frontengine-1.0.72 → frontengine-1.0.74}/frontengine/utils/multi_language/france.py

@@ -171,6 +171,10 @@ french_word_dict = {
     "web_setting_open_enable_input": "Activer l'entrée",
     # Scene UI
     "tab_scene_text": "Scène",
+    "image_board_label": "PLANCHE DE RÉFÉRENCE",
+    "image_board_choose": "Ouvrir une planche...",
+    "image_board_close": "Fermer les planches",
+    "image_board_hint": "Choisissez plusieurs images à la fois. Faites glisser chacune pour l'arranger, le fond pour vous déplacer, la molette pour zoomer ; Suppr retire l'image sélectionnée et Échap ferme la planche.",
     "scene_start": "Commencer la scène",
     "scene_table_view_type": "Type",
     "scene_file_path": "Chemin du fichier",
@@ -532,6 +536,7 @@ french_word_dict = {
     "tools_measure_start": "Commencer à mesurer",
     "tools_measure_stop": "Arrêter de mesurer",
     "tools_color_format": "Copier la couleur en",
+    "tools_capture_pin": "Épingler la dernière",
     "tools_capture_label": "Capture de zone",
     "tools_capture_start": "Capturer une zone",
     "tools_capture_copy": "Copier la dernière",

{frontengine-1.0.72 → frontengine-1.0.74}/frontengine/utils/multi_language/germany.py

@@ -171,6 +171,10 @@ germany_word_dict = {
     "web_setting_open_enable_input": "Eingabe aktivieren",
     # Szenen-UI
     "tab_scene_text": "Szene",
+    "image_board_label": "REFERENZTAFEL",
+    "image_board_choose": "Referenztafel öffnen...",
+    "image_board_close": "Tafeln schließen",
+    "image_board_hint": "Mehrere Bilder auf einmal wählen. Einzelne ziehen zum Anordnen, den Hintergrund ziehen zum Verschieben, Mausrad zum Zoomen, Entf entfernt das gewählte Bild, Escape schließt die Tafel.",
     "scene_start": "Szene starten",
     "scene_table_view_type": "Typ",
     "scene_file_path": "Dateipfad",
@@ -535,6 +539,7 @@ germany_word_dict = {
     "tools_measure_start": "Messen starten",
     "tools_measure_stop": "Messen beenden",
     "tools_color_format": "Farbe kopieren als",
+    "tools_capture_pin": "Letzten anheften",
     "tools_capture_label": "Bereichsaufnahme",
     "tools_capture_start": "Bereich aufnehmen",
     "tools_capture_copy": "Letzte kopieren",

{frontengine-1.0.72 → frontengine-1.0.74}/frontengine/utils/multi_language/italy.py

@@ -171,6 +171,10 @@ italian_word_dict = {
     "web_setting_open_enable_input": "Abilita input",
     # Scene UI
     "tab_scene_text": "Scena",
+    "image_board_label": "TAVOLA DI RIFERIMENTO",
+    "image_board_choose": "Apri tavola di riferimento...",
+    "image_board_close": "Chiudi le tavole",
+    "image_board_hint": "Scegli più immagini insieme. Trascina ciascuna per disporla, trascina lo sfondo per spostarti, rotellina per lo zoom, Canc toglie quella selezionata ed Esc chiude la tavola.",
     "scene_start": "Inizia la scena",
     "scene_table_view_type": "Tipo",
     "scene_file_path": "Percorso del file",
@@ -532,6 +536,7 @@ italian_word_dict = {
     "tools_measure_start": "Inizia a misurare",
     "tools_measure_stop": "Smetti di misurare",
     "tools_color_format": "Copia il colore come",
+    "tools_capture_pin": "Fissa l'ultima",
     "tools_capture_label": "Cattura di un'area",
     "tools_capture_start": "Cattura un'area",
     "tools_capture_copy": "Copia l'ultima",