frontengine 1.0.8__tar.gz → 1.0.10__tar.gz

{frontengine-1.0.8 → frontengine-1.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.8
+Version: 1.0.10
 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.8 → frontengine-1.0.10}/frontengine/show/pet/desktop_pet.py

@@ -1,10 +1,12 @@
 import random as _random_module
+import sys
 from datetime import datetime
 from pathlib import Path
 from typing import Optional, Tuple
 
-from PySide6.QtCore import Qt, QRect, QTimer, Signal
+from PySide6.QtCore import Qt, QRect, QTimer, QUrl, Signal
 from PySide6.QtGui import QAction, QColor, QCursor, QFont, QFontMetrics, QMovie, QPainter, QPixmap, QTransform
+from PySide6.QtMultimedia import QSoundEffect
 from PySide6.QtWidgets import QMenu, QMessageBox, QWidget
 
 from frontengine.show.base_widget import BaseWidget
@@ -95,6 +97,53 @@ def derive_visual_state(dragging: bool, airborne: bool, surface: str, motion_sta
     return STATE_WALK
 
 
+# 列舉可站立視窗時要略過的外殼視窗類別
+# Shell window classes skipped when enumerating standable windows.
+_PLATFORM_SKIP_CLASSES = {"WorkerW", "Progman", "Shell_TrayWnd", "Button"}
+
+
+def windows_platforms(exclude_hwnds=()) -> list:
+    """
+    回傳目前可見頂層視窗的上緣做為可站立平台 (left, right, top_y)。僅 Windows
+    有效，其餘平台或發生錯誤時回傳空清單。
+    Return the top edges of visible top-level windows as standable platforms
+    (left, right, top_y). Windows only; returns [] elsewhere or on error.
+    """
+    if sys.platform != "win32":
+        return []
+    try:
+        import ctypes
+        from ctypes import wintypes
+
+        user32 = ctypes.windll.user32
+        exclude = {int(h) for h in exclude_hwnds}
+        platforms: list = []
+
+        @ctypes.WINFUNCTYPE(wintypes.BOOL, wintypes.HWND, wintypes.LPARAM)
+        def _collect(hwnd, _lparam):
+            if int(hwnd) in exclude or not user32.IsWindowVisible(hwnd):
+                return True
+            rect = wintypes.RECT()
+            if not user32.GetWindowRect(hwnd, ctypes.byref(rect)):
+                return True
+            width = rect.right - rect.left
+            height = rect.bottom - rect.top
+            if width < 80 or height < 40:
+                return True
+            class_buffer = ctypes.create_unicode_buffer(64)
+            user32.GetClassNameW(hwnd, class_buffer, 64)
+            if class_buffer.value in _PLATFORM_SKIP_CLASSES:
+                return True
+            platforms.append((rect.left, rect.right, rect.top))
+            return True
+
+        user32.EnumWindows(_collect, 0)
+        return platforms
+    except Exception as error:  # pragma: no cover - Win32 boundary
+        front_engine_logger.warning(f"[windows_platforms] error: {error!r}")
+        return []
+
+
 def message_bucket(hour: int) -> str:
     """依小時回傳時段 / Time-of-day bucket for the given hour."""
     hour = int(hour) % 24
@@ -251,6 +300,12 @@ class PetMotion:
         self.asleep = False
         self.climb = bool(climb)
         self.surface = SURFACE_FLOOR
+        # 可站立的視窗平台 (left, right, top_y)；站在平台上時的狀態
+        # Standable window platforms (left, right, top_y) and platform state.
+        self.platforms: list = []
+        self.on_platform = False
+        self.platform_span: Optional[Tuple[float, float]] = None
+        self.ground_feet = 0.0
 
     @property
     def facing_left(self) -> bool:
@@ -259,6 +314,10 @@ class PetMotion:
     def set_bounds(self, bounds: Tuple[int, int, int, int]) -> None:
         self.bounds = bounds
 
+    def set_platforms(self, platforms) -> None:
+        """設定可站立的視窗上緣平台 / Set standable window top-edge platforms."""
+        self.platforms = list(platforms)
+
     def set_target(self, x: float, y: float) -> None:
         self.target = (float(x), float(y))
 
@@ -269,6 +328,8 @@ class PetMotion:
         self._airborne = True
         self.asleep = False
         self.surface = SURFACE_FLOOR
+        self.on_platform = False
+        self.platform_span = None
 
     def step(self) -> Tuple[int, int]:
         left, top, right, bottom = self.bounds
@@ -279,38 +340,19 @@ class PetMotion:
             return self._step_wander(left, top, right, bottom)
         return self._step_floor(left, top, right, bottom, floor_y)
 
-    # --- floor / gravity / climbing ---
+    # --- floor / gravity / climbing / window platforms ---
     def _step_floor(self, left, top, right, bottom, floor_y) -> Tuple[int, int]:
-        airborne = self._airborne or (self.surface == SURFACE_FLOOR and self.y < floor_y - 0.5)
+        airborne = self._airborne or (
+            not self.on_platform and self.surface == SURFACE_FLOOR and self.y < floor_y - 0.5
+        )
         if airborne:
-            self.vy += self.GRAVITY
-            self.x += self.vx
-            self.y += self.vy
-            if self.x <= left:
-                self.x = float(left)
-                self.vx = abs(self.vx) * self.WALL_DAMPING
-            elif self.x + self.width >= right:
-                self.x = float(right - self.width)
-                self.vx = -abs(self.vx) * self.WALL_DAMPING
-            if self.y <= top:
-                self.y = float(top)
-                self.vy = abs(self.vy) * self.WALL_DAMPING
-            if self.y >= floor_y:
-                self.y = float(floor_y)
-                if abs(self.vy) > self.BOUNCE_THRESHOLD:
-                    self.vy = -self.vy * self.BOUNCE_DAMPING
-                else:
-                    self.vy = 0.0
-                    self._airborne = False
-                    self.surface = SURFACE_FLOOR
-                    self.vx = float(self.speed) if self.vx >= 0 else float(-self.speed)
-                    self._new_state(force_walk=True)
-            return int(self.x), int(self.y)
-
+            return self._step_fall(left, top, right, bottom, floor_y)
+        if self.on_platform:
+            return self._step_platform(left, top, right, bottom, floor_y)
         if self.surface != SURFACE_FLOOR:
             return self._step_climb(left, top, right, bottom, floor_y)
 
-        # grounded on the floor: random walk / idle, with a chance to climb a wall
+        # grounded on the screen floor: random walk / idle, with a chance to climb a wall
         self.y = float(floor_y)
         if self._state_ticks <= 0:
             self._new_state()
@@ -334,6 +376,84 @@ class PetMotion:
                 self.vx = -abs(self.vx)
         return int(self.x), int(self.y)
 
+    def _step_fall(self, left, top, right, bottom, floor_y) -> Tuple[int, int]:
+        """落下：撞牆/天花板反彈，並在越過視窗平台或螢幕地板時落地。"""
+        prev_feet = self.y + self.height
+        self.vy += self.GRAVITY
+        self.x += self.vx
+        self.y += self.vy
+        if self.x <= left:
+            self.x = float(left)
+            self.vx = abs(self.vx) * self.WALL_DAMPING
+        elif self.x + self.width >= right:
+            self.x = float(right - self.width)
+            self.vx = -abs(self.vx) * self.WALL_DAMPING
+        if self.y <= top:
+            self.y = float(top)
+            self.vy = abs(self.vy) * self.WALL_DAMPING
+        new_feet = self.y + self.height
+        center_x = self.x + self.width / 2.0
+
+        land_feet = None
+        land_span = None
+        for platform_left, platform_right, platform_y in self.platforms:
+            if platform_left <= center_x <= platform_right and prev_feet <= platform_y <= new_feet:
+                if land_feet is None or platform_y < land_feet:
+                    land_feet = float(platform_y)
+                    land_span = (float(platform_left), float(platform_right))
+        if prev_feet <= bottom <= new_feet and (land_feet is None or bottom < land_feet):
+            land_feet = float(bottom)
+            land_span = None
+
+        if land_feet is not None:
+            self.y = float(land_feet - self.height)
+            if abs(self.vy) > self.BOUNCE_THRESHOLD:
+                self.vy = -self.vy * self.BOUNCE_DAMPING
+            else:
+                self.vy = 0.0
+                self._airborne = False
+                self.surface = SURFACE_FLOOR
+                self.on_platform = land_span is not None
+                self.platform_span = land_span
+                self.ground_feet = land_feet
+                self.vx = float(self.speed) if self.vx >= 0 else float(-self.speed)
+                self._new_state(force_walk=True)
+        return int(self.x), int(self.y)
+
+    def _platform_under(self) -> Optional[Tuple[float, float]]:
+        """回傳目前站立平台的水平範圍；平台已消失（視窗移走/關閉）則回傳 None。"""
+        body_left = self.x
+        body_right = self.x + self.width
+        for platform_left, platform_right, platform_y in self.platforms:
+            if abs(platform_y - self.ground_feet) <= 2.0 and not (platform_right < body_left or platform_left > body_right):
+                return (float(platform_left), float(platform_right))
+        return None
+
+    def _step_platform(self, left, top, right, bottom, floor_y) -> Tuple[int, int]:
+        """站在視窗平台上走動；到平台兩端轉向；平台消失則掉落。"""
+        span = self._platform_under()
+        if span is None:
+            self._airborne = True
+            self.on_platform = False
+            self.platform_span = None
+            return self._step_fall(left, top, right, bottom, floor_y)
+        self.platform_span = span
+        span_left, span_right = span
+        self.y = float(self.ground_feet - self.height)
+        if self._state_ticks <= 0:
+            self._new_state()
+        self._state_ticks -= 1
+        if self.state != "walk":
+            return int(self.x), int(self.y)
+        self.x += self.vx
+        if self.x <= span_left:
+            self.x = float(span_left)
+            self.vx = abs(self.vx)
+        elif self.x + self.width >= span_right:
+            self.x = float(span_right - self.width)
+            self.vx = -abs(self.vx)
+        return int(self.x), int(self.y)
+
     def _step_climb(self, left, top, right, bottom, floor_y) -> Tuple[int, int]:
         """沿螢幕邊緣爬行；隨機放手則掉落 / Crawl the screen perimeter; may let go and fall."""
         if self._rng.random() < self.DROP_CHANCE:
@@ -451,10 +571,12 @@ class DesktopPetWidget(BaseWidget):
     clone_requested = Signal()
 
     def __init__(self, image_path: str, size: int = 128, speed: int = 3,
-                 behaviour: str = BEHAVIOUR_FLOOR, climb: bool = True, talk: bool = True):
+                 behaviour: str = BEHAVIOUR_FLOOR, climb: bool = True, talk: bool = True,
+                 sound_path: Optional[str] = None, sit_on_windows: bool = True):
         front_engine_logger.info(
             f"[DesktopPetWidget] Init | path={image_path}, size={size}, speed={speed}, "
-            f"behaviour={behaviour}, climb={climb}, talk={talk}"
+            f"behaviour={behaviour}, climb={climb}, talk={talk}, sound={sound_path}, "
+            f"sit_on_windows={sit_on_windows}"
         )
         super().__init__()
         self.opacity = 1.0
