gamekit2d 0.2.0__py3-none-any.whl

gamekit/__init__.py

@@ -0,0 +1,63 @@
+"""gamekit —— 一个零第三方依赖的极简 2D 游戏库。
+
+只使用 Python 标准库（tkinter + winsound），API 简单到极致：
+创建一个 ``Game``、创建几个 ``Sprite``、注册几个回调、``run()`` 一行开跑。
+
+快速上手：:
+
+    from gamekit import Game, Key
+
+    game = Game(title="我的第一个游戏", width=800, height=600, fps=60)
+
+    player = game.sprite(color="red", x=400, y=500, width=60, height=40)
+
+    @game.on_key(Key.LEFT)
+    def left():
+        player.vx = -300
+
+    @game.on_key(Key.RIGHT)
+    def right():
+        player.vx = 300
+
+    @game.on_key(Key.SPACE)
+    def stop():
+        player.vx = 0
+
+    game.run()
+"""
+
+from .core.game import Game
+from .core.scene import Scene
+from .core.keys import Key, normalize
+from .sprites.sprite import Sprite
+from .sprites.animation import Animation
+from .physics.collision import (rect_collide, circle_collide, point_in_rect,
+                                point_in_circle, distance, collides,
+                                pixel_collide)
+from .audio.sound import Sound
+from .ui.text import Text
+from .ui.widgets import Button, ProgressBar
+from .fx.particles import ParticleSystem
+from .fx.draw import Line, Polygon, Ellipse, Arc
+from .utils.color import (Color, to_color, mix, random_color,
+                          RED, GREEN, BLUE, YELLOW, ORANGE, PURPLE, PINK,
+                          CYAN, LIME, MAGENTA, BROWN, WHITE, BLACK, GRAY,
+                          LIGHT_GRAY, DARK_GRAY, NAVY)
+from .utils.vector import Vec2
+
+__version__ = "0.2.0"
+__all__ = [
+    "Game", "Scene", "Key", "normalize",
+    "Sprite", "Animation",
+    "rect_collide", "circle_collide", "point_in_rect", "point_in_circle",
+    "distance", "collides", "pixel_collide",
+    "Sound",
+    "Text", "Button", "ProgressBar",
+    "ParticleSystem",
+    "Line", "Polygon", "Ellipse", "Arc",
+    "Color", "to_color", "mix", "random_color",
+    "RED", "GREEN", "BLUE", "YELLOW", "ORANGE", "PURPLE", "PINK",
+    "CYAN", "LIME", "MAGENTA", "BROWN", "WHITE", "BLACK", "GRAY",
+    "LIGHT_GRAY", "DARK_GRAY", "NAVY",
+    "Vec2",
+]

gamekit/audio/__init__.py

@@ -0,0 +1 @@
+"""audio：WAV 音效与音乐（Windows winsound，零第三方依赖）。"""

gamekit/audio/sound.py

@@ -0,0 +1,69 @@
+"""音频模块：WAV 音效与背景音乐。
+
+实现说明（零第三方依赖）：
+- Windows 平台使用标准库 ``winsound`` 异步播放 WAV 文件
+- 其他平台（Linux / macOS）标准库没有音频播放能力，
+  ``Sound.play()`` 会打印提示并静默，不影响游戏逻辑运行
+
+限制：
+- 仅支持 ``.wav`` 文件（标准库只能解码 wav）
+- Windows 下一次只能播放一个音频（winsound 限制），
+  音乐与音效无法同时响，按需取舍
+"""
+
+import os
+import sys
+
+_WIN = sys.platform == "win32"
+if _WIN:
+    import winsound
+
+    _HAS_AUDIO = True
+else:
+    _HAS_AUDIO = False
+
+
+class Sound:
+    """一个 WAV 音频。
+
+    :param path: .wav 文件路径
+    :param volume: 音量 0.0 ~ 1.0（winsound 不支持调音量，仅作记录保留）
+    :param loop: 是否循环播放
+    """
+
+    def __init__(self, path, volume=1.0, loop=False):
+        if not os.path.exists(path):
+            raise FileNotFoundError("音频文件不存在: %s" % path)
+        if not path.lower().endswith(".wav"):
+            raise ValueError(
+                "gamekit 音频仅支持 .wav 文件（标准库能力限制），收到: %s" % path
+            )
+        self.path = path
+        self.volume = max(0.0, min(1.0, float(volume)))
+        self._looping = bool(loop)
+        self._playing = False
+
+    @property
+    def playing(self):
+        return self._playing
+
+    def play(self, loop=None):
+        """播放音频。``loop=True`` 循环播放，``loop=False`` 播放一次。"""
+        if not _HAS_AUDIO:
+            print("[gamekit] 当前平台不支持音频播放（仅 Windows 支持）: %s" % self.path)
+            return self
+        if loop is not None:
+            self._looping = bool(loop)
+        flags = winsound.SND_FILENAME | winsound.SND_ASYNC
+        if self._looping:
+            flags |= winsound.SND_LOOP
+        winsound.PlaySound(self.path, flags)
+        self._playing = True
+        return self
+
+    def stop(self):
+        """停止播放。"""
+        if _HAS_AUDIO:
+            winsound.PlaySound(None, winsound.SND_PURGE)
+        self._playing = False
+        return self

gamekit/core/__init__.py

@@ -0,0 +1 @@
+"""core：游戏引擎核心（Game 主类、场景管理、按键常量）。"""