frontengine 1.0.1__tar.gz → 1.0.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.1
+Version: 1.0.3
 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.1 → frontengine-1.0.3}/frontengine/__init__.py

@@ -4,6 +4,7 @@ from frontengine.show.load.load_someone_make_ui import load_extend_ui_file
 from frontengine.show.load.load_someone_make_ui import load_ui_file
 from frontengine.show.sound_player.sound_effect import SoundEffectWidget
 from frontengine.show.sound_player.sound_player import SoundPlayer
+from frontengine.show.pet.desktop_pet import DesktopPetWidget
 from frontengine.show.text.draw_text import TextWidget
 from frontengine.show.video.video_player import VideoWidget
 from frontengine.show.web.webview import WebWidget
@@ -16,6 +17,7 @@ from frontengine.ui.page.image.image_setting_ui import ImageSettingUI
 from frontengine.ui.page.sound_player.sound_player_setting_ui import SoundPlayerSettingUI
 from frontengine.ui.page.video.video_setting_ui import VideoSettingUI
 from frontengine.ui.page.control_center.control_center_ui import ControlCenterUI
+from frontengine.ui.page.pet.pet_setting_ui import PetSettingUI
 from frontengine.ui.page.scene_setting.scene_setting_ui import SceneSettingUI
 from frontengine.ui.main_ui import FrontEngineMainUI
 from frontengine.ui.main_ui import FrontEngine_EXTEND_TAB
@@ -26,5 +28,5 @@ __all__ = [
     "WebWidget", "ImageWidget", "VideoWidget", "language_wrapper", "load_extend_ui_file", "load_ui_file",
     "TextSettingUI", "WEBSettingUI", "GIFSettingUI", "ImageSettingUI", "SoundPlayerSettingUI",
     "VideoSettingUI", "ControlCenterUI", "SceneSettingUI", "FrontEngineMainUI",
-    "FrontEngine_EXTEND_TAB", "RedirectManager"
+    "FrontEngine_EXTEND_TAB", "RedirectManager", "DesktopPetWidget", "PetSettingUI"
 ]

frontengine-1.0.3/frontengine/show/pet/desktop_pet.py

