raylib-py

这是优秀的 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)

• 暴露 RLGL 和 RayMath 函数

包括 raymath.h 和 rlgl.h 中的所有符号

问题：

• 日志记录的回调函数将无法工作

我没有很好的解决方案来包装带有可变数量参数的 C 函数。 如果你知道如何解决这个问题，你的帮助将不胜感激。

• 带有 vararg 的函数将无法工作

原因同上。

• 避免字符串操作函数

原因同上，同时也因为某些函数涉及内存分配和手动释放资源。Python 字符串方法可以为你提供相同甚至更多的功能。

• 由于 API 变更，一些示例已损坏

有一些函数重命名，一些示例更新以适应新版本。

你想要一个更定制化的 raylib 绑定吗？

再次，在 issue 45 中我更详细地解释了这个项目的实际状态。

这可能看起来像是坏消息，但实际上恰恰相反。

请看看这个项目：raylibpyctbg