frontengine 1.0.3__tar.gz → 1.0.4__tar.gz

{frontengine-1.0.3 → frontengine-1.0.4}/PKG-INFO

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

@@ -2,7 +2,7 @@ import random as _random_module
 from pathlib import Path
 from typing import Optional, Tuple
 
-from PySide6.QtCore import Qt, QRect, QTimer
+from PySide6.QtCore import Qt, QRect, QTimer, Signal
 from PySide6.QtGui import QAction, QCursor, QMovie, QPainter, QPixmap, QTransform
 from PySide6.QtWidgets import QMenu, QMessageBox
 
@@ -16,6 +16,12 @@ BEHAVIOUR_FLOOR = "floor"    # walk on the floor with gravity, throw & bounce
 BEHAVIOUR_WANDER = "wander"  # free 2D bounce, no gravity
 BEHAVIOUR_CHASE = "chase"    # chase the mouse cursor, sleep when caught
 
+# 攀爬時所在的表面 / Surface the pet is crawling on while climbing
+SURFACE_FLOOR = "floor"
+SURFACE_LEFT = "left"
+SURFACE_CEILING = "ceiling"
+SURFACE_RIGHT = "right"
+
 
 class PetMotion:
     """
@@ -34,6 +40,8 @@ class PetMotion:
     BOUNCE_THRESHOLD = 8.0
     CHASE_STOP_DISTANCE = 10.0
     CHASE_SPEED_FACTOR = 2.0
+    CLIMB_CHANCE = 0.5      # chance to grab a wall (vs. turn around) at a floor corner
+    DROP_CHANCE = 0.008     # chance per step to let go while on a wall/ceiling
 
     def __init__(
         self,
@@ -45,6 +53,7 @@ class PetMotion:
         speed: int = 3,
         behaviour: str = BEHAVIOUR_FLOOR,
         rng=None,
+        climb: bool = True,
     ) -> None:
         self.x = float(x)
         self.y = float(y)
@@ -61,6 +70,8 @@ class PetMotion:
         self._state_ticks = 0
         self.target: Optional[Tuple[float, float]] = None
         self.asleep = False
+        self.climb = bool(climb)
+        self.surface = SURFACE_FLOOR
 
     @property
     def facing_left(self) -> bool:
@@ -78,6 +89,7 @@ class PetMotion:
         self.vy = float(vy)
         self._airborne = True
         self.asleep = False
+        self.surface = SURFACE_FLOOR
 
     def step(self) -> Tuple[int, int]:
         left, top, right, bottom = self.bounds
@@ -88,9 +100,9 @@ class PetMotion:
             return self._step_wander(left, top, right, bottom)
         return self._step_floor(left, top, right, bottom, floor_y)
 
-    # --- floor / gravity ---
+    # --- floor / gravity / climbing ---
     def _step_floor(self, left, top, right, bottom, floor_y) -> Tuple[int, int]:
-        airborne = self._airborne or self.y < floor_y - 0.5
+        airborne = self._airborne or (self.surface == SURFACE_FLOOR and self.y < floor_y - 0.5)
         if airborne:
             self.vy += self.GRAVITY
             self.x += self.vx
@@ -111,23 +123,81 @@ class PetMotion:
                 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)
 
-        # grounded: random walk / idle
+        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
         self.y = float(floor_y)
         if self._state_ticks <= 0:
             self._new_state()
         self._state_ticks -= 1
-        if self.state == "walk":
+        if self.state != "walk":
+            return int(self.x), int(self.y)
+        self.x += self.vx
+        if self.x <= left:
+            self.x = float(left)
+            if self.climb and self._rng.random() < self.CLIMB_CHANCE:
+                self.surface = SURFACE_LEFT
+                self.vy = float(-self.speed)
+            else:
+                self.vx = abs(self.vx)
+        elif self.x + self.width >= right:
+            self.x = float(right - self.width)
+            if self.climb and self._rng.random() < self.CLIMB_CHANCE:
+                self.surface = SURFACE_RIGHT
+                self.vy = float(-self.speed)
+            else:
+                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:
+            self.surface = SURFACE_FLOOR
+            self._airborne = True
+            self.vy = 1.0
+            return int(self.x), int(self.y)
+
+        if self.surface == SURFACE_RIGHT:
+            self.x = float(right - self.width)
+            self.y += self.vy
+            if self.vy < 0 and self.y <= top:            # reached the ceiling, crawl left
+                self.y = float(top)
+                self.surface = SURFACE_CEILING
+                self.vx = float(-self.speed)
+            elif self.vy > 0 and self.y >= floor_y:      # climbed back down
+                self.y = float(floor_y)
+                self.surface = SURFACE_FLOOR
+                self.vx = float(-self.speed)
+                self._new_state(force_walk=True)
+        elif self.surface == SURFACE_LEFT:
+            self.x = float(left)
+            self.y += self.vy
+            if self.vy < 0 and self.y <= top:
+                self.y = float(top)
+                self.surface = SURFACE_CEILING
+                self.vx = float(self.speed)
+            elif self.vy > 0 and self.y >= floor_y:
+                self.y = float(floor_y)
+                self.surface = SURFACE_FLOOR
+                self.vx = float(self.speed)
+                self._new_state(force_walk=True)
+        elif self.surface == SURFACE_CEILING:
+            self.y = float(top)
             self.x += self.vx
-            if self.x <= left:
+            if self.vx < 0 and self.x <= left:           # corner -> climb down the left wall
                 self.x = float(left)
-                self.vx = abs(self.vx)
-            elif self.x + self.width >= right:
+                self.surface = SURFACE_LEFT
+                self.vy = float(self.speed)
+            elif self.vx > 0 and self.x + self.width >= right:
                 self.x = float(right - self.width)
-                self.vx = -abs(self.vx)
+                self.surface = SURFACE_RIGHT
+                self.vy = float(self.speed)
         return int(self.x), int(self.y)
 
     def _new_state(self, force_walk: bool = False) -> None:
@@ -187,10 +257,13 @@ class DesktopPetWidget(BaseWidget):
     A draggable, throwable, cursor-chasing animated sprite (GIF or image).
     """
 