@@ -0,0 +1,297 @@
+import random as _random_module
+from pathlib import Path
+from typing import Optional, Tuple
+
+from PySide6.QtCore import Qt, QRect, QTimer
+from PySide6.QtGui import QAction, QCursor, QMovie, QPainter, QPixmap, QTransform
+from PySide6.QtWidgets import QMenu, QMessageBox
+
+from frontengine.show.base_widget import BaseWidget
+from frontengine.show.window_helpers import apply_overlay_window_flags
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+
+# 行為模式 / Behaviour modes
+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
+
+
+class PetMotion:
+    """
+    純邏輯的寵物移動模型（不依賴 Qt，完全可測試）。包含：
+      - 重力落下、落地、彈跳（受動量丟出後）
+      - 走路/發呆的隨機行為狀態機（rng 可注入以利測試）
+      - 追逐游標模式（追到後進入睡眠，游標移動即醒）
+    A pure, Qt-free motion model: gravity fall/land/bounce (after a throw),
+    a random walk/idle behaviour state machine (injectable rng), and a
+    cursor-chase mode that sleeps once it catches the target.
+    """
+
+    GRAVITY = 2.0
+    BOUNCE_DAMPING = 0.55
+    WALL_DAMPING = 0.6
+    BOUNCE_THRESHOLD = 8.0
+    CHASE_STOP_DISTANCE = 10.0
+    CHASE_SPEED_FACTOR = 2.0
+
+    def __init__(
+        self,
+        x: int,
+        y: int,
+        width: int,
+        height: int,
+        bounds: Tuple[int, int, int, int],
+        speed: int = 3,
+        behaviour: str = BEHAVIOUR_FLOOR,
+        rng=None,
+    ) -> None:
+        self.x = float(x)
+        self.y = float(y)
+        self.width = int(width)
+        self.height = int(height)
+        self.bounds = bounds  # (left, top, right, bottom)
+        self.speed = max(1, int(speed))
+        self.behaviour = behaviour
+        self._rng = rng if rng is not None else _random_module.SystemRandom()
+        self.vx = float(self.speed)
+        self.vy = 0.0 if behaviour != BEHAVIOUR_WANDER else float(self.speed)
+        self._airborne = False
+        self.state = "walk"  # walk | idle
+        self._state_ticks = 0
+        self.target: Optional[Tuple[float, float]] = None
+        self.asleep = False
+
+    @property
+    def facing_left(self) -> bool:
+        return self.vx < 0
+
+    def set_bounds(self, bounds: Tuple[int, int, int, int]) -> None:
+        self.bounds = bounds
+
+    def set_target(self, x: float, y: float) -> None:
+        self.target = (float(x), float(y))
+
+    def throw(self, vx: float, vy: float) -> None:
+        """拖曳放開後以動量丟出（只在重力模式有意義）。"""
+        self.vx = float(vx)
+        self.vy = float(vy)
+        self._airborne = True
+        self.asleep = False
+
+    def step(self) -> Tuple[int, int]:
+        left, top, right, bottom = self.bounds
+        floor_y = bottom - self.height
+        if self.behaviour == BEHAVIOUR_CHASE:
+            return self._step_chase(left, top, right, bottom)
+        if self.behaviour == BEHAVIOUR_WANDER:
+            return self._step_wander(left, top, right, bottom)
+        return self._step_floor(left, top, right, bottom, floor_y)
+
+    # --- floor / gravity ---
+    def _step_floor(self, left, top, right, bottom, floor_y) -> Tuple[int, int]:
+        airborne = self._airborne or 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.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
+        self.y = float(floor_y)
+        if self._state_ticks <= 0:
+            self._new_state()
+        self._state_ticks -= 1
+        if self.state == "walk":
+            self.x += self.vx
+            if self.x <= left:
+                self.x = float(left)
+                self.vx = abs(self.vx)
+            elif self.x + self.width >= right:
+                self.x = float(right - self.width)
+                self.vx = -abs(self.vx)
+        return int(self.x), int(self.y)
+
+    def _new_state(self, force_walk: bool = False) -> None:
+        if force_walk or self._rng.random() < 0.65:
+            self.state = "walk"
+            if not force_walk:
+                self.vx = float(self.speed) if self._rng.random() < 0.5 else float(-self.speed)
+            self._state_ticks = self._rng.randint(30, 120)
+        else:
+            self.state = "idle"
+            self._state_ticks = self._rng.randint(20, 80)
+
+    # --- free wander ---
+    def _step_wander(self, left, top, right, bottom) -> Tuple[int, int]:
+        if abs(self.vy) < 1e-9:
+            self.vy = float(self.speed)
+        self.x += self.vx
+        self.y += self.vy
+        if self.x <= left:
+            self.x = float(left)
+            self.vx = abs(self.vx)
+        elif self.x + self.width >= right:
+            self.x = float(right - self.width)
+            self.vx = -abs(self.vx)
+        if self.y <= top:
+            self.y = float(top)
+            self.vy = abs(self.vy)
+        elif self.y + self.height >= bottom:
+            self.y = float(bottom - self.height)
+            self.vy = -abs(self.vy)
+        return int(self.x), int(self.y)
+
+    # --- chase cursor ---
+    def _step_chase(self, left, top, right, bottom) -> Tuple[int, int]:
+        if self.target is None:
+            return int(self.x), int(self.y)
+        target_x, target_y = self.target
+        dx = target_x - (self.x + self.width / 2)
+        dy = target_y - (self.y + self.height / 2)
+        distance = (dx * dx + dy * dy) ** 0.5
+        if distance <= self.CHASE_STOP_DISTANCE:
+            self.asleep = True
+            return int(self.x), int(self.y)
+        self.asleep = False
+        step = float(self.speed) * self.CHASE_SPEED_FACTOR
+        self.x += step * (dx / distance)
+        self.y += step * (dy / distance)
+        self.vx = abs(self.vx) if dx >= 0 else -abs(self.vx)
+        self.x = min(max(self.x, float(left)), float(right - self.width))
+        self.y = min(max(self.y, float(top)), float(bottom - self.height))
+        return int(self.x), int(self.y)
+
+
+class DesktopPetWidget(BaseWidget):
+    """
+    桌面寵物：可自主走動、可拖曳丟出、可追游標的動畫精靈。支援 GIF 與靜態圖。
+    A draggable, throwable, cursor-chasing animated sprite (GIF or image).
+    """
+
+    def __init__(self, image_path: str, size: int = 128, speed: int = 3,
+                 behaviour: str = BEHAVIOUR_FLOOR):
+        front_engine_logger.info(
+            f"[DesktopPetWidget] Init | path={image_path}, size={size}, speed={speed}, behaviour={behaviour}"
+        )
+        super().__init__()
+        self.opacity = 1.0
+        self.pet_size: int = max(16, int(size))
+        self.image_path: Path = Path(image_path)
+        self.movie: Optional[QMovie] = None
+        self.pixmap: Optional[QPixmap] = None
+        self._dragging: bool = False
+        self._drag_offset = None
+        self._last_move_delta: Tuple[int, int] = (0, 0)
+
+        if self.image_path.exists() and self.image_path.is_file():
+            if self.image_path.suffix.lower() in (".gif", ".webp"):
+                self.movie = QMovie(str(self.image_path))
+                self.movie.frameChanged.connect(self.update)
+                self.movie.start()
+            else:
+                self.pixmap = QPixmap(str(self.image_path))
+        else:
+            front_engine_logger.error(f"[DesktopPetWidget] File not found: {self.image_path}")
+            message_box = QMessageBox(self)
+            message_box.setText(language_wrapper.language_word_dict.get("pet_message_box_text", "Pet image not found"))
+            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._timer = QTimer(self)
+        self._timer.timeout.connect(self._on_tick)
+
+        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:
+        """寵物需接收滑鼠以便拖曳，故 allow_input=True 並置頂。"""
+        apply_overlay_window_flags(self, show_on_bottom=False, allow_input=True)
+
+    def _current_pixmap(self) -> Optional[QPixmap]:
+        if self.movie is not None:
+            return self.movie.currentPixmap()
+        return self.pixmap
+
+    def draw_content(self, painter: QPainter) -> None:
+        pixmap = self._current_pixmap()
+        if pixmap is None or pixmap.isNull():
+            return
+        if self.motion.facing_left:
+            pixmap = pixmap.transformed(QTransform().scale(-1, 1))
+        painter.drawPixmap(QRect(0, 0, self.width(), self.height()), pixmap)
+
+    def start_moving(self, bounds: Tuple[int, int, int, int], interval_ms: int = 33) -> None:
+        front_engine_logger.info(f"[DesktopPetWidget] start_moving | bounds={bounds}")
+        left, top, right, bottom = bounds
+        self.motion.set_bounds(bounds)
+        self.motion.x = float(left)
+        self.motion.y = float(bottom - self.pet_size)
+        self.move(int(self.motion.x), int(self.motion.y))
+        self._timer.start(max(10, int(interval_ms)))
+
+    def _on_tick(self) -> None:
+        if self._dragging:
+            return
+        if self.motion.behaviour == BEHAVIOUR_CHASE:
+            cursor = QCursor.pos()
+            self.motion.set_target(cursor.x(), cursor.y())
+        x, y = self.motion.step()
+        self.move(x, y)
+
+    # --- dragging + throwing ---
+    def mousePressEvent(self, event) -> None:
+        if event.button() == Qt.MouseButton.LeftButton:
+            self._dragging = True
+            self._last_move_delta = (0, 0)
+            self._drag_offset = event.globalPosition().toPoint() - self.frameGeometry().topLeft()
+        super().mousePressEvent(event)
+
+    def mouseMoveEvent(self, event) -> None:
+        if self._dragging and self._drag_offset is not None:
+            new_top_left = event.globalPosition().toPoint() - self._drag_offset
+            self._last_move_delta = (new_top_left.x() - self.x(), new_top_left.y() - self.y())
+            self.move(new_top_left)
+        super().mouseMoveEvent(event)
+
+    def mouseReleaseEvent(self, event) -> None:
+        if self._dragging:
+            self._dragging = False
+            self.motion.x = float(self.x())
+            self.motion.y = float(self.y())
+            # Fling with the momentum of the last drag movement (floor mode).
+            if self.motion.behaviour == BEHAVIOUR_FLOOR:
+                self.motion.throw(self._last_move_delta[0], self._last_move_delta[1])
+        super().mouseReleaseEvent(event)
+
+    def contextMenuEvent(self, event) -> None:
+        self.menu.popup(event.globalPos())
+
+    def closeEvent(self, event) -> None:
+        if self._timer.isActive():
+            self._timer.stop()
+        if self.movie is not None:
+            self.movie.stop()
+        super().closeEvent(event)

