frontengine-dev 0.0.89__tar.gz → 0.0.92__tar.gz

{frontengine_dev-0.0.89 → frontengine_dev-0.0.92}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine_dev
-Version: 0.0.89
+Version: 0.0.92
 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
@@ -14,7 +14,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: PySide6==6.9.3
+Requires-Dist: PySide6==6.10.0
 Requires-Dist: qt-material
 Dynamic: license-file
 

frontengine_dev-0.0.92/frontengine/show/base_widget.py

@@ -0,0 +1,83 @@
+import os
+from abc import abstractmethod
+from pathlib import Path
+
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QPainter, QIcon
+from PySide6.QtWidgets import QWidget
+
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+
+class BaseWidget(QWidget):
+    """
+    BaseWidget: 提供共用 UI 屬性與事件處理的基底類別
+    BaseWidget: Base class providing shared UI attributes and event handling
+    """
+
+    def __init__(self, draw_location_x: int = 0, draw_location_y: int = 0):
+        super().__init__()
+        self.draw_location_x: int = draw_location_x
+        self.draw_location_y: int = draw_location_y
+        self.opacity: float = 0.2
+
+        # 設定視窗屬性 / Set widget attributes
+        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
+        self.setAttribute(Qt.WidgetAttribute.WA_TranslucentBackground)
+
+        # 設定視窗 Icon / Set window icon
+        self.icon_path: Path = Path(os.getcwd()) / "je_driver_icon.ico"
+        if self.icon_path.exists() and self.icon_path.is_file():
+            self.setWindowIcon(QIcon(str(self.icon_path)))
+
+    def set_ui_window_flag(self, show_on_bottom: bool = False) -> None:
+        """
+        設定視窗旗標 (保持最上層或最下層)
+        Set window flags (stay on top or bottom)
+        """
+        front_engine_logger.info(f"{self.__class__.__name__} set_ui_window_flag | show_on_bottom: {show_on_bottom}")
+        self.setWindowFlag(
+            Qt.WindowType.WindowTransparentForInput |
+            Qt.WindowType.FramelessWindowHint |
+            Qt.WindowType.Tool
+        )
+        if not show_on_bottom:
+            self.setWindowFlag(Qt.WindowType.WindowStaysOnTopHint)
+        else:
+            self.setWindowFlag(Qt.WindowType.WindowStaysOnBottomHint)
+
+    def set_ui_variable(self, opacity: float = 0.2) -> None:
+        """
+        設定 UI 透明度
+        Set UI opacity
+        """
+        front_engine_logger.info(f"{self.__class__.__name__} set_ui_variable | opacity: {opacity}")
+        self.opacity = opacity
+
+    def paintEvent(self, event) -> None:
+        """
+        呼叫子類別的繪製方法
+        Call subclass draw_content method
+        """
+        front_engine_logger.debug(f"{self.__class__.__name__} paintEvent | event: {event}")
+        painter = QPainter(self)
+        painter.setOpacity(self.opacity)
+        self.draw_content(painter)
+        painter.restore()
+
+    @abstractmethod
+    def draw_content(self, painter: QPainter) -> None:
+        """
+        子類別必須實作的繪製方法
+        Subclasses must implement this drawing method
+        """
+        pass
+
+    # --- 共用滑鼠事件 / Shared mouse events ---
+    def mousePressEvent(self, event) -> None:
+        front_engine_logger.debug(f"{self.__class__.__name__} mousePressEvent | event: {event}")
+        super().mousePressEvent(event)
+
+    def mouseDoubleClickEvent(self, event) -> None:
+        front_engine_logger.debug(f"{self.__class__.__name__} mouseDoubleClickEvent | event: {event}")
+        super().mouseDoubleClickEvent(event)

frontengine_dev-0.0.92/frontengine/show/gif/paint_gif.py

