gamekit2d 0.3.2__tar.gz → 0.3.4__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gamekit2d
-Version: 0.3.2
+Version: 0.3.4
 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
@@ -82,7 +82,14 @@ def wave(dt):
 
 `Group` 是一组精灵的轻量容器：整组移动 / 隐藏 / 删除，不用自己写循环。精灵仍由 Game 统一渲染，Group 只做批量管理。
 
-`Game(..., dirty=True)` 开启**脏矩形局部更新**：不整屏清屏，只把上一帧真正移动过的精灵旧位置刷回背景色。实测：在"少量动态对象 + 静态背景"场景（菜单、UI、几个移动元素）与整屏清屏基本持平；**大量精灵同时移动时建议保持 `dirty=False`**（局部恢复比整屏 `memmove` 清屏更贵）。仅 GDI 后端有效。
+`Game(..., dirty=True)` 开启**脏矩形局部更新**：不整屏清屏，只把上一帧移动过的精灵旧位置刷回背景。配合 `game.sprite(..., static=True)` 标记静态元素（墙壁、砖块、UI 装饰）——它们只在第一帧画进后台缓冲，之后只要没被移动精灵压过就不再重画。
+
+**实测结论（务必按场景选择）**：
+- **适合**：少量动态元素 + 小范围移动（菜单光标、弹窗、射击子弹）——此时比整屏清屏快
+- **别开**：大量精灵同时移动、或动态精灵横穿大半个屏幕——脏区会波及大量静态精灵，"恢复背景 + 重画被压静态 + Python 层相交计算"的综合开销比直接全画还高 20~30%
+- 不确定就保持默认 `dirty=False`，整屏清屏用字节模板 `memmove`，1MB 只要 ~0.1ms，已经足够快
+
+仅 GDI 后端有效。
 
 ---
 
@@ -120,6 +127,42 @@ game.run()
 
 ---
 
+## Camera 相机 + 视口裁剪
+
+大地图卷轴游戏必备，把世界坐标和屏幕坐标分开：
+
+```python
+game.camera_x = 1200   # 世界坐标左上角对应屏幕 (0,0)
+game.camera_y = 400
+```
+
+设置后所有精灵绘制自动按偏移转换，**完全在屏幕外的精灵直接跳过不画**。4000 个精灵分布在 3200×2400 大地图、相机扫过只画屏幕内几十个，实测 **190 FPS**（对比全画 38 FPS，5 倍提升）——这才是大地图性能的真正解法。
+
+## Tilemap 关卡
+
+从字符串数组快速铺一整关（打砖块 / 平台游戏）：
+
+```python
+MAP = [
+    "##########",
+    "#........#",
+    "#..SS....#",
+    "##########",
+]
+game.tilemap(MAP, tile_size=32,
+             tile_defs={"#": "#4488ff", "S": "#ff4444"})
+```
+
+未在 `tile_defs` 里的字符（如 `.`）视为空气。生成的瓦片自动 `static=True`，配合 camera 只画屏幕内。
+
+## 跨平台音频
+
+- Windows：标准库 `winsound` 播放 WAV
+- macOS / Linux：自动调系统播放器（`afplay` / `paplay` / `aplay`），不装第三方包
+- 探测不到播放器时静默降级，游戏不崩
+
+---
+
 ## 功能总览
 
 | 功能 | 说明 | 快速示例 |