{frontengine-1.0.1 → frontengine-1.0.3}/frontengine/ui/dialog/choose_file_dialog.py

@@ -85,6 +85,16 @@ def choose_player_sound(trigger_ui: QWidget) -> Optional[str]:
     )
 
 
+def choose_pet(trigger_ui: QWidget) -> Optional[str]:
+    """選擇桌面寵物圖片 (gif/webp/png/jpg) / Choose a desktop-pet sprite."""
+    return choose_file(
+        trigger_ui,
+        file_filter="Pet sprite (*.gif;*.webp;*.png;*.jpg)",
+        extensions=[".gif", ".webp", ".png", ".jpg"],
+        warning_message=language_wrapper.language_word_dict.get("gif_setting_message_box")
+    )
+
+
 def choose_video(trigger_ui: QWidget) -> Optional[str]:
     """選擇影片檔案 (mp4) / Choose video file"""
     return choose_file(

{frontengine-1.0.1 → frontengine-1.0.3}/frontengine/ui/main_ui.py

@@ -18,6 +18,7 @@ from frontengine.ui.page.control_center.control_center_ui import ControlCenterUI
 from frontengine.ui.page.gif.gif_setting_ui import GIFSettingUI
 from frontengine.ui.page.image.image_setting_ui import ImageSettingUI
 from frontengine.ui.page.particle.particle_setting_ui import ParticleSettingUI
+from frontengine.ui.page.pet.pet_setting_ui import PetSettingUI
 from frontengine.ui.page.scene_setting.scene_setting_ui import SceneSettingUI
 from frontengine.ui.page.sound_player.sound_player_setting_ui import SoundPlayerSettingUI
 from frontengine.ui.page.text.text_setting_ui import TextSettingUI
@@ -98,6 +99,7 @@ class FrontEngineMainUI(QMainWindow):
         self.text_setting_ui = TextSettingUI()
         self.scene_setting_ui = SceneSettingUI()
         self.particle_setting_ui = ParticleSettingUI()
+        self.pet_setting_ui = PetSettingUI()
 
         # 控制中心
         # Control Center
@@ -110,7 +112,8 @@ class FrontEngineMainUI(QMainWindow):
             self.text_setting_ui,
             self.scene_setting_ui,
             self.particle_setting_ui,
-            redirect_output
+            redirect_output,
+            pet_setting_ui=self.pet_setting_ui,
         )
 
         # Menu Bar
