raylib 5.0

[jakubmanczak]

Created with brew bump-formula-pr.

release notes

![raylib50_banner_10th_anniversary_github](https://github.com/raysan5/raylib/assets/5766837/f71081d5-aeeb-4dff-8663-fe73f7b2831d)
It's been 7 months since latest raylib release and 10 years since raylib 1.0 was officially released... what an adventure! In the last 10 years raylib has improved a lot, new functions have been added, many new features and improvements implemented, up to 500 contributors have helped to shape the library as it is today. raylib 5.0 is the final result of all this incredible amount of work and dedication. Here it is the summary with the key features and additions of this NEW major version of raylib.
Some numbers for this release:

+200 closed issues (for a TOTAL of +1540!)
+550 commits since previous RELEASE (for a TOTAL of +6950!)
+35 functions ADDED to raylib API (for a TOTAL of 552!)
+60 functions REVIEWED/REDESIGNED
+80 new contributors (for a TOTAL of +500!)

Highlights for raylib 5.0:


rcore module platform-split: Probably the biggest raylib redesign in the last 10 years. raylib started as a library targeting 3 desktop platforms: Windows, Linux and macOS (thanks to GLFW underlying library) but with the years support for several new platforms has been added (Android, Web, Rapsberry Pi, RPI native...); lot of the platform code was shared so the logic was all together on rcore.c module, separated by compilation flags. This approach was very handy but also made it very difficult to support new platforms and specially painful for contributors not familiar with the module, navigating +8000 lines of code in a single file. A big redesign was really needed but the amount of work required was humungus and quite scary for a solo-developer like me, moreover considering that everything was working and the chances to break things were really high. Fortunately, some contributors were ready for the task (@ubkp, @michaelfiber, @Bigfoot71) and thanks to their initiative and super-hard work, the rcore platform split has been possible! This new raylib architecture greatly improves the platforms maintenance but also greatly simplifies the addition of new platforms. A platforms/rcore_template.c file is provided with the required structure and functions to be filled for the addition of new platforms, actually it has been simplified to mostly filling some pre-defined functions: InitPlatform(), ClosePlatform, PollInputEvents... Undoubtely, this redesign opens the doors to a new era for raylib, letting the users to plug new platforms as desired.


NEW Platform backend supported: SDL: Thanks to the new rcore platform-split, the addition of new platforms/backends to raylib has been greatly simplified. As a proof of concept, SDL2 platform backend has been added to raylib as an aternative for GLFW library for desktop builds: platforms/rcore_desktop_sdl. Lot of work has been put to provide exactly the same features as the other platforms and carefully test the new implementation. Now SDL2 fans can use this new backend, just providing the required include libraries on compilation and linkage (not included in raylib, like GLFW). SDL backend support also eases the process of supporting a wider range of platforms that already support SDL.


NEW Platform backend supported: Nintendo Switch (closed source): The addition of the SDL backend was quite a challenge but to really verify the robustness and ease of the new platform plugin system, adding support for a console was a more demanding adventure. Surprisingly, only two days of work were required to add support for Nintendo Switch to raylib! Implementation result showed an outstanding level of simplicity, with a self-contained module (rcore_swith.cpp) supporting graphics and inputs. Unfortunately this module can not be open-sourced due to licensing restrictions.


NEW Splines drawing and evaluation API: A complete set of functions has been added to draw and evaluate different types of splines: Linear, Basis, Catmull-Rom, Quadratic Bezier and Cubic Bezier. Splines are extremely useful for game development (describe paths, control NPC movement...) but they can also be very useful on tools development (node-conections, elements-movement, 3d modelling, animations...). This was the missing feature on the raylib rshapes module to make it complete! Note that rshapes module can also be used independently of raylib just providing the only 6 functions required for vertex definition and drawing.


NEW Pseudo-random numbers generator: rprand: After several years of users asking for this missing piece, a brand new pseudo-random generator module has been added to raylib. rprand implements the Xoshiro128** algorithm combined with SplitMix64, specially suited for fast software pseudo-random numbers generation. The module also implies some useful functions to generate non-repetitive random numbers sequences, functionality exposed by raylib. usage of this module can be controlled by a compilation flag, in case the default libc rand() function was preferred.


NEW Automation Events System API: This new system was first added in raylib 4.0 as an experimental feature but it was a bit clumsy and there was no API exposed to users. For the new raylib 5.0 the system has been redesigned and proper API added for the users. With this new events automation system, users can record input events for later replay, very useful feature for testing automation, tutorials generation, assisted game playing, in-game cinematics, speedruns saving or even AI assited game playing!


NEW raygui 4.0: The official raylib immediate-mode gui library designed for tools development has been updated to a new version, aligned with raylib 5.0. This new version is a complete redesign of raygui to unify all controls structure and usage, now all controls have the same function signature!. raygui has been battle-tested with the development of +12 published tools in the last few years. The tools can be seen and used for free in the raylib technologies tools page. Worth mentioning that several of those tools have been open sourced for anyone to use, compile, contribute or learn how the code works.


NEW raylib web examples functionality: Beside the addition of several new examples, the web examples functionality has been improved. Examples have been organized by complexity level, marked with one star for simple examples and up to 4 stars for more complex ones. A new option has been added to web to allow to filter examples by function-name usage, to ease the learning process when looking for an usage example of some function. Finally, open-graph metadata information has been added to all examples individual webpages, improving a the visuals and information when sharing those webpages on social networks, sharing the example screenshot and details.


As always, those are only some highlights of the new raylib 5.0 but there is many more improvements! Support for 16-bit HDR images/textures, SVG loading and scaling support, new OpenGL ES 3.0 graphic backend, new image gradient generators, sound alias loading, improved 3d models loading, multiple optimizations, new bindings, CodeQL integration and much more!
Make sure to check raylib CHANGELOG for a detailed list of changes!
Undoubtely, this is the biggest raylib update in 10 years. Many new features and improvements with a special focus on maintainabiliy and long-term sustainability. Undoubtely, this is the raylib of the future.
Enjoy programming! :)
New Contributors