@@ -0,0 +1,47 @@
+from pathlib import Path
+
+from PySide6.QtCore import QRect
+from PySide6.QtGui import QPainter, QMovie
+from PySide6.QtWidgets import QMessageBox, QLabel
+
+from frontengine.show.base_widget import BaseWidget
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+
+
+class GifWidget(BaseWidget):
+    """
+    GifWidget: 顯示 GIF 動畫
+    GifWidget: Display animated GIF
+    """
+
+    def __init__(self, gif_image_path: str, draw_location_x: int = 0, draw_location_y: int = 0):
+        super().__init__(draw_location_x, draw_location_y)
+        self.speed: int = 100
+        self.gif_path: Path = Path(gif_image_path)
+        self.movie: QMovie = QMovie()
+        self.gif_label: QLabel = QLabel()
+
+        if self.gif_path.exists() and self.gif_path.is_file():
+            front_engine_logger.info(f"Loading GIF file: {self.gif_path}")
+            self.movie.setFileName(str(self.gif_path))
+            self.movie.frameChanged.connect(self.repaint)
+            self.gif_label.setMovie(self.movie)
+            self.movie.start()
+            self.resize(self.movie.frameRect().size())
+        else:
+            message_box: QMessageBox = QMessageBox(self)
+            message_box.setText(language_wrapper.language_word_dict.get("paint_gif_message_box_text"))
+            message_box.show()
+
+    def set_gif_variable(self, speed: int = 100) -> None:
+        front_engine_logger.info(f"GifWidget set_gif_variable | speed: {speed}")
+        self.speed = speed
+        self.movie.setSpeed(self.speed)
+
+    def draw_content(self, painter: QPainter) -> None:
+        current_gif_frame = self.movie.currentPixmap()
+        painter.drawPixmap(
+            QRect(self.draw_location_x, self.draw_location_y, self.width(), self.height()),
+            current_gif_frame
+        )

frontengine_dev-0.0.92/frontengine/show/image/paint_image.py

@@ -0,0 +1,35 @@
+from pathlib import Path
+
+from PySide6.QtCore import QRect
+from PySide6.QtGui import QPainter, QImage
+from PySide6.QtWidgets import QMessageBox
+
+from frontengine.show.base_widget import BaseWidget
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+
+
+class ImageWidget(BaseWidget):
+    """
+    ImageWidget: 顯示靜態圖片
+    ImageWidget: Display static image
+    """
+
+    def __init__(self, image_path: str, draw_location_x: int = 0, draw_location_y: int = 0):
+        super().__init__(draw_location_x, draw_location_y)
+        self.image_path: Path = Path(image_path)
+
+        if self.image_path.exists() and self.image_path.is_file():
+            front_engine_logger.info(f"Loading image file: {self.image_path}")
+            self.image: QImage = QImage(str(self.image_path))
+            self.resize(self.image.size())
+        else:
+            message_box: QMessageBox = QMessageBox(self)
+            message_box.setText(language_wrapper.language_word_dict.get("paint_image_message_box_text"))
+            message_box.show()
+
+    def draw_content(self, painter: QPainter) -> None:
+        painter.drawImage(
+            QRect(self.draw_location_x, self.draw_location_y, self.width(), self.height()),
+            self.image
+        )

frontengine_dev-0.0.92/frontengine/show/load/load_someone_make_ui.py

