frontengine 1.0.0__tar.gz → 1.0.2__tar.gz

{frontengine-1.0.0 → frontengine-1.0.2}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2023 JE-Chen
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2023 JE-Chen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

frontengine-1.0.2/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: frontengine
+Version: 1.0.2
+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
+Project-URL: Code, https://github.com/Intergration-Automation-Testing/FrontEngine
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: MacOS X
+Classifier: Environment :: X11 Applications
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PySide6==6.10.2
+Requires-Dist: qt-material
+Requires-Dist: PyOpenGL
+Requires-Dist: PyOpenGL_accelerate
+Requires-Dist: numpy
+Requires-Dist: pynput
+Dynamic: license-file
+
+# FrontEngine
+
+[Support this project on Steam](https://store.steampowered.com/app/2793470/FrontEngine/)
+
+## About
+
+FrontEngine is a lightweight and flexible framework designed to simplify automation and visualization tasks.  
+It provides an intuitive interface and supports multiple media formats for interactive demonstrations.
+
+![FrontEngine UI](image/FrontEngine.png)
+
+---
+
+## Features
+
+- **GIFs & Animations**  
+  *(GIFs may take time to load)*  
+  ![GIF](gifs/play_gif.gif)  
+  ![WEBP](gifs/webp.gif)
+
+- **Video**  
+  ![Video](gifs/video.gif)
+
+- **Website**  
+  ![Website](gifs/website.gif)
+
+- **YouTube Showcase**  
+  [Watch on YouTube](https://youtu.be/fewogcb3b8Y)
+
+---
+
+## Install
+
+- **System Requirements**
+  - Python **3.10+**
+  - Windows 10/11 is the primary target; macOS and Linux are supported but may need extra OS dependencies.
+
+- **From PyPI**
+  ```bash
+  pip install frontengine
+  ```
+
+- **Pre-built binaries**
+  - [GitHub Releases](https://github.com/Intergration-Automation-Testing/FrontEngine/releases)
+
+---
+
+## Development
+
+- Requires **Python 3.10+**.
+- Install the dev toolchain:
+  ```bash
+  pip install -r dev_requirements.txt
+  pip install -e .
+  ```
+- Run the unit smoke tests:
+  ```bash
+  python ./tests/unit_test/start/start_front_engine.py
+  python ./tests/unit_test/start/extend_front_engine.py
+  ```
+- Contributions and pull requests are welcome!
+
+---
+
+## Continuous Integration & Release
+
+This repository ships two GitHub Actions workflows:
+
+| Workflow | Trigger | Purpose |
+|----------|---------|---------|
+| `CI` (`.github/workflows/ci.yml`) | Push / PR to `main` or `dev`, daily cron | Matrix smoke test across Python 3.10 / 3.11 / 3.12 on Windows |
+| `Release` (`.github/workflows/release.yml`) | A pull request is merged into `main` (or manual dispatch) | Auto-bumps the version in `stable.toml`/`pyproject.toml`, commits the bump back to `main`, swaps `stable.toml` → `pyproject.toml`, builds sdist + wheel, uploads to PyPI as `frontengine` via `twine`, creates a GitHub release tagged `v<version>` |
+
+Publishing **only happens on merge to `main`** — pushing to `dev` runs CI but
+never publishes. On merge, the workflow **automatically bumps the patch
+segment** of the version (configurable via manual dispatch: `patch` / `minor`
+/ `major`), commits the bump back to `main` with `[skip ci]`, then builds,
+uploads, and releases under the new version. Both the PyPI upload and the
+GitHub release see the bumped version, not the previous one.
+
+### Cutting a new release
+
+1. Merge a pull request into `main` — the patch version bumps automatically.
+2. That's it. PyPI publish and GitHub release happen in one workflow run.
+
+For a minor or major bump, trigger the workflow manually via *Actions →
+Release → Run workflow* and pick the `bump` segment. That path also works
+when you need to re-run a failed publish without a new merge.
+
+### Required repository secrets
+
+| Secret | Used by | Contents |
+|--------|---------|----------|
+| `PYPI_API_TOKEN` | `release.yml` | A PyPI API token scoped to the `frontengine` project |
+
+The workflow uses `__token__` as the twine username, so only the token itself
+needs to be stored.

frontengine-1.0.2/README.md

@@ -0,0 +1,97 @@
+# FrontEngine
+
+[Support this project on Steam](https://store.steampowered.com/app/2793470/FrontEngine/)
+
+## About
+
+FrontEngine is a lightweight and flexible framework designed to simplify automation and visualization tasks.  
+It provides an intuitive interface and supports multiple media formats for interactive demonstrations.
+
+![FrontEngine UI](image/FrontEngine.png)
+
+---
+
+## Features
+
+- **GIFs & Animations**  
+  *(GIFs may take time to load)*  
+  ![GIF](gifs/play_gif.gif)  
+  ![WEBP](gifs/webp.gif)
+
+- **Video**  
+  ![Video](gifs/video.gif)
+
+- **Website**  
+  ![Website](gifs/website.gif)
+
+- **YouTube Showcase**  
+  [Watch on YouTube](https://youtu.be/fewogcb3b8Y)
+
+---
+
+## Install
+
+- **System Requirements**
+  - Python **3.10+**
+  - Windows 10/11 is the primary target; macOS and Linux are supported but may need extra OS dependencies.
+
+- **From PyPI**
+  ```bash
+  pip install frontengine
+  ```
+
+- **Pre-built binaries**
+  - [GitHub Releases](https://github.com/Intergration-Automation-Testing/FrontEngine/releases)
+
+---
+
+## Development
+
+- Requires **Python 3.10+**.
+- Install the dev toolchain:
+  ```bash
+  pip install -r dev_requirements.txt
+  pip install -e .
+  ```
+- Run the unit smoke tests:
+  ```bash
+  python ./tests/unit_test/start/start_front_engine.py
+  python ./tests/unit_test/start/extend_front_engine.py
+  ```
+- Contributions and pull requests are welcome!
+
+---
+
+## Continuous Integration & Release
+
+This repository ships two GitHub Actions workflows:
+
+| Workflow | Trigger | Purpose |
+|----------|---------|---------|
+| `CI` (`.github/workflows/ci.yml`) | Push / PR to `main` or `dev`, daily cron | Matrix smoke test across Python 3.10 / 3.11 / 3.12 on Windows |
+| `Release` (`.github/workflows/release.yml`) | A pull request is merged into `main` (or manual dispatch) | Auto-bumps the version in `stable.toml`/`pyproject.toml`, commits the bump back to `main`, swaps `stable.toml` → `pyproject.toml`, builds sdist + wheel, uploads to PyPI as `frontengine` via `twine`, creates a GitHub release tagged `v<version>` |
+
+Publishing **only happens on merge to `main`** — pushing to `dev` runs CI but
+never publishes. On merge, the workflow **automatically bumps the patch
+segment** of the version (configurable via manual dispatch: `patch` / `minor`
+/ `major`), commits the bump back to `main` with `[skip ci]`, then builds,
+uploads, and releases under the new version. Both the PyPI upload and the
+GitHub release see the bumped version, not the previous one.
+
+### Cutting a new release
+
+1. Merge a pull request into `main` — the patch version bumps automatically.
+2. That's it. PyPI publish and GitHub release happen in one workflow run.
+
+For a minor or major bump, trigger the workflow manually via *Actions →
+Release → Run workflow* and pick the `bump` segment. That path also works
+when you need to re-run a failed publish without a new merge.
+
+### Required repository secrets
+
+| Secret | Used by | Contents |
+|--------|---------|----------|
+| `PYPI_API_TOKEN` | `release.yml` | A PyPI API token scoped to the `frontengine` project |
+
+The workflow uses `__token__` as the twine username, so only the token itself
+needs to be stored.

{frontengine-1.0.0 → frontengine-1.0.2}/frontengine/__init__.py

@@ -1,30 +1,32 @@
-from frontengine.show.gif.paint_gif import GifWidget
-from frontengine.show.image.paint_image import ImageWidget
-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.text.draw_text import TextWidget
-from frontengine.show.video.video_player import VideoWidget
-from frontengine.show.web.webview import WebWidget
-from frontengine.ui.main_ui import start_front_engine
-from frontengine.utils.multi_language.language_wrapper import language_wrapper
-from frontengine.ui.page.text.text_setting_ui import TextSettingUI
-from frontengine.ui.page.web.web_setting_ui import WEBSettingUI
-from frontengine.ui.page.gif.gif_setting_ui import GIFSettingUI
-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.scene_setting.scene_setting_ui import SceneSettingUI
-from frontengine.ui.main_ui import FrontEngineMainUI
-from frontengine.ui.main_ui import FrontEngine_EXTEND_TAB
-from frontengine.utils.redirect_manager.redirect_manager_class import RedirectManager
-
-__all__ = [
-    "start_front_engine", "GifWidget", "SoundPlayer", "SoundEffectWidget", "TextWidget",
-    "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"
-]
+from frontengine.show.gif.paint_gif import GifWidget
+from frontengine.show.image.paint_image import ImageWidget
+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
+from frontengine.ui.main_ui import start_front_engine
+from frontengine.utils.multi_language.language_wrapper import language_wrapper
+from frontengine.ui.page.text.text_setting_ui import TextSettingUI
+from frontengine.ui.page.web.web_setting_ui import WEBSettingUI
+from frontengine.ui.page.gif.gif_setting_ui import GIFSettingUI
+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
+from frontengine.utils.redirect_manager.redirect_manager_class import RedirectManager
+
+__all__ = [
+    "start_front_engine", "GifWidget", "SoundPlayer", "SoundEffectWidget", "TextWidget",
+    "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", "DesktopPetWidget", "PetSettingUI"
+]

frontengine-1.0.2/frontengine/__main__.py

@@ -0,0 +1,8 @@
+"""
+允許以 `python -m frontengine [--preset NAME] [--debug]` 啟動。
+Enable `python -m frontengine [--preset NAME] [--debug]`.
+"""
+from frontengine.ui.main_ui import main
+
+if __name__ == "__main__":
+    main()

frontengine-1.0.2/frontengine/show/base_widget.py

@@ -0,0 +1,47 @@
+from abc import abstractmethod
+
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QPainter
+from PySide6.QtWidgets import QWidget
+
+from frontengine.show.window_helpers import apply_overlay_window_flags, load_overlay_icon
+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
+
+        self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
+        self.setAttribute(Qt.WidgetAttribute.WA_TranslucentBackground)
+        load_overlay_icon(self)
+
+    def set_ui_window_flag(self, show_on_bottom: bool = False) -> None:
+        front_engine_logger.info(f"{self.__class__.__name__} set_ui_window_flag | show_on_bottom: {show_on_bottom}")
+        apply_overlay_window_flags(self, show_on_bottom=show_on_bottom)
+
+    def set_ui_variable(self, opacity: float = 0.2) -> None:
+        front_engine_logger.info(f"{self.__class__.__name__} set_ui_variable | opacity: {opacity}")
+        self.opacity = opacity
+
+    def paintEvent(self, event) -> None:
+        front_engine_logger.debug(f"{self.__class__.__name__} paintEvent | event: {event}")
+        painter = QPainter(self)
+        painter.save()
+        painter.setOpacity(self.opacity)
+        try:
+            self.draw_content(painter)
+        finally:
+            painter.restore()
+
+    @abstractmethod
+    def draw_content(self, painter: QPainter) -> None:
+        """Subclass hook that renders the widget content onto the shared painter."""

{frontengine-1.0.0 → frontengine-1.0.2}/frontengine/show/gif/paint_gif.py

@@ -1,47 +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
-        )
+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-1.0.0 → frontengine-1.0.2}/frontengine/show/image/paint_image.py

@@ -1,35 +1,51 @@
-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
-        )
+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 set_image_path(self, image_path: str) -> bool:
+        """
+        熱換顯示的圖片（用於輪播）。路徑無效時保持原圖並回傳 False。
+        Hot-swap the displayed image (used by the slideshow). Keeps the
+        current image and returns False when the path is invalid.
+        """
+        path = Path(image_path)
+        if not (path.exists() and path.is_file()):
+            front_engine_logger.warning(f"[ImageWidget] set_image_path skip invalid: {path}")
+            return False
+        self.image_path = path
+        self.image = QImage(str(path))
+        self.resize(self.image.size())
+        self.update()
+        return True
+
+    def draw_content(self, painter: QPainter) -> None:
+        painter.drawImage(
+            QRect(self.draw_location_x, self.draw_location_y, self.width(), self.height()),
+            self.image
+        )