@@ -200,6 +203,7 @@ class FrontEngineMainUI(QMainWindow):
             (self.text_setting_ui, "tab_text_text"),
             (self.scene_setting_ui, "tab_scene_text"),
             (self.particle_setting_ui, "tab_particle_text"),
+            (self.pet_setting_ui, "tab_pet_text"),
             (self.control_center_ui, "tab_control_center_text"),
         ]
 
@@ -351,6 +355,7 @@ class FrontEngineMainUI(QMainWindow):
         self.sound_player_setting_ui.sound_widget_list.clear()
         self.text_setting_ui.text_widget_list.clear()
         self.particle_setting_ui.particle_list.clear()
+        self.pet_setting_ui.pet_list.clear()
         self.scene_setting_ui.close_scene()
         super().close()
         if self.main_app:

{frontengine-1.0.1 → frontengine-1.0.3}/frontengine/ui/menu/preset_menu.py

@@ -23,6 +23,7 @@ _PRESET_PAGES = (
     ("sound", "sound_player_setting_ui"),
     ("text", "text_setting_ui"),
     ("particle", "particle_setting_ui"),
+    ("pet", "pet_setting_ui"),
 )
 
 

{frontengine-1.0.1 → frontengine-1.0.3}/frontengine/ui/page/control_center/control_center_ui.py

