frontengine 1.0.9__tar.gz → 1.0.11__tar.gz

{frontengine-1.0.9 → frontengine-1.0.11}/PKG-INFO

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

@@ -1,4 +1,5 @@
 import random as _random_module
+import sys
 from datetime import datetime
 from pathlib import Path
 from typing import Optional, Tuple
@@ -96,6 +97,70 @@ 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 nearest_peer(center, peers):
+    """
+    回傳離 center 最近的同伴座標與距離；無同伴回傳 (None, inf)。
+    Return the nearest peer center and its distance to `center`, or
+    (None, inf) when there are no peers.
+    """
+    best = None
+    best_distance = float("inf")
+    cx, cy = center
+    for peer_x, peer_y in peers:
+        distance = ((peer_x - cx) ** 2 + (peer_y - cy) ** 2) ** 0.5
+        if distance < best_distance:
+            best_distance = distance
+            best = (peer_x, peer_y)
+    return best, best_distance
+
+
 def message_bucket(hour: int) -> str:
     """依小時回傳時段 / Time-of-day bucket for the given hour."""
     hour = int(hour) % 24
@@ -252,6 +317,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:
@@ -260,6 +331,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))
 
@@ -270,6 +345,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
@@ -280,38 +357,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()
@@ -335,6 +393,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:
@@ -453,10 +589,11 @@ class DesktopPetWidget(BaseWidget):
 
     def __init__(self, image_path: str, size: int = 128, speed: int = 3,
                  behaviour: str = BEHAVIOUR_FLOOR, climb: bool = True, talk: bool = True,
-                 sound_path: Optional[str] = None):
+                 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}, sound={sound_path}"
+            f"behaviour={behaviour}, climb={climb}, talk={talk}, sound={sound_path}, "
+            f"sit_on_windows={sit_on_windows}"
         )
         super().__init__()
         self.opacity = 1.0
@@ -494,6 +631,12 @@ class DesktopPetWidget(BaseWidget):
         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
+        # 多寵物互動 / Multi-pet interaction
+        self._peers_provider = None
+        self._peer_greeted = False
+        self._peer_tick = 0
         self._bubble = SpeechBubble()
         self._chatter_timer = QTimer(self)
         self._chatter_timer.setSingleShot(True)
@@ -507,10 +650,42 @@ class DesktopPetWidget(BaseWidget):
         self.close_action.triggered.connect(self.close)
         self.menu.addAction(self.close_action)
 
+    MEET_DISTANCE = 90.0
+
     def set_pet_window_flag(self) -> None:
         """寵物需接收滑鼠以便拖曳，故 allow_input=True 並置頂。"""
         apply_overlay_window_flags(self, show_on_bottom=False, allow_input=True)
 
+    def center(self) -> Tuple[int, int]:
+        return (self.x() + self.width() // 2, self.y() + self.height() // 2)
+
+    def set_peers_provider(self, provider) -> None:
+        """設定回傳其他寵物中心座標清單的函式 / Provider of other pets' centres."""
+        self._peers_provider = provider
+
+    def _check_peers(self) -> None:
+        """靠近其他寵物時轉向並打招呼（帶遲滯，避免重複）。"""
+        if self._peers_provider is None or not self._talk:
+            return
+        try:
+            peers = self._peers_provider()
+        except Exception:  # pragma: no cover - defensive
+            return
+        my_center = self.center()
+        peer, distance = nearest_peer(my_center, peers)
+        if peer is None:
+            self._peer_greeted = False
+            return
+        if distance <= self.MEET_DISTANCE:
+            if not self._peer_greeted:
+                self._peer_greeted = True
+                self.motion.vx = abs(self.motion.vx) if peer[0] >= my_center[0] else -abs(self.motion.vx)
+                pool = self._messages.get("meet") or []
+                if pool:
+                    self.say(pool[self._chatter_rng.randrange(len(pool))])
+        elif distance > self.MEET_DISTANCE * 1.6:
+            self._peer_greeted = False
+
     def _load_sprite(self, path: str):
         if Path(path).suffix.lower() in (".gif", ".webp"):
             movie = QMovie(str(path))
@@ -590,6 +765,7 @@ class DesktopPetWidget(BaseWidget):
             "night": lines("pet_chatter_night", "It's late - get some rest!|Still up?"),
             "happy": lines("pet_chatter_happy", "I'm so happy!|You're the best!|(^o^)"),
             "sad": lines("pet_chatter_sad", "Feeling a bit lonely...|Pet me?|(._.)"),
+            "meet": lines("pet_chatter_meet", "Hi friend!|Hello!|Let's play!"),
             "any": lines("pet_chatter_any", "Hi there!|(^_^)|Keep going!"),
         }
 
