frontengine 1.0.72__tar.gz → 1.0.73__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.72
+Version: 1.0.73
 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.73/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.73/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.72 → frontengine-1.0.73}/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.73}/frontengine/ui/main_ui.py

@@ -398,7 +398,8 @@ 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, []))
 
@@ -929,6 +930,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.73}/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.73}/frontengine/utils/multi_language/english.py

@@ -542,6 +542,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.73}/frontengine/utils/multi_language/france.py

@@ -532,6 +532,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.73}/frontengine/utils/multi_language/germany.py

@@ -535,6 +535,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.73}/frontengine/utils/multi_language/italy.py

@@ -532,6 +532,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",

{frontengine-1.0.72 → frontengine-1.0.73}/frontengine/utils/multi_language/russian.py

@@ -532,6 +532,7 @@ russian_word_dict = {
     "tools_measure_start": "Начать измерение",
     "tools_measure_stop": "Остановить измерение",
     "tools_color_format": "Копировать цвет как",
+    "tools_capture_pin": "Закрепить последний",
     "tools_capture_label": "Снимок области",
     "tools_capture_start": "Снять область",
     "tools_capture_copy": "Копировать последний",

{frontengine-1.0.72 → frontengine-1.0.73}/frontengine/utils/multi_language/simplified_chinese.py

@@ -534,6 +534,7 @@ simplified_chinese_word_dict = {
     "tools_measure_start": "开始量测",
     "tools_measure_stop": "停止量测",
     "tools_color_format": "颜色复制为",
+    "tools_capture_pin": "固定上一张",
     "tools_capture_label": "区域截图",
     "tools_capture_start": "框选截图",
     "tools_capture_copy": "复制上一张",

{frontengine-1.0.72 → frontengine-1.0.73}/frontengine/utils/multi_language/traditional_chinese.py

@@ -541,6 +541,7 @@ traditional_chinese_word_dict = {
     "tools_measure_start": '開始量測',
     "tools_measure_stop": '結束量測',
     "tools_color_format": '色碼複製格式',
+    "tools_capture_pin": "釘選上一張",
     "tools_capture_label": '區域截圖',
     "tools_capture_start": '框選截圖',
     "tools_capture_copy": '複製上一張',

{frontengine-1.0.72 → frontengine-1.0.73}/frontengine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.72
+Version: 1.0.73
 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.72 → frontengine-1.0.73}/frontengine.egg-info/SOURCES.txt

@@ -11,6 +11,7 @@ frontengine.egg-info/requires.txt
 frontengine.egg-info/top_level.txt
 frontengine/show/__init__.py
 frontengine/show/base_widget.py
+frontengine/show/draggable_window.py
 frontengine/show/overlay_factory.py
 frontengine/show/window_helpers.py
 frontengine/show/camera/__init__.py
@@ -37,6 +38,8 @@ frontengine/show/particle/__init__.py
 frontengine/show/particle/particle_ui.py
 frontengine/show/pet/__init__.py
 frontengine/show/pet/desktop_pet.py
+frontengine/show/pinned/__init__.py
+frontengine/show/pinned/pinned_image.py
 frontengine/show/presentation/__init__.py
 frontengine/show/presentation/annotation_overlay.py
 frontengine/show/presentation/cursor_effects.py

{frontengine-1.0.72 → frontengine-1.0.73}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "frontengine"
-version = "1.0.72"
+version = "1.0.73"
 authors = [
     { name = "JE-Chen", email = "jechenmailman@gmail.com" },
 ]