frontengine 1.0.70__tar.gz → 1.0.71__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.70
+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.70 → 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.70 → 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.70 → 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",

{frontengine-1.0.70 → 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",

{frontengine-1.0.70 → 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",

{frontengine-1.0.70 → 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",

{frontengine-1.0.70 → 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": "Показать копию",

{frontengine-1.0.70 → 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": "显示副本",

{frontengine-1.0.70 → 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": "顯示複本",

{frontengine-1.0.70 → 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
             # 只取客戶區：不然複本裡會有一圈原視窗的標題列與邊框，看起來像截圖失誤。

{frontengine-1.0.70 → frontengine-1.0.71}/frontengine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.70
+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.70 → frontengine-1.0.71}/pyproject.toml

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