@@ -645,9 +821,18 @@ 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())
+        self._peer_tick += 1
+        if self._peer_tick >= 5:
+            self._peer_tick = 0
+            self._check_peers()
         if self._bubble.isVisible():
             self._bubble.reposition(self)
 

{frontengine-1.0.9 → frontengine-1.0.11}/frontengine/ui/page/pet/pet_setting_ui.py

@@ -76,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"))
@@ -102,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)
@@ -118,8 +121,10 @@ class PetSettingUI(QWidget):
             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_peers_provider(lambda me=pet: self._peer_centers(me))
         pet.set_pet_window_flag()
         self.pet_list.append(pet)
         screen = QGuiApplication.primaryScreen()
@@ -128,6 +133,18 @@ class PetSettingUI(QWidget):
         if geometry is not None:
             pet.start_moving((geometry.left(), geometry.top(), geometry.right(), geometry.bottom()))
 
+    def _peer_centers(self, me) -> list:
+        """回傳其他仍存活寵物的中心座標（略過已被銷毀者）。"""
+        centers = []
+        for other in list(self.pet_list):
+            if other is me:
+                continue
+            try:
+                centers.append(other.center())
+            except RuntimeError:
+                pass  # underlying C++ object already deleted
+        return centers
+
     def start_play_pet(self) -> None:
         front_engine_logger.info("[PetSettingUI] start_play_pet")
         if not self.pet_image_path or not self.ready_to_play:
@@ -203,6 +220,7 @@ class PetSettingUI(QWidget):
             "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:
@@ -228,3 +246,5 @@ class PetSettingUI(QWidget):
             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.9 → frontengine-1.0.11}/frontengine/utils/multi_language/english.py

@@ -229,6 +229,7 @@ english_word_dict = {
     "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?",
@@ -236,6 +237,7 @@ english_word_dict = {
     "pet_chatter_any": "Hi there!|(^_^)|Keep going!|You've got this!",
     "pet_chatter_happy": "I'm so happy!|You're the best!|(^o^)/|Best day ever!",
     "pet_chatter_sad": "Feeling a bit lonely...|Pet me?|(._.)|Don't forget about me~",
+    "pet_chatter_meet": "Hi friend!|Hello there!|Let's play!|Fancy meeting you here!",
     "pet_start": "Spawn pet",
     "pet_message_box_text": "Pet image not found",
 }

{frontengine-1.0.9 → frontengine-1.0.11}/frontengine/utils/multi_language/traditional_chinese.py

@@ -230,6 +230,7 @@ traditional_chinese_word_dict = {
     "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": "晚上好！|今天過得如何？|快完成了嗎？",
@@ -237,6 +238,7 @@ traditional_chinese_word_dict = {
     "pet_chatter_any": "嗨！|(^_^)|加油！|你可以的！",
     "pet_chatter_happy": "我好開心！|你最棒了！|(^o^)/|今天真美好！",
     "pet_chatter_sad": "有點寂寞…|摸摸我好嗎？|(._.)|別忘了我～",
+    "pet_chatter_meet": "嗨朋友！|你好呀！|一起玩吧！|在這遇到你真巧！",
     "pet_start": "召喚寵物",
     "pet_message_box_text": "找不到寵物圖片",
 }

{frontengine-1.0.9 → frontengine-1.0.11}/frontengine.egg-info/PKG-INFO

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

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