-
-

Python Bindings for Raylib 4.5

+
+

Python Bindings for Raylib 5.0

New CFFI API static bindings.

  • Automatically generated to be as close as possible to @@ -114,7 +116,7 @@ original Raylib.

    • Full documentation

-

Quickstart

+

Quickstart

pip3 install raylib

from pyray import *
 init_window(800, 450, "Hello")
@@ -128,7 +130,7 @@ close_window()
-

Installation

+

Installation

First make sure you have the latest pip installed:

python3 -m pip install --upgrade pip
@@ -142,11 +144,11 @@ python3 -m pip install raylib

If yours isn’t available then pip will attempt to build from source, in which case you will need to have Raylib development libs installed, e.g. using homebrew, apt, etc.

-

Raspberry Pi

+

Raspberry Pi

Using on Rasperry Pi

-

Dynamic binding version

+

Dynamic binding version

There is now a separate dynamic version of this binding:

python3 -m pip install raylib_dynamic
@@ -154,7 +156,7 @@ using homebrew, apt, etc.

It works on some systems where the static version doesn’t, but be sure to read these caveats before using it

-

Beta testing

+

Beta testing

If you find a bug, it may be fixed in the latest dev release. You can install an alpha or beta version by specifying the exact version number like this:

python3 -m pip install raylib==4.2.0.0.dev4
@@ -162,7 +164,7 @@ You can install an alpha or beta version by specifying the exact version number
-

Problems?

+

Problems?

If it doesn’t work, try to build manually.. If that works then submit an issue to let us know what you did.

If you need help you can try asking on Discord.

@@ -170,48 +172,48 @@ to let us know what you did.

-

How to use

+

How to use

There are two APIs, you can use either or both:

-

If you are familiar with C coding and the Raylib C library and you want to use an exact copy of the C API

+

If you are familiar with C coding and the Raylib C library and you want to use an exact copy of the C API

Use the C API.

-

If you prefer a slightly more Pythonistic API and don’t mind it might be slightly slower

+

If you prefer a slightly more Pythonistic API and don’t mind it might be slightly slower

Use the Python API.

-

App showcase

+

App showcase

Tanki

Alloy Bloxel Editor

Add your app here!

-

RLZero

+

RLZero

A related library (that is a work in progress!):

A simplified API for Raylib for use in education and to enable beginners to create 3d games

-

Help wanted

+

Help wanted

  • Converting more examples from C to Python

  • Testing on more platforms

-

License (updated)

+

License (updated)

The bindings are now under the Eclipse Public License, so you are free to statically link and use in non-free / proprietary / commercial projects!

-

Performance

+

Performance

For fastest performance use Pypy rather than standard Python.

Every call to C is costly, so it’s slightly faster if you use Python data structures and functions when calculating in your update loop and then only convert them to C data structures when you have to call the C functions for drawing.

-

Bunnymark

+

Bunnymark

@@ -251,7 +253,7 @@ and then only convert them to C data structures when you have to call the C func
-

Packaging your app

+

Packaging your app

You can create a standalone binary using the Nuitka compiler. For example, here is how to package Bunnymark:

pip3 install nuitka
 cd examples/textures