@@ -0,0 +1,68 @@
+from typing import Optional, List
+
+from PySide6.QtGui import QScreen
+from PySide6.QtUiTools import QUiLoader
+from PySide6.QtWidgets import QWidget
+
+from frontengine.utils.exception.exceptions import FrontEngineLoadUIException
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+
+def load_extend_ui_file(ui_path: str, show_all_screen: bool = False) -> None:
+    """
+    載入並顯示 UI 檔案
+    Load and display a UI file
+
+    :param ui_path: UI 檔案路徑 / Path to the UI file
+    :param show_all_screen: 是否顯示在所有螢幕上 / Show on all screens
+    """
+    front_engine_logger.info(
+        f"[load_extend_ui_file] ui_path={ui_path}, show_all_screen={show_all_screen}"
+    )
+
+    ui: QWidget = load_ui_file(ui_path)
+
+    if show_all_screen:
+        ui.showFullScreen()
+    else:
+        # 取得所有螢幕並在每個螢幕上顯示 UI
+        # Get all monitors and display UI on each
+        monitors: List[QScreen] = QScreen.virtualSiblings(ui.screen())
+        for screen in monitors:
+            monitor_geometry = screen.availableGeometry()
+            ui.move(monitor_geometry.left(), monitor_geometry.top())
+            ui.showFullScreen()
+
+
+def load_ui_file(ui_path: str) -> QWidget:
+    """
+    載入 UI 檔案
+    Load a UI file
+
+    :param ui_path: UI 檔案路徑 / Path to the UI file
+    :return: QWidget 物件 / QWidget object
+    :raises FrontEngineLoadUIException: 若載入失敗 / If loading fails
+    """
+    front_engine_logger.info(f"[load_ui_file] ui_path={ui_path}")
+    ui: QWidget = QUiLoader().load(ui_path)
+
+    if not ui:
+        front_engine_logger.error(f"[load_ui_file] Failed to load UI: {ui_path}")
+        raise FrontEngineLoadUIException(f"Failed to load UI file: {ui_path}")
+
+    return ui
+
+
+def read_extend_ui(ui: QWidget) -> Optional[QWidget]:
+    """
+    驗證並回傳 UI 物件
+    Validate and return UI object
+
+    :param ui: QWidget 物件 / QWidget object
+    :return: QWidget 或 None / QWidget or None
+    """
+    front_engine_logger.info(f"[read_extend_ui] ui={ui}")
+
+    if not isinstance(ui, QWidget):
+        return None
+    return ui

frontengine_dev-0.0.92/frontengine/show/particle/particle_scene.py

