frontengine 1.0.74__tar.gz → 1.0.76__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.74
+Version: 1.0.76
 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.76/frontengine/show/freeze/freeze_widget.py

@@ -0,0 +1,93 @@
+"""
+凍結畫面：把某個螢幕現在的樣子拍下來，鋪滿那個螢幕蓋在最上層。
+
+用途是講解的節奏控制——切去別的地方操作、開別的檔案、把東西準備好，而投影出去
+或被分享的那個畫面停在原地。
+
+**一定要能在看不見主視窗的情況下解除。** 凍結之後畫面上就只剩那張靜止圖，
+FrontEngine 的視窗在它後面，按鈕點不到。所以解除的出口有三個：Escape、雙擊、
+以及全域快速鍵；三個都不通的話，使用者只剩工作管理員。
+
+Freeze the screen: photograph a display as it is now and cover that display with
+the picture.
+
+It is for pacing an explanation - stepping away to open something, getting the
+next thing ready - while what is projected or shared stays where it was.
+
+**Unfreezing must work without seeing the main window.** Once frozen, the still
+image is all there is; FrontEngine's own window is behind it and its buttons
+cannot be clicked. So there are three ways out - Escape, a double-click, and the
+global shortcut - because with none of them the user is left with the task
+manager.
+"""
+from __future__ import annotations
+
+from typing import Optional
+
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QPainter, QPixmap, QScreen
+from PySide6.QtWidgets import QWidget
+
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+
+def capture_screen(screen: Optional[QScreen]) -> QPixmap:
+    """
+    把整個螢幕拍成一張圖。拍不到就回傳空的 QPixmap，呼叫端負責不要顯示它。
+    Photograph a whole screen. An unavailable screen gives a null pixmap and the
+    caller is responsible for not showing it.
+    """
+    if screen is None:
+        return QPixmap()
+    try:
+        geometry = screen.geometry()
+        return screen.grabWindow(0, 0, 0, geometry.width(), geometry.height())
+    except Exception as error:  # pragma: no cover - platform boundary
+        front_engine_logger.warning(f"[Freeze] capture failed: {error!r}")
+        return QPixmap()
+
+
+class FreezeWidget(QWidget):
+    """一張靜止的螢幕畫面，鋪滿目標螢幕。"""
+
+    def __init__(self, pixmap: QPixmap, parent: Optional[QWidget] = None) -> None:
+        super().__init__(parent)
+        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
+        # 不用 Tool：Tool 視窗在部分平台不吃鍵盤焦點，那樣 Escape 就按不掉了。
+        # Not a Tool window: on some platforms those do not take keyboard focus,
+        # which is exactly how Escape would stop working.
+        self.setWindowFlags(
+            Qt.WindowType.FramelessWindowHint | Qt.WindowType.WindowStaysOnTopHint)
+        self.setWindowTitle("FrontEngine")
+        self.pixmap = pixmap if pixmap is not None else QPixmap()
+        front_engine_logger.info(
+            f"[FreezeWidget] Init | size=({self.pixmap.width()}, {self.pixmap.height()})")
+
+    def show_on(self, screen: Optional[QScreen]) -> None:
+        """在指定螢幕上鋪滿顯示，並取得鍵盤焦點好讓 Escape 有效。"""
+        if screen is not None:
+            self.setScreen(screen)
+            self.setGeometry(screen.geometry())
+        self.showFullScreen()
+        self.raise_()
+        self.activateWindow()
+        self.setFocus(Qt.FocusReason.OtherFocusReason)
+
+    def paintEvent(self, event) -> None:
+        if self.pixmap.isNull():
+            return
+        painter = QPainter(self)
+        painter.drawPixmap(self.rect(), self.pixmap)
+
+    def mouseDoubleClickEvent(self, event) -> None:
+        self.close()
+        event.accept()
+
+    def keyPressEvent(self, event) -> None:
+        # 任何鍵都解除，不只是 Escape。畫面被一張靜止圖蓋住的時候，使用者最可能做的
+        # 就是「隨便按一個鍵看看」，那時候應該要有反應。
+        # Any key unfreezes, not only Escape. Faced with a screen that has stopped
+        # responding, pressing something at random is the first thing anyone tries,
+        # and it should work.
+        self.close()
+        event.accept()