@@ -490,6 +612,10 @@ class DesktopPetWidget(BaseWidget):
         self._chatter_rng = _random_module.SystemRandom()
         self._mood = PetMood(user_setting_dict.get("pet_mood", 60))
         self._messages = self._load_messages()
+        self._sound: Optional[QSoundEffect] = None
+        self._init_sound(sound_path)
+        self._sit_on_windows = bool(sit_on_windows)
+        self._platform_tick = 0
         self._bubble = SpeechBubble()
         self._chatter_timer = QTimer(self)
         self._chatter_timer.setSingleShot(True)
@@ -592,6 +718,27 @@ class DesktopPetWidget(BaseWidget):
     def _persist_mood(self) -> None:
         user_setting_dict["pet_mood"] = self._mood.value
 
+    def _init_sound(self, sound_path: Optional[str]) -> None:
+        if not sound_path:
+            return
+        path = Path(sound_path)
+        if not (path.exists() and path.is_file()):
+            return
+        try:
+            self._sound = QSoundEffect(self)
+            self._sound.setSource(QUrl.fromLocalFile(str(path)))
+        except Exception as error:  # pragma: no cover - audio backend guard
+            front_engine_logger.warning(f"[DesktopPetWidget] sound load failed: {error!r}")
+            self._sound = None
+
+    def _play_sound(self) -> None:
+        if self._sound is None:
+            return
+        try:
+            self._sound.play()
+        except Exception as error:  # pragma: no cover - audio backend guard
+            front_engine_logger.warning(f"[DesktopPetWidget] sound play failed: {error!r}")
+
     def _schedule_chatter(self) -> None:
         if self._talk:
             self._chatter_timer.start(self._chatter_rng.randint(15000, 35000))