@@ -0,0 +1,134 @@
+import random
+from typing import Callable, Dict, Any
+
+from PySide6.QtCore import QTimer, QPoint, QRect
+from PySide6.QtGui import QPixmap
+from PySide6.QtWidgets import QGraphicsScene
+
+from frontengine.show.particle.particle_utils import (
+    particle_down, particle_up, particle_left, particle_right,
+    particle_left_down, particle_left_up, particle_right_down, particle_right_up,
+    particle_random_minus, particle_random_add, particle_random
+)
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+
+class ParticleGraphicScene(QGraphicsScene):
+    """
+    粒子特效場景，用於顯示粒子動畫
+    ParticleGraphicScene: A QGraphicsScene subclass for particle animation
+    """
+
+    def __init__(self,
+                 particle_pixmap: QPixmap,
+                 particle_direction: str,
+                 particle_count: int = 500,
+                 screen_height: int = 1920,
+                 screen_width: int = 1080,
+                 opacity: float = 0.2,
+                 particle_speed: int = 1):
+        """
+        初始化粒子場景
+        Initialize particle scene
+
+        :param particle_pixmap: 粒子圖片 / Particle pixmap
+        :param particle_direction: 粒子移動方向 / Particle movement direction
+        :param particle_count: 粒子數量 / Number of particles
+        :param screen_height: 畫布高度 / Screen height
+        :param screen_width: 畫布寬度 / Screen width
+        :param opacity: 粒子透明度 / Particle opacity
+        :param particle_speed: 粒子移動速度 / Particle speed
+        """
+        front_engine_logger.info(
+            f"Init ParticleGraphicScene | "
+            f"particle_direction={particle_direction}, "
+            f"particle_count={particle_count}, "
+            f"screen_height={screen_height}, screen_width={screen_width}, "
+            f"opacity={opacity}, particle_speed={particle_speed}"
+        )
+        super().__init__()
+
+        # --- 基本屬性 / Basic attributes ---
+        self.particle_pixmap: QPixmap = particle_pixmap
+        self.particle_direction: str = particle_direction
+        self.particle_count: int = particle_count
+        self.opacity: float = opacity
+        self.particle_speed: int = particle_speed
+        self.screen_height: int = screen_height
+        self.screen_width: int = screen_width
+
+        # 儲存粒子資訊的字典 / Dictionary to store particle info
+        self.particle_dict: Dict[str, Dict[str, Any]] = {}
+
+        # 建立粒子 / Create particles
+        self.create_particle()
+
+        # 設定更新函式 / Set update function
+        self.update_function: Callable = {
+            "down": particle_down,
+            "up": particle_up,
+            "left": particle_left,
+            "right": particle_right,
+            "left_down": particle_left_down,
+            "left_up": particle_left_up,
+            "right_down": particle_right_down,
+            "right_up": particle_right_up,
+            "random_minus": particle_random_minus,
+            "random_add": particle_random_add,
+            "random": particle_random
+        }.get(self.particle_direction)
+
+        if not self.update_function:
+            front_engine_logger.error(f"Invalid particle direction: {self.particle_direction}")
+            raise ValueError(f"Unsupported particle direction: {self.particle_direction}")
+
+        # 設定場景大小 / Set scene size
+        self.setSceneRect(QRect(0, 0, screen_width, screen_height))
+
+        # 啟動定時器 / Start update timer
+        self.update_timer: QTimer = QTimer()
+        self.update_timer.setInterval(100)  # 更新間隔 (毫秒) / Update interval (ms)
+        self.update_timer.timeout.connect(self.update_particle_xy)
+        self.update_timer.start()
+
+    def create_particle(self) -> None:
+        """
+        建立粒子並隨機分布在場景中
+        Create particles and randomly distribute them in the scene
+        """
+        front_engine_logger.info("ParticleGraphicScene create_particle")
+        self.particle_dict.clear()
+
+        for count in range(self.particle_count):
+            item = self.addPixmap(self.particle_pixmap)
+            item.setOpacity(self.opacity)
+            self.particle_dict[f"particle_{count}"] = {
+                "x": random.randint(0, self.screen_width),
+                "y": random.randint(0, self.screen_height),
+                "height": self.screen_height,
+                "width": self.screen_width,
+                "pixmap_item": item,
+            }
+
+    def update_particle_xy(self) -> None:
+        """
+        更新粒子座標並重新繪製
+        Update particle positions and redraw
+        """
+        front_engine_logger.debug("ParticleGraphicScene update_particle_xy")
+
+        # 更新粒子座標 / Update particle positions
+        self.update_function(self.particle_dict, self.particle_speed)
+
+        # 更新場景中的粒子位置 / Update positions in scene
+        for particle in self.particle_dict.values():
+            pixmap_item = particle["pixmap_item"]
+            pixmap_item.setPos(particle["x"], particle["y"])
+
+            # 如果粒子超出場景範圍，移除它 / Remove particle if out of bounds
+            if not self.sceneRect().contains(QPoint(particle["x"], particle["y"])):
+                self.removeItem(pixmap_item)
+
+        # 如果場景中沒有粒子，重新建立 / Recreate particles if all removed
+        if not self.items():
+            self.create_particle()

frontengine_dev-0.0.92/frontengine/show/particle/particle_ui.py