{frontengine-1.0.74 → frontengine-1.0.76}/frontengine/ui/dialog/hotkey_settings_dialog.py

@@ -33,6 +33,7 @@ _ACTION_LABELS: Dict[str, Tuple[str, str]] = {
     "dashboard_next": ("web_dashboard_next", "Next page"),
     "toggle_lock": ("hotkey_toggle_lock", "Lock / unlock overlays"),
     "show_shortcuts": ("hotkey_show_shortcuts", "Show this shortcut list"),
+    "toggle_freeze": ("hotkey_toggle_freeze", "Freeze / unfreeze the screen"),
 }
 
 

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

@@ -698,6 +698,13 @@ class FrontEngineMainUI(QMainWindow):
             self.control_center_ui.toggle_lock_all()
         elif action == "show_shortcuts":
             self.toggle_shortcut_sheet()
+        elif action == "toggle_freeze":
+            # 畫面被凍結時，主視窗就在那張靜止圖後面，按鈕點不到——所以這個
+            # 快速鍵是唯一保證按得到的解除方式。
+            # While frozen the main window is behind the still image and its
+            # buttons cannot be reached; this shortcut is the way out that is
+            # always available.
+            self.presentation_setting_ui.toggle_freeze()
 
     def toggle_shortcut_sheet(self) -> None:
         """

{frontengine-1.0.74 → frontengine-1.0.76}/frontengine/ui/page/presentation/presentation_setting_ui.py

@@ -22,6 +22,7 @@ from frontengine.show.presentation.annotation_overlay import (
 from frontengine.show.presentation.cursor_effects import CursorEffectWidget
 from frontengine.show.presentation.keystroke_display import KeystrokeDisplayWidget
 from frontengine.show.presentation.magnifier import MagnifierWidget
+from frontengine.show.freeze.freeze_widget import FreezeWidget, capture_screen
 from frontengine.ui.page.utils import build_target_monitor_combobox, coerce_int, resolve_preferred_monitor
 from frontengine.utils.input_watch.input_watch_service import InputWatchService
 from frontengine.ui.page.layout_kit import SettingPage
@@ -106,6 +107,14 @@ class PresentationSettingUI(SettingPage):
         self.whiteboard_save_button.clicked.connect(self.save_whiteboard)
         self.target_monitor_label = tr(QLabel(), "target_monitor_label", "Target monitor")
         self.target_monitor_combobox = build_target_monitor_combobox()
+
+        # 凍結畫面：把目標螢幕現在的樣子拍下來蓋上去，講解時可以先停住畫面
+        # Freeze: cover the target screen with a photograph of itself, so an
+        # explanation can be paced without the audience watching you work.
+        self.freeze_widget_list: list = []
+        self.freeze_label = tr(QLabel(), "presentation_freeze_label", "Freeze screen")
+        self.freeze_button = tr(QPushButton(), "presentation_freeze_start", "Freeze")
+        self.freeze_button.clicked.connect(self.toggle_freeze)
         self.hint_label = tr(QLabel(), "presentation_hint",
             "Drawing takes the mouse while it is on; the other overlays pass clicks through.")
         self.hint_label.setWordWrap(True)
@@ -137,6 +146,9 @@ class PresentationSettingUI(SettingPage):
         whiteboard.add_inline(self.whiteboard_button, self.whiteboard_save_button)
 
         where = self.add_section("section_where", "Where")
+        freeze = self.add_section(self.freeze_label)
+        freeze.add_inline(self.freeze_button)
+
         where.add_row(self.target_monitor_label, self.target_monitor_combobox)
 
         self.add_body_widget(self.hint_label)
@@ -340,6 +352,68 @@ class PresentationSettingUI(SettingPage):
         else:
             self.start_whiteboard()
 
+    def toggle_freeze(self):
+        """
+        凍結／解除目標螢幕。已經凍結就解除，所以同一顆按鈕（和同一個快速鍵）
+        兩種方向都走得通。
+        Freeze or unfreeze the target screen. Frozen already means unfreeze, so
+        the same button - and the same shortcut - works both ways.
+        """
+        if self.freeze_widget_list:
+            self.unfreeze()
+            return None
+
+        screens = QGuiApplication.screens()
+        index = resolve_preferred_monitor(self.target_monitor_combobox)
+        screen = screens[index] if index is not None and 0 <= index < len(screens)             else QGuiApplication.primaryScreen()
+
+        pixmap = capture_screen(screen)
+        if pixmap.isNull():
+            # 拍不到就不要蓋一塊空白上去：那會讓整個螢幕變成一片黑，而且看起來
+            # 像當機而不是「凍結失敗」。
+            # Without a picture, do not cover anything: a blank sheet turns the
+            # screen black and reads as a crash rather than a failed freeze.
+            front_engine_logger.info("[PresentationSettingUI] nothing captured, not freezing")
+            return None
+
+        widget = FreezeWidget(pixmap)
+        widget.destroyed.connect(lambda: self._forget_freeze(widget))
+        widget.show_on(screen)
+        self.freeze_widget_list.append(widget)
+        retranslator.set_text(self.freeze_button, "presentation_freeze_stop", "Unfreeze")
+        return widget
+
+    def unfreeze(self) -> None:
+        """解除凍結。"""
+        for widget in self.freeze_widget_list[:]:
+            try:
+                widget.close()
+            except RuntimeError:  # pragma: no cover - 底層物件已消失
+                pass
+        self.freeze_widget_list.clear()
+        retranslator.set_text(self.freeze_button, "presentation_freeze_start", "Freeze")
+
+    def _forget_freeze(self, widget) -> None:
+        """
+        使用者自己按 Escape 或雙擊關掉時也要回到「凍結」字樣，否則按鈕會一直
+        寫著「解除凍結」，而畫面上根本沒有凍結的東西。
+        Coming back to "Freeze" when the user dismissed it themselves; otherwise
+        the button keeps offering to unfreeze something that is no longer there.
+        """
+        if widget in self.freeze_widget_list:
+            self.freeze_widget_list.remove(widget)
+        if self.freeze_widget_list:
+            return
+        try:
+            retranslator.set_text(self.freeze_button, "presentation_freeze_start", "Freeze")
+        except RuntimeError:
+            # destroyed 是在 C++ 物件消失之後才送到的，關閉程式時這一頁可能已經
+            # 先走了。那時候沒有按鈕可以改，也不需要改。
+            # destroyed arrives after the C++ object is gone, and on shutdown this
+            # page may already have followed it. There is no button left to
+            # relabel, and nothing that needs relabelling.
+            pass
+
     def start_whiteboard(self) -> None:
         """開一塊無限畫布（可平移縮放，畫過的東西留在畫布座標上）。"""
         front_engine_logger.info("[PresentationSettingUI] start_whiteboard")

{frontengine-1.0.74 → frontengine-1.0.76}/frontengine/user_setting/user_setting_file.py

@@ -18,6 +18,7 @@ default_hotkeys: Dict[str, str] = {
     "dashboard_next": "<ctrl>+<shift>+<right>",
     "toggle_lock": "<ctrl>+<shift>+l",
     "show_shortcuts": "<ctrl>+<shift>+<f8>",
+    "toggle_freeze": "<ctrl>+<shift>+<f7>",
 }
 
 user_setting_dict: Dict[str, Any] = {

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

@@ -31,6 +31,10 @@ english_word_dict = {
     "screen_care_band": "Band",
     "screen_care_strength": "Strength",
     "screen_care_type": "Type",
+    "presentation_freeze_label": "Freeze screen",
+    "presentation_freeze_start": "Freeze",
+    "presentation_freeze_stop": "Unfreeze",
+    "hotkey_toggle_freeze": "Freeze / unfreeze the screen",
     "presentation_tool": "Tool",
     "presentation_colour": "Colour",
     "presentation_width": "Width",

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

@@ -32,6 +32,10 @@ french_word_dict = {
     "screen_care_band": "Largeur",
     "screen_care_strength": "Intensité",
     "screen_care_type": "Type",
+    "presentation_freeze_label": "Figer l'écran",
+    "presentation_freeze_start": "Figer",
+    "presentation_freeze_stop": "Libérer",
+    "hotkey_toggle_freeze": "Figer / libérer l'écran",
     "presentation_tool": "Outil",
     "presentation_colour": "Couleur",
     "presentation_width": "Épaisseur",

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

@@ -32,6 +32,10 @@ germany_word_dict = {
     "screen_care_band": "Breite",
     "screen_care_strength": "Stärke",
     "screen_care_type": "Typ",
+    "presentation_freeze_label": "Bild einfrieren",
+    "presentation_freeze_start": "Einfrieren",
+    "presentation_freeze_stop": "Auftauen",
+    "hotkey_toggle_freeze": "Bild einfrieren / auftauen",
     "presentation_tool": "Werkzeug",
     "presentation_colour": "Farbe",
     "presentation_width": "Breite",

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

@@ -32,6 +32,10 @@ italian_word_dict = {
     "screen_care_band": "Larghezza",
     "screen_care_strength": "Intensità",
     "screen_care_type": "Tipo",
+    "presentation_freeze_label": "Congela lo schermo",
+    "presentation_freeze_start": "Congela",
+    "presentation_freeze_stop": "Scongela",
+    "hotkey_toggle_freeze": "Congela / scongela lo schermo",
     "presentation_tool": "Strumento",
     "presentation_colour": "Colore",
     "presentation_width": "Spessore",

{frontengine-1.0.74 → frontengine-1.0.76}/frontengine/utils/multi_language/russian.py

@@ -32,6 +32,10 @@ russian_word_dict = {
     "screen_care_band": "Ширина",
     "screen_care_strength": "Сила",
     "screen_care_type": "Тип",
+    "presentation_freeze_label": "Заморозить экран",
+    "presentation_freeze_start": "Заморозить",
+    "presentation_freeze_stop": "Разморозить",
+    "hotkey_toggle_freeze": "Заморозить / разморозить экран",
     "presentation_tool": "Инструмент",
     "presentation_colour": "Цвет",
     "presentation_width": "Толщина",

{frontengine-1.0.74 → frontengine-1.0.76}/frontengine/utils/multi_language/simplified_chinese.py

@@ -32,6 +32,10 @@ simplified_chinese_word_dict = {
     "screen_care_band": "宽度",
     "screen_care_strength": "强度",
     "screen_care_type": "类型",
+    "presentation_freeze_label": "冻结画面",
+    "presentation_freeze_start": "冻结",
+    "presentation_freeze_stop": "解除冻结",
+    "hotkey_toggle_freeze": "冻结／解除冻结画面",
     "presentation_tool": "工具",
     "presentation_colour": "颜色",
     "presentation_width": "粗细",

{frontengine-1.0.74 → frontengine-1.0.76}/frontengine/utils/multi_language/traditional_chinese.py

@@ -32,6 +32,10 @@ traditional_chinese_word_dict = {
     "screen_care_band": "寬度",
     "screen_care_strength": "強度",
     "screen_care_type": "類型",
+    "presentation_freeze_label": "凍結畫面",
+    "presentation_freeze_start": "凍結",
+    "presentation_freeze_stop": "解除凍結",
+    "hotkey_toggle_freeze": "凍結／解除凍結畫面",
     "presentation_tool": "工具",
     "presentation_colour": "顏色",
     "presentation_width": "粗細",

{frontengine-1.0.74 → frontengine-1.0.76}/frontengine.egg-info/PKG-INFO

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

@@ -22,6 +22,8 @@ frontengine/show/capture/__init__.py
 frontengine/show/capture/region_capture.py
 frontengine/show/focus_shield/__init__.py
 frontengine/show/focus_shield/focus_shield_widget.py
+frontengine/show/freeze/__init__.py
+frontengine/show/freeze/freeze_widget.py
 frontengine/show/gif/__init__.py
 frontengine/show/gif/paint_gif.py
 frontengine/show/image/__init__.py

{frontengine-1.0.74 → frontengine-1.0.76}/pyproject.toml

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