gamekit2d 0.2.0__tar.gz → 0.3.2__tar.gz

{gamekit2d-0.2.0 → gamekit2d-0.3.2}/MANIFEST.in

@@ -7,3 +7,4 @@ include pyproject.toml
 recursive-include examples *.py
 recursive-include examples/assets *.png
 recursive-include tests *.py
+include TUTORIAL_zh.md

{gamekit2d-0.2.0 → gamekit2d-0.3.2}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: gamekit2d
-Version: 0.2.0
-Summary: A tiny zero-dependency 2D game library (standard library only, tkinter + winsound). A simpler pygame.
+Version: 0.3.2
+Summary: A tiny zero-dependency 2D game library (standard library only, self-made GDI renderer + tkinter + winsound). A simpler pygame.
 Author: gamekit contributors
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/your-name/gamekit
-Project-URL: Repository, https://github.com/your-name/gamekit
+Project-URL: Homepage, https://github.com/yuleemoon/gamekit2d
+Project-URL: Repository, https://github.com/yuleemoon/gamekit2d
 Keywords: game,2d,game-engine,tkinter,zero-dependency,pygame-alternative
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -28,10 +28,11 @@ Dynamic: license-file
 
 gamekit 的目标是：**让任何人用最少的代码，最快做出一个能玩的 2D 小游戏**。不需要懂窗口、事件循环、坐标系等底层细节，一个文件就能跑起一个完整游戏。
 
-- 🚫 **零依赖**：只用 Python 标准库（`tkinter` 渲染 / `winsound` 音频），装好 Python 就能跑
+- 🚫 **零依赖**：只用 Python 标准库（`tkinter` / 自研 GDI 渲染、`winsound` 音频），装好 Python 就能跑
+- ⚡ **可插拔渲染后端**：默认 Windows 上用**自研 GDI 内核**（同场景实测约为 tkinter 的 2~3.5 倍），其他平台自动回落 tkinter；一行 `Game(backend=...)` 切换
 - ✨ **极简 API**：`Game` 一个类搞定窗口、输入、精灵、碰撞、物理、音效、粒子、场景
 - 🎮 **功能齐全**：精灵 / 图像 / 动画 / 碰撞 / 重力 / 音效 / 文字 / 按钮 / 进度条 / 粒子 / 场景切换
-- 🪶 **轻量**：纯 Python 实现，核心约 2000 行，结构清晰可读
+- 🪶 **轻量**：纯 Python 实现（ctypes 直接调系统 GDI），核心约 2000 行，结构清晰可读
 
 ---
 
@@ -42,7 +43,7 @@ gamekit 的目标是：**让任何人用最少的代码，最快做出一个能
 把 `gamekit/` 目录放到你的项目旁边，然后直接 `import gamekit`：
 
 ```bash
-git clone https://github.com/your-name/gamekit.git
+git clone https://github.com/yuleemoon/gamekit2d.git
 cd gamekit
 python examples/01_hello.py          # 直接运行示例
 ```
@@ -50,11 +51,39 @@ python examples/01_hello.py          # 直接运行示例
 ### 方式二：pip 安装
 
 ```bash
-pip install gamekit
+pip install gamekit2d      # 安装名是 gamekit2d，import 仍是 import gamekit
 ```
 
 > 无论哪种方式都**不需要安装任何第三方包**。运行环境只需 Python 3.9+（Windows / Linux / macOS 均可，音频仅 Windows 支持，其他平台自动静默降级）。
 
+### 渲染后端
+
+`Game` 默认 `backend="auto"`：Windows 上自动使用**自研 GDI 高性能内核**（原生窗口 + BitBlt 双缓冲 + 矩形精灵 Surface 缓存，同尺寸同色精灵共享像素、每帧一次位块传送），其他平台自动回落 tkinter。也可显式指定：
+
+```python
+Game(..., backend="gdi")   # 强制 GDI（仅 Windows）
+Game(..., backend="tk")    # 强制 tkinter（跨平台保底）
+```
+
+同一套游戏代码不用改，切后端只改这一个参数。
+
+### 场景分组与脏矩形
+
+```python
+from gamekit import Group
+
+enemies = Group(*[game.sprite(color="red", x=i*40, y=80, width=28, height=28)
+                  for i in range(10)])
+
+@game.on_update
+def wave(dt):
+    enemies.move(0, 50 * dt)        # 整组移动
+```
+
+`Group` 是一组精灵的轻量容器：整组移动 / 隐藏 / 删除，不用自己写循环。精灵仍由 Game 统一渲染，Group 只做批量管理。
+
+`Game(..., dirty=True)` 开启**脏矩形局部更新**：不整屏清屏，只把上一帧真正移动过的精灵旧位置刷回背景色。实测：在"少量动态对象 + 静态背景"场景（菜单、UI、几个移动元素）与整屏清屏基本持平；**大量精灵同时移动时建议保持 `dirty=False`**（局部恢复比整屏 `memmove` 清屏更贵）。仅 GDI 后端有效。
+
 ---
 
 ## 快速上手
@@ -273,13 +302,14 @@ Key.A ~ Key.Z  /  Key.F1 ~ Key.F12
 gamekit/
 ├── gamekit/
 │   ├── core/        # 核心引擎：Game 主类、场景、事件、按键
+│   ├── render/      # 自研渲染层：Surface/Window（GDI 内核）+ 后端接口
 │   ├── sprites/     # 精灵、图像处理（自研缩放/旋转）、帧动画
 │   ├── physics/     # 碰撞检测（矩形/圆形）
 │   ├── audio/       # WAV 音效（winsound）
 │   ├── ui/          # 文字、按钮、进度条
 │   ├── fx/          # 粒子系统
 │   └── utils/       # 颜色、向量工具
-├── examples/        # 4 个完整示例 + 素材生成脚本
+├── examples/        # 5 个完整示例 + 素材生成脚本
 ├── tests/           # 单元测试 + GUI 冒烟测试
 ├── pyproject.toml   # 发布配置（零依赖）
 └── README.md
@@ -296,7 +326,7 @@ gamekit/
 | 音频 | 仅 `.wav`，仅 Windows，一次一个 | 标准库 `winsound` 的能力边界；其他平台自动静默 |
 | 图像格式 | PNG / GIF / PPM / BMP | 不支持 JPG（Tk 无解码器），可用 PNG 替代 |
 | 旋转/缩放 | 最近邻算法，大图较慢 | 适合 200×200 以下的小图，在加载时调用一次 |
-| 渲染性能 | 每帧全量重绘 | 适合教学、原型、小规模游戏；大量精灵（>500）会掉帧 |
+| 渲染性能 | GDI 后端约是 tkinter 的 2~3.5 倍；1000 个矩形精灵实测约 60~120 FPS（受机器负载影响） | 同场景实测（32×32 彩色矩形、640×400）：GDI 100 个 ≈ 300+ FPS、500 个 ≈ 100~190 FPS、2000 个 ≈ 60 FPS；tkinter 用于跨平台保底。基准见 `learn_pygame/bench_compare.py` |
 
 ---