@@ -620,6 +767,11 @@ class DesktopPetWidget(BaseWidget):
         if self.motion.behaviour == BEHAVIOUR_CHASE:
             cursor = QCursor.pos()
             self.motion.set_target(cursor.x(), cursor.y())
+        elif self._sit_on_windows and self.motion.behaviour == BEHAVIOUR_FLOOR:
+            self._platform_tick += 1
+            if self._platform_tick >= 10:
+                self._platform_tick = 0
+                self.motion.set_platforms(windows_platforms(exclude_hwnds=(int(self.winId()),)))
         x, y = self.motion.step()
         self.move(x, y)
         self._set_active_sprite(self._visual_state())
@@ -636,6 +788,7 @@ class DesktopPetWidget(BaseWidget):
             self.motion.wake()  # interacting wakes a sleeping pet
             self._mood.pet()    # petting cheers it up
             self._persist_mood()
+            self._play_sound()
             self._set_active_sprite(STATE_DRAG)
         super().mousePressEvent(event)
 

{frontengine-1.0.8 → frontengine-1.0.10}/frontengine/ui/page/pet/pet_setting_ui.py

@@ -8,7 +8,7 @@ from PySide6.QtWidgets import (
 from frontengine.show.pet.desktop_pet import (
     DesktopPetWidget, BEHAVIOUR_FLOOR, BEHAVIOUR_WANDER, BEHAVIOUR_CHASE, scan_pet_pack,
 )
-from frontengine.ui.dialog.choose_file_dialog import choose_pet
+from frontengine.ui.dialog.choose_file_dialog import choose_pet, choose_wav_sound
 from frontengine.ui.page.utils import (
     build_recent_combobox,
     enable_file_drop,
@@ -32,6 +32,7 @@ class PetSettingUI(QWidget):
         self.pet_list: list = []
         self.ready_to_play = False
         self.pet_image_path: Optional[str] = None
+        self.pet_sound_path: Optional[str] = None
 
         # Choose file
         self.choose_file_button = QPushButton(
@@ -42,6 +43,10 @@ class PetSettingUI(QWidget):
             language_wrapper.language_word_dict.get("pet_choose_pack", "Choose pet pack...")
         )
         self.choose_pack_button.clicked.connect(self.choose_pack)
+        self.choose_sound_button = QPushButton(
+            language_wrapper.language_word_dict.get("pet_choose_sound", "Choose sound (optional)")
+        )
+        self.choose_sound_button.clicked.connect(self.choose_sound)
         self.ready_label = QLabel(language_wrapper.language_word_dict.get("Not Ready"))
 
         # Size
@@ -71,6 +76,8 @@ class PetSettingUI(QWidget):
         self.climb_checkbox.setChecked(True)
         self.talk_checkbox = QCheckBox(language_wrapper.language_word_dict.get("pet_talk_label", "Speech bubbles"))
         self.talk_checkbox.setChecked(True)
+        self.sit_checkbox = QCheckBox(language_wrapper.language_word_dict.get("pet_sit_label", "Sit on windows"))
+        self.sit_checkbox.setChecked(True)
 
         # Start
         self.start_button = QPushButton(language_wrapper.language_word_dict.get("pet_start", "Spawn pet"))
@@ -88,6 +95,7 @@ class PetSettingUI(QWidget):
         self.grid_layout.addWidget(self.choose_file_button, 0, 0)
         self.grid_layout.addWidget(self.ready_label, 0, 1)
         self.grid_layout.addWidget(self.choose_pack_button, 0, 2)
+        self.grid_layout.addWidget(self.choose_sound_button, 1, 2)
         self.grid_layout.addWidget(self.size_label, 1, 0)
         self.grid_layout.addWidget(self.size_combobox, 1, 1)
         self.grid_layout.addWidget(self.speed_label, 2, 0)
@@ -96,6 +104,7 @@ class PetSettingUI(QWidget):
         self.grid_layout.addWidget(self.behaviour_combobox, 3, 1)
         self.grid_layout.addWidget(self.climb_checkbox, 3, 2)
         self.grid_layout.addWidget(self.talk_checkbox, 2, 2)
+        self.grid_layout.addWidget(self.sit_checkbox, 4, 2)
         self.grid_layout.addWidget(self.start_button, 4, 0)
         self.grid_layout.addWidget(self.recent_files_label, 5, 0)
         self.grid_layout.addWidget(self.recent_files_combobox, 5, 1)
@@ -111,6 +120,8 @@ class PetSettingUI(QWidget):
             behaviour=self.behaviour_combobox.currentData(),
             climb=self.climb_checkbox.isChecked(),
             talk=self.talk_checkbox.isChecked(),
+            sound_path=self.pet_sound_path,
+            sit_on_windows=self.sit_checkbox.isChecked(),
         )
         pet.clone_requested.connect(self._spawn_pet)
         pet.set_pet_window_flag()
@@ -141,6 +152,13 @@ class PetSettingUI(QWidget):
             add_recent_file("pet", self.pet_image_path)
             reload_recent_combobox(self.recent_files_combobox, "pet")
 
+    def choose_sound(self) -> None:
+        """選擇點擊時播放的音效（選填）/ Choose an optional click sound."""
+        front_engine_logger.info("[PetSettingUI] choose_sound")
+        path = choose_wav_sound(self)
+        if path:
+            self.pet_sound_path = path
+
     def choose_pack(self) -> None:
         """選擇動作包資料夾（依 walk/idle/climb/fall/drag 檔名對應狀態）。"""
         front_engine_logger.info("[PetSettingUI] choose_pack")
@@ -188,6 +206,8 @@ class PetSettingUI(QWidget):
             "behaviour": self.behaviour_combobox.currentData(),
             "climb": self.climb_checkbox.isChecked(),
             "talk": self.talk_checkbox.isChecked(),
+            "sound": self.pet_sound_path,
+            "sit": self.sit_checkbox.isChecked(),
         }
 
     def set_state(self, state: dict) -> None:
