frontengine 1.0.69__tar.gz → 1.0.71__tar.gz

{frontengine-1.0.69 → frontengine-1.0.71}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.69
+Version: 1.0.71
 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.69 → frontengine-1.0.71}/frontengine/show/replica/replica_widget.py

@@ -20,7 +20,7 @@ from PySide6.QtWidgets import QWidget
 
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.window_replica.dwm_thumbnail import (
-    DEFAULT_REPLICA_WIDTH, MIN_REPLICA_SIZE, DwmThumbnail, available, fit_within,
+    DEFAULT_REPLICA_WIDTH, MIN_REPLICA_SIZE, DwmThumbnail, available, crop_rect, fit_within,
 )
 
 
@@ -28,7 +28,8 @@ class WindowReplicaWidget(QWidget):
     """顯示另一個視窗即時畫面的小視窗。"""
 
     def __init__(self, source_handle: int, title: str = "",
-                 opacity_percent: int = 100, parent: Optional[QWidget] = None) -> None:
+                 opacity_percent: int = 100, parent: Optional[QWidget] = None,
+                 crop: Optional[tuple] = None) -> None:
         front_engine_logger.info(f"[WindowReplicaWidget] Init | source={source_handle}")
         super().__init__(parent)
         self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
@@ -42,6 +43,10 @@ class WindowReplicaWidget(QWidget):
         self.source_handle = int(source_handle)
         self.source_title = title
         self.opacity_percent = max(1, min(100, int(opacity_percent)))
+        # 裁切用比例存：來源視窗被調整大小時，框到的還是同一塊。
+        # The crop is kept as fractions so it still points at the same part of
+        # the source after that window is resized.
+        self.crop = crop
         self.thumbnail = DwmThumbnail()
         self._drag_origin: Optional[QPoint] = None
 
@@ -63,6 +68,14 @@ class WindowReplicaWidget(QWidget):
         if not self.thumbnail.register(int(self.winId()), self.source_handle):
             return False
         source_size = self.thumbnail.source_size()
+        # 有裁切的話，長寬比要照框出來的那一塊算，不是照整個視窗算——否則框一條
+        # 細長的聊天欄會得到一個又寬又空的複本。
+        # With a crop the aspect ratio comes from the cropped part, not the whole
+        # window: cropping a narrow chat column would otherwise give a wide,
+        # mostly empty replica.
+        cropped = crop_rect(source_size, self.crop)
+        if cropped is not None:
+            source_size = (cropped[2] - cropped[0], cropped[3] - cropped[1])
         width, height = fit_within(source_size, (DEFAULT_REPLICA_WIDTH,
                                                  int(DEFAULT_REPLICA_WIDTH * 9 / 16)))
         self.resize(width, height)
@@ -71,7 +84,13 @@ class WindowReplicaWidget(QWidget):
 
     def _refresh(self) -> None:
         self.thumbnail.update(self.width(), self.height(),
-                              opacity=int(self.opacity_percent * 255 / 100))
+                              opacity=int(self.opacity_percent * 255 / 100),
+                              source_rect=crop_rect(self.thumbnail.source_size(), self.crop))
+
+    def set_crop(self, crop: Optional[tuple]) -> None:
+        """換一塊要顯示的區域（None 表示整個視窗）。"""
+        self.crop = crop
+        self._refresh()
 
     def set_opacity_percent(self, percent: int) -> None:
         self.opacity_percent = max(1, min(100, int(percent)))

frontengine-1.0.71/frontengine/show/shortcuts/shortcut_sheet.py