+    clone_requested = Signal()
+
     def __init__(self, image_path: str, size: int = 128, speed: int = 3,
-                 behaviour: str = BEHAVIOUR_FLOOR):
+                 behaviour: str = BEHAVIOUR_FLOOR, climb: bool = True):
         front_engine_logger.info(
-            f"[DesktopPetWidget] Init | path={image_path}, size={size}, speed={speed}, behaviour={behaviour}"
+            f"[DesktopPetWidget] Init | path={image_path}, size={size}, speed={speed}, "
+            f"behaviour={behaviour}, climb={climb}"
         )
         super().__init__()
         self.opacity = 1.0
@@ -216,14 +289,19 @@ class DesktopPetWidget(BaseWidget):
             message_box.show()
 
         self.resize(self.pet_size, self.pet_size)
-        self.motion = PetMotion(0, 0, self.pet_size, self.pet_size, (0, 0, 1920, 1080), speed, behaviour)
+        self.motion = PetMotion(
+            0, 0, self.pet_size, self.pet_size, (0, 0, 1920, 1080), speed, behaviour, climb=climb
+        )
 
         self._timer = QTimer(self)
         self._timer.timeout.connect(self._on_tick)
 
+        self.menu = QMenu(self)
+        self.clone_action = QAction(language_wrapper.language_word_dict.get("pet_clone", "Clone"), self)
+        self.clone_action.triggered.connect(self.clone_requested.emit)
+        self.menu.addAction(self.clone_action)
         self.close_action = QAction(language_wrapper.language_word_dict.get("control_center_close_all", "Close"), self)
         self.close_action.triggered.connect(self.close)
-        self.menu = QMenu(self)
         self.menu.addAction(self.close_action)
 
     def set_pet_window_flag(self) -> None:

{frontengine-1.0.3 → frontengine-1.0.4}/frontengine/ui/page/pet/pet_setting_ui.py