@@ -31,7 +31,8 @@ class ControlCenterUI(QWidget):
             text_setting_ui: TextSettingUI,
             scene_setting_ui: SceneSettingUI,
             particle_setting_ui: ParticleSettingUI,
-            redirect_output: bool = True
+            redirect_output: bool = True,
+            pet_setting_ui=None,
     ):
         front_engine_logger.info(
             f"[ControlCenterUI] Init | video={video_setting_ui}, image={image_setting_ui}, web={web_setting_ui}, "
@@ -54,6 +55,7 @@ class ControlCenterUI(QWidget):
         self.text_setting_ui = text_setting_ui
         self.scene_setting_ui = scene_setting_ui
         self.particle_setting_ui = particle_setting_ui
+        self.pet_setting_ui = pet_setting_ui
 
         # Buttons
         self.clear_video_button = self._create_button("control_center_close_all_video", self.clear_video)
@@ -151,11 +153,13 @@ class ControlCenterUI(QWidget):
         self.sound_player_setting_ui.sound_widget_list.clear()
         self.text_setting_ui.text_widget_list.clear()
         self.particle_setting_ui.particle_list.clear()
+        if self.pet_setting_ui is not None:
+            self.pet_setting_ui.pet_list.clear()
         self.scene_setting_ui.close_scene()
 
     def _all_overlay_widget_lists(self) -> list:
         """回傳所有覆蓋層 widget 清單 / All overlay widget lists."""
-        return [
+        lists = [
             self.video_setting_ui.video_widget_list,
             self.image_setting_ui.image_widget_list,
             self.web_setting_ui.web_widget_list,
@@ -164,6 +168,9 @@ class ControlCenterUI(QWidget):
             self.text_setting_ui.text_widget_list,
             self.particle_setting_ui.particle_list,
         ]
+        if self.pet_setting_ui is not None:
+            lists.append(self.pet_setting_ui.pet_list)
+        return lists
 
     def _for_each_overlay(self, action) -> None:
         """

frontengine-1.0.3/frontengine/ui/page/pet/pet_setting_ui.py

@@ -0,0 +1,168 @@
+from typing import Optional
+
+from PySide6.QtGui import QGuiApplication
+from PySide6.QtWidgets import (
+    QWidget, QGridLayout, QLabel, QPushButton, QMessageBox, QComboBox,
+)
+
+from frontengine.show.pet.desktop_pet import (
+    DesktopPetWidget, BEHAVIOUR_FLOOR, BEHAVIOUR_WANDER, BEHAVIOUR_CHASE,
+)
+from frontengine.ui.dialog.choose_file_dialog import choose_pet
+from frontengine.ui.page.utils import (
+    build_recent_combobox,
+    enable_file_drop,
+    reload_recent_combobox,
+)
+from frontengine.user_setting.user_setting_file import add_recent_file
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+
+_PET_EXTENSIONS = (".gif", ".webp", ".png", ".jpg")
+
+
+class PetSettingUI(QWidget):
+    def __init__(self):
+        front_engine_logger.info("[PetSettingUI] Init")
+        super().__init__()
+        self.grid_layout = QGridLayout(self)
+        self.grid_layout.setContentsMargins(0, 0, 0, 0)
+
+        # Init variable
+        self.pet_list: list = []
+        self.ready_to_play = False
+        self.pet_image_path: Optional[str] = None
+
+        # Choose file
+        self.choose_file_button = QPushButton(
+            language_wrapper.language_word_dict.get("pet_choose_file", "Choose pet sprite")
+        )
+        self.choose_file_button.clicked.connect(self.choose_and_play)
+        self.ready_label = QLabel(language_wrapper.language_word_dict.get("Not Ready"))
+
+        # Size
+        self.size_label = QLabel(language_wrapper.language_word_dict.get("pet_size_label", "Size"))
+        self.size_combobox = QComboBox()
+        self.size_combobox.addItems(["64", "96", "128", "192", "256"])
+        self.size_combobox.setCurrentText("128")
+
+        # Speed
+        self.speed_label = QLabel(language_wrapper.language_word_dict.get("pet_speed_label", "Speed"))
+        self.speed_combobox = QComboBox()
+        self.speed_combobox.addItems([str(n) for n in range(1, 11)])
+        self.speed_combobox.setCurrentText("3")
+
+        # Behaviour
+        self.behaviour_label = QLabel(language_wrapper.language_word_dict.get("pet_behaviour_label", "Behaviour"))
+        self.behaviour_combobox = QComboBox()
+        self.behaviour_combobox.addItem(
+            language_wrapper.language_word_dict.get("pet_behaviour_floor", "Walk on floor"), BEHAVIOUR_FLOOR)
+        self.behaviour_combobox.addItem(
+            language_wrapper.language_word_dict.get("pet_behaviour_wander", "Free wander"), BEHAVIOUR_WANDER)
+        self.behaviour_combobox.addItem(
+            language_wrapper.language_word_dict.get("pet_behaviour_chase", "Chase cursor"), BEHAVIOUR_CHASE)
+
+        # Start
+        self.start_button = QPushButton(language_wrapper.language_word_dict.get("pet_start", "Spawn pet"))
+        self.start_button.clicked.connect(self.start_play_pet)
+
+        # Recent files
+        self.recent_files_label = QLabel(language_wrapper.language_word_dict.get("recent_files_label", "Recent"))
+        self.recent_files_combobox = build_recent_combobox("pet")
+        self.recent_files_combobox.activated.connect(self._apply_recent_file)
+
+        # Drag and drop
+        self._drop_filter = enable_file_drop(self, _PET_EXTENSIONS, self._on_file_dropped)
+
+        # Layout
+        self.grid_layout.addWidget(self.choose_file_button, 0, 0)
+        self.grid_layout.addWidget(self.ready_label, 0, 1)
+        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)
+        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.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:
+        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(),
+        )
+        pet.set_pet_window_flag()
+        self.pet_list.append(pet)
+        return pet
+
+    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:
+            message_box = QMessageBox(self)
+            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)
+
+    def choose_and_play(self) -> None:
+        front_engine_logger.info("[PetSettingUI] choose_and_play")
+        self.ready_label.setText(language_wrapper.language_word_dict.get("Not Ready"))
+        self.ready_to_play = False
+        self.pet_image_path = choose_pet(self)
+        if self.pet_image_path:
+            self.ready_label.setText(language_wrapper.language_word_dict.get("Ready"))
+            self.ready_to_play = True
+            add_recent_file("pet", self.pet_image_path)
+            reload_recent_combobox(self.recent_files_combobox, "pet")
+
+    def _apply_recent_file(self, _index: int = 0) -> None:
+        path = self.recent_files_combobox.currentData()
+        self.recent_files_combobox.setCurrentIndex(0)
+        if not path:
+            return
+        self.pet_image_path = path
+        self.ready_to_play = True
+        self.ready_label.setText(language_wrapper.language_word_dict.get("Ready"))
+
+    def _on_file_dropped(self, path: str) -> None:
+        front_engine_logger.info(f"[PetSettingUI] _on_file_dropped | path={path}")
+        self.pet_image_path = path
+        self.ready_to_play = True
+        self.ready_label.setText(language_wrapper.language_word_dict.get("Ready"))
+        add_recent_file("pet", path)
+        reload_recent_combobox(self.recent_files_combobox, "pet")
+
+    def get_state(self) -> dict:
+        return {
+            "pet_image_path": self.pet_image_path,
+            "size": self.size_combobox.currentText(),
+            "speed": self.speed_combobox.currentText(),
+            "behaviour": self.behaviour_combobox.currentData(),
+        }
+
+    def set_state(self, state: dict) -> None:
+        if state.get("pet_image_path"):
+            self.pet_image_path = state["pet_image_path"]
+            self.ready_to_play = True
+            self.ready_label.setText(language_wrapper.language_word_dict.get("Ready"))
+        for combobox, key in ((self.size_combobox, "size"), (self.speed_combobox, "speed")):
+            if state.get(key) is not None:
+                index = combobox.findText(str(state[key]))
+                if index >= 0:
+                    combobox.setCurrentIndex(index)
+        behaviour = state.get("behaviour")
+        if behaviour is None and "gravity" in state:  # back-compat with old presets
+            behaviour = BEHAVIOUR_FLOOR if state.get("gravity") else BEHAVIOUR_WANDER
+        if behaviour is not None:
+            index = self.behaviour_combobox.findData(behaviour)
+            if index >= 0:
+                self.behaviour_combobox.setCurrentIndex(index)

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

@@ -214,4 +214,15 @@ english_word_dict = {
     "web_zoom_label": "Zoom",
     "web_refresh_label": "Auto refresh",
     "web_refresh_off": "Off",
+    # Desktop pet
+    "tab_pet_text": "Pet",
+    "pet_choose_file": "Choose pet sprite",
+    "pet_size_label": "Size",
+    "pet_speed_label": "Speed",
+    "pet_behaviour_label": "Behaviour",
+    "pet_behaviour_floor": "Walk on floor",
+    "pet_behaviour_wander": "Free wander",
+    "pet_behaviour_chase": "Chase cursor",
+    "pet_start": "Spawn pet",
+    "pet_message_box_text": "Pet image not found",
 }

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

@@ -215,4 +215,15 @@ traditional_chinese_word_dict = {
     "web_zoom_label": "縮放",
     "web_refresh_label": "自動重新整理",
     "web_refresh_off": "關閉",
+    # Desktop pet
+    "tab_pet_text": "桌面寵物",
+    "pet_choose_file": "選擇寵物圖片",
+    "pet_size_label": "大小",
+    "pet_speed_label": "速度",
+    "pet_behaviour_label": "行為",
+    "pet_behaviour_floor": "沿底部行走",
+    "pet_behaviour_wander": "自由漫遊",
+    "pet_behaviour_chase": "追逐游標",
+    "pet_start": "召喚寵物",
+    "pet_message_box_text": "找不到寵物圖片",
 }

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.1
+Version: 1.0.3
 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.1 → frontengine-1.0.3}/frontengine.egg-info/SOURCES.txt

@@ -21,6 +21,8 @@ frontengine/show/load/__init__.py
 frontengine/show/load/load_someone_make_ui.py
 frontengine/show/particle/__init__.py
 frontengine/show/particle/particle_ui.py
+frontengine/show/pet/__init__.py
+frontengine/show/pet/desktop_pet.py
 frontengine/show/scene/__init__.py
 frontengine/show/scene/extend_graphic_scene.py
 frontengine/show/scene/extend_graphic_view.py
@@ -60,6 +62,8 @@ frontengine/ui/page/image/__init__.py
 frontengine/ui/page/image/image_setting_ui.py
 frontengine/ui/page/particle/__init__.py
 frontengine/ui/page/particle/particle_setting_ui.py
+frontengine/ui/page/pet/__init__.py
+frontengine/ui/page/pet/pet_setting_ui.py
 frontengine/ui/page/scene_setting/__init__.py
 frontengine/ui/page/scene_setting/scene_manager.py
 frontengine/ui/page/scene_setting/scene_setting_ui.py

{frontengine-1.0.1 → frontengine-1.0.3}/pyproject.toml

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