@@ -0,0 +1,152 @@
+"""
+快速鍵速查表：把目前綁定的全域快速鍵列在畫面上。
+
+快速鍵改得掉，所以印在說明文件裡的那份遲早會過時；這一份是直接從實際生效的綁定
+讀出來的，改過就跟著改。
+
+排版與文字是純函式（`sheet_rows`），所以「顯示的內容對不對」不必開視窗就能驗。
+
+A shortcut cheat sheet: the global shortcuts as they are actually bound.
+
+Shortcuts can be rebound, so any list written into the documentation goes stale;
+this one is read from the bindings in force and follows them.
+
+The rows are produced by a pure function (`sheet_rows`), so what it says can be
+checked without opening a window.
+"""
+from __future__ import annotations
+
+from typing import Dict, List, Optional, Tuple
+
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QColor, QFont, QPainter
+from PySide6.QtWidgets import QApplication
+
+from frontengine.show.base_widget import BaseWidget
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+# pynput 的寫法轉成看得懂的樣子
+# pynput spellings turned into something readable
+_PRETTY = {
+    "ctrl": "Ctrl", "alt": "Alt", "shift": "Shift", "cmd": "Cmd",
+    "up": "Up", "down": "Down", "left": "Left", "right": "Right",
+    "space": "Space", "enter": "Enter", "esc": "Esc", "tab": "Tab",
+}
+
+
+def pretty_combo(combo: str) -> str:
+    """
+    把 `<ctrl>+<shift>+<f12>` 變成 `Ctrl + Shift + F12`。
+
+    使用者是在對照畫面上按下去的手指，不是在讀設定檔，所以尖括號和小寫都要去掉。
+    Turn `<ctrl>+<shift>+<f12>` into `Ctrl + Shift + F12`. The reader is matching
+    this against their fingers, not against a settings file, so the angle
+    brackets and the lower case go.
+    """
+    parts = []
+    for raw in str(combo or "").split("+"):
+        name = raw.strip().strip("<>").strip()
+        if not name:
+            continue
+        if name in _PRETTY:
+            parts.append(_PRETTY[name])
+        elif len(name) > 1 and name[0] == "f" and name[1:].isdigit():
+            parts.append(name.upper())
+        else:
+            parts.append(name.upper() if len(name) == 1 else name.capitalize())
+    return " + ".join(parts)
+
+
+def sheet_rows(bindings: Dict[str, str], label_for) -> List[Tuple[str, str]]:
+    """
+    產生 (快速鍵, 動作說明) 的清單，依動作說明排序。
+
+    `bindings` 是「組合字串 -> 動作名稱」，和 HotkeyService 用的同一份，所以這裡
+    列出來的一定就是實際會生效的。沒有綁定時回傳空清單，呼叫端才能說「沒有」而
+    不是開一個空白視窗。
+    Rows of (shortcut, what it does), sorted by the description.
+
+    `bindings` is the same combo-to-action mapping HotkeyService uses, so what
+    is listed is what will actually fire. With nothing bound this returns an
+    empty list, so the caller can say so rather than opening a blank window.
+    """
+    rows = []
+    for combo, action in (bindings or {}).items():
+        if not combo or not action:
+            continue
+        rows.append((pretty_combo(combo), label_for(action)))
+    return sorted(rows, key=lambda row: row[1].lower())
+
+
+class ShortcutSheetWidget(BaseWidget):
+    """把速查表畫在畫面中央，點擊穿透。"""
+
+    PADDING = 28
+    LINE_SPACING = 10
+
+    def __init__(self, rows: List[Tuple[str, str]], title: str = "Shortcuts",
+                 font_size: int = 20, opacity: float = 0.9) -> None:
+        front_engine_logger.info(f"[ShortcutSheetWidget] Init | rows={len(rows)}")
+        super().__init__()
+        self.opacity = max(0.1, min(1.0, float(opacity)))
+        self.rows = list(rows)
+        self.title = title
+        self.font_size = max(10, int(font_size))
+        self.text_color = QColor("#ffffff")
+        self.key_color = QColor("#ffd740")
+        self.background_color = QColor(0, 0, 0, 210)
+
+    def sizeHint(self):  # pragma: no cover - Qt geometry
+        screen = QApplication.primaryScreen()
+        available = screen.availableGeometry() if screen is not None else None
+        if available is None:
+            return super().sizeHint()
+        return available.size() / 2
+
+    def draw_content(self, painter: QPainter) -> None:
+        painter.fillRect(self.rect(), self.background_color)
+
+        title_font = QFont()
+        title_font.setPixelSize(int(self.font_size * 1.3))
+        title_font.setBold(True)
+        painter.setFont(title_font)
+        painter.setPen(self.text_color)
+        y = self.PADDING + int(self.font_size * 1.3)
+        painter.drawText(self.PADDING, y, self.title)
+
+        row_font = QFont()
+        row_font.setPixelSize(self.font_size)
+        painter.setFont(row_font)
+        y += int(self.font_size * 1.4)
+
+        # 左欄放快速鍵、右欄放說明。欄寬固定，兩欄才會各自對齊成一直線。
+        # Shortcut on the left, description on the right, at a fixed column so
+        # both line up rather than drifting with the text.
+        key_column = self.PADDING
+        text_column = self.PADDING + int(self.font_size * 11)
+        for combo, description in self.rows:
+            y += self.font_size + self.LINE_SPACING
+            painter.setPen(self.key_color)
+            painter.drawText(key_column, y, combo)
+            painter.setPen(self.text_color)
+            painter.drawText(text_column, y, description)
+
+    def keyPressEvent(self, event) -> None:  # pragma: no cover - Qt event
+        if event.key() in (Qt.Key.Key_Escape,):
+            self.close()
+            return
+        super().keyPressEvent(event)
+
+
+def build_sheet(bindings: Dict[str, str], label_for, title: str = "Shortcuts",
+                font_size: int = 20) -> Optional[ShortcutSheetWidget]:
+    """
+    建立速查表；沒有任何綁定時回傳 None。
+    Build the sheet, or None when nothing is bound - an empty black rectangle
+    explains nothing.
+    """
+    rows = sheet_rows(bindings, label_for)
+    if not rows:
+        front_engine_logger.info("[ShortcutSheetWidget] nothing bound, not showing")
+        return None
+    return ShortcutSheetWidget(rows, title=title, font_size=font_size)

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/ui/dialog/hotkey_settings_dialog.py

