pygamestudio 1.0.0.dev1__tar.gz → 1.0.0.dev2__tar.gz

{pygamestudio-1.0.0.dev1 → pygamestudio-1.0.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygamestudio
-Version: 1.0.0.dev1
+Version: 1.0.0.dev2
 Summary: Let's create pygame visually!
 Project-URL: Documentation, https://pygamestudio.com/tutorial/installation
 Project-URL: Homepage, https://pygamestudio.com
@@ -23,6 +23,7 @@ Requires-Python: >=3.9
 Requires-Dist: numpy>=1.26.0
 Requires-Dist: platformdirs>=3.5.1
 Requires-Dist: pygame-ce>=2.5.6
+Requires-Dist: pyinstaller>=6.18.0
 Requires-Dist: pyside6>=6.10.0
 Description-Content-Type: text/markdown
 
@@ -35,9 +36,11 @@ Description-Content-Type: text/markdown
     <img src="https://static.pepy.tech/personalized-badge/pygamestudio?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads" />
     <img src="https://img.shields.io/pypi/v/pygamestudio.svg?maxAge=86400">
     <img src="https://img.shields.io/badge/python-3-red.svg" />
-</div>
+    <br>
+    <br>
 
-<br>
+[README (简体中文)](https://github.com/pygamestudio/pygamestudio/blob/main/README_zh-CN.md)
+</div>
 
 **Pygame Studio** is a visual editor built specifically for **pygame-ce**, designed to help users create pygame-ce projects visually, making it easier for beginners, students, and hobby developers to get started with pygame development.
 
@@ -60,6 +63,12 @@ After installation, run the following command in your terminal to launch the edi
 pygamestudio
 ```
 
+You may also use the shortcut command:
+
+```bash
+pygs
+```
+
 If the Pygame Studio editor launches successfully, the installation is complete.
 
 <img src="https://i-blog.csdnimg.cn/direct/2824782c7b4d4f2fb9f5650bab6ce87e.png" width="600"/>
@@ -73,6 +82,7 @@ If the Pygame Studio editor launches successfully, the installation is complete.
 | PySide6 | >=6.10.0 | 
 | platformdirs | >=3.5.1 | 
 | numpy | >=1.26.0 | 
+| pyinstaller | >=6.18.0 |
 
 <br>
 
@@ -83,22 +93,28 @@ If the Pygame Studio editor launches successfully, the installation is complete.
 pygamestudio
 ```
 
+Or use the shortcut command:
+
+```bash
+pygs
+```
+
 <br>
 
 **2.** Click the "Create" button to create a new project.
 
-<img src="https://i-blog.csdnimg.cn/direct/a627d1820d3145dda30bbd7857fd17b3.png" width="600"/>
+<img src="https://i-blog.csdnimg.cn/direct/e60511fa4e344e1faf36fe41f160fa4e.png" width="600"/>
 
 
 Once created, the game project will be displayed in the Dashboard.
 
-<img src="https://i-blog.csdnimg.cn/direct/b1ef0d71e0f04265b1e77151032e7847.png" width="600"/>
+<img src="https://i-blog.csdnimg.cn/direct/167b961ee6c14c0e8ceccdaf81706f57.png" width="600"/>
 
 <br>
 
 **3.** Double-click the created project to open the editing window and start your creation.
 
-<img src="https://i-blog.csdnimg.cn/direct/72f5ae9b15694ffbac8b14db81223ca2.png" width="800"/>
+<img src="https://i-blog.csdnimg.cn/direct/28198f7ded9143f58f866c9a7e8d6dd2.png" width="800"/>
 
 <br>
 
@@ -107,6 +123,11 @@ Once created, the game project will be displayed in the Dashboard.
 
 <br>
 
+# Release Notes
+🔗 visit https://pygamestudio.com/updates_and_support/release_notes
+
+<br>
+
 # Key Features
 - **Open Source & Free Forever**: Released under the MIT LICENSE, free to use and modify for all purposes.
 - **Easy Installation**: Simply run `pip install pygamestudio` to install the editor.

{pygamestudio-1.0.0.dev1 → pygamestudio-1.0.0.dev2}/README.md

@@ -7,9 +7,11 @@
     <img src="https://static.pepy.tech/personalized-badge/pygamestudio?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads" />
     <img src="https://img.shields.io/pypi/v/pygamestudio.svg?maxAge=86400">
     <img src="https://img.shields.io/badge/python-3-red.svg" />
-</div>
+    <br>
+    <br>
 
-<br>
+[README (简体中文)](https://github.com/pygamestudio/pygamestudio/blob/main/README_zh-CN.md)
+</div>
 
 **Pygame Studio** is a visual editor built specifically for **pygame-ce**, designed to help users create pygame-ce projects visually, making it easier for beginners, students, and hobby developers to get started with pygame development.
 
@@ -32,6 +34,12 @@ After installation, run the following command in your terminal to launch the edi
 pygamestudio
 ```
 
+You may also use the shortcut command:
+
+```bash
+pygs
+```
+
 If the Pygame Studio editor launches successfully, the installation is complete.
 
 <img src="https://i-blog.csdnimg.cn/direct/2824782c7b4d4f2fb9f5650bab6ce87e.png" width="600"/>
@@ -45,6 +53,7 @@ If the Pygame Studio editor launches successfully, the installation is complete.
 | PySide6 | >=6.10.0 | 
 | platformdirs | >=3.5.1 | 
 | numpy | >=1.26.0 | 
+| pyinstaller | >=6.18.0 |
 
 <br>
 
@@ -55,22 +64,28 @@ If the Pygame Studio editor launches successfully, the installation is complete.
 pygamestudio
 ```
 
+Or use the shortcut command:
+
+```bash
+pygs
+```
+
 <br>
 
 **2.** Click the "Create" button to create a new project.
 
-<img src="https://i-blog.csdnimg.cn/direct/a627d1820d3145dda30bbd7857fd17b3.png" width="600"/>
+<img src="https://i-blog.csdnimg.cn/direct/e60511fa4e344e1faf36fe41f160fa4e.png" width="600"/>
 
 
 Once created, the game project will be displayed in the Dashboard.
 
-<img src="https://i-blog.csdnimg.cn/direct/b1ef0d71e0f04265b1e77151032e7847.png" width="600"/>
+<img src="https://i-blog.csdnimg.cn/direct/167b961ee6c14c0e8ceccdaf81706f57.png" width="600"/>
 
 <br>
 
 **3.** Double-click the created project to open the editing window and start your creation.
 
-<img src="https://i-blog.csdnimg.cn/direct/72f5ae9b15694ffbac8b14db81223ca2.png" width="800"/>
+<img src="https://i-blog.csdnimg.cn/direct/28198f7ded9143f58f866c9a7e8d6dd2.png" width="800"/>
 
 <br>
 
@@ -79,6 +94,11 @@ Once created, the game project will be displayed in the Dashboard.
 
 <br>
 
+# Release Notes
+🔗 visit https://pygamestudio.com/updates_and_support/release_notes
+
+<br>
+
 # Key Features
 - **Open Source & Free Forever**: Released under the MIT LICENSE, free to use and modify for all purposes.
 - **Easy Installation**: Simply run `pip install pygamestudio` to install the editor.

pygamestudio-1.0.0.dev2/README_zh-CN.md

@@ -0,0 +1,112 @@
+<div align="center"><img src="https://i-blog.csdnimg.cn/direct/ce0f186a9ade4295bfa9367ceecba0e2.png" width="300"></div>
+<div dir="auto" align="center">
+    <img src="https://img.shields.io/badge/Pygame Studio-Open Source-green.svg" />
+    <img src="https://img.shields.io/badge/For-pygame_ce-dark.svg" />
+    <img src="https://img.shields.io/badge/Language-Python-purple.svg" />
+    <img src="https://img.shields.io/badge/License-MIT-orange.svg" />
+    <img src="https://static.pepy.tech/personalized-badge/pygamestudio?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads" />
+    <img src="https://img.shields.io/pypi/v/pygamestudio.svg?maxAge=86400">
+    <img src="https://img.shields.io/badge/python-3-red.svg" />
+    <br>
+    <br>
+
+[README (English)](https://github.com/pygamestudio/pygamestudio)
+</div>
+
+**Pygame Studio** 是专为 **pygame-ce** 打造的可视化编辑器，支持以可视化方式制作 pygame-ce 项目，让编程新手、在校学生以及业余开发者都能更轻松地入门 Pygame 游戏开发。
+
+<br>
+
+# 安装教程
+你可以通过 pip 快速安装 Pygame Studio（请确保已安装 Python 3.9 及以上版本）：
+
+```bash
+pip install --upgrade pygamestudio
+```
+
+> **注意：** 当前版本均为开发测试版，请务必加上 --upgrade 参数，确保安装最新开发版，而非本地缓存的旧版本。
+
+<br>
+
+安装完成后，在终端执行以下命令即可启动编辑器，同时验证安装是否成功：
+
+```bash
+pygamestudio
+```
+
+也可以使用以下快捷命令：
+
+```bash
+pygs
+```
+
+若 Pygame Studio 编辑器成功显示，即代表安装成功。
+
+<img src="https://i-blog.csdnimg.cn/direct/2824782c7b4d4f2fb9f5650bab6ce87e.png" width="600"/>
+
+<br>
+
+# 依赖库
+| 库名称 | 要求版本 |
+|-----|-----|
+| pygame-ce | >=2.5.6 |
+| PySide6 | >=6.10.0 | 
+| platformdirs | >=3.5.1 | 
+| numpy | >=1.26.0 | 
+| pyinstaller | >=6.18.0 |
+
+<br>
+
+# 快速上手
+**1.** 输入以下命令启动 Pygame Studio：
+
+```bash
+pygamestudio
+```
+
+也可以使用以下快捷命令：
+
+```bash
+pygs
+```
+
+<br>
+
+**2.** 点击「创建」按钮新建项目。
+
+<img src="https://i-blog.csdnimg.cn/direct/e60511fa4e344e1faf36fe41f160fa4e.png" width="600"/>
+
+
+创建完成后，游戏项目会展示在项目面板中。
+
+<img src="https://i-blog.csdnimg.cn/direct/167b961ee6c14c0e8ceccdaf81706f57.png" width="600"/>
+
+<br>
+
+**3.** 双击已创建的项目，即可打开编辑窗口，开始你的游戏创作。
+
+<img src="https://i-blog.csdnimg.cn/direct/28198f7ded9143f58f866c9a7e8d6dd2.png" width="800"/>
+
+<br>
+
+# 在线文档
+🔗 请访问 https://pygamestudio.com
+
+<br>
+
+# 更新日志
+🔗 请访问 https://pygamestudio.com/updates_and_support/release_notes
+
+<br>
+
+# 核心特点
+- **永久开源免费**：基于 MIT 开源协议发布，可自由使用、二次修改。
+- **极简安装方式**：只需执行 `pip install pygamestudio` 即可完成安装。
+- **轻量跨平台**：启动速度快、无臃肿引擎，完美适配 Windows、macOS、Linux 三大系统。
+- **可视化拖拽编辑**：以可视化拖拽方式开发 pygame-ce 游戏项目。
+- **初学者友好**：非常适合 Python 初学者、学生和业余开发者学习与创作。
+
+<br>
+
+# 开源协议
+Pygame Studio 基于 MIT 开源协议。

{pygamestudio-1.0.0.dev1 → pygamestudio-1.0.0.dev2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pygamestudio"
-version = "1.0.0.dev1"
+version = "1.0.0.dev2"
 authors = [{ name="Louis Ren", email="louis@pygamestudio.com" }]
 description = "Let's create pygame visually!"
 readme = "README.md"
@@ -28,7 +28,8 @@ dependencies = [
     "pygame-ce>=2.5.6",
     "PySide6>=6.10.0",
     "platformdirs>=3.5.1",
-    "numpy>=1.26.0"
+    "numpy>=1.26.0",
+    "pyinstaller>=6.18.0"
 ]
 
 [project.urls]

{pygamestudio-1.0.0.dev1 → pygamestudio-1.0.0.dev2}/src/pygamestudio/api/runtime/scene.py

@@ -1,4 +1,5 @@
 import os
+import re
 import json
 import pygame
 from pathlib import Path
@@ -115,7 +116,48 @@ class SceneLoader:
 
         _update(self._all_object_tree_struct, screen_surface)
 
-    def _get_object_tree_struct(self, object_uuid, parent_object_tree_struct=None):
+    def _get_object_tree_struct_by_path(self, object_path):
+        def _get(name, target_item_index, current_item_index, recursion_time, part_number, object_tree_struct):
+            key = list(object_tree_struct.keys())[0]
+            value = list(object_tree_struct.values())[0]
+        
+            if part_number < recursion_time:
+                return None
+            elif part_number == recursion_time:
+                if name == value['object'].name and target_item_index == current_item_index:
+                    return {key: value}
+                else:
+                    return None
+            else:
+                recursion_time += 1
+                for i, child_object_tree_struct in enumerate(value['children']):
+                    result = _get(name, target_item_index, i, recursion_time, part_number, child_object_tree_struct)
+                    if result:
+                        return result
+                
+            return None
+
+        path_parts = object_path.strip('/').split('/')
+        if not path_parts:
+            return None
+        
+        for i, part in enumerate(path_parts):
+            match = re.fullmatch(r'([^\[\]]+)(?:\[(\d+)\])?', part.strip())
+            if not match:
+                return None
+            
+            recursion_time = 0
+            name = match.group(1)
+            target_item_index = int(match.group(2)) if match.group(2) is not None else 0
+            object_tree_struct = _get(name, target_item_index, 0, recursion_time, i, self._all_object_tree_struct)
+
+            if i < len(path_parts)-1:
+                if object_tree_struct == None:
+                    return None
+            else:
+                return object_tree_struct
+        
+    def _get_object_tree_struct_by_uuid(self, object_uuid, parent_object_tree_struct=None):
         def _get(object_uuid, object_tree_struct):
             key = list(object_tree_struct.keys())[0]
             value = list(object_tree_struct.values())[0]
@@ -134,15 +176,13 @@ class SceneLoader:
         return _get(object_uuid, parent_object_tree_struct)
     
     def get_object_by_path(self, object_path:str):
-        ...
-
+        object_tree_struct = self._get_object_tree_struct_by_path(object_path)
+        return list(object_tree_struct.values())[0]['object'] if object_tree_struct else None
+    
     def get_object_by_uuid(self, object_uuid:str):
-        object_tree_struct = self._get_object_tree_struct(object_uuid)
+        object_tree_struct = self._get_object_tree_struct_by_uuid(object_uuid)
         return object_tree_struct[object_uuid]['object'] if object_tree_struct else None
-
-    def get_object_by_name(self, object_name:str):
-        ...
-
+    
 
 scene_loader = SceneLoader()
 
@@ -153,7 +193,4 @@ def get_object_by_path(object_path:str) -> object:
     return scene_loader.get_object_by_path(object_path)
 
 def get_object_by_uuid(object_uuid:str) -> object:
-    return scene_loader.get_object_by_uuid(object_uuid)
-
-def get_object_by_name(object_name:str) -> object:
-    return scene_loader.get_object_by_name(object_name)
+    return scene_loader.get_object_by_uuid(object_uuid)

{pygamestudio-1.0.0.dev1 → pygamestudio-1.0.0.dev2}/src/pygamestudio/common/i18n/languages/en.json

@@ -13,6 +13,8 @@
         "question_delete_hierarchy_item_content": "Sure to delete the selected item(s)?",
         "question_delete_project_content": "Sure to delete the project?",
         "question_overwrite_content": "Sure to overwrite the following duplicate resources?\n{}",
+        "question_stop_build": "Sure to stop the building?",
+        "question_stop_build_close_window": "Sure to stop the building and close the window?",
         "information_title": "Info",
         "information_os_content": "Unsupported Operating System",
         "critical_title": "Error",
@@ -24,6 +26,12 @@
         "critical_rename_content": "Failed to rename: {}",
         "critical_open_project": "Failed to open the project. Couldn't find project.pygs.",
         "critical_find_project": "Couldn't find the project.",
+        "critical_delete_project": "Couldn't delete the project: {}",
+        "critical_main_not_found": "main.py is not found. Please make sure main.py is in the project root directory.",
+        "critical_app_icon_not_exist": "App icon not exist",
+        "critical_no_output_dir": "Please choose the output dir",
+        "critical_output_dir_not_exist": "Output dir does not exist",
+        "critical_fail_to_build": "Failed to build the project. Please check the log.",
         "to_be_released": "To be released!"
     },
 
@@ -70,7 +78,8 @@
         "documentation": "Documentation",
         "release_notes": "Release Notes",
         "github_repository": "Github Repository",
-        "about_pygamestudio": "About Pygame Stuido"
+        "about_pygamestudio": "About Pygame Studio",
+        "support_pygamestudio": "Support Pygame Studio"
     },
 
     "item": {
@@ -177,5 +186,21 @@
 
     "about": {
         "version": "Version {}"
+    },
+
+    "build": {
+        "app_name": "App Name",
+        "app_name_placeholder": "Please enter the app name",
+        "app_icon": "App Icon",
+        "app_icon_placeholder": "Please choose the app icon (.png/.ico/.icns)",
+        "output_dir": "Output Dir",
+        "output_dir_placeholder": "Please choose the output dir",
+        "clean_cache": "Clean Cache",
+        "build": "Build",
+        "open_output_dir": "Open Output Dir",
+        "desktop_app": "Desktop App",
+        "stop": "Stop",
+        "select_app_icon": "Select App Icon",
+        "select_output_dir": "Select Output Dir"
     }
 }

{pygamestudio-1.0.0.dev1 → pygamestudio-1.0.0.dev2}/src/pygamestudio/common/i18n/languages/zh_CN.json

@@ -13,6 +13,8 @@
         "question_delete_hierarchy_item_content": "是否删除选中的对象？",
         "question_delete_project_content": "是否删除该项目？",
         "question_overwrite_content": "是否覆盖以下重复资源？\n{}",
+        "question_stop_build": "是否停止打包？",
+        "question_stop_build_close_window": "是否停止打包并关闭窗口？",
         "information_title": "提示",
         "information_os_content": "不支持的操作系统",
         "critical_title": "错误",
@@ -24,6 +26,12 @@
         "critical_rename_content": "重命名失败：{}",
         "critical_open_project": "打开项目失败，找不到project.pygs。",
         "critical_find_project": "找不到该项目。",
+        "critical_delete_project": "无法删除项目：{}",
+        "critical_app_icon_not_exist": "图标文件不存在",
+        "critical_no_output_dir": "请选择输出目录",
+        "critical_output_dir_not_exist": "输出目录不存在",
+        "critical_main_not_found": "没有找到main.py，请确保main.py位于项目根目录下。",
+        "critical_fail_to_build": "项目打包失败，请检查日志。",
         "to_be_released": "即将发布，敬请期待！"
     },
 
@@ -66,11 +74,12 @@
         "undo": "撤销",
         "redo": "重做",
         "run": "运行",
-        "build": "构建",
+        "build": "打包",
         "documentation": "在线文档",
         "release_notes": "更新日志",
         "github_repository": "GitHub仓库",
-        "about_pygamestudio": "关于Pygame Studio"
+        "about_pygamestudio": "关于Pygame Studio",
+        "support_pygamestudio": "支持Pygame Studio"
     },
 
     "item": {
@@ -177,5 +186,21 @@
 
     "about": {
         "version": "版本{}"
+    },
+
+    "build": {
+        "app_name": "应用名称",
+        "app_name_placeholder": "请输入应用名称",
+        "app_icon": "应用图标",
+        "app_icon_placeholder": "请选择应用图标 (.png/.ico/.icns)",
+        "output_dir": "输出目录",
+        "output_dir_placeholder": "请选择输出目录",
+        "clean_cache": "清除缓存",
+        "build": "打包",
+        "open_output_dir": "打开输出目录",
+        "desktop_app": "桌面应用",
+        "stop": "停止",
+        "select_app_icon": "选择应用图标",
+        "select_output_dir": "选择输出目录"
     }
 }

{pygamestudio-1.0.0.dev1 → pygamestudio-1.0.0.dev2}/src/pygamestudio/common/res/qss/dark.qss

@@ -120,6 +120,19 @@ QComboBox::down-arrow {
     height: 10px;
 }
 
+QComboBox QAbstractItemView {
+    background-color: #1e1e1e;
+    color: #cccccc;
+    border: 1px solid #3c3c3c;
+    selection-background-color: #007acc;
+    selection-color: #ffffff;
+    outline: 0px;
+}
+
+QComboBox QAbstractItemView::item:selected {
+    background-color: #007acc;
+}
+
 QMenu {
     background-color: #1e1e1e;
     color: #cccccc;
@@ -128,7 +141,7 @@ QMenu {
 }
 
 QMenu::item {
-    padding: 5px 30px 5px 30px;
+    padding: 5px 20px 5px 20px;
     border: 1px solid transparent;
 }
 
@@ -141,6 +154,11 @@ QMenu::item:selected {
     color: #ffffff;
 }
 
+QMenu::icon {
+    position: relative;
+    left: 15px;
+}
+
 QMenu::separator {
     height: 1px;
     background-color: #3c3c3c;
@@ -322,6 +340,21 @@ QListWidget::item {
     height: 30px;
 }
 
+QProgressBar {
+    border: 1px solid lightgray;
+    border-radius: 3px;
+    text-align: center;
+    background-color: qlineargradient(x1:1, y1:0, x2:1, y2:0.4, stop:0 white, stop:1 #dedede);
+    color: #1e1e1e;
+    font-weight: bold;
+    height: 10px;
+}
+
+QProgressBar::chunk {
+    background-color: qlineargradient(x1:1, y1:0, x2:1, y2:0.4, stop:0 white, stop:1 #007acc);
+    border-radius： 2px;
+}
+
 /* ----- Window Base ----- */
 QWidget#windowBaseCentralWidget {
     border-radius: 9px;
@@ -484,6 +517,10 @@ QWidget#inspector QPushButton:pressed {
     border-radius: 5px;
 }
 
+QWidget#inspectorContainer QLineEdit:disabled {
+    color: gray;
+}
+
 QWidget#inspectorContainer QLabel {
     background-color: #282828;
 }

{pygamestudio-1.0.0.dev1 → pygamestudio-1.0.0.dev2}/src/pygamestudio/common/res/resources.qrc

@@ -2,6 +2,7 @@
     <qresource prefix="/">
         <file>images/add_item.png</file>
         <file>images/add.png</file>
+        <file>images/browse.png</file>
         <file>images/canvas.png</file>
         <file>images/check.png</file>
         <file>images/clear.png</file>
@@ -14,11 +15,14 @@
         <file>images/eye_closed.png</file>
         <file>images/eye_off.png</file>
         <file>images/eye_open.png</file>
+        <file>images/heart.png</file>
         <file>images/import_project.png</file>
         <file>images/info.png</file>
         <file>images/left_arrow.png</file>
+        <file>images/line.png</file>
         <file>images/logo.png</file>
         <file>images/maximize.png</file>
+        <file>images/maximize_disabled.png</file>
         <file>images/minimize.png</file>
         <file>images/normalize.png</file>
         <file>images/project_icon.png</file>