Scrawl 游戏引擎是一个受到 Scratch 启发的 Python 游戏开发库，它简化了游戏逻辑的编写，让开发者可以专注于创意。本教程将详细介绍 Scrawl 游戏引擎的安装、核心概念、基本使用、精灵操作、事件处理、高级功能以及提供一个完整的示例。

引言

Scrawl 游戏引擎旨在提供一个直观且易于上手的框架，帮助用户快速创建 2D 游戏。它封装了 Pygame 的复杂性，并引入了类似 Scratch 的事件驱动编程模型。引擎的核心循环和渲染由内部处理，用户通过装饰器将自己的逻辑"注入"到引擎的事件流中。

安装

Scrawl 游戏引擎的安装非常简单，可以通过 pip 命令进行：

pip install scrawl-engine

注意：由于 Scrawl 引擎在内部使用了 cat1.svg、cat2.svg 和 Simhei.ttf 等资源文件，如果您在使用 Cat 精灵或默认字体时遇到文件未找到的错误，您可能需要将这些资源文件放置在您的 Python 脚本所在的目录，或者确保它们存在于 scrawl-engine 包的安装路径中。通常，这些文件会随包一同安装。

核心概念

Scrawl 引擎主要围绕以下三个核心类构建：

1. Game 类：
   • 游戏的入口点和主循环管理器。
   • 负责初始化 Pygame、管理屏幕、处理全局事件（如按键、鼠标）、场景切换、任务调度和调试信息显示。
   • 提供音频管理功能。
2. Scene 类：
   • 代表游戏中的一个"场景"或"关卡"。
   • 管理该场景中的所有精灵和粒子系统。
   • 负责场景的背景绘制和场景级别的事件处理。
3. Sprite 类：
   • 游戏中的可交互对象，如角色、道具等。
   • 拥有位置、方向、大小、造型等属性。
   • 可以响应事件、移动、碰撞、说话等。

1. 创建游戏窗口

首先，你需要创建一个 Game 实例来初始化游戏引擎和窗口。

from scrawl import Game

# 创建一个 800x600 像素的游戏窗口，标题为 "我的 Scrawl 游戏"
game = Game(width=800, height=600, title="我的 Scrawl 游戏")

2. 创建场景

游戏通常由多个场景组成。你需要创建一个继承自 Scene 的类来定义你的游戏场景。

from scrawl import Scene, Sprite

class MyScene(Scene):
    def __init__(self):
        super().__init__()
        self.name = "主场景" # 为场景命名
        self.background_color = (150, 200, 255) # 设置背景颜色
        # 在 __init__ 中添加精灵
        player = Player() # 假设 Player 类已定义
        self.add_sprite(player)
        print(f"{[self.name](<http://self.name/>)} 已创建！")

3. 添加精灵

精灵是场景中的主要元素。你可以创建继承自 Sprite 的类来定义你的角色或对象。