@@ -32,6 +32,7 @@ _ACTION_LABELS: Dict[str, Tuple[str, str]] = {
     "opacity_down": ("hotkey_opacity_down", "Opacity down"),
     "dashboard_next": ("web_dashboard_next", "Next page"),
     "toggle_lock": ("hotkey_toggle_lock", "Lock / unlock overlays"),
+    "show_shortcuts": ("hotkey_show_shortcuts", "Show this shortcut list"),
 }
 
 
@@ -39,6 +40,20 @@ def _t(key: str, fallback: str) -> str:
     return language_wrapper.language_word_dict.get(key, fallback)
 
 
+def action_label(action: str) -> str:
+    """
+    動作名稱的顯示文字，翻不到就退回動作名稱本身。
+
+    速查表和這個對話框共用同一張表：兩邊各記一份的話，改了快速鍵的說明只會改到
+    其中一邊，而使用者看到的是兩個不同的名字。
+    The display text for an action, falling back to the action name. The cheat
+    sheet and this dialog share one table: with a copy each, renaming a shortcut
+    updates only one of them and the user sees two different names.
+    """
+    key, fallback = _ACTION_LABELS.get(action, ("", str(action)))
+    return _t(key, fallback) if key else fallback
+
+
 class HotkeySettingsDialog(QDialog):
     """
     讓使用者以 pynput 組合鍵語法（例如 <ctrl>+<shift>+<f12>）重新綁定全域

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/ui/dialog/window_replica_dialog.py

@@ -12,8 +12,8 @@ from typing import List, Optional, Tuple
 
 from PySide6.QtCore import Qt
 from PySide6.QtWidgets import (
-    QAbstractItemView, QDialog, QDialogButtonBox, QGridLayout, QLabel, QListWidget,
-    QListWidgetItem, QPushButton, QSlider, QWidget,
+    QAbstractItemView, QComboBox, QDialog, QDialogButtonBox, QGridLayout, QLabel,
+    QListWidget, QListWidgetItem, QPushButton, QSlider, QWidget,
 )
 
 from frontengine.show.replica.replica_widget import WindowReplicaWidget
@@ -23,6 +23,19 @@ from frontengine.utils.multi_language.retranslate import retranslator, tr
 from frontengine.utils.window_pin import window_pin
 from frontengine.utils.window_replica.dwm_thumbnail import available
 
+# 要顯示來源的哪一塊，用比例（左, 上, 右, 下）表示。
+# 用比例而不是像素：來源視窗被調整大小之後，框到的還是同一塊。
+# Which part of the source to show, as (left, top, right, bottom) fractions.
+# Fractions rather than pixels, so a resize of the source keeps the same part.
+CROP_REGIONS = (
+    ("window_replica_whole", "Whole window", None),
+    ("window_replica_top_half", "Top half", (0.0, 0.0, 1.0, 0.5)),
+    ("window_replica_bottom_half", "Bottom half", (0.0, 0.5, 1.0, 1.0)),
+    ("window_replica_left_half", "Left half", (0.0, 0.0, 0.5, 1.0)),
+    ("window_replica_right_half", "Right half", (0.5, 0.0, 1.0, 1.0)),
+    ("window_replica_centre", "Centre", (0.25, 0.25, 0.75, 0.75)),
+)
+
 
 def _t(key: str, fallback: str) -> str:
     return language_wrapper.language_word_dict.get(key, fallback)
@@ -47,6 +60,11 @@ class WindowReplicaDialog(QDialog):
         self.show_button = tr(QPushButton(), "window_replica_show", "Show replica")
         self.show_button.clicked.connect(self.start_replica)
 
+        self.crop_label = tr(QLabel(), "window_replica_region", "Show")
+        self.crop_combobox = QComboBox()
+        for key, fallback, region in CROP_REGIONS:
+            self.crop_combobox.addItem(_t(key, fallback), region)
+
         self.opacity_label = tr(QLabel(), "window_replica_opacity", "Opacity")
         self.opacity_slider = QSlider(Qt.Orientation.Horizontal)
         self.opacity_slider.setRange(10, 100)
@@ -69,10 +87,12 @@ class WindowReplicaDialog(QDialog):
         layout.addWidget(self.window_list, 0, 0, 1, 2)
         layout.addWidget(self.refresh_button, 1, 0)
         layout.addWidget(self.show_button, 1, 1)
-        layout.addWidget(self.opacity_label, 2, 0)
-        layout.addWidget(self.opacity_slider, 2, 1)
-        layout.addWidget(self.hint_label, 3, 0, 1, 2)
-        layout.addWidget(self.button_box, 4, 0, 1, 2)
+        layout.addWidget(self.crop_label, 2, 0)
+        layout.addWidget(self.crop_combobox, 2, 1)
+        layout.addWidget(self.opacity_label, 3, 0)
+        layout.addWidget(self.opacity_slider, 3, 1)
+        layout.addWidget(self.hint_label, 4, 0, 1, 2)
+        layout.addWidget(self.button_box, 5, 0, 1, 2)
 
         self.show_button.setEnabled(available())
         self.reload_windows()
@@ -106,7 +126,8 @@ class WindowReplicaDialog(QDialog):
         if chosen is None:
             return None
         handle, title = chosen
-        replica = self._replica_factory(handle, title, self.opacity_slider.value(), None)
+        replica = self._replica_factory(handle, title, self.opacity_slider.value(), None,
+                                        self.crop_combobox.currentData())
         if not replica.start():
             front_engine_logger.info(f"[WindowReplicaDialog] could not replicate {title!r}")
             replica.close()

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/ui/main_ui.py

@@ -15,6 +15,7 @@ from qt_material import apply_stylesheet
 from frontengine.ui.nav.sidebar import NavigationSidebar
 from frontengine.ui.style.app_style import apply_app_style
 
+from frontengine.show.shortcuts.shortcut_sheet import build_sheet
 from frontengine.show.toast.toast_widget import show_toast
 from frontengine.system_tray.extend_system_tray import ExtendSystemTray
 from frontengine.ui.menu.help_menu import build_help_menu
@@ -55,7 +56,7 @@ from frontengine.utils.hotkey.hotkey_service import HotkeyService
 from frontengine.utils.keep_awake.keep_awake import KeepAwake
 from frontengine.utils.logging.loggin_instance import front_engine_logger
 from frontengine.utils.multi_language.language_wrapper import language_wrapper
-from frontengine.utils.multi_language.retranslate import retranslator
+from frontengine.utils.multi_language.retranslate import retranslator, translate
 from frontengine.utils.plugins.plugin_loader import load_plugins
 from frontengine.utils.preset_schedule.preset_schedule_service import PresetScheduleService
 from frontengine.ui.dialog.remote_control_dialog import (
@@ -66,6 +67,7 @@ from frontengine.ui.dialog.signage_dialog import current_settings as current_sig
 from frontengine.utils.signage.signage_service import SignageService
 from frontengine.utils.midi.midi_input import MidiInput, binding_key
 from frontengine.utils.remote.remote_server import RemoteServer
+from frontengine.ui.dialog.hotkey_settings_dialog import action_label as hotkey_action_label
 from frontengine.ui.dialog.smart_pause_dialog import current_rules
 from frontengine.utils.screen_privacy.share_watch import ShareWatchService
 from frontengine.utils.screensaver.screensaver_service import ScreensaverService
@@ -689,6 +691,33 @@ class FrontEngineMainUI(QMainWindow):
             self.web_setting_ui.show_next_dashboard_page()
         elif action == "toggle_lock":
             self.control_center_ui.toggle_lock_all()
+        elif action == "show_shortcuts":
+            self.toggle_shortcut_sheet()
+
+    def toggle_shortcut_sheet(self) -> None:
+        """
+        開關快速鍵速查表。已經開著就收起來，所以同一個快速鍵按第二次是關閉——
+        不然使用者得去找別的方法把它關掉。
+        Toggle the shortcut sheet: pressing the same shortcut again closes it,
+        rather than leaving the user hunting for another way to dismiss it.
+        """
+        existing = getattr(self, "shortcut_sheet", None)
+        if existing is not None:
+            try:
+                existing.close()
+            except RuntimeError:  # pragma: no cover - 底層物件已消失
+                pass
+            self.shortcut_sheet = None
+            return
+        sheet = build_sheet(
+            get_hotkey_bindings(),
+            lambda action: hotkey_action_label(action),
+            title=translate("shortcut_sheet_title", "Shortcuts"))
+        if sheet is None:
+            return
+        sheet.set_ui_window_flag()
+        sheet.showFullScreen()
+        self.shortcut_sheet = sheet
 
     def _on_smart_pause_changed(self, paused: bool, reason: str) -> None:
         """

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/ui/menu/help_menu.py