@@ -0,0 +1,80 @@
+from PySide6.QtCore import QSize
+from PySide6.QtGui import QPixmap, Qt
+from PySide6.QtWidgets import QWidget, QGridLayout
+
+from frontengine.show.particle.particle_scene import ParticleGraphicScene
+from frontengine.show.scene.extend_graphic_view import ExtendGraphicView
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+
+class ParticleWidget(QWidget):
+    """
+    粒子特效顯示元件
+    ParticleWidget: A QWidget wrapper for displaying particle effects
+    """
+
+    def __init__(self,
+                 pixmap: QPixmap,
+                 particle_size: int,
+                 particle_direction: str,
+                 particle_count: int = 50,
+                 screen_height: int = 1080,
+                 screen_width: int = 1920,
+                 opacity: float = 0.2,
+                 particle_speed: int = 1):
+        """
+        初始化粒子元件
+        Initialize particle widget
+
+        :param pixmap: 粒子圖片 / Particle pixmap
+        :param particle_size: 粒子大小 / Particle size
+        :param particle_direction: 粒子方向 / Particle direction
+        :param particle_count: 粒子數量 / Number of particles
+        :param screen_height: 畫布高度 / Screen height
+        :param screen_width: 畫布寬度 / Screen width
+        :param opacity: 粒子透明度 / Particle opacity
+        :param particle_speed: 粒子速度 / Particle speed
+        """
+        front_engine_logger.info(
+            f"[ParticleWidget] Init | direction={particle_direction}, "
+            f"count={particle_count}, size={particle_size}, "
+            f"screen=({screen_width}x{screen_height}), opacity={opacity}, speed={particle_speed}"
+        )
+        super().__init__()
+
+        # 設定視窗屬性 / Set widget attributes
+        self.setAttribute(Qt.WidgetAttribute.WA_TranslucentBackground)
+        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
+
+        # --- 設定粒子圖片大小 / Scale particle pixmap ---
+        target_size = QSize(particle_size, particle_size) if particle_size else QSize(pixmap.width(), pixmap.height())
+        self.pixmap: QPixmap = pixmap.scaled(target_size, Qt.AspectRatioMode.KeepAspectRatio)
+
+        # --- 建立場景與視圖 / Create scene and view ---
+        self.particle_view: ExtendGraphicView = ExtendGraphicView()
+        self.particle_scene: ParticleGraphicScene = ParticleGraphicScene(
+            self.pixmap, particle_direction, particle_count,
+            screen_height, screen_width, opacity, particle_speed
+        )
+        self.particle_view.setScene(self.particle_scene)
+
+        # --- 設定版面配置 / Set layout ---
+        self.grid_layout: QGridLayout = QGridLayout()
+        self.grid_layout.addWidget(self.particle_view, 0, 0, -1, -1)
+        self.setLayout(self.grid_layout)
+
+    def set_ui_window_flag(self, show_on_bottom: bool = False) -> None:
+        """
+        設定視窗旗標 (保持最上層或最下層)
+        Set window flags (stay on top or bottom)
+        """
+        front_engine_logger.info(f"[ParticleWidget] set_ui_window_flag | show_on_bottom={show_on_bottom}")
+        self.setWindowFlag(
+            Qt.WindowType.WindowTransparentForInput |
+            Qt.WindowType.FramelessWindowHint |
+            Qt.WindowType.Tool
+        )
+        if not show_on_bottom:
+            self.setWindowFlag(Qt.WindowType.WindowStaysOnTopHint)
+        else:
+            self.setWindowFlag(Qt.WindowType.WindowStaysOnBottomHint)

frontengine_dev-0.0.92/frontengine/show/particle/particle_utils.py

