qgame 1.0.0__py3-none-any.whl

qgame/__init__.py

@@ -0,0 +1,57 @@
+try:
+    from .core import init, set_settings, Window, Events, Clock, EventType
+    from .input import Keys, Keyboard, Mouse, MouseButtons
+    from .collision import Collision
+    from .audio import Sound, Music
+    from .graphics import Image, Draw, Rect
+    from .camera import Camera
+    from .animation import (
+        add_file_path, image_show, animation_start, animation_stop,
+        set_animation_frame, set_animation_speed, animation_reverse,
+        animation_reverse_back, AnimationStatus
+    )
+    from .animation_sprite import AnimationSprite, AnimationBackground
+    from .ui import TextBox
+    from .scene import Scene, SceneManager
+    from .spritesheet import Spritesheet
+except ImportError:
+    from core import init, set_settings, Window, Events, Clock, EventType
+    from input import Keys, Keyboard, Mouse, MouseButtons
+    from collision import Collision
+    from audio import Sound, Music
+    from graphics import Image, Draw, Rect
+    from camera import Camera
+    from animation import (
+        add_file_path, image_show, animation_start, animation_stop,
+        set_animation_frame, set_animation_speed, animation_reverse,
+        animation_reverse_back, AnimationStatus
+    )
+    from animation_sprite import AnimationSprite, AnimationBackground
+    from ui import TextBox
+    from scene import Scene, SceneManager
+    from spritesheet import Spritesheet
+
+# 接口全局实例映射
+window = Window()
+events = Events()
+eventType = EventType
+draw = Draw()
+keys = Keys()
+keyboard = Keyboard()
+mouse = Mouse()
+mouseButtons = MouseButtons
+collision = Collision()
+scene_manager = SceneManager # 实例化映射 alias 方便小写调用
+
+__author__ = "WatermelonCode"
+___version__ = "1.0.0"
+
+__all__ = [
+    'init', 'set_settings', 'window', 'events', 'draw', 'keys', 'keyboard', 
+    'mouse', 'mouseButtons', 'collision', 'Clock', 'EventType',
+    'Image', 'Draw', 'Rect', 'Sound', 'Music',
+    'Camera', 'add_file_path', 'image_show', 'animation_start', 'animation_stop',
+    'set_animation_frame', 'set_animation_speed', 'animation_reverse', 
+    'animation_reverse_back', 'AnimationStatus', 'AnimationSprite', 'AnimationBackground',
+    'TextBox', 'Scene', 'SceneManager', 'scene_manager', 'Spritesheet'
+]

qgame/__main__.py