@@ -36,6 +36,18 @@ def build_help_menu(ui_we_want_to_set: FrontEngineMainUI) -> None:
         "How to use..."
     )
 
+    # 也要能從選單開。只能用快速鍵叫出來的「快速鍵速查表」是個笑話：不知道快速鍵
+    # 的人正是最需要它的人。
+    # It has to be reachable from the menu too. A shortcut sheet you can only open
+    # with a shortcut is a joke: the person who does not know the shortcuts is
+    # exactly who needs it.
+    _add_action(
+        help_menu,
+        "shortcut_sheet_action",
+        lambda: ui_we_want_to_set.toggle_shortcut_sheet(),
+        "Shortcut list..."
+    )
+
     _add_action(
         help_menu,
         "help_menu_open_issue",

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/user_setting/user_setting_file.py

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

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/utils/multi_language/english.py

@@ -49,6 +49,13 @@ english_word_dict = {
     "pet_settle_typing": "Settle while typing",
     "target_monitor_span": "Span all screens",
     "tools_replicate_window": "Replicate a window...",
+    "window_replica_region": "Show",
+    "window_replica_whole": "Whole window",
+    "window_replica_top_half": "Top half",
+    "window_replica_bottom_half": "Bottom half",
+    "window_replica_left_half": "Left half",
+    "window_replica_right_half": "Right half",
+    "window_replica_centre": "Centre",
     "window_replica_title": "Replicate a window",
     "window_replica_refresh": "Refresh",
     "window_replica_show": "Show replica",
@@ -569,6 +576,9 @@ english_word_dict = {
     "clipboard_clear": 'Clear (keep pinned)',
     "clipboard_persist": 'Keep this history between sessions',
     "clipboard_hint": 'History stays on this machine and is never sent anywhere. Unless you tick the box above it is kept in memory only, because clipboards often hold passwords.',
+    "shortcut_sheet_title": "Shortcuts",
+    "shortcut_sheet_action": "Shortcut list...",
+    "hotkey_show_shortcuts": "Show this shortcut list",
     "tools_layout_label": 'Window layout',
     "tools_layout_name": 'Layout name',
     "tools_layout_save": 'Save layout',

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/utils/multi_language/france.py

@@ -50,6 +50,13 @@ french_word_dict = {
     "pet_settle_typing": "Rester tranquille pendant la frappe",
     "target_monitor_span": "Sur tous les écrans",
     "tools_replicate_window": "Dupliquer une fenêtre...",
+    "window_replica_region": "Afficher",
+    "window_replica_whole": "Fenêtre entière",
+    "window_replica_top_half": "Moitié supérieure",
+    "window_replica_bottom_half": "Moitié inférieure",
+    "window_replica_left_half": "Moitié gauche",
+    "window_replica_right_half": "Moitié droite",
+    "window_replica_centre": "Centre",
     "window_replica_title": "Dupliquer une fenêtre",
     "window_replica_refresh": "Actualiser",
     "window_replica_show": "Afficher le duplicata",
@@ -559,6 +566,9 @@ french_word_dict = {
     "clipboard_clear": "Effacer (garder les épinglés)",
     "clipboard_persist": "Conserver cet historique d'une session à l'autre",
     "clipboard_hint": "L'historique reste sur cette machine et n'est jamais envoyé ailleurs. Sauf si vous cochez la case ci-dessus, il n'est gardé qu'en mémoire, car les presse-papiers contiennent souvent des mots de passe.",
+    "shortcut_sheet_title": "Raccourcis",
+    "shortcut_sheet_action": "Liste des raccourcis...",
+    "hotkey_show_shortcuts": "Afficher cette liste de raccourcis",
     "tools_layout_label": "Disposition des fenêtres",
     "tools_layout_name": "Nom de la disposition",
     "tools_layout_save": "Enregistrer la disposition",

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/utils/multi_language/germany.py

@@ -50,6 +50,13 @@ germany_word_dict = {
     "pet_settle_typing": "Beim Tippen still halten",
     "target_monitor_span": "Über alle Bildschirme",
     "tools_replicate_window": "Fenster duplizieren...",
+    "window_replica_region": "Anzeigen",
+    "window_replica_whole": "Ganzes Fenster",
+    "window_replica_top_half": "Obere Hälfte",
+    "window_replica_bottom_half": "Untere Hälfte",
+    "window_replica_left_half": "Linke Hälfte",
+    "window_replica_right_half": "Rechte Hälfte",
+    "window_replica_centre": "Mitte",
     "window_replica_title": "Fenster duplizieren",
     "window_replica_refresh": "Aktualisieren",
     "window_replica_show": "Duplikat anzeigen",
@@ -562,6 +569,9 @@ germany_word_dict = {
     "clipboard_clear": "Löschen (Angeheftetes behalten)",
     "clipboard_persist": "Diesen Verlauf über Sitzungen hinweg behalten",
     "clipboard_hint": "Der Verlauf bleibt auf diesem Rechner und wird niemals irgendwohin gesendet. Solange Sie das Kästchen oben nicht ankreuzen, bleibt er nur im Arbeitsspeicher – denn in Zwischenablagen stehen oft Passwörter.",
+    "shortcut_sheet_title": "Tastenkürzel",
+    "shortcut_sheet_action": "Tastenkürzel-Liste...",
+    "hotkey_show_shortcuts": "Diese Tastenkürzel-Liste anzeigen",
     "tools_layout_label": "Fensteranordnung",
     "tools_layout_name": "Name der Anordnung",
     "tools_layout_save": "Anordnung speichern",

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/utils/multi_language/italy.py

@@ -50,6 +50,13 @@ italian_word_dict = {
     "pet_settle_typing": "Fermo mentre scrivi",
     "target_monitor_span": "Su tutti gli schermi",
     "tools_replicate_window": "Duplica una finestra...",
+    "window_replica_region": "Mostra",
+    "window_replica_whole": "Tutta la finestra",
+    "window_replica_top_half": "Metà superiore",
+    "window_replica_bottom_half": "Metà inferiore",
+    "window_replica_left_half": "Metà sinistra",
+    "window_replica_right_half": "Metà destra",
+    "window_replica_centre": "Centro",
     "window_replica_title": "Duplica una finestra",
     "window_replica_refresh": "Aggiorna",
     "window_replica_show": "Mostra il duplicato",
@@ -559,6 +566,9 @@ italian_word_dict = {
     "clipboard_clear": "Cancella (mantieni i fissati)",
     "clipboard_persist": "Conserva questa cronologia tra una sessione e l'altra",
     "clipboard_hint": "La cronologia resta su questa macchina e non viene mai inviata altrove. Se non spunti la casella qui sopra viene tenuta solo in memoria, perché negli appunti finiscono spesso delle password.",
+    "shortcut_sheet_title": "Scorciatoie",
+    "shortcut_sheet_action": "Elenco scorciatoie...",
+    "hotkey_show_shortcuts": "Mostra questo elenco di scorciatoie",
     "tools_layout_label": "Disposizione delle finestre",
     "tools_layout_name": "Nome della disposizione",
     "tools_layout_save": "Salva la disposizione",

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/utils/multi_language/russian.py

@@ -50,6 +50,13 @@ russian_word_dict = {
     "pet_settle_typing": "Не двигаться при наборе текста",
     "target_monitor_span": "На все экраны",
     "tools_replicate_window": "Копия окна...",
+    "window_replica_region": "Показывать",
+    "window_replica_whole": "Всё окно",
+    "window_replica_top_half": "Верхняя половина",
+    "window_replica_bottom_half": "Нижняя половина",
+    "window_replica_left_half": "Левая половина",
+    "window_replica_right_half": "Правая половина",
+    "window_replica_centre": "Центр",
     "window_replica_title": "Копия окна",
     "window_replica_refresh": "Обновить",
     "window_replica_show": "Показать копию",
@@ -559,6 +566,9 @@ russian_word_dict = {
     "clipboard_clear": "Очистить (оставить закреплённые)",
     "clipboard_persist": "Сохранять эту историю между сеансами",
     "clipboard_hint": "История остаётся на этом компьютере и никуда не отправляется. Пока флажок выше не установлен, она хранится только в памяти — ведь в буфере обмена часто оказываются пароли.",
+    "shortcut_sheet_title": "Горячие клавиши",
+    "shortcut_sheet_action": "Список горячих клавиш...",
+    "hotkey_show_shortcuts": "Показать этот список",
     "tools_layout_label": "Расположение окон",
     "tools_layout_name": "Название расположения",
     "tools_layout_save": "Сохранить расположение",

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/utils/multi_language/simplified_chinese.py

@@ -50,6 +50,13 @@ simplified_chinese_word_dict = {
     "pet_settle_typing": "打字时安分",
     "target_monitor_span": "横跨所有屏幕",
     "tools_replicate_window": "窗口副本⋯",
+    "window_replica_region": "显示范围",
+    "window_replica_whole": "整个窗口",
+    "window_replica_top_half": "上半部",
+    "window_replica_bottom_half": "下半部",
+    "window_replica_left_half": "左半部",
+    "window_replica_right_half": "右半部",
+    "window_replica_centre": "中央",
     "window_replica_title": "窗口副本",
     "window_replica_refresh": "刷新",
     "window_replica_show": "显示副本",
@@ -561,6 +568,9 @@ simplified_chinese_word_dict = {
     "clipboard_clear": "清除(保留钉选)",
     "clipboard_persist": "跨工作阶段保留这份历史",
     "clipboard_hint": "历史只留在这台机器上，不会送到任何地方。除非你勾选上面那个选项，否则只保存在记忆体里 — 因为剪贴板常常有密码。",
+    "shortcut_sheet_title": "快捷键",
+    "shortcut_sheet_action": "快捷键一览⋯",
+    "hotkey_show_shortcuts": "显示快捷键一览",
     "tools_layout_label": "视窗版面",
     "tools_layout_name": "版面名称",
     "tools_layout_save": "储存版面",

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/utils/multi_language/traditional_chinese.py

@@ -50,6 +50,13 @@ traditional_chinese_word_dict = {
     "pet_settle_typing": "打字時安分",
     "target_monitor_span": "橫跨所有螢幕",
     "tools_replicate_window": "視窗複本⋯",
+    "window_replica_region": "顯示範圍",
+    "window_replica_whole": "整個視窗",
+    "window_replica_top_half": "上半部",
+    "window_replica_bottom_half": "下半部",
+    "window_replica_left_half": "左半部",
+    "window_replica_right_half": "右半部",
+    "window_replica_centre": "中央",
     "window_replica_title": "視窗複本",
     "window_replica_refresh": "重新整理",
     "window_replica_show": "顯示複本",
@@ -568,6 +575,9 @@ traditional_chinese_word_dict = {
     "clipboard_clear": '清空（保留釘選）',
     "clipboard_persist": '跨工作階段保存這份歷史',
     "clipboard_hint": '歷史只留在本機、不會傳到任何地方。沒有勾選上面那項時只存在記憶體，因為剪貼簿裡常常有密碼。',
+    "shortcut_sheet_title": "快速鍵",
+    "shortcut_sheet_action": "快速鍵一覽⋯",
+    "hotkey_show_shortcuts": "顯示快速鍵一覽",
     "tools_layout_label": '視窗版面',
     "tools_layout_name": '版面名稱',
     "tools_layout_save": '儲存版面',

{frontengine-1.0.69 → frontengine-1.0.71}/frontengine/utils/window_replica/dwm_thumbnail.py

@@ -42,6 +42,40 @@ def available() -> bool:
     return sys.platform == "win32"
 
 
+def crop_rect(source: Tuple[int, int], crop: Optional[Tuple[float, float, float, float]]
+              ) -> Optional[Tuple[int, int, int, int]]:
+    """
+    把「左、上、右、下」四個 0..1 的比例換算成來源視窗上的像素矩形。
+
+    用比例而不是像素，是因為來源視窗會被使用者調大調小；記像素的話，視窗一改大小
+    框到的就不再是原來那一塊了。
+
+    框不出面積時回傳 None——寬或高為零的來源矩形會讓 DWM 直接不畫，畫面上只剩一
+    塊黑，看起來像壞掉而不是「你框錯了」。
+    Turn left/top/right/bottom fractions into a pixel rectangle on the source.
+
+    Fractions rather than pixels because the source window gets resized: pixels
+    would stop pointing at the same part of it the moment that happened.
+
+    A rectangle with no area returns None. A zero-width or zero-height source
+    rectangle makes DWM draw nothing at all, leaving a black panel that reads as
+    broken rather than as a bad selection.
+    """
+    if crop is None:
+        return None
+    source_width, source_height = source
+    if source_width <= 0 or source_height <= 0:
+        return None
+    left, top, right, bottom = (max(0.0, min(1.0, float(value))) for value in crop)
+    if right <= left or bottom <= top:
+        return None
+    rect = (int(left * source_width), int(top * source_height),
+            int(right * source_width), int(bottom * source_height))
+    if rect[2] - rect[0] < 1 or rect[3] - rect[1] < 1:
+        return None
+    return rect
+
+
 def fit_within(source: Tuple[int, int], bounds: Tuple[int, int]) -> Tuple[int, int]:
     """
     把來源尺寸等比縮到不超過 bounds，並保持長寬比。
@@ -135,8 +169,13 @@ class DwmThumbnail:
             return (0, 0)
 
     def update(self, width: int, height: int, opacity: int = 255,
-               client_area_only: bool = True) -> bool:
-        """把縮圖鋪滿目的地視窗的這個大小。"""
+               client_area_only: bool = True,
+               source_rect: Optional[Tuple[int, int, int, int]] = None) -> bool:
+        """
+        把縮圖鋪滿目的地視窗的這個大小。給了 source_rect 就只顯示來源的那一塊。
+        Fill the destination at this size. With a source_rect, only that part of
+        the source is shown.
+        """
         if self._handle is None or self._dwmapi is None:
             return False
         try:
@@ -161,6 +200,10 @@ class DwmThumbnail:
             properties.dwFlags = (DWM_TNP_RECTDESTINATION | DWM_TNP_OPACITY
                                   | DWM_TNP_VISIBLE | DWM_TNP_SOURCECLIENTAREAONLY)
             properties.rcDestination = RECT(0, 0, max(1, int(width)), max(1, int(height)))
+            if source_rect is not None:
+                left, top, right, bottom = source_rect
+                properties.rcSource = RECT(int(left), int(top), int(right), int(bottom))
+                properties.dwFlags |= DWM_TNP_RECTSOURCE
             properties.opacity = max(0, min(255, int(opacity)))
             properties.fVisible = True
             # 只取客戶區：不然複本裡會有一圈原視窗的標題列與邊框，看起來像截圖失誤。