@@ -211,3 +231,7 @@ class PetSettingUI(QWidget):
             self.climb_checkbox.setChecked(bool(state["climb"]))
         if "talk" in state:
             self.talk_checkbox.setChecked(bool(state["talk"]))
+        if state.get("sound"):
+            self.pet_sound_path = str(state["sound"])
+        if "sit" in state:
+            self.sit_checkbox.setChecked(bool(state["sit"]))

{frontengine-1.0.8 → frontengine-1.0.10}/frontengine/utils/multi_language/english.py

@@ -226,8 +226,10 @@ english_word_dict = {
     "pet_climb_label": "Climb walls",
     "pet_clone": "Clone",
     "pet_choose_pack": "Choose pet pack...",
+    "pet_choose_sound": "Choose sound (optional)",
     "pet_pack_empty": "No sprites (walk/idle/sleep/climb/fall/drag) found in that folder.",
     "pet_talk_label": "Speech bubbles",
+    "pet_sit_label": "Sit on windows",
     "pet_chatter_morning": "Good morning!|Rise and shine!|Ready for the day?",
     "pet_chatter_afternoon": "Good afternoon!|Taking a break?|Keep it up!",
     "pet_chatter_evening": "Good evening!|How was your day?|Almost done?",

{frontengine-1.0.8 → frontengine-1.0.10}/frontengine/utils/multi_language/traditional_chinese.py

@@ -227,8 +227,10 @@ traditional_chinese_word_dict = {
     "pet_climb_label": "攀爬牆壁",
     "pet_clone": "複製",
     "pet_choose_pack": "選擇動作包資料夾...",
+    "pet_choose_sound": "選擇音效（選填）",
     "pet_pack_empty": "該資料夾找不到精靈檔（walk/idle/sleep/climb/fall/drag）。",
     "pet_talk_label": "對話泡泡",
+    "pet_sit_label": "站在視窗上",
     "pet_chatter_morning": "早安！|新的一天開始囉！|準備好了嗎？",
     "pet_chatter_afternoon": "午安！|要不要休息一下？|繼續加油！",
     "pet_chatter_evening": "晚上好！|今天過得如何？|快完成了嗎？",

{frontengine-1.0.8 → frontengine-1.0.10}/frontengine.egg-info/PKG-INFO

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

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