README

raylib is a simple and easy-to-use library to enjoy videogames programming.

raylib is highly inspired by Borland BGI graphics lib and by XNA framework and it's especially well suited for prototyping, tooling, graphical applications, embedded systems and education.

NOTE for ADVENTURERS: raylib is a programming library to enjoy videogames programming; no fancy interface, no visual helpers, no debug button... just coding in the most pure spartan-programmers way.

Ready to learn? Jump to code examples!

---























features
--------
  - NO external dependencies, all required libraries are included in raylib
  - Multiple platforms supported: Windows, Linux, MacOS, RPI, Android, HTML5... and more!
  - Written in plain C code (C99) using PascalCase/camelCase notation
  - Hardware accelerated with OpenGL: 1.1, 2.1, 3.3, 4.3, ES 2.0, ES 3.0
  - Unique OpenGL abstraction layer (usable as standalone module): rlgl
  - Software Renderer backend (no OpenGL required!): rlsw
  - Multiple Texture formats supported, including compressed formats (DXT, ETC, ASTC)
  - Multiple Fonts formats supported (TTF, OTF, FNT, BDF, sprite fonts)
  - Full 3D support, including 3D Shapes, Models, Billboards, Heightmaps and more!
  - Flexible Materials system, supporting classic maps and PBR maps
  - Animated 3D models supported (skeletal bones animation, GPU-skinning) (IQM, M3D, glTF)
  - Shaders support, including model shaders and postprocessing shaders
  - Powerful math module for Vector, Matrix and Quaternion operations: raymath
  - Audio loading and playing with streaming support (WAV, QOA, OGG, MP3, FLAC, XM, MOD)
  - VR stereo rendering support with configurable HMD device parameters
  - Huge examples collection with +220 code examples!
  - Bindings to +70 programming languages!
  - Free and open source

limitations
-----------

raylib presents some limitations by design for code simplicity. Some forks, alternatives, and samples are available to overcome most of them but it's up to the users to modify the library for their specific needs.

  - Single window with single OpenGL context by default, no multi-window support
  - Window resize and move stops the rendering loop on platforms supporting a window
  - RenderTextures are flipped vertically, as provided by OpenGL, it's up to the user to draw them flipped to the screen
  - Font rasterization has lower quality than alternatives like Freetype2, HarfBuzz or Slug
  - Text drawing does not support RTL, ligatures or emojis

basic example
--------------
This is a basic raylib example, it creates a window and draws the text "Congrats! You created your first window!" in the middle of the screen. Check this example running live on web here.
c
include "raylib.h"

int main(void)
{
    InitWindow(800, 450, "raylib example - basic window");

    while (!WindowShouldClose())
    {
        BeginDrawing();
            ClearBackground(RAYWHITE);
            DrawText("Congrats! You created your first window!", 190, 200, 20

Top issues

Discussions

Latest release

raylib 6.2 release notes

After almost 6 months since latest raylib release, here it is a new installment of the library. It was supposed to be just a patch version to address an issue with CMake build system but it took way longer than expected and included +300 changes and improvements.

Some numbers for this release:

 - ~100 closed issues (for a TOTAL of +2240!)
 - +500 commits since previous RELEASE (for a TOTAL of +10280!)
 - +20 new functions ADDED to raylib API (for a TOTAL of 619!)
 - +10 new examples to learn from (for a TOTAL of +225!)
 - +100 new contributors (for a TOTAL