raylib-py

PyPI - Python 版本 GitHub 最新发布版本 GitHub 发布日期

PyPI - 轮子 PyPI - 许可证 PyPI - 下载量

GitHub 所有版本 GitHub 特定版本下载量

GitHub 提交活动 GitHub 标记版本后的提交数

这是优秀的 C 语言库 raylib 的 Python 绑定。

警告：这是一个仅用于发布的仓库。

请阅读这个问题以获取更多信息。

我计划仅使用此仓库发布新的 raylib-py 版本。此仓库中的源代码相当过时，并不反映最新版本。

发布信息：

这里发布的最新版本是从另一个项目生成的，如 #45 中所述。

如何安装：

从 PyPI，在命令行中：

$ pip install raylib-py

你也可以从发布页面下载轮子文件，然后在本地使用 pip 安装：

$ pip install path/to/raylib_py-5.0.0-py3-none-any.whl

如何使用：

尝试以下代码（安装 raylib-py 后，创建一个新的 Python 文件，将以下代码保存到其中，然后运行）：

from raylibpy import *

def main():
    init_window(800, 450, "raylib [core] 示例 - 基本窗口")
    
    set_target_fps(60)
    
    while not window_should_close():
        begin_drawing()
        clear_background(RAYWHITE)
        draw_text("恭喜！你创建了你的第一个窗口！", 190, 200, 20, LIGHTGRAY)
        end_drawing()
    
    close_window()

if __name__ == '__main__':
    main()

API 文档

请参考 v5.0.0b1 的 DOCS.md

特性：

仅使用 PEP8 命名约定：

结构体属性使用 snake_case，类和其他类型使用 PascalCase。

类型提示（非类型注解）：

def get_ray_collision_mesh(ray, mesh, transform):
    # type: (Ray, Mesh, Matrix) -> RayCollision

结构体带有作为方法和属性的函数：

sound = Sound.load('my/resorces/sound.wav')     # 等同于 load_sound(...)
position = Vector(4.0, 10.0)

稍后...

sound.play() # 等同于 play_sound(sound) length = position.length # 等同于 vector2length(position)；使用 raymath.h 函数


- Vector{2,3,4}、Rectangle 和 Color 支持属性重组；

```python
vec3 = Vector3(2.0, 5.0, 3.0)
vec2 = vec3.zxy                 # vec2 是一个 Vector2，而不是序列类型
other_vec3 = vec2.xxy           # 同样：other_vec3 是一个 Vector3
vec2.xy = vec3.y, other_vec3.z  # 可以将序列设置为值

c_red = Color(255, 0, 0)
c_yellow = c_red.rrb

# Rectangle 有宽度和高度的别名：分别为 w 和 h：
rect = Rectangle(10.0, 10.0, 320.0, 240.0)
other_rect = rect.whxy          # 属性重组仅允许使用四个属性，不能是 3 个或 2 个

美化打印：大多数结构实现了友好的 __str__() 和 __repr__()；
上下文管理器：begin_* 和 end_* 函数可以作为上下文管理器调用：

不使用上下文管理器：

# 这个例子展示了一个渲染步骤

begin_drawing()

begin_texture_mode(minimap_texture)
# 渲染"小地图"
draw_line(2, 2, 5, 5, RED)
end_texture_mode(minimap_texture)

begin_mode2d(main_camera)
# 2d 绘图逻辑...
draw_texture(minimap_texture, 10, 10, WHITE)
end_mode2d()

end_drawing()

使用上下文管理器：

# 这个例子展示了一个渲染步骤

with drawing():

    with texture_mode(minimap_texture):
        # 渲染小地图
        draw_line(2, 2, 5, 5, RED)

    with mode2d(main_camera):
        # 2d 绘图逻辑...
        draw_texture(minimap_texture, 10, 10, WHITE)

某些结构的上下文管理器：Camera{2,3}D、Shader 等；

继续上面的例子：

# 这个例子展示了一个渲染步骤

with drawing():

    with minimap_texture:
        # 渲染小地图
        draw_line(2, 2, 5, 5, RED)

    with main_camera:
        # 2d 绘图逻辑...
        draw_texture(minimap_texture, 10, 10, WHITE)