@Koromix made their first contribution in Fix missing include in rglfw.c on BSD platforms raysan5/raylib#2968
@Webfra made their first contribution in Add const qualifier to char * path argument in qoaplay_open() raysan5/raylib#2972
@eltociear made their first contribution in Fix typo in rmodels.c raysan5/raylib#2976
@devmanso made their first contribution in add missing space in one of the cameraDescriptions raysan5/raylib#2977
@gingerBill made their first contribution in Update BINDINGS.md for raylib Odin 4.5 raysan5/raylib#2981
@jarroddavis68 made their first contribution in Update BINDINGS.md raysan5/raylib#2983
@RicoP made their first contribution in slightly optimize Vector3Normalize raysan5/raylib#2982
@chocolate42 made their first contribution in [rtext] Fix GetCodepointNext() to return default value on invalid input with size=0 raysan5/raylib#2997
@eternalStudent made their first contribution in Minor fix in DrawLineBezier* raysan5/raylib#3006
@benjamin-thomas made their first contribution in CMake project example: fix a couple of typos raysan5/raylib#3014
@RadsammyT made their first contribution in [raudio] Rewritten ExportWaveAsCode() file saving to be more like rtextures ExportImageAsCode() raysan5/raylib#3013
@Soutaisei made their first contribution in Update BINDINGS.md raysan5/raylib#3017
@szsam made their first contribution in Fix offset used before range check raysan5/raylib#3021
@kolunmi made their first contribution in Ensure distance is greater than 0 in CameraMoveToTarget raysan5/raylib#3031
@Bigfoot71 made their first contribution in Correction of values ​​used only once in GenMeshCubicmap raysan5/raylib#3032
@Stopfield made their first contribution in WingBGI link in "HISTORY.md" now leads to the correct website! raysan5/raylib#3033
@nullstare made their first contribution in Lightmap example. raysan5/raylib#3043
@Gamer-Kold made their first contribution in Fixed broken build.zig files. raysan5/raylib#3045
@alfredbaudisch made their first contribution in Store GLTF model animation names raysan5/raylib#3044
@Shoozza made their first contribution in Fix vs code project raysan5/raylib#3048
@manuel5975p made their first contribution in Update GetCollisionRec raysan5/raylib#3052
@lesleyrs made their first contribution in update cmake example project raysan5/raylib#3062
@hamyyy made their first contribution in GetCurrentMonitor() bugfix raysan5/raylib#3058
@crynux made their first contribution in Update rmodels.c; free fileData for LoadModelAnimationsGLTF raysan5/raylib#3065
@PixelPhobicGames made their first contribution in Updated (rcamera) To Add Analog Stick Cam Controls raysan5/raylib#3066
@danemadsen made their first contribution in Replaced GenImageGradientH and GenImageGradientV with GenImageLinearGradient raysan5/raylib#3074
@Luramoth made their first contribution in Add new file formats to FAQ raysan5/raylib#3079
@jasonliang-dev made their first contribution in Fix a link in the FAQ raysan5/raylib#3082
@archydragon made their first contribution in BINDINGS.md: Janet bindings supported version update raysan5/raylib#3083
@rayit made their first contribution in Fixed compile on OpenBSD raysan5/raylib#3085
@yujiri8 made their first contribution in build.zig: Fix cross-compiling from Linux raysan5/raylib#3090
@TheLastBilly made their first contribution in cross compilation for PLATFORM_DRM raysan5/raylib#3091
@chemaguerra made their first contribution in Continuation of support for ES3/WebGL2 raysan5/raylib#3107
@dantecatalfamo made their first contribution in Add options to zig compile raysan5/raylib#3115
@Gisteron made their first contribution in fix vector angle example mode 0 circle segment drawing raysan5/raylib#3150
@ewpratten made their first contribution in Add raylib-ffi to bindings list raysan5/raylib#3164
@superxkooda made their first contribution in Makefile change for cross compiling. raysan5/raylib#3176
@RokasPuzonas made their first contribution in Update usage of 'sinf()' and 'cosf()' to be correct raysan5/raylib#3181
@AlbertoGP made their first contribution in Document buffer format for audio processors. raysan5/raylib#3186
@danilwhale made their first contribution in Fixed GetMonitorName description (#3184) raysan5/raylib#3189
@smalltimewizard made their first contribution in Optimization of ImageDrawRectangleRec() raysan5/raylib#3185
@jakubvf made their first contribution in build.zig: Support for building with PLAFORM_DRM raysan5/raylib#3191
@bohonghuang made their first contribution in Re-fix DrawBillboardPro to allow source of negative size (#3197) raysan5/raylib#3203
@ndytts made their first contribution in Fix android soname in src/Makefile raysan5/raylib#3211
@mode777 made their first contribution in Update BINDINGS.md to include rayjs raysan5/raylib#3212
@kassane made their first contribution in Zig build: PathSource changed raysan5/raylib#3214
@VitusVeit made their first contribution in [CORE] Support for SetWindowTitle and InitWindow for web raysan5/raylib#3222
@mohad12211 made their first contribution in fix: gif recordering doesn't work if num/caps lock is active. raysan5/raylib#3230
@actondev made their first contribution in add build.zig options for individual modules raysan5/raylib#3254
@asdqwe made their first contribution in Match CMakeOptions.txt options default values raysan5/raylib#3258
@Dial0 made their first contribution in Add Vector3 Projecting and Rejection to Raymath raysan5/raylib#3263
@n77y made their first contribution in [Feature] IsKey... safety checks and more raysan5/raylib#3256
@branc116 made their first contribution in Fix bug where default shaders was not linking. raysan5/raylib#3261
@jbarthelmes made their first contribution in Fix uninitialized thread-locals in stbi #3282 raysan5/raylib#3283
@SuperUserNameMan made their first contribution in Update Makefile : clean raygui.c & physac.c raysan5/raylib#3296
@vushu made their first contribution in added raylib-raku to bindings raysan5/raylib#3299
@gabrielssanches made their first contribution in examples: core: adds 2D camera two player split screen raysan5/raylib#3298
@wilsonsilva made their first contribution in Update BINDINGS.md with vaiorabbit/raylib-bindings raysan5/raylib#3318
@Codom made their first contribution in Added UBSAN complaint fix to rLoadTexture #1891 raysan5/raylib#3321
@WraithGlade made their first contribution in Factor's Raylib bindings mention being at v4.5 now. raysan5/raylib#3350
@thechampagne made their first contribution in fix BINDINGS.md raysan5/raylib#3358
@blueloveTH made their first contribution in Update BINDINGS.md with raylib-pkpy-bindings raysan5/raylib#3361
@luis605 made their first contribution in Texture Tiling Example - luis605 raysan5/raylib#3353
@DaveH355 made their first contribution in Optimize m3d mesh creation raysan5/raylib#3363
@purple4pur made their first contribution in Update zig build system to zig version 0.11.0 raysan5/raylib#3393
@Murlocohol made their first contribution in Hotfix for Vector2LineAngle(), should probably be reviewed along with… raysan5/raylib#3394
@BabakSamimi made their first contribution in Ported to stb_image_resize2.h raysan5/raylib#3403
@KislyjKisel made their first contribution in Fix UpdateSound parameter name raysan5/raylib#3405
@BeardedBread made their first contribution in Implement SetMouseCursor for PLATFORM_WEB raysan5/raylib#3414
@bluesillybeard made their first contribution in Fix raygui.c leftover from zig build raysan5/raylib#3417
@jcorks made their first contribution in Inclusion of Matte to BINDINGS.md raysan5/raylib#3427
@neyrox made their first contribution in Fix GenMeshPlane when resX != resZ raysan5/raylib#3425
@rexim made their first contribution in [raudio] Implement GetMasterVolume() raysan5/raylib#3434
@keithstellyes made their first contribution in fix examples Makefile to use Makefile.Web when building for web (Brings core/core_loading_thread example closer to working) raysan5/raylib#3449
@gk646 made their first contribution in Fixed LoadSoundAlias() memory leak raysan5/raylib#3458
@2Bear made their first contribution in Fix missing PLATFORM_DESKTOP_SDL checks. raysan5/raylib#3469
@M374LX made their first contribution in GetCurrentMonitor() - check window center instead of top-left corner raysan5/raylib#3468
@jestarray made their first contribution in Fix IsGestureDetected parameter inconsistency in raylib.h with rgextures.h raysan5/raylib#3464
@khalid586 made their first contribution in [Typo fixed]  in CHANGELOG raysan5/raylib#3477
@JaanDev made their first contribution in Fix compressed DDS texture loading issues raysan5/raylib#3483
@JettMonstersGoBoom made their first contribution in adding rlEnablePointMode to mirror rlEnableWireMode raysan5/raylib#3490
@27justin made their first contribution in examples/shaders: Add an example for deferred shading raysan5/raylib#3496
@Techuuu made their first contribution in Update README.md raysan5/raylib#3495
@cabarger made their first contribution in build.zig updates for 0.11.0 release. raysan5/raylib#3501
@AndreaBoroni made their first contribution in Fixed Issue 3504 raysan5/raylib#3505
@freakmangd made their first contribution in Allow raylib to be built with zig 0.11.0 and zig 0.12.0dev (master) raysan5/raylib#3506
@glowiak made their first contribution in Update info about Jaylib raysan5/raylib#3508
@icy-comet made their first contribution in [build]: add uninstall cmake target raysan5/raylib#3511
@b4yuan made their first contribution in Add CodeQL Workflow for Code Security Analysis raysan5/raylib#3476
@awfulcooking made their first contribution in Add ES 3.0 to CMakeOptions raysan5/raylib#3514
@maksut made their first contribution in WindowShouldClose(), reset shouldClose flag when window is inited raysan5/raylib#3518
@mmilenkov made their first contribution in [Examples - Core] Automation events - browser shortcut/keybind clash raysan5/raylib#3519
@isaacgravenortechnologies made their first contribution in Added wiki links to README raysan5/raylib#3525

Full Changelog: raysan5/raylib@4.5.0...5.0

[chenrui333]

@jakubmanczak thanks for your first contribution to homebrew-core! 🎉

[github-actions]

🤖 An automated task has requested bottles to be published to this PR.