@@ -0,0 +1,120 @@
+import random
+from typing import Dict, Callable
+
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+
+def particle_down(particle_dict: Dict[str, dict], particle_speed: int = 30) -> None:
+    """
+    粒子向下移動
+    Move particles downward
+    """
+    front_engine_logger.debug(f"[particle_down] speed={particle_speed}, count={len(particle_dict)}")
+    for particle in particle_dict.values():
+        particle["y"] = particle.get("y", 0) + random.randint(0, particle_speed)
+
+
+def particle_up(particle_dict: Dict[str, dict], particle_speed: int = 30) -> None:
+    """
+    粒子向上移動
+    Move particles upward
+    """
+    front_engine_logger.debug(f"[particle_up] speed={particle_speed}, count={len(particle_dict)}")
+    for particle in particle_dict.values():
+        particle["y"] = particle.get("y", 0) - random.randint(0, particle_speed)
+
+
+def particle_left(particle_dict: Dict[str, dict], particle_speed: int = 30) -> None:
+    """
+    粒子向左移動
+    Move particles left
+    """
+    front_engine_logger.debug(f"[particle_left] speed={particle_speed}, count={len(particle_dict)}")
+    for particle in particle_dict.values():
+        particle["x"] = particle.get("x", 0) - random.randint(0, particle_speed)
+
+
+def particle_right(particle_dict: Dict[str, dict], particle_speed: int = 30) -> None:
+    """
+    粒子向右移動
+    Move particles right
+    """
+    front_engine_logger.debug(f"[particle_right] speed={particle_speed}, count={len(particle_dict)}")
+    for particle in particle_dict.values():
+        particle["x"] = particle.get("x", 0) + random.randint(0, particle_speed)
+
+
+def particle_left_down(particle_dict: Dict[str, dict], particle_speed: int = 30) -> None:
+    """
+    粒子向左下移動
+    Move particles left and down
+    """
+    front_engine_logger.debug(f"[particle_left_down] speed={particle_speed}")
+    particle_left(particle_dict, particle_speed)
+    particle_down(particle_dict, particle_speed)
+
+
+def particle_left_up(particle_dict: Dict[str, dict], particle_speed: int = 30) -> None:
+    """
+    粒子向左上移動
+    Move particles left and up
+    """
+    front_engine_logger.debug(f"[particle_left_up] speed={particle_speed}")
+    particle_left(particle_dict, particle_speed)
+    particle_up(particle_dict, particle_speed)
+
+
+def particle_right_down(particle_dict: Dict[str, dict], particle_speed: int = 30) -> None:
+    """
+    粒子向右下移動
+    Move particles right and down
+    """
+    front_engine_logger.debug(f"[particle_right_down] speed={particle_speed}")
+    particle_right(particle_dict, particle_speed)
+    particle_down(particle_dict, particle_speed)
+
+
+def particle_right_up(particle_dict: Dict[str, dict], particle_speed: int = 30) -> None:
+    """
+    粒子向右上移動
+    Move particles right and up
+    """
+    front_engine_logger.debug(f"[particle_right_up] speed={particle_speed}")
+    particle_right(particle_dict, particle_speed)
+    particle_up(particle_dict, particle_speed)
+
+
+def particle_random_minus(particle_dict: Dict[str, dict], particle_speed: int = 30) -> None:
+    """
+    粒子隨機往左下移動
+    Move particles randomly left and down
+    """
+    front_engine_logger.debug(f"[particle_random_minus] speed={particle_speed}")
+    for particle in particle_dict.values():
+        particle["y"] = particle.get("y", 0) + random.randint(0, particle_speed)
+        particle["x"] = particle.get("x", 0) - random.randint(0, particle_speed)
+
+
+def particle_random_add(particle_dict: Dict[str, dict], particle_speed: int = 30) -> None:
+    """
+    粒子隨機往右上移動
+    Move particles randomly right and up
+    """
+    front_engine_logger.debug(f"[particle_random_add] speed={particle_speed}")
+    for particle in particle_dict.values():
+        particle["y"] = particle.get("y", 0) - random.randint(0, particle_speed)
+        particle["x"] = particle.get("x", 0) + random.randint(0, particle_speed)
+
+
+def particle_random(particle_dict: Dict[str, dict], particle_speed: int = 30) -> None:
+    """
+    粒子隨機選擇一種方向移動
+    Move particles in a random direction
+    """
+    front_engine_logger.debug(f"[particle_random] speed={particle_speed}")
+    function: Callable = random.choice([
+        particle_down, particle_up, particle_left, particle_right,
+        particle_right_up, particle_left_down, particle_left_up, particle_right_down,
+        particle_random_add, particle_random_minus
+    ])
+    function(particle_dict, particle_speed)

frontengine_dev-0.0.92/frontengine/show/scene/extend_graphic_scene.py

@@ -0,0 +1,32 @@
+from PySide6.QtGui import QBrush, QColor
+from PySide6.QtWidgets import QGraphicsScene
+
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+
+class ExtendGraphicScene(QGraphicsScene):
+    """
+    ExtendGraphicScene: 可擴展的 QGraphicsScene 基底類別
+    ExtendGraphicScene: A base class extending QGraphicsScene for custom scenes
+    """
+
+    def __init__(self, background_color: QColor = QColor(0, 0, 0, 0)):
+        """
+        初始化場景
+        Initialize the scene
+
+        :param background_color: 場景背景顏色 (預設透明) / Scene background color (default transparent)
+        """
+        front_engine_logger.info("Init ExtendGraphicScene")
+        super().__init__()
+
+        # 設定背景顏色 / Set background color
+        self.setBackgroundBrush(QBrush(background_color))
+
+    def clear_scene(self) -> None:
+        """
+        清除場景內所有項目
+        Clear all items in the scene
+        """
+        front_engine_logger.debug("ExtendGraphicScene clear_scene")
+        self.clear()