@@ -2,7 +2,7 @@ from typing import Optional
 
 from PySide6.QtGui import QGuiApplication
 from PySide6.QtWidgets import (
-    QWidget, QGridLayout, QLabel, QPushButton, QMessageBox, QComboBox,
+    QWidget, QGridLayout, QLabel, QPushButton, QMessageBox, QComboBox, QCheckBox,
 )
 
 from frontengine.show.pet.desktop_pet import (
@@ -62,6 +62,10 @@ class PetSettingUI(QWidget):
         self.behaviour_combobox.addItem(
             language_wrapper.language_word_dict.get("pet_behaviour_chase", "Chase cursor"), BEHAVIOUR_CHASE)
 
+        # Climb walls / ceiling (only meaningful in floor mode)
+        self.climb_checkbox = QCheckBox(language_wrapper.language_word_dict.get("pet_climb_label", "Climb walls"))
+        self.climb_checkbox.setChecked(True)
+
         # Start
         self.start_button = QPushButton(language_wrapper.language_word_dict.get("pet_start", "Spawn pet"))
         self.start_button.clicked.connect(self.start_play_pet)
@@ -83,20 +87,30 @@ class PetSettingUI(QWidget):
         self.grid_layout.addWidget(self.speed_combobox, 2, 1)
         self.grid_layout.addWidget(self.behaviour_label, 3, 0)
         self.grid_layout.addWidget(self.behaviour_combobox, 3, 1)
+        self.grid_layout.addWidget(self.climb_checkbox, 3, 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)
 
-    def _create_pet_widget(self) -> DesktopPetWidget:
+    def _spawn_pet(self) -> None:
+        """建立、顯示並開始移動一隻寵物（供 Start 與右鍵複製共用）。"""
+        if not self.pet_image_path:
+            return
         pet = DesktopPetWidget(
             image_path=self.pet_image_path,
             size=int(self.size_combobox.currentText()),
             speed=int(self.speed_combobox.currentText()),
             behaviour=self.behaviour_combobox.currentData(),
+            climb=self.climb_checkbox.isChecked(),
         )
+        pet.clone_requested.connect(self._spawn_pet)
         pet.set_pet_window_flag()
         self.pet_list.append(pet)
-        return pet
+        screen = QGuiApplication.primaryScreen()
+        geometry = screen.availableGeometry() if screen is not None else None
+        pet.show()
+        if geometry is not None:
+            pet.start_moving((geometry.left(), geometry.top(), geometry.right(), geometry.bottom()))
 
     def start_play_pet(self) -> None:
         front_engine_logger.info("[PetSettingUI] start_play_pet")
@@ -105,13 +119,7 @@ class PetSettingUI(QWidget):
             message_box.setText(language_wrapper.language_word_dict.get("not_prepare"))
             message_box.exec()
             return
-        pet = self._create_pet_widget()
-        screen = QGuiApplication.primaryScreen()
-        geometry = screen.availableGeometry() if screen is not None else None
-        pet.show()
-        if geometry is not None:
-            bounds = (geometry.left(), geometry.top(), geometry.right(), geometry.bottom())
-            pet.start_moving(bounds)
+        self._spawn_pet()
 
     def choose_and_play(self) -> None:
         front_engine_logger.info("[PetSettingUI] choose_and_play")
@@ -147,6 +155,7 @@ class PetSettingUI(QWidget):
             "size": self.size_combobox.currentText(),
             "speed": self.speed_combobox.currentText(),
             "behaviour": self.behaviour_combobox.currentData(),
+            "climb": self.climb_checkbox.isChecked(),
         }
 
     def set_state(self, state: dict) -> None:
@@ -166,3 +175,5 @@ class PetSettingUI(QWidget):
             index = self.behaviour_combobox.findData(behaviour)
             if index >= 0:
                 self.behaviour_combobox.setCurrentIndex(index)
+        if "climb" in state:
+            self.climb_checkbox.setChecked(bool(state["climb"]))

{frontengine-1.0.3 → frontengine-1.0.4}/frontengine/utils/multi_language/english.py

@@ -223,6 +223,8 @@ english_word_dict = {
     "pet_behaviour_floor": "Walk on floor",
     "pet_behaviour_wander": "Free wander",
     "pet_behaviour_chase": "Chase cursor",
+    "pet_climb_label": "Climb walls",
+    "pet_clone": "Clone",
     "pet_start": "Spawn pet",
     "pet_message_box_text": "Pet image not found",
 }

{frontengine-1.0.3 → frontengine-1.0.4}/frontengine/utils/multi_language/traditional_chinese.py

@@ -224,6 +224,8 @@ traditional_chinese_word_dict = {
     "pet_behaviour_floor": "沿底部行走",
     "pet_behaviour_wander": "自由漫遊",
     "pet_behaviour_chase": "追逐游標",
+    "pet_climb_label": "攀爬牆壁",
+    "pet_clone": "複製",
     "pet_start": "召喚寵物",
     "pet_message_box_text": "找不到寵物圖片",
 }

{frontengine-1.0.3 → frontengine-1.0.4}/frontengine.egg-info/PKG-INFO

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

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