fantas V3¶

快速开始¶

欢迎了解 fantas！这是一个基于 pygame-ce [1] 的 2D 图形程序框架。当你安装好 fantas 后，下一个问题就是怎样让程序运行起来。你可能知道，pygame-ce 并不是一个开箱即用的库，它需要你完全掌控整个主循环，这对于初学者来说可能会有些困难。幸运的是，fantas 帮你做好了一切。

安装 fantas¶

fantas 可以通过 pip 轻松安装：

pip install fantas

小试牛刀¶

来看一个简单的例子吧：

import fantas

# 创建窗口
window = fantas.Window(
    fantas.WindowConfig(
        title="Hello, Fantas!",
        window_size=(800, 600),
    )
)

# 创建渐变背景
background = fantas.LinearGradientLabel(
    rect=fantas.Rect((0, 0), window.size),
    start_color=fantas.Color('red'),
    end_color=fantas.Color('blue'),
    start_pos=(0, 0),
    end_pos=window.size
)
window.append(background)

# 设置默认文本样式
fantas.DEFAULTTEXTSTYLE.font = fantas.fonts.DEFAULTSYSFONT
fantas.DEFAULTTEXTSTYLE.size = 90
# 创建文本
text = fantas.Text(
    text="好好学习\n天天向上",
    rect=fantas.Rect(0, 0, 600, 300),
    align_mode=fantas.AlignMode.CENTER,
)
text.rect.center = background.rect.center  # 将文本中心对齐到背景中心
window.append(text)

# 启动窗口主循环
window.mainloop()

想要来点动画吗，那就试试这个：

import fantas

window = fantas.Window(
    fantas.WindowConfig(
        title="Animate It!",
        window_size=(400, 300),
    )
)

# 纯色背景
background = fantas.ColorBackground(fantas.Color(0, 0, 0))
window.append(background)

# 来个小方块吧
block = fantas.Label(fantas.Rect(20, 20, 50, 50))
background.append(block)

# 动画1：让方块动起来
block_pos_kf = fantas.PointKeyFrame(
    block.rect,
    "center",
    fantas.Vector2(355, 255),
    fantas.CURVE_SMOOTH,
)
block_pos_kf.set_duration_ms(1000)
block_pos_kf.start()

# 动画2：让背景变色
background_color_kf = fantas.ColorKeyframe(
    background,
    "bgcolor",
    fantas.Color(255, 0, 0),
    fantas.CURVE_SMOOTH,
)
background_color_kf.set_duration_ms(1000)
background_color_kf.start()

window.mainloop()

想要更深入地探索可以看看教程或者参考，祝你好运！

教程¶

介绍 fantas 的核心概念和使用方法，适合初学者入门。

未完成

TODO: 编写教程内容。

参考¶

详细介绍 fantas 的各个模块和函数的功能和参数，适合有一定基础的用户查阅。

未完成

TODO: 编写参考内容。

开发帮助¶

如果你想要参与 fantas 的开发，或者想要自己编译一个版本，那么你需要了解一些关于 fantas 的开发指南：

fantas 源代码托管在 GitHub 上，欢迎访问、使用和贡献。

首先，你需要克隆 fantas 的代码仓库（当然，也可以是你自己 fork 后的仓库）：

git clone https://github.com/Fantastair/FantasV3.git

fantas 提供了一个开发脚本 dev.py，集成了所有开发过程中可能需要用到的命令，查看使用 dev.py 脚本

其他¶

GitHub

这是 fantas 的代码仓库，欢迎访问、使用和贡献。

在此也一并提供 pygame-ce for fantas 的仓库链接。fantas 使用的是其 fantas 分支编译的版本。

MIT License