@@ -260,7 +262,7 @@ python3 -m nuitka --onefile --linux-onefile-icon resources/wabbit_alpha.png text
+ @@ -756,6 +770,8 @@
  • draw_circle_gradient() (in module pyray)
  • draw_circle_lines() (in module pyray) +
    • +
  • draw_circle_lines_v() (in module pyray)
  • draw_circle_sector() (in module pyray)
    • @@ -792,10 +808,6 @@
  • draw_line_3d() (in module pyray)
  • draw_line_bezier() (in module pyray) -
    • -
  • draw_line_bezier_cubic() (in module pyray) -
    • -
  • draw_line_bezier_quad() (in module pyray)
  • draw_line_ex() (in module pyray)
    • @@ -862,6 +874,26 @@
  • draw_sphere_ex() (in module pyray)
  • draw_sphere_wires() (in module pyray) +
    • +
  • draw_spline_basis() (in module pyray) +
    • +
  • draw_spline_bezier_cubic() (in module pyray) +
    • +
  • draw_spline_bezier_quadratic() (in module pyray) +
    • +
  • draw_spline_catmull_rom() (in module pyray) +
    • +
  • draw_spline_linear() (in module pyray) +
    • +
  • draw_spline_segment_basis() (in module pyray) +
    • +
  • draw_spline_segment_bezier_cubic() (in module pyray) +
    • +
  • draw_spline_segment_bezier_quadratic() (in module pyray) +
    • +
  • draw_spline_segment_catmull_rom() (in module pyray) +
    • +
  • draw_spline_segment_linear() (in module pyray)
  • draw_text() (in module pyray)
    • @@ -918,6 +950,8 @@
  • DrawCircleGradient() (in module raylib)
  • DrawCircleLines() (in module raylib) +
    • +
  • DrawCircleLinesV() (in module raylib)
  • DrawCircleSector() (in module raylib)
    • @@ -954,10 +988,6 @@
  • DrawLine3D() (in module raylib)
  • DrawLineBezier() (in module raylib) -
    • -
  • DrawLineBezierCubic() (in module raylib) -
    • -
  • DrawLineBezierQuad() (in module raylib)
  • DrawLineEx() (in module raylib)
    • @@ -1024,6 +1054,26 @@
  • DrawSphereEx() (in module raylib)
  • DrawSphereWires() (in module raylib) +
    • +
  • DrawSplineBasis() (in module raylib) +
    • +
  • DrawSplineBezierCubic() (in module raylib) +
    • +
  • DrawSplineBezierQuadratic() (in module raylib) +
    • +
  • DrawSplineCatmullRom() (in module raylib) +
    • +
  • DrawSplineLinear() (in module raylib) +
    • +
  • DrawSplineSegmentBasis() (in module raylib) +
    • +
  • DrawSplineSegmentBezierCubic() (in module raylib) +
    • +
  • DrawSplineSegmentBezierQuadratic() (in module raylib) +
    • +
  • DrawSplineSegmentCatmullRom() (in module raylib) +
    • +
  • DrawSplineSegmentLinear() (in module raylib)
  • DrawText() (in module raylib)
    • @@ -1113,15 +1163,17 @@
  • EndMode3D() (in module raylib)
    • - - + + - - + - + - + + - + -

    Library

    		 +
  • GuiScrollPanel() (in module raylib) +
    • +
  • GuiSetAlpha() (in module raylib)
  • GuiSetFont() (in module raylib)
    • @@ -2321,6 +2419,12 @@ +
  • GuiTextAlignmentVertical (class in pyray) + +
  • GuiTextBox() (in module raylib) @@ -2333,6 +2437,12 @@
  • GuiTextInputBox() (in module raylib)
    • +
  • GuiTextWrapMode (class in pyray) + +
  • GuiToggle() (in module raylib)
  • GuiToggleGroup() (in module raylib) @@ -2343,6 +2453,8 @@
  • (in module raylib)
    • +
  • GuiToggleSlider() (in module raylib) +
  • GuiUnlock() (in module raylib)
  • GuiValueBox() (in module raylib) @@ -2395,12 +2507,6 @@
    • -
  • ICON_219 (in module raylib) - -
  • ICON_220 (in module raylib) @@ -3435,8 +3541,6 @@
  • (pyray.GuiIconName attribute)
    • -     		-
  • TextCopy() (in module raylib)
    • -     		+
  • toggle_borderless_windowed() (in module pyray) +
  • toggle_fullscreen() (in module pyray) +
    • +
  • ToggleBorderlessWindowed() (in module raylib)
  • ToggleFullscreen() (in module raylib)
    • @@ -7869,6 +8099,8 @@ - +
    • vector3_negate() (in module pyray)
    • vector3_normalize() (in module pyray) @@ -8179,10 +8421,14 @@
    • vector3_ortho_normalize() (in module pyray)
    • vector3_perpendicular() (in module pyray) +
      • +
    • vector3_project() (in module pyray)
    • vector3_reflect() (in module pyray)
    • vector3_refract() (in module pyray) +
      • +
    • vector3_reject() (in module pyray)
    • vector3_rotate_by_axis_angle() (in module pyray)
      • @@ -8249,10 +8495,14 @@
    • Vector3OrthoNormalize() (in module raylib)
    • Vector3Perpendicular() (in module raylib) +
      • +
    • Vector3Project() (in module raylib)
    • Vector3Reflect() (in module raylib)
    • Vector3Refract() (in module raylib) +
      • +
    • Vector3Reject() (in module raylib)
    • Vector3RotateByAxisAngle() (in module raylib)
      • diff --git a/docs/index.html b/docs/index.html index bd70efc..d713af7 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,26 +1,28 @@ - + - + Raylib Python — Raylib Python documentation - - - + + + + + - - - - - + + + + + - + @@ -44,7 +46,7 @@