@@ -0,0 +1,566 @@
+import sys
+import os
+
+# ==================== 智能路径自适应寻轨 ====================
+current_dir = os.path.dirname(os.path.abspath(__file__))  
+parent_dir = os.path.dirname(current_dir)                 
+
+if parent_dir not in sys.path:
+    sys.path.insert(0, parent_dir)
+if os.getcwd() not in sys.path:
+    sys.path.append(os.getcwd())
+
+import qgame
+# ===========================================================
+
+import math
+import random
+import json
+
+# 定位包内内置的 examples 物理资源路径
+EXAMPLES_DIR = os.path.join(current_dir, "examples")
+PLAYER_IMG_PATH = os.path.join(EXAMPLES_DIR, "player.png")
+SOUND_WAV_PATH = os.path.join(EXAMPLES_DIR, "sound.wav")
+MUSIC_MP3_PATH = os.path.join(EXAMPLES_DIR, "music.mp3")
+
+# ==================== 示例 1：Delta Time 与图像旋转镜像 ====================
+def run_delta_time_demo():
+    qgame.init()
+    canvas = qgame.set_settings(width=800, height=600, title="Delta Time 与图像旋转镜像")
+    clock = qgame.Clock()
+
+    player_img = None
+    if os.path.exists(PLAYER_IMG_PATH):
+        player_img = qgame.Image(PLAYER_IMG_PATH)
+    else:
+        print(f"[警告] 未在 {PLAYER_IMG_PATH} 找到 player.png")
+
+    rect_x = 100.0
+    speed_per_second = 300.0
+    running = True
+    angle = 0
+
+    while running:
+        dt = clock.tick(60)
+        fps = 1.0 / dt if dt > 0 else 0
+
+        for event in qgame.events.get():
+            if event.type == qgame.eventType.QUIT:
+                running = False
+            elif event.type == qgame.eventType.KEY_DOWN:
+                if event.key == qgame.keys.ESCAPE:
+                    running = False
+                if event.key == qgame.keys.F11:
+                    qgame.window.toggle_fullscreen()
+                if event.key == qgame.keys.F and player_img:
+                    player_img.flip(horizontal=True, vertical=False)
+                if event.key == qgame.keys.G and player_img:
+                    player_img.flip(horizontal=False, vertical=True)
+                if event.key == qgame.keys.H and player_img:
+                    player_img.reset()
+                    player_img.resize(100, 100)
+
+        rect_x += speed_per_second * dt
+        if rect_x > 800:
+            rect_x = -100
+
+        if player_img:
+            player_img.reset()
+            player_img.resize(100, 100)
+            angle = (angle + 100) % 360
+            player_img.rotate(angle)
+
+        qgame.draw.fill(canvas, (30, 30, 30))
+        qgame.draw.rect(canvas, (0, 180, 255), (int(rect_x), 300, 100, 50))
+        qgame.draw.text(canvas, "Smooth Speed Box", (int(rect_x), 275), size=12)
+
+        if player_img:
+            qgame.draw.image(canvas, player_img, (350, 100), center=True)
+            qgame.draw.text(canvas, "Press [F]: Flip H  [G]: Flip V  [H]: Reset", (220, 220), size=14)
+
+        qgame.draw.text(canvas, f"Delta Time: {dt:.4f}s  |  FPS: {fps:.1f}", (50, 480), size=16, color=(100, 255, 100))
+        qgame.window.update()
+
+# ==================== 示例 2：裁剪、不透明度、全屏和隐藏鼠标 ====================
+def run_clipping_demo():
+    qgame.init()
+    canvas = qgame.set_settings(width=800, height=600, title="不透明度与图像裁剪")
+    clock = qgame.Clock()
+
+    player_img = None
+    if os.path.exists(PLAYER_IMG_PATH):
+        player_img = qgame.Image(PLAYER_IMG_PATH)
+
+    cursor_visible = True
+    opacity_timer = 0.0
+    running = True
+
+    while running:
+        dt = clock.tick(60)
+        for event in qgame.events.get():
+            if event.type == qgame.eventType.QUIT:
+                running = False
+            elif event.type == qgame.eventType.KEY_DOWN:
+                if event.key == qgame.keys.ESCAPE:
+                    running = False
+                if event.key == qgame.keys.F11:
+                    qgame.window.toggle_fullscreen()
+                if event.key == qgame.keys.M:
+                    cursor_visible = not cursor_visible
+                    qgame.window.show_cursor(cursor_visible)
+
+        qgame.draw.fill(canvas, (20, 24, 30))
+        if player_img:
+            opacity_timer += dt * 2.0
+            current_opacity = 0.5 + 0.5 * math.sin(opacity_timer)
+            qgame.draw.image(canvas, player_img, (200, 300), center=True, opacity=current_opacity)
+            
+            crop_rect = (0, 0, min(50, player_img.width), min(50, player_img.height))
+            qgame.draw.image(canvas, player_img, (600, 300), center=True, src_rect=crop_rect)
+
+        qgame.draw.text(canvas, "F11: Fullscreen  |  M: Toggle Cursor  |  Esc: Back", (50, 50), size=18)
+        qgame.window.update()
+
+# ==================== 示例 3：场景管理与UI自动销毁 ====================
+class MenuScene(qgame.Scene):
+    def on_enter(self, *args, **kwargs):
+        super().on_enter()
+        self.input_box = self.add_ui(
+            qgame.TextBox(200, 180, 400, 150, placeholder="写下你的勇者名字...", multi_line=True)
+        )
+        self.input_box.set_theme(bg_color=(35, 35, 45), text_color=(255, 255, 0), border_color=(0, 255, 120))
+        self.button_rect = (300, 380, 200, 50)
+
+    def handle_event(self, event):
+        if event.type == qgame.eventType.MOUSE_BUTTON_DOWN:
+            if event.button == qgame.mouseButtons.LEFT:
+                if qgame.collision.check_point_rect(event.pos, self.button_rect):
+                    name = self.input_box.get_text().strip() or "神秘勇者"
+                    qgame.scene_manager.switch(PlayScene(), player_name=name)
+
+    def draw(self, canvas):
+        qgame.draw.fill(canvas, (24, 28, 38))
+        qgame.draw.text(canvas, "勇者传说 - 主菜单", (280, 100), size=28, color=(255, 255, 255))
+        
+        m_pos = qgame.mouse.get_pos()
+        hover = qgame.collision.check_point_rect(m_pos, self.button_rect)
+        btn_color = (0, 255, 120) if hover else (0, 180, 90)
+        
+        qgame.draw.rect(canvas, btn_color, self.button_rect, width=0)
+        qgame.draw.text(canvas, "开始游戏", (360, 393), size=18, color=(0, 0, 0))
+
+class PlayScene(qgame.Scene):
+    def on_enter(self, *args, **kwargs):
+        super().on_enter()
+        self.player_name = kwargs.get("player_name", "神秘人")
+        self.px, self.py = 400.0, 300.0
+        self.speed = 250.0
+
+    def handle_event(self, event):
+        if event.type == qgame.eventType.KEY_DOWN:
+            if event.key == qgame.keys.ESCAPE:
+                qgame.scene_manager.switch(MenuScene())
+
+    def update(self, dt):
+        if qgame.keyboard.is_pressed(qgame.keys.W) or qgame.keyboard.is_pressed(qgame.keys.UP):
+            self.py -= self.speed * dt
+        if qgame.keyboard.is_pressed(qgame.keys.S) or qgame.keyboard.is_pressed(qgame.keys.DOWN):
+            self.py += self.speed * dt
+        if qgame.keyboard.is_pressed(qgame.keys.A) or qgame.keyboard.is_pressed(qgame.keys.LEFT):
+            self.px -= self.speed * dt
+        if qgame.keyboard.is_pressed(qgame.keys.D) or qgame.keyboard.is_pressed(qgame.keys.RIGHT):
+            self.px += self.speed * dt
+
+    def draw(self, canvas):
+        qgame.draw.fill(canvas, (10, 40, 30))
+        qgame.draw.text(canvas, f"当前勇者: {self.player_name}", (20, 20), size=16, color=(255, 255, 255))
+        qgame.draw.text(canvas, "操作: WASD/方向键移动，按 Esc 键返回主菜单", (20, 50), size=14, color=(200, 200, 200))
+        qgame.draw.rect(canvas, (0, 255, 200), (int(self.px) - 25, int(self.py) - 25, 50, 50))
+
+def run_scene_demo():
+    qgame.init()
+    canvas = qgame.set_settings(width=800, height=600, title="qgame 场景管理系统测试")
+    clock = qgame.Clock()
+
+    qgame.scene_manager.switch(MenuScene())
+    running = True
+    while running:
+        dt = clock.tick(60)
+        for event in qgame.events.get():
+            if event.type == qgame.eventType.QUIT:
+                running = False
+            if event.type == qgame.eventType.KEY_DOWN:
+                if event.key == qgame.keys.F11:
+                    qgame.window.toggle_fullscreen()
+            qgame.scene_manager.handle_event(event)
+
+        qgame.scene_manager.update(dt)
+        qgame.scene_manager.draw(canvas)
+        qgame.window.update()
+
+# ==================== 示例 4：高级摄像机追踪测试 ====================
+def run_camera_demo():
+    qgame.init()
+    canvas = qgame.set_settings(width=800, height=600, title="qgame 2D 摄像机平滑缓冲示范")
+    clock = qgame.Clock()
+
+    WORLD_WIDTH, WORLD_HEIGHT = 2000, 2000
+    camera = qgame.Camera(800, 600)
+    camera.set_bounds(0, 0, WORLD_WIDTH, WORLD_HEIGHT)
+    camera.set_deadzone(120, 100)
+
+    class Player:
+        def __init__(self):
+            self.x, self.y = 1000.0, 1000.0
+            self.width, self.height = 40, 40
+            self.speed = 400.0
+    
+    player = Player()
+    camera.follow(player, lerp_speed=4.5)
+
+    stars = []
+    for _ in range(120):
+        stars.append((
+            random.randint(10, WORLD_WIDTH - 20),
+            random.randint(10, WORLD_HEIGHT - 20),
+            (random.randint(180, 255), random.randint(180, 255), random.randint(0, 100))
+        ))
+
+    running, show_debug = True, True
+    while running:
+        dt = clock.tick(60)
+        for event in qgame.events.get():
+            if event.type == qgame.eventType.QUIT:
+                running = False
+            elif event.type == qgame.eventType.KEY_DOWN:
+                if event.key == qgame.keys.ESCAPE:
+                    running = False
+                elif event.key == qgame.keys.SPACE:
+                    camera.shake(intensity=18.0, duration=0.4)
+                elif event.key == qgame.keys.F3:
+                    show_debug = not show_debug
+                elif event.key == qgame.keys.F11:
+                    qgame.window.toggle_fullscreen()
+
+        dx, dy = 0.0, 0.0
+        if qgame.keyboard.is_pressed(qgame.keys.W) or qgame.keyboard.is_pressed(qgame.keys.UP):
+            dy -= player.speed * dt
+        if qgame.keyboard.is_pressed(qgame.keys.S) or qgame.keyboard.is_pressed(qgame.keys.DOWN):
+            dy += player.speed * dt
+        if qgame.keyboard.is_pressed(qgame.keys.A) or qgame.keyboard.is_pressed(qgame.keys.LEFT):
+            dx -= player.speed * dt
+        if qgame.keyboard.is_pressed(qgame.keys.D) or qgame.keyboard.is_pressed(qgame.keys.RIGHT):
+            dx += player.speed * dt
+
+        player.x += dx
+        player.y += dy
+
+        old_x, old_y = player.x, player.y
+        player.x = max(0.0, min(player.x, WORLD_WIDTH - player.width))
+        player.y = max(0.0, min(player.y, WORLD_HEIGHT - player.height))
+        if (player.x != old_x or player.y != old_y) and (dx != 0.0 or dy != 0.0):
+            camera.shake(intensity=3.0, duration=0.15)
+
+        camera.update(dt)
+
+        qgame.draw.fill(canvas, (20, 20, 25))
+        map_rect = camera.apply((0, 0, WORLD_WIDTH, WORLD_HEIGHT))
+        qgame.draw.rect(canvas, (40, 45, 60), map_rect, width=2)
+
+        for star in stars:
+            screen_pos = camera.apply((star[0], star[1]))
+            if 0 <= screen_pos[0] <= 800 and 0 <= screen_pos[1] <= 600:
+                qgame.draw.rect(canvas, star[2], (screen_pos[0], screen_pos[1], 8, 8), width=0)
+
+        p_screen_rect = camera.apply((player.x, player.y, player.width, player.height))
+        qgame.draw.rect(canvas, (0, 255, 120), p_screen_rect, width=0)
+        qgame.draw.rect(canvas, (255, 255, 255), p_screen_rect, width=2)
+
+        if show_debug:
+            dz_rect = (int(400 - camera.deadzone_width / 2),
+                       int(300 - camera.deadzone_height / 2),
+                       int(camera.deadzone_width),
+                       int(camera.deadzone_height))
+            qgame.draw.rect(canvas, (255, 200, 50), dz_rect, width=1)
+
+        qgame.draw.text(canvas, f"Coordinate: ({int(player.x)}, {int(player.y)})", (20, 20), size=16)
+        qgame.draw.text(canvas, "WASD: Move  |  Space: Shake Screen  |  Esc: Back", (20, 550), size=14)
+        qgame.window.update()
+
+# ==================== 示例 5：合图与网格切图测试 ====================
+def run_spritesheet_demo():
+    from PySide6.QtGui import QPainter, QColor, QImage
+    img_path = "temp_test_spritesheet.png"
+    json_path = "temp_test_atlas.json"
+
+    # 生成测试图
+    temp_img = QImage(128, 128, QImage.Format.Format_ARGB32)
+    p = QPainter(temp_img)
+    p.fillRect(0, 0, 64, 64, QColor(255, 50, 50))
+    p.fillRect(64, 0, 64, 64, QColor(50, 255, 50))
+    p.fillRect(0, 64, 64, 64, QColor(50, 50, 255))
+    p.fillRect(64, 64, 64, 64, QColor(255, 255, 50))
+    p.end()
+    temp_img.save(img_path)
+
+    with open(json_path, 'w', encoding='utf-8') as f:
+        json.dump({
+            "frames": {
+                "red_block.png": {"frame": {"x": 0, "y": 0, "w": 64, "h": 64}},
+                "green_block.png": {"frame": {"x": 64, "y": 0, "w": 64, "h": 64}},
+                "blue_block.png": {"frame": {"x": 0, "y": 64, "w": 64, "h": 64}},
+                "yellow_block.png": {"frame": {"x": 64, "y": 64, "w": 64, "h": 64}}
+            }
+        }, f)
+
+    qgame.init()
+    canvas = qgame.set_settings(width=800, height=600, title="雪碧图与合图解析器演示")
+    clock = qgame.Clock()
+
+    sheet = qgame.Spritesheet(img_path)
+    tiles = sheet.parse_grid(tile_width=64, tile_height=64)
+    atlas = sheet.parse_atlas(json_path)
+
+    running = True
+    while running:
+        clock.tick(60)
+        for event in qgame.events.get():
+            if event.type == qgame.eventType.QUIT:
+                running = False
+            if event.type == qgame.eventType.KEY_DOWN and event.key == qgame.keys.ESCAPE:
+                running = False
+
+        qgame.draw.fill(canvas, (30, 30, 30))
+        qgame.draw.text(canvas, "Spritesheet / Texture Atlas 成果展示", (50, 40), size=22)
+        
+        qgame.draw.text(canvas, "1. 顺序网格切割渲染 (parse_grid):", (50, 100), size=14, color=(200, 200, 200))
+        for idx, tile_image in enumerate(tiles):
+            qgame.draw.image(canvas, tile_image, (50 + idx * 80, 130))
+
+        qgame.draw.text(canvas, "2. 配置文件字典直接提取 (parse_atlas):", (50, 280), size=14, color=(200, 200, 200))
+        qgame.draw.image(canvas, atlas["blue_block.png"], (50, 310))
+        qgame.draw.image(canvas, atlas["yellow_block.png"], (180, 310))
+        qgame.draw.image(canvas, atlas["red_block.png"], (310, 310))
+
+        qgame.window.update()
+
+    for p in [img_path, json_path]:
+        if os.path.exists(p):
+            os.remove(p)
+
+# ==================== 示例 6：几何图形与抗锯齿文字 ====================
+def run_geometrics_demo():
+    qgame.init()
+    canvas = qgame.set_settings(width=800, height=600, title="几何画板功能测试")
+    clock = qgame.Clock()
+
+    circle_radius, pulse_dir = 50, 1
+    running = True
+    while running:
+        clock.tick(60)
+        for event in qgame.events.get():
+            if event.type == qgame.eventType.QUIT:
+                running = False
+            elif event.type == qgame.eventType.KEY_DOWN and event.key == qgame.keys.ESCAPE:
+                running = False
+
+        circle_radius += pulse_dir * 1
+        if circle_radius >= 120 or circle_radius <= 20:
+            pulse_dir *= -1
+
+        qgame.draw.fill(canvas, (30, 32, 40))
+
+        qgame.draw.rect(canvas, (240, 80, 80), (50, 50, 150, 100))
+        qgame.draw.rect(canvas, (80, 240, 80), (50, 200, 150, 100), width=4)
+        qgame.draw.circle(canvas, (80, 120, 240), (400, 250), circle_radius)
+        qgame.draw.circle(canvas, (240, 200, 80), (400, 250), 130, width=3)
+        qgame.draw.ellipse(canvas, (180, 80, 240), (600, 50, 150, 80))
+        qgame.draw.line(canvas, (255, 100, 255), (50, 320), (750, 380), width=4)
+
+        qgame.draw.text(canvas, "QGame Engine Text Rendering Test", (50, 420), size=24)
+        qgame.draw.text(canvas, "Size 28px 中文抗锯齿测试", (50, 500), size=28, color=(255, 200, 50))
+        qgame.window.update()
+
+# ==================== 示例 7：文本输入与聊天框自适应 ====================
+def run_textbox_demo():
+    qgame.init()
+    canvas = qgame.set_settings(width=800, height=600, title="UI 控件自适应文本框测试")
+    clock = qgame.Clock()
+
+    chat_board = qgame.TextBox(50, 50, 700, 350, placeholder="聊天频道暂无消息...", multi_line=True)
+    chat_board.widget.setReadOnly(True)
+    chat_board.set_theme(bg_color=(20, 20, 25, 180), text_color=(200, 230, 200), border_color=(100, 100, 120), font_size=13)
+
+    chat_input = qgame.TextBox(50, 420, 600, 100, placeholder="输入文本，按回车或点击发送按钮发送...", multi_line=True)
+    chat_input.set_focus()
+
+    btn_rect = (670, 420, 80, 100)
+    chat_log = ["【系统提示】: 欢迎测试 QGame 原生聊天框！按 F11 体验完美全屏缩放。"]
+
+    def post_msg():
+        text = chat_input.get_text().strip()
+        if text:
+            chat_log.append(f"【测试勇者】: {text}")
+            chat_input.clear()
+            chat_board.set_text("\n".join(chat_log))
+            chat_board.widget.moveCursor(chat_board.widget.textCursor().MoveOperation.End)
+            chat_input.set_focus()
+
+    chat_board.set_text("\n".join(chat_log))
+    running = True
+
+    while running:
+        clock.tick(60)
+        for event in qgame.events.get():
+            if event.type == qgame.eventType.QUIT:
+                running = False
+            elif event.type == qgame.eventType.KEY_DOWN:
+                if event.key == qgame.keys.ESCAPE:
+                    running = False
+                elif event.key == qgame.keys.F11:
+                    qgame.window.toggle_fullscreen()
+                elif event.key == qgame.keys.RETURN or event.key == qgame.keys.ENTER:
+                    post_msg()
+            elif event.type == qgame.eventType.MOUSE_BUTTON_DOWN:
+                if event.button == qgame.mouseButtons.LEFT:
+                    if qgame.collision.check_point_rect(event.pos, btn_rect):
+                        post_msg()
+
+        qgame.draw.fill(canvas, (30, 35, 45))
+        is_hover = qgame.collision.check_point_rect(qgame.mouse.get_pos(), btn_rect)
+        qgame.draw.rect(canvas, (90, 160, 255) if is_hover else (70, 130, 230), btn_rect)
+        qgame.draw.text(canvas, "发送", (690, 460), size=18, color=(255, 255, 255))
+        qgame.window.update()
+
+# ==================== 示例 8：音效音乐与碰撞交互测试 ====================
+def run_audio_collision_demo():
+    qgame.init()
+    canvas = qgame.set_settings(width=800, height=600, title="音效音乐与方块点碰撞检测")
+    clock = qgame.Clock()
+
+    rect_btn = (150, 200, 200, 80)
+    square_btn = (480, 190, 150, 100)
+
+    sound_eff = None
+    if os.path.exists(SOUND_WAV_PATH):
+        try:
+            sound_eff = qgame.Sound(SOUND_WAV_PATH)
+            sound_eff.set_volume(0.8)
+        except Exception as e:
+            print(f"音效载入失败: {e}")
+
+    bg_music = None
+    bg_music_active = False
+    if os.path.exists(MUSIC_MP3_PATH):
+        try:
+            bg_music = qgame.Music(MUSIC_MP3_PATH)
+            bg_music.set_volume(2)
+            bg_music.play(loop=True)
+            bg_music_active = True
+        except Exception as e:
+            print(f"背景音乐载入失败: {e}")
+
+    status_msg = "音频测试就绪。将鼠标悬停在按钮上并点击。"
+    running = True
+
+    while running:
+        clock.tick(60)
+        mouse_pt = qgame.mouse.get_pos()
+
+        hover_rect = qgame.collision.check_point_rect(mouse_pt, rect_btn)
+        hover_square = qgame.collision.check_point_rect(mouse_pt, square_btn)
+
+        for event in qgame.events.get():
+            if event.type == qgame.eventType.QUIT:
+                running = False
+            elif event.type == qgame.eventType.KEY_DOWN:
+                if event.key == qgame.keys.ESCAPE:
+                    running = False
+                if event.key == qgame.keys.F11:
+                    qgame.window.toggle_fullscreen()
+
+            elif event.type == qgame.eventType.MOUSE_BUTTON_DOWN:
+                if event.button == qgame.mouseButtons.LEFT:
+                    if qgame.collision.check_point_rect(event.pos, rect_btn):
+                        status_msg = "播放音效：sound.wav"
+                        if sound_eff:
+                            sound_eff.play()
+
+                    elif qgame.collision.check_point_rect(event.pos, square_btn):
+                        if bg_music:
+                            if bg_music_active:
+                                bg_music.pause()
+                                bg_music_active = False
+                                status_msg = "BGM 已暂停"
+                            else:
+                                bg_music.unpause()
+                                bg_music_active = True
+                                status_msg = "BGM 继续播放"
+
+        qgame.draw.fill(canvas, (30, 32, 40))
+
+        green_color = (130, 250, 130) if hover_rect else (60, 180, 60)
+        blue_color = (130, 180, 250) if hover_square else (60, 110, 200)
+
+        qgame.draw.rect(canvas, green_color, rect_btn)
+        qgame.draw.rect(canvas, blue_color, square_btn)
+
+        qgame.draw.text(canvas, "Play Sound", (195, 230), size=14, color=(0, 0, 0))
+        qgame.draw.text(canvas, "BGM Ctrl\n(Square)", (495, 220), size=12, color=(0, 0, 0))
+
+        qgame.draw.text(canvas, "Audio & Points Collision Interactive Demo", (50, 60), size=22)
+        qgame.draw.text(canvas, f"State: {status_msg}", (50, 420), size=16, color=(255, 220, 100))
+        qgame.draw.text(canvas, "Press [ESC] to back.", (50, 530), size=14, color=(150, 150, 150))
+
+        qgame.window.update()
+
+    if bg_music:
+        bg_music.stop()
+
+# ==================== CLI 路由导航中心 ====================
+def main():
+    while True:
+        print("\n" + "=" * 40)
+        print("         QGame Engine 演示包航行器      ")
+        print("=" * 40)
+        print("1. Delta Time 平滑步进与图像翻转旋转")
+        print("2. 视口裁剪、不透明度呼吸与鼠标光标显隐")
+        print("3. 多场景无缝管理与场景 UI 销毁测试")
+        print("4. 世界轴 2D 摄像机 (平滑跟随、震屏、死区缓冲)")
+        print("5. 瓦片网格切图与合图配置文件解析测试")
+        print("6. 几何图形混合绘制与高质量抗锯齿文字")
+        print("7. 原生 IME 输入框与聊天框自使用缩放测试")
+        print("8. 音效音乐加载与方块点碰撞交互测试")
+        print("0. 退出测试系统")
+        print("=" * 40)
+
+        try:
+            choice = input("请输入您想运行的演示编号并回车 [0-8]: ").strip()
+        except (KeyboardInterrupt, SystemExit):
+            print("\n已安全退出。")
+            break
+
+        if choice == "1":
+            run_delta_time_demo()
+        elif choice == "2":
+            run_clipping_demo()
+        elif choice == "3":
+            run_scene_demo()
+        elif choice == "4":
+            run_camera_demo()
+        elif choice == "5":
+            run_spritesheet_demo()
+        elif choice == "6":
+            run_geometrics_demo()
+        elif choice == "7":
+            run_textbox_demo()
+        elif choice == "8":
+            run_audio_collision_demo()
+        elif choice in ("0", ""):
+            print("演示程序关闭。")
+            break
+        else:
+            print("输入无效，请输入 0 到 8 之间的数字。")
+
+if __name__ == "__main__":
+    main()

qgame/anim_data.py

@@ -0,0 +1,9 @@
+# 摄像机的运行状态
+camera_position = {"x": 0, "y" : 0}
+camera_size = 1.0
+camera_d = 0 # 0 = 向上, 90 = 向右, 180 = 向下, 270 = 向左
+screen_center = {"x" : 0, "y" : 0}
+minimum = 0.00000000000001
+
+# 动画别名存储
+an_alias = []