2017-07-22 10:44:24 +02:00
/**********************************************************************************************
2014-09-03 16:51:28 +02:00
*
2024-11-22 11:01:10 +01:00
* raylib v5 .6 - dev - A simple and easy - to - use library to enjoy videogames programming ( www . raylib . com )
2013-11-18 23:38:44 +01:00
*
2017-02-16 00:50:02 +01:00
* FEATURES :
2018-06-26 01:36:13 +02:00
* - NO external dependencies , all required libraries included with raylib
2021-04-22 18:55:24 +02:00
* - Multiplatform : Windows , Linux , FreeBSD , OpenBSD , NetBSD , DragonFly ,
2021-10-13 19:22:47 +02:00
* MacOS , Haiku , Android , Raspberry Pi , DRM native , HTML5 .
2017-10-12 14:07:31 +02:00
* - Written in plain C code ( C99 ) in PascalCase / camelCase notation
2024-10-24 09:59:54 +02:00
* - Hardware accelerated with OpenGL ( 1.1 , 2.1 , 3.3 , 4.3 , ES2 , ES3 - choose at compile )
2017-03-19 12:52:58 +01:00
* - Unique OpenGL abstraction layer ( usable as standalone module ) : [ rlgl ]
2024-10-24 09:59:54 +02:00
* - Multiple Fonts formats supported ( TTF , OTF , FNT , BDF , Sprite fonts )
2017-12-05 13:22:26 +01:00
* - Outstanding texture formats support , including compressed formats ( DXT , ETC , ASTC )
* - Full 3 d support for 3 d Shapes , Models , Billboards , Heightmaps and more !
2017-10-12 14:07:31 +02:00
* - Flexible Materials system , supporting classic maps and PBR maps
2024-10-24 09:59:54 +02:00
* - Animated 3 D models supported ( skeletal bones animation ) ( IQM , M3D , GLTF )
2017-10-12 14:07:31 +02:00
* - Shaders support , including Model shaders and Postprocessing shaders
2017-12-05 13:22:26 +01:00
* - Powerful math module for Vector , Matrix and Quaternion operations : [ raymath ]
2024-10-24 09:59:54 +02:00
* - Audio loading and playing with streaming support ( WAV , OGG , MP3 , FLAC , QOA , XM , MOD )
2017-12-05 13:22:26 +01:00
* - VR stereo rendering with configurable HMD device parameters
2019-04-10 23:50:48 +02:00
* - Bindings to multiple programming languages available !
2016-11-16 18:46:13 +01:00
*
2017-02-16 00:50:02 +01:00
* NOTES :
2021-10-13 19:22:47 +02:00
* - One default Font is loaded on InitWindow ( ) - > LoadFontDefault ( ) [ core , text ]
* - One default Texture2D is loaded on rlglInit ( ) , 1 x1 white pixel R8G8B8A8 [ rlgl ] ( OpenGL 3.3 or ES2 )
* - One default Shader is loaded on rlglInit ( ) - > rlLoadShaderDefault ( ) [ rlgl ] ( OpenGL 3.3 or ES2 )
* - One default RenderBatch is loaded on rlglInit ( ) - > rlLoadRenderBatch ( ) [ rlgl ] ( OpenGL 3.3 or ES2 )
2017-02-16 00:50:02 +01:00
*
2017-12-05 13:22:26 +01:00
* DEPENDENCIES ( included ) :
2024-10-24 09:59:54 +02:00
* [ rcore ] [ GLFW ] rglfw ( Camilla Löwy - github . com / glfw / glfw ) for window / context management and input
* [ rcore ] [ RGFW ] rgfw ( ColleagueRiley - github . com / ColleagueRiley / RGFW ) for window / context management and input
* [ rlgl ] glad / glad_gles2 ( David Herberth - github . com / Dav1dde / glad ) for OpenGL 3.3 extensions loading
2021-07-03 21:25:05 +02:00
* [ raudio ] miniaudio ( David Reid - github . com / mackron / miniaudio ) for audio device / context management
2017-03-19 12:52:58 +01:00
*
2017-12-05 13:22:26 +01:00
* OPTIONAL DEPENDENCIES ( included ) :
2021-10-13 19:22:47 +02:00
* [ rcore ] msf_gif ( Miles Fogle ) for GIF recording
2022-03-25 15:39:32 +01:00
* [ rcore ] sinfl ( Micha Mettke ) for DEFLATE decompression algorithm
* [ rcore ] sdefl ( Micha Mettke ) for DEFLATE compression algorithm
2024-10-24 09:59:54 +02:00
* [ rcore ] rprand ( Ramon Snatamaria ) for pseudo - random numbers generation
* [ rtextures ] qoi ( Dominic Szablewski - https : //phoboslab.org) for QOI image manage
2021-10-13 19:22:47 +02:00
* [ rtextures ] stb_image ( Sean Barret ) for images loading ( BMP , TGA , PNG , JPEG , HDR . . . )
2021-11-01 23:06:26 +01:00
* [ rtextures ] stb_image_write ( Sean Barret ) for image writing ( BMP , TGA , PNG , JPG )
2024-10-24 09:59:54 +02:00
* [ rtextures ] stb_image_resize2 ( Sean Barret ) for image resizing algorithms
* [ rtextures ] stb_perlin ( Sean Barret ) for Perlin Noise image generation
2021-10-13 19:22:47 +02:00
* [ rtext ] stb_truetype ( Sean Barret ) for ttf fonts loading
* [ rtext ] stb_rect_pack ( Sean Barret ) for rectangles packing
* [ rmodels ] par_shapes ( Philip Rideout ) for parametric 3 d shapes generation
* [ rmodels ] tinyobj_loader_c ( Syoyo Fujita ) for models loading ( OBJ , MTL )
* [ rmodels ] cgltf ( Johannes Kuhlmann ) for models loading ( glTF )
2024-10-24 09:59:54 +02:00
* [ rmodels ] m3d ( bzt ) for models loading ( M3D , https : //bztsrc.gitlab.io/model3d)
* [ rmodels ] vox_loader ( Johann Nadalutti ) for models loading ( VOX )
2021-04-21 00:41:55 +02:00
* [ raudio ] dr_wav ( David Reid ) for WAV audio file loading
2019-04-10 23:50:48 +02:00
* [ raudio ] dr_flac ( David Reid ) for FLAC audio file loading
* [ raudio ] dr_mp3 ( David Reid ) for MP3 audio file loading
2021-04-21 00:41:55 +02:00
* [ raudio ] stb_vorbis ( Sean Barret ) for OGG audio loading
2019-04-10 23:50:48 +02:00
* [ raudio ] jar_xm ( Joshua Reisenauer ) for XM audio module loading
* [ raudio ] jar_mod ( Joshua Reisenauer ) for MOD audio module loading
2024-10-24 09:59:54 +02:00
* [ raudio ] qoa ( Dominic Szablewski - https : //phoboslab.org) for QOA audio manage
2013-11-18 23:38:44 +01:00
*
2014-01-23 12:36:18 +01:00
*
2017-02-16 00:50:02 +01:00
* LICENSE : zlib / libpng
2013-11-18 23:38:44 +01:00
*
2014-09-03 16:51:28 +02:00
* raylib is licensed under an unmodified zlib / libpng license , which is an OSI - certified ,
2013-11-23 13:30:54 +01:00
* BSD - like license that allows static linking with closed source software :
2014-09-03 16:51:28 +02:00
*
2025-01-01 00:02:52 +01:00
* Copyright ( c ) 2013 - 2025 Ramon Santamaria ( @ raysan5 )
2014-09-03 16:51:28 +02:00
*
* This software is provided " as-is " , without any express or implied warranty . In no event
2013-11-23 13:30:54 +01:00
* will the authors be held liable for any damages arising from the use of this software .
2013-11-18 23:38:44 +01:00
*
2014-09-03 16:51:28 +02:00
* Permission is granted to anyone to use this software for any purpose , including commercial
2013-11-23 13:30:54 +01:00
* applications , and to alter it and redistribute it freely , subject to the following restrictions :
2013-11-18 23:38:44 +01:00
*
2014-09-03 16:51:28 +02:00
* 1. The origin of this software must not be misrepresented ; you must not claim that you
* wrote the original software . If you use this software in a product , an acknowledgment
2013-11-23 13:30:54 +01:00
* in the product documentation would be appreciated but is not required .
2013-11-18 23:38:44 +01:00
*
2013-11-23 13:30:54 +01:00
* 2. Altered source versions must be plainly marked as such , and must not be misrepresented
* as being the original software .
2013-11-18 23:38:44 +01:00
*
2013-11-23 13:30:54 +01:00
* 3. This notice may not be removed or altered from any source distribution .
2013-11-18 23:38:44 +01:00
*
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
# ifndef RAYLIB_H
2014-04-19 16:36:49 +02:00
# define RAYLIB_H
2014-04-09 20:25:26 +02:00
2020-01-19 11:22:28 +01:00
# include <stdarg.h> // Required for: va_list - Only used by TraceLogCallback
2018-07-26 21:57:45 +02:00
2023-10-18 00:33:05 +02:00
# define RAYLIB_VERSION_MAJOR 5
2024-11-22 11:01:10 +01:00
# define RAYLIB_VERSION_MINOR 6
2023-01-22 09:29:29 -05:00
# define RAYLIB_VERSION_PATCH 0
2024-11-22 11:01:10 +01:00
# define RAYLIB_VERSION "5.6-dev"
2021-05-04 11:20:47 +02:00
2023-11-28 19:43:45 +00:00
// Function specifiers in case library is build/used as a shared library
2021-10-05 18:33:41 +02:00
// NOTE: Microsoft specifiers to tell compiler that symbols are imported/exported from a .dll
2023-11-28 19:43:45 +00:00
// NOTE: visibility("default") attribute makes symbols "visible" when compiled with -fvisibility=hidden
2020-01-19 11:22:28 +01:00
# if defined(_WIN32)
2023-11-28 19:43:45 +00:00
# if defined(__TINYC__)
# define __declspec(x) __attribute__((x))
# endif
2020-01-19 11:22:28 +01:00
# if defined(BUILD_LIBTYPE_SHARED)
2021-10-05 18:33:41 +02:00
# define RLAPI __declspec(dllexport) // We are building the library as a Win32 shared library (.dll)
2020-01-19 11:22:28 +01:00
# elif defined(USE_LIBTYPE_SHARED)
2021-10-05 18:33:41 +02:00
# define RLAPI __declspec(dllimport) // We are using the library as a Win32 shared library (.dll)
2021-10-08 10:12:21 -07:00
# endif
2023-11-28 19:43:45 +00:00
# else
# if defined(BUILD_LIBTYPE_SHARED)
# define RLAPI __attribute__((visibility("default"))) // We are building as a Unix shared library (.so/.dylib)
# endif
2021-10-08 17:22:58 +02:00
# endif
# ifndef RLAPI
2021-10-07 11:17:45 -07:00
# define RLAPI // Functions defined as 'extern' by default (implicit specifiers)
2016-08-13 11:31:15 +02:00
# endif
2013-11-18 23:38:44 +01:00
//----------------------------------------------------------------------------------
// Some basic Defines
//----------------------------------------------------------------------------------
# ifndef PI
2016-10-17 00:03:38 +02:00
# define PI 3.14159265358979323846f
2013-11-18 23:38:44 +01:00
# endif
2021-07-31 18:10:26 +02:00
# ifndef DEG2RAD
# define DEG2RAD (PI / 180.0f)
# endif
# ifndef RAD2DEG
# define RAD2DEG (180.0f / PI)
# endif
2013-11-18 23:38:44 +01:00
2019-04-23 14:55:35 +02:00
// Allow custom memory allocators
2022-07-15 18:53:08 +02:00
// NOTE: Require recompiling raylib sources
2019-04-23 14:55:35 +02:00
# ifndef RL_MALLOC
2024-07-01 18:30:22 +02:00
# define RL_MALLOC(sz) malloc(sz)
2019-04-23 14:55:35 +02:00
# endif
# ifndef RL_CALLOC
2024-07-01 18:30:22 +02:00
# define RL_CALLOC(n,sz) calloc(n,sz)
2019-04-23 14:55:35 +02:00
# endif
2020-01-19 11:23:38 +01:00
# ifndef RL_REALLOC
2020-02-27 13:18:55 +01:00
# define RL_REALLOC(ptr,sz) realloc(ptr,sz)
2020-01-19 11:23:38 +01:00
# endif
2019-04-23 14:55:35 +02:00
# ifndef RL_FREE
2020-02-27 13:18:55 +01:00
# define RL_FREE(ptr) free(ptr)
2019-04-23 14:55:35 +02:00
# endif
2019-10-21 08:38:23 -07:00
2021-01-22 11:57:18 +01:00
// NOTE: MSVC C++ compiler does not support compound literals (C99 feature)
2021-06-05 12:33:05 +02:00
// Plain structures in C++ (without constructors) can be initialized with { }
2023-06-01 08:47:52 +01:00
// This is called aggregate initialization (C++11 feature)
2018-10-16 10:53:01 +02:00
# if defined(__cplusplus)
2019-07-24 22:38:57 +02:00
# define CLITERAL(type) type
2016-08-01 18:05:07 +02:00
# else
2019-07-24 22:38:57 +02:00
# define CLITERAL(type) (type)
2016-08-01 18:05:07 +02:00
# endif
2013-11-18 23:38:44 +01:00
2023-06-01 08:47:52 +01:00
// Some compilers (mostly macos clang) default to C++98,
// where aggregate initialization can't be used
// So, give a more clear error stating how to fix this
# if !defined(_MSC_VER) && (defined(__cplusplus) && __cplusplus < 201103L)
# error "C++11 or later is required. Add -std=c++11"
# endif
2021-07-30 13:44:52 +02:00
// NOTE: We set some defines with some data types declared by raylib
// Other modules (raymath, rlgl) also require some of those types, so,
// to be able to use those other modules as standalone (not depending on raylib)
// this defines are very useful for internal check and avoid type (re)definitions
2021-08-21 23:57:41 +02:00
# define RL_COLOR_TYPE
# define RL_RECTANGLE_TYPE
2021-07-30 13:44:52 +02:00
# define RL_VECTOR2_TYPE
# define RL_VECTOR3_TYPE
# define RL_VECTOR4_TYPE
# define RL_QUATERNION_TYPE
# define RL_MATRIX_TYPE
2016-08-09 23:03:29 +02:00
// Some Basic Colors
// NOTE: Custom raylib color palette for amazing visuals on WHITE background
2019-07-24 22:38:57 +02:00
# define LIGHTGRAY CLITERAL(Color){ 200, 200, 200, 255 } // Light Gray
# define GRAY CLITERAL(Color){ 130, 130, 130, 255 } // Gray
# define DARKGRAY CLITERAL(Color){ 80, 80, 80, 255 } // Dark Gray
# define YELLOW CLITERAL(Color){ 253, 249, 0, 255 } // Yellow
# define GOLD CLITERAL(Color){ 255, 203, 0, 255 } // Gold
# define ORANGE CLITERAL(Color){ 255, 161, 0, 255 } // Orange
# define PINK CLITERAL(Color){ 255, 109, 194, 255 } // Pink
# define RED CLITERAL(Color){ 230, 41, 55, 255 } // Red
# define MAROON CLITERAL(Color){ 190, 33, 55, 255 } // Maroon
# define GREEN CLITERAL(Color){ 0, 228, 48, 255 } // Green
# define LIME CLITERAL(Color){ 0, 158, 47, 255 } // Lime
# define DARKGREEN CLITERAL(Color){ 0, 117, 44, 255 } // Dark Green
# define SKYBLUE CLITERAL(Color){ 102, 191, 255, 255 } // Sky Blue
# define BLUE CLITERAL(Color){ 0, 121, 241, 255 } // Blue
# define DARKBLUE CLITERAL(Color){ 0, 82, 172, 255 } // Dark Blue
# define PURPLE CLITERAL(Color){ 200, 122, 255, 255 } // Purple
# define VIOLET CLITERAL(Color){ 135, 60, 190, 255 } // Violet
# define DARKPURPLE CLITERAL(Color){ 112, 31, 126, 255 } // Dark Purple
# define BEIGE CLITERAL(Color){ 211, 176, 131, 255 } // Beige
# define BROWN CLITERAL(Color){ 127, 106, 79, 255 } // Brown
# define DARKBROWN CLITERAL(Color){ 76, 63, 47, 255 } // Dark Brown
2016-08-09 23:03:29 +02:00
2019-07-24 22:38:57 +02:00
# define WHITE CLITERAL(Color){ 255, 255, 255, 255 } // White
# define BLACK CLITERAL(Color){ 0, 0, 0, 255 } // Black
# define BLANK CLITERAL(Color){ 0, 0, 0, 0 } // Blank (Transparent)
# define MAGENTA CLITERAL(Color){ 255, 0, 255, 255 } // Magenta
2019-07-24 22:38:06 +02:00
# define RAYWHITE CLITERAL(Color){ 245, 245, 245, 255 } // My own White (raylib logo)
2016-08-09 23:03:29 +02:00
2013-11-18 23:38:44 +01:00
//----------------------------------------------------------------------------------
2017-04-21 00:08:00 +02:00
// Structures Definition
2013-11-18 23:38:44 +01:00
//----------------------------------------------------------------------------------
2019-04-11 00:11:11 +02:00
// Boolean type
2022-05-19 20:21:09 +01:00
# if (defined(__STDC__) && __STDC_VERSION__ >= 199901L) || (defined(_MSC_VER) && _MSC_VER >= 1800)
2019-04-11 00:11:11 +02:00
# include <stdbool.h>
# elif !defined(__cplusplus) && !defined(bool)
2022-05-19 20:21:09 +01:00
typedef enum bool { false = 0 , true = ! false } bool ;
2021-07-31 18:10:26 +02:00
# define RL_BOOL_TYPE
2019-04-11 00:11:11 +02:00
# endif
2021-05-29 13:54:05 +02:00
// Vector2, 2 components
2014-04-09 20:25:26 +02:00
typedef struct Vector2 {
2021-05-25 23:19:03 +02:00
float x ; // Vector x component
float y ; // Vector y component
2014-04-09 20:25:26 +02:00
} Vector2 ;
2021-05-29 13:54:05 +02:00
// Vector3, 3 components
2014-04-09 20:25:26 +02:00
typedef struct Vector3 {
2021-05-25 23:19:03 +02:00
float x ; // Vector x component
float y ; // Vector y component
float z ; // Vector z component
2014-04-09 20:25:26 +02:00
} Vector3 ;
2021-05-29 13:54:05 +02:00
// Vector4, 4 components
2018-02-24 12:31:32 +01:00
typedef struct Vector4 {
2021-05-25 23:19:03 +02:00
float x ; // Vector x component
float y ; // Vector y component
float z ; // Vector z component
float w ; // Vector w component
2018-02-24 12:31:32 +01:00
} Vector4 ;
2021-05-29 13:54:05 +02:00
// Quaternion, 4 components (Vector4 alias)
2018-07-02 18:53:46 +02:00
typedef Vector4 Quaternion ;
2023-02-09 07:17:47 -05:00
// Matrix, 4x4 components, column major, OpenGL style, right-handed
2015-04-06 14:02:29 +02:00
typedef struct Matrix {
2021-05-25 23:19:03 +02:00
float m0 , m4 , m8 , m12 ; // Matrix first row (4 components)
float m1 , m5 , m9 , m13 ; // Matrix second row (4 components)
float m2 , m6 , m10 , m14 ; // Matrix third row (4 components)
float m3 , m7 , m11 , m15 ; // Matrix fourth row (4 components)
2015-04-06 14:02:29 +02:00
} Matrix ;
2021-05-29 13:54:05 +02:00
// Color, 4 components, R8G8B8A8 (32bit)
2013-11-18 23:38:44 +01:00
typedef struct Color {
2021-05-25 23:19:03 +02:00
unsigned char r ; // Color red value
unsigned char g ; // Color green value
unsigned char b ; // Color blue value
unsigned char a ; // Color alpha value
2013-11-18 23:38:44 +01:00
} Color ;
2021-05-29 13:54:05 +02:00
// Rectangle, 4 components
2013-11-18 23:38:44 +01:00
typedef struct Rectangle {
2021-06-22 20:14:44 +02:00
float x ; // Rectangle top-left corner position x
2021-05-25 23:19:03 +02:00
float y ; // Rectangle top-left corner position y
float width ; // Rectangle width
float height ; // Rectangle height
2013-11-18 23:38:44 +01:00
} Rectangle ;
2021-05-29 13:54:05 +02:00
// Image, pixel data stored in CPU memory (RAM)
2013-11-18 23:38:44 +01:00
typedef struct Image {
2015-05-04 23:46:31 +02:00
void * data ; // Image raw data
int width ; // Image base width
int height ; // Image base height
int mipmaps ; // Mipmap levels, 1 by default
2018-01-06 13:43:48 +01:00
int format ; // Data format (PixelFormat type)
2013-11-18 23:38:44 +01:00
} Image ;
2021-05-29 13:54:05 +02:00
// Texture, tex data stored in GPU memory (VRAM)
2020-09-28 00:40:32 +02:00
typedef struct Texture {
2015-05-04 23:46:31 +02:00
unsigned int id ; // OpenGL texture id
int width ; // Texture base width
int height ; // Texture base height
int mipmaps ; // Mipmap levels, 1 by default
2018-01-06 13:43:48 +01:00
int format ; // Data format (PixelFormat type)
2020-09-28 00:40:32 +02:00
} Texture ;
2013-11-18 23:38:44 +01:00
2021-05-29 13:54:05 +02:00
// Texture2D, same as Texture
2020-09-28 00:40:32 +02:00
typedef Texture Texture2D ;
2018-07-09 10:23:53 +02:00
2021-05-29 13:54:05 +02:00
// TextureCubemap, same as Texture
2020-09-28 00:40:32 +02:00
typedef Texture TextureCubemap ;
2019-02-04 13:27:36 +01:00
2021-05-29 13:54:05 +02:00
// RenderTexture, fbo for texture rendering
2020-09-28 00:40:32 +02:00
typedef struct RenderTexture {
2021-03-19 13:19:54 +01:00
unsigned int id ; // OpenGL framebuffer object id
Texture texture ; // Color buffer attachment texture
Texture depth ; // Depth buffer attachment texture
2020-09-28 00:40:32 +02:00
} RenderTexture ;
2016-03-30 20:09:16 +02:00
2021-05-29 13:54:05 +02:00
// RenderTexture2D, same as RenderTexture
2020-09-28 00:40:32 +02:00
typedef RenderTexture RenderTexture2D ;
2018-07-09 10:23:53 +02:00
2021-05-29 13:54:05 +02:00
// NPatchInfo, n-patch layout info
2018-08-08 16:39:10 -03:00
typedef struct NPatchInfo {
2021-03-19 13:19:54 +01:00
Rectangle source ; // Texture source rectangle
int left ; // Left border offset
int top ; // Top border offset
int right ; // Right border offset
int bottom ; // Bottom border offset
int layout ; // Layout of the n-patch: 3x3, 1x3 or 3x1
2018-08-08 16:39:10 -03:00
} NPatchInfo ;
2018-08-03 04:48:46 -03:00
2021-08-11 21:16:39 +02:00
// GlyphInfo, font characters glyphs info
typedef struct GlyphInfo {
2017-02-05 02:59:39 +01:00
int value ; // Character value (Unicode)
int offsetX ; // Character offset X when drawing
int offsetY ; // Character offset Y when drawing
int advanceX ; // Character advance position X
BREAKING CHANGE: Read description
Changes:
- Font structure has been redesigned, CharInfo structure contained character rectangle within font texture, it has not much sense, considering that it was an information relative to the font atlas generated and not the character itself, so character rectangles have been moved out from CharInfo to Font.
- CharInfo included a data parameters to contain character pixel data (usually grayscale), generated on TTF font generation. It was inconsistent with other fonts types, so, now CharInfo includes directly an Image of the glyph.
- REDESIGNED: GenImageFontAtlas(), additional recs parameter added, loaded and filled inside the function to export atlas characters rectangles, instead of silently modify the input CharInfo data.
- REVIEWED: ImageTextEx(), funtion retrieved the font atlas image from the GPU, that was slow and problematic in several platforms. Now it uses directly the CharInfo image. Support for unicode codepoints has also been added.
- REDESIGNED: ImageDraw(), now it includes an additional parameter, the color tint, not only it could be useful for several situations but also function signature is more consistent with similar functions.
- ADDED: ImageFromImage() to generate a new image from a piece of another image.
- REVIEWED: GetNextCodepoint(), renamed parameters to be more clear.
Also all examples and games that were affected by those changes have been reviewed.
2019-07-24 15:05:14 +02:00
Image image ; // Character image data
2021-08-11 21:16:39 +02:00
} GlyphInfo ;
2017-02-05 02:59:39 +01:00
2021-08-11 21:16:39 +02:00
// Font, font texture and GlyphInfo array data
2018-05-04 16:59:48 +02:00
typedef struct Font {
2017-02-05 02:59:39 +01:00
int baseSize ; // Base size (default chars height)
2021-09-01 23:11:31 +02:00
int glyphCount ; // Number of glyph characters
int glyphPadding ; // Padding around the glyph characters
Texture2D texture ; // Texture atlas containing the glyphs
Rectangle * recs ; // Rectangles in texture for the glyphs
GlyphInfo * glyphs ; // Glyphs info data
2018-05-04 16:59:48 +02:00
} Font ;
2021-05-29 13:54:05 +02:00
// Camera, defines position/orientation in 3d space
2018-05-01 12:31:03 +02:00
typedef struct Camera3D {
2016-03-05 13:05:45 +01:00
Vector3 position ; // Camera position
Vector3 target ; // Camera target it looks-at
Vector3 up ; // Camera up vector (rotation over its axis)
2022-09-28 21:04:59 +03:00
float fovy ; // Camera field-of-view aperture in Y (degrees) in perspective, used as near plane width in orthographic
2021-03-19 13:56:46 +01:00
int projection ; // Camera projection: CAMERA_PERSPECTIVE or CAMERA_ORTHOGRAPHIC
2018-05-01 12:31:03 +02:00
} Camera3D ;
2019-04-12 21:41:30 +02:00
typedef Camera3D Camera ; // Camera type fallback, defaults to Camera3D
2014-04-19 16:36:49 +02:00
2021-05-29 13:54:05 +02:00
// Camera2D, defines position/orientation in 2d space
2016-03-05 15:40:08 +01:00
typedef struct Camera2D {
2016-03-27 18:32:36 +02:00
Vector2 offset ; // Camera offset (displacement from target)
2016-05-02 00:16:32 +02:00
Vector2 target ; // Camera target (rotation and zoom origin)
2016-03-05 15:40:08 +01:00
float rotation ; // Camera rotation in degrees
float zoom ; // Camera zoom (scaling), should be 1.0f by default
} Camera2D ;
2021-05-29 13:54:05 +02:00
// Mesh, vertex data and vao/vbo
2016-01-18 13:36:18 +01:00
typedef struct Mesh {
2021-06-26 22:13:45 +02:00
int vertexCount ; // Number of vertices stored in arrays
int triangleCount ; // Number of triangles stored (indexed or not)
2017-07-21 09:34:09 +02:00
2021-08-22 01:07:37 +02:00
// Vertex attributes data
2021-06-26 22:13:45 +02:00
float * vertices ; // Vertex position (XYZ - 3 components per vertex) (shader-location = 0)
float * texcoords ; // Vertex texture coordinates (UV - 2 components per vertex) (shader-location = 1)
2022-04-29 17:52:22 +02:00
float * texcoords2 ; // Vertex texture second coordinates (UV - 2 components per vertex) (shader-location = 5)
2021-06-26 22:13:45 +02:00
float * normals ; // Vertex normals (XYZ - 3 components per vertex) (shader-location = 2)
float * tangents ; // Vertex tangents (XYZW - 4 components per vertex) (shader-location = 4)
2021-05-25 23:19:03 +02:00
unsigned char * colors ; // Vertex colors (RGBA - 4 components per vertex) (shader-location = 3)
unsigned short * indices ; // Vertex indices (in case vertex data comes indexed)
2018-11-06 15:10:50 +01:00
2018-07-24 18:28:58 +02:00
// Animation vertex data
2021-06-26 22:13:45 +02:00
float * animVertices ; // Animated vertex positions (after bones transformations)
float * animNormals ; // Animated normals (after bones transformations)
2024-09-20 11:30:37 -04:00
unsigned char * boneIds ; // Vertex bone ids, max 255 bone ids, up to 4 bones influence by vertex (skinning) (shader-location = 6)
float * boneWeights ; // Vertex bone weight, up to 4 bones influence by vertex (skinning) (shader-location = 7)
Matrix * boneMatrices ; // Bones animated transformation matrices
int boneCount ; // Number of bones
2018-07-24 18:28:58 +02:00
// OpenGL identifiers
2021-06-26 22:13:45 +02:00
unsigned int vaoId ; // OpenGL Vertex Array Object id
unsigned int * vboId ; // OpenGL Vertex Buffer Objects id (default vertex data)
2016-01-18 13:36:18 +01:00
} Mesh ;
2014-04-19 16:36:49 +02:00
2021-05-29 13:54:05 +02:00
// Shader
2015-03-01 16:00:52 +01:00
typedef struct Shader {
2021-06-26 22:13:45 +02:00
unsigned int id ; // Shader program id
2021-07-31 19:46:44 +02:00
int * locs ; // Shader locations array (RL_MAX_SHADER_LOCATIONS)
2015-03-01 16:00:52 +01:00
} Shader ;
2021-05-29 13:54:05 +02:00
// MaterialMap
2017-07-19 10:09:34 +02:00
typedef struct MaterialMap {
2021-06-26 22:13:45 +02:00
Texture2D texture ; // Material map texture
Color color ; // Material map color
float value ; // Material map value
2017-07-19 10:09:34 +02:00
} MaterialMap ;
2016-07-29 21:35:57 +02:00
2021-05-29 13:54:05 +02:00
// Material, includes shader and maps
2017-07-17 00:33:40 +02:00
typedef struct Material {
2021-06-26 22:13:45 +02:00
Shader shader ; // Material shader
MaterialMap * maps ; // Material maps array (MAX_MATERIAL_MAPS)
float params [ 4 ] ; // Material generic parameters (if required)
2016-01-25 13:54:09 +01:00
} Material ;
2022-10-11 12:20:29 +03:00
// Transform, vertex transformation data
2019-04-04 13:33:54 +02:00
typedef struct Transform {
2021-06-26 22:13:45 +02:00
Vector3 translation ; // Translation
Quaternion rotation ; // Rotation
Vector3 scale ; // Scale
2019-04-04 13:33:54 +02:00
} Transform ;
2021-05-29 13:54:05 +02:00
// Bone, skeletal animation bone
2019-04-04 13:33:54 +02:00
typedef struct BoneInfo {
2021-06-26 22:13:45 +02:00
char name [ 32 ] ; // Bone name
int parent ; // Bone parent
2019-04-04 13:33:54 +02:00
} BoneInfo ;
2021-05-29 13:54:05 +02:00
// Model, meshes, materials and animation data
2014-04-19 16:36:49 +02:00
typedef struct Model {
2021-06-26 22:13:45 +02:00
Matrix transform ; // Local transform matrix
2019-04-04 13:50:52 +02:00
2021-06-26 22:13:45 +02:00
int meshCount ; // Number of meshes
int materialCount ; // Number of materials
Mesh * meshes ; // Meshes array
Material * materials ; // Materials array
int * meshMaterial ; // Mesh material number
2019-04-04 13:50:52 +02:00
2019-04-04 13:33:54 +02:00
// Animation data
2021-06-26 22:13:45 +02:00
int boneCount ; // Number of bones
BoneInfo * bones ; // Bones information (skeleton)
Transform * bindPose ; // Bones base transformation (pose)
2014-04-19 16:36:49 +02:00
} Model ;
2013-11-18 23:38:44 +01:00
2021-05-29 13:54:05 +02:00
// ModelAnimation
2019-04-04 13:33:54 +02:00
typedef struct ModelAnimation {
2021-06-26 22:13:45 +02:00
int boneCount ; // Number of bones
int frameCount ; // Number of animation frames
BoneInfo * bones ; // Bones information (skeleton)
Transform * * framePoses ; // Poses array by frame
2023-05-07 10:33:14 +02:00
char name [ 32 ] ; // Animation name
2019-04-04 13:33:54 +02:00
} ModelAnimation ;
2021-05-29 13:54:05 +02:00
// Ray, ray for raycasting
2015-03-02 20:52:58 +01:00
typedef struct Ray {
2021-06-26 22:13:45 +02:00
Vector3 position ; // Ray position (origin)
2024-07-07 20:57:18 +02:00
Vector3 direction ; // Ray direction (normalized)
2015-03-02 20:52:58 +01:00
} Ray ;
2021-05-29 13:54:05 +02:00
// RayCollision, ray hit information
2021-05-31 11:41:56 +02:00
typedef struct RayCollision {
2021-06-26 22:13:45 +02:00
bool hit ; // Did the ray hit something?
2023-02-09 07:17:47 -05:00
float distance ; // Distance to the nearest hit
Vector3 point ; // Point of the nearest hit
2021-06-26 22:13:45 +02:00
Vector3 normal ; // Surface normal of hit
2021-05-31 11:41:56 +02:00
} RayCollision ;
2016-12-31 15:06:39 -08:00
2021-05-29 13:54:05 +02:00
// BoundingBox
2019-04-12 11:29:01 +02:00
typedef struct BoundingBox {
2021-06-26 22:13:45 +02:00
Vector3 min ; // Minimum vertex box-corner
Vector3 max ; // Maximum vertex box-corner
2019-04-12 11:29:01 +02:00
} BoundingBox ;
2021-05-29 13:54:05 +02:00
// Wave, audio wave data
2014-12-15 01:08:30 +01:00
typedef struct Wave {
2021-08-16 11:06:31 +02:00
unsigned int frameCount ; // Total number of frames (considering channels)
2021-05-25 23:19:03 +02:00
unsigned int sampleRate ; // Frequency (samples per second)
unsigned int sampleSize ; // Bit depth (bits per sample): 8, 16, 32 (24 not supported)
2021-08-16 11:06:31 +02:00
unsigned int channels ; // Number of channels (1-mono, 2-stereo, ...)
2021-05-25 23:19:03 +02:00
void * data ; // Buffer data pointer
2014-12-15 01:08:30 +01:00
} Wave ;
2022-03-24 20:49:11 +01:00
// Opaque structs declaration
// NOTE: Actual structs are defined internally in raudio module
2019-07-23 22:21:01 +02:00
typedef struct rAudioBuffer rAudioBuffer ;
2022-03-30 20:13:02 +02:00
typedef struct rAudioProcessor rAudioProcessor ;
2016-07-29 21:35:57 +02:00
2021-05-29 13:54:05 +02:00
// AudioStream, custom audio stream
2016-08-02 17:32:24 +02:00
typedef struct AudioStream {
2021-05-25 23:19:03 +02:00
rAudioBuffer * buffer ; // Pointer to internal data used by the audio system
2022-03-30 20:13:02 +02:00
rAudioProcessor * processor ; // Pointer to internal data processor, useful for audio effects
2020-09-14 15:36:50 +02:00
2021-05-25 23:19:03 +02:00
unsigned int sampleRate ; // Frequency (samples per second)
unsigned int sampleSize ; // Bit depth (bits per sample): 8, 16, 32 (24 not supported)
2021-08-16 11:06:31 +02:00
unsigned int channels ; // Number of channels (1-mono, 2-stereo, ...)
2016-08-02 17:32:24 +02:00
} AudioStream ;
2021-05-29 13:54:05 +02:00
// Sound
2019-07-23 22:21:01 +02:00
typedef struct Sound {
2021-05-25 23:19:03 +02:00
AudioStream stream ; // Audio stream
2021-08-16 11:06:31 +02:00
unsigned int frameCount ; // Total number of frames (considering channels)
2019-07-23 22:21:01 +02:00
} Sound ;
2021-05-29 13:54:05 +02:00
// Music, audio stream, anything longer than ~10 seconds should be streamed
2019-07-26 10:26:39 +02:00
typedef struct Music {
2021-05-25 23:19:03 +02:00
AudioStream stream ; // Audio stream
2021-08-16 11:06:31 +02:00
unsigned int frameCount ; // Total number of frames (considering channels)
2021-05-25 23:19:03 +02:00
bool looping ; // Music looping enable
2019-07-23 22:21:01 +02:00
2021-05-25 23:19:03 +02:00
int ctxType ; // Type of music context (audio filetype)
void * ctxData ; // Audio context data, depends on type
2019-07-26 10:26:39 +02:00
} Music ;
2019-07-23 22:21:01 +02:00
2021-05-29 13:54:05 +02:00
// VrDeviceInfo, Head-Mounted-Display device parameters
2017-10-17 13:32:15 +02:00
typedef struct VrDeviceInfo {
2021-03-20 18:36:25 +01:00
int hResolution ; // Horizontal resolution in pixels
int vResolution ; // Vertical resolution in pixels
float hScreenSize ; // Horizontal size in meters
float vScreenSize ; // Vertical size in meters
float eyeToScreenDistance ; // Distance between eye and display in meters
float lensSeparationDistance ; // Lens separation distance in meters
float interpupillaryDistance ; // IPD (distance between pupils) in meters
float lensDistortionValues [ 4 ] ; // Lens distortion constant parameters
float chromaAbCorrection [ 4 ] ; // Chromatic aberration correction parameters
2017-10-17 13:32:15 +02:00
} VrDeviceInfo ;
2021-05-29 13:54:05 +02:00
// VrStereoConfig, VR stereo rendering configuration for simulator
2021-03-20 18:36:25 +01:00
typedef struct VrStereoConfig {
2021-04-06 22:49:41 +02:00
Matrix projection [ 2 ] ; // VR projection matrices (per eye)
Matrix viewOffset [ 2 ] ; // VR view offset matrices (per eye)
2021-03-20 18:36:25 +01:00
float leftLensCenter [ 2 ] ; // VR left lens center
float rightLensCenter [ 2 ] ; // VR right lens center
float leftScreenCenter [ 2 ] ; // VR left screen center
float rightScreenCenter [ 2 ] ; // VR right screen center
float scale [ 2 ] ; // VR distortion scale
float scaleIn [ 2 ] ; // VR distortion scale in
} VrStereoConfig ;
2022-06-11 23:24:13 +02:00
// File path list
typedef struct FilePathList {
2022-06-12 11:32:10 +02:00
unsigned int capacity ; // Filepaths max entries
2022-06-11 23:24:13 +02:00
unsigned int count ; // Filepaths entries count
char * * paths ; // Filepaths entries
} FilePathList ;
2023-10-30 13:29:14 +01:00
// Automation event
2023-10-26 23:59:19 +02:00
typedef struct AutomationEvent {
2023-10-27 01:19:10 +02:00
unsigned int frame ; // Event frame
unsigned int type ; // Event type (AutomationEventType)
int params [ 4 ] ; // Event parameters (if required)
2023-10-26 23:59:19 +02:00
} AutomationEvent ;
// Automation event list
typedef struct AutomationEventList {
unsigned int capacity ; // Events max entries (MAX_AUTOMATION_EVENTS)
unsigned int count ; // Events entries count
AutomationEvent * events ; // Events entries
} AutomationEventList ;
2017-04-21 00:08:00 +02:00
//----------------------------------------------------------------------------------
// Enumerators Definition
//----------------------------------------------------------------------------------
2020-11-23 00:49:27 +01:00
// System/Window config flags
// NOTE: Every bit registers one state (use it with bit masks)
// By default all flags are set to 0
2018-12-03 11:04:32 +01:00
typedef enum {
2020-11-23 23:46:05 +01:00
FLAG_VSYNC_HINT = 0x00000040 , // Set to try enabling V-Sync on GPU
2020-11-23 00:49:27 +01:00
FLAG_FULLSCREEN_MODE = 0x00000002 , // Set to run program in fullscreen
FLAG_WINDOW_RESIZABLE = 0x00000004 , // Set to allow resizable window
FLAG_WINDOW_UNDECORATED = 0x00000008 , // Set to disable window decoration (frame and buttons)
FLAG_WINDOW_HIDDEN = 0x00000080 , // Set to hide window
FLAG_WINDOW_MINIMIZED = 0x00000200 , // Set to minimize window (iconify)
FLAG_WINDOW_MAXIMIZED = 0x00000400 , // Set to maximize window (expanded to monitor)
FLAG_WINDOW_UNFOCUSED = 0x00000800 , // Set to window non focused
FLAG_WINDOW_TOPMOST = 0x00001000 , // Set to window always on top
FLAG_WINDOW_ALWAYS_RUN = 0x00000100 , // Set to allow windows running while minimized
2020-11-23 23:46:05 +01:00
FLAG_WINDOW_TRANSPARENT = 0x00000010 , // Set to allow transparent framebuffer
FLAG_WINDOW_HIGHDPI = 0x00002000 , // Set to support HighDPI
2022-06-11 18:13:15 +02:00
FLAG_WINDOW_MOUSE_PASSTHROUGH = 0x00004000 , // Set to support mouse passthrough, only supported when FLAG_WINDOW_UNDECORATED
2023-08-02 14:16:35 -03:00
FLAG_BORDERLESS_WINDOWED_MODE = 0x00008000 , // Set to run program in borderless windowed mode
2020-11-23 00:49:27 +01:00
FLAG_MSAA_4X_HINT = 0x00000020 , // Set to try enabling MSAA 4X
FLAG_INTERLACED_HINT = 0x00010000 // Set to try enabling interlaced video format (for V3D)
2021-03-19 13:19:54 +01:00
} ConfigFlags ;
2018-12-03 11:04:32 +01:00
2021-03-19 13:19:54 +01:00
// Trace log level
2021-05-30 18:02:06 +02:00
// NOTE: Organized by priority level
2018-12-03 11:04:32 +01:00
typedef enum {
2019-04-11 00:11:11 +02:00
LOG_ALL = 0 , // Display all logs
2021-05-30 18:02:06 +02:00
LOG_TRACE , // Trace logging, intended for internal use only
LOG_DEBUG , // Debug logging, used for internal debugging, it should be disabled on release builds
LOG_INFO , // Info logging, used for program execution info
LOG_WARNING , // Warning logging, used on recoverable failures
LOG_ERROR , // Error logging, used on unrecoverable failures
LOG_FATAL , // Fatal logging, used to abort program: exit(EXIT_FAILURE)
2019-04-11 00:11:11 +02:00
LOG_NONE // Disable logging
2021-03-19 13:19:54 +01:00
} TraceLogLevel ;
2018-12-03 11:04:32 +01:00
2020-12-18 18:58:02 +01:00
// Keyboard keys (US keyboard layout)
// NOTE: Use GetKeyPressed() to allow redefining
// required keys for alternative layouts
2018-12-03 11:04:32 +01:00
typedef enum {
2021-06-26 22:13:45 +02:00
KEY_NULL = 0 , // Key: NULL, used for no key pressed
2018-12-03 11:04:32 +01:00
// Alphanumeric keys
2021-06-26 22:13:45 +02:00
KEY_APOSTROPHE = 39 , // Key: '
KEY_COMMA = 44 , // Key: ,
KEY_MINUS = 45 , // Key: -
KEY_PERIOD = 46 , // Key: .
KEY_SLASH = 47 , // Key: /
KEY_ZERO = 48 , // Key: 0
KEY_ONE = 49 , // Key: 1
KEY_TWO = 50 , // Key: 2
KEY_THREE = 51 , // Key: 3
KEY_FOUR = 52 , // Key: 4
KEY_FIVE = 53 , // Key: 5
KEY_SIX = 54 , // Key: 6
KEY_SEVEN = 55 , // Key: 7
KEY_EIGHT = 56 , // Key: 8
KEY_NINE = 57 , // Key: 9
KEY_SEMICOLON = 59 , // Key: ;
KEY_EQUAL = 61 , // Key: =
KEY_A = 65 , // Key: A | a
KEY_B = 66 , // Key: B | b
KEY_C = 67 , // Key: C | c
KEY_D = 68 , // Key: D | d
KEY_E = 69 , // Key: E | e
KEY_F = 70 , // Key: F | f
KEY_G = 71 , // Key: G | g
KEY_H = 72 , // Key: H | h
KEY_I = 73 , // Key: I | i
KEY_J = 74 , // Key: J | j
KEY_K = 75 , // Key: K | k
KEY_L = 76 , // Key: L | l
KEY_M = 77 , // Key: M | m
KEY_N = 78 , // Key: N | n
KEY_O = 79 , // Key: O | o
KEY_P = 80 , // Key: P | p
KEY_Q = 81 , // Key: Q | q
KEY_R = 82 , // Key: R | r
KEY_S = 83 , // Key: S | s
KEY_T = 84 , // Key: T | t
KEY_U = 85 , // Key: U | u
KEY_V = 86 , // Key: V | v
KEY_W = 87 , // Key: W | w
KEY_X = 88 , // Key: X | x
KEY_Y = 89 , // Key: Y | y
KEY_Z = 90 , // Key: Z | z
KEY_LEFT_BRACKET = 91 , // Key: [
KEY_BACKSLASH = 92 , // Key: '\'
KEY_RIGHT_BRACKET = 93 , // Key: ]
KEY_GRAVE = 96 , // Key: `
2018-12-03 11:04:32 +01:00
// Function keys
2021-06-26 22:13:45 +02:00
KEY_SPACE = 32 , // Key: Space
KEY_ESCAPE = 256 , // Key: Esc
KEY_ENTER = 257 , // Key: Enter
KEY_TAB = 258 , // Key: Tab
KEY_BACKSPACE = 259 , // Key: Backspace
KEY_INSERT = 260 , // Key: Ins
KEY_DELETE = 261 , // Key: Del
KEY_RIGHT = 262 , // Key: Cursor right
KEY_LEFT = 263 , // Key: Cursor left
KEY_DOWN = 264 , // Key: Cursor down
KEY_UP = 265 , // Key: Cursor up
KEY_PAGE_UP = 266 , // Key: Page up
KEY_PAGE_DOWN = 267 , // Key: Page down
KEY_HOME = 268 , // Key: Home
KEY_END = 269 , // Key: End
KEY_CAPS_LOCK = 280 , // Key: Caps lock
KEY_SCROLL_LOCK = 281 , // Key: Scroll down
KEY_NUM_LOCK = 282 , // Key: Num lock
KEY_PRINT_SCREEN = 283 , // Key: Print screen
KEY_PAUSE = 284 , // Key: Pause
KEY_F1 = 290 , // Key: F1
KEY_F2 = 291 , // Key: F2
KEY_F3 = 292 , // Key: F3
KEY_F4 = 293 , // Key: F4
KEY_F5 = 294 , // Key: F5
KEY_F6 = 295 , // Key: F6
KEY_F7 = 296 , // Key: F7
KEY_F8 = 297 , // Key: F8
KEY_F9 = 298 , // Key: F9
KEY_F10 = 299 , // Key: F10
KEY_F11 = 300 , // Key: F11
KEY_F12 = 301 , // Key: F12
KEY_LEFT_SHIFT = 340 , // Key: Shift left
KEY_LEFT_CONTROL = 341 , // Key: Control left
KEY_LEFT_ALT = 342 , // Key: Alt left
KEY_LEFT_SUPER = 343 , // Key: Super left
KEY_RIGHT_SHIFT = 344 , // Key: Shift right
KEY_RIGHT_CONTROL = 345 , // Key: Control right
KEY_RIGHT_ALT = 346 , // Key: Alt right
KEY_RIGHT_SUPER = 347 , // Key: Super right
KEY_KB_MENU = 348 , // Key: KB menu
2018-12-03 11:04:32 +01:00
// Keypad keys
2021-06-26 22:13:45 +02:00
KEY_KP_0 = 320 , // Key: Keypad 0
KEY_KP_1 = 321 , // Key: Keypad 1
KEY_KP_2 = 322 , // Key: Keypad 2
KEY_KP_3 = 323 , // Key: Keypad 3
KEY_KP_4 = 324 , // Key: Keypad 4
KEY_KP_5 = 325 , // Key: Keypad 5
KEY_KP_6 = 326 , // Key: Keypad 6
KEY_KP_7 = 327 , // Key: Keypad 7
KEY_KP_8 = 328 , // Key: Keypad 8
KEY_KP_9 = 329 , // Key: Keypad 9
KEY_KP_DECIMAL = 330 , // Key: Keypad .
KEY_KP_DIVIDE = 331 , // Key: Keypad /
KEY_KP_MULTIPLY = 332 , // Key: Keypad *
KEY_KP_SUBTRACT = 333 , // Key: Keypad -
KEY_KP_ADD = 334 , // Key: Keypad +
KEY_KP_ENTER = 335 , // Key: Keypad Enter
KEY_KP_EQUAL = 336 , // Key: Keypad =
2021-03-19 13:19:54 +01:00
// Android key buttons
2021-06-26 22:13:45 +02:00
KEY_BACK = 4 , // Key: Android back button
2024-01-20 17:22:33 -03:00
KEY_MENU = 5 , // Key: Android menu button
2021-06-26 22:13:45 +02:00
KEY_VOLUME_UP = 24 , // Key: Android volume up button
KEY_VOLUME_DOWN = 25 // Key: Android volume down button
2021-03-19 13:19:54 +01:00
} KeyboardKey ;
2018-12-03 11:04:32 +01:00
2021-05-08 09:26:24 -07:00
// Add backwards compatibility support for deprecated names
# define MOUSE_LEFT_BUTTON MOUSE_BUTTON_LEFT
# define MOUSE_RIGHT_BUTTON MOUSE_BUTTON_RIGHT
# define MOUSE_MIDDLE_BUTTON MOUSE_BUTTON_MIDDLE
2018-12-03 11:04:32 +01:00
// Mouse buttons
typedef enum {
2021-06-26 22:13:45 +02:00
MOUSE_BUTTON_LEFT = 0 , // Mouse button left
MOUSE_BUTTON_RIGHT = 1 , // Mouse button right
MOUSE_BUTTON_MIDDLE = 2 , // Mouse button middle (pressed wheel)
MOUSE_BUTTON_SIDE = 3 , // Mouse button side (advanced mouse device)
MOUSE_BUTTON_EXTRA = 4 , // Mouse button extra (advanced mouse device)
2022-09-28 21:04:41 +03:00
MOUSE_BUTTON_FORWARD = 5 , // Mouse button forward (advanced mouse device)
2021-06-26 22:13:45 +02:00
MOUSE_BUTTON_BACK = 6 , // Mouse button back (advanced mouse device)
2018-12-03 11:04:32 +01:00
} MouseButton ;
2021-03-19 13:19:54 +01:00
// Mouse cursor
2020-10-21 03:55:52 -05:00
typedef enum {
2021-06-26 22:13:45 +02:00
MOUSE_CURSOR_DEFAULT = 0 , // Default pointer shape
MOUSE_CURSOR_ARROW = 1 , // Arrow shape
2021-06-30 16:39:07 +02:00
MOUSE_CURSOR_IBEAM = 2 , // Text writing cursor shape
MOUSE_CURSOR_CROSSHAIR = 3 , // Cross shape
2021-06-26 22:13:45 +02:00
MOUSE_CURSOR_POINTING_HAND = 4 , // Pointing hand cursor
MOUSE_CURSOR_RESIZE_EW = 5 , // Horizontal resize/move arrow shape
MOUSE_CURSOR_RESIZE_NS = 6 , // Vertical resize/move arrow shape
MOUSE_CURSOR_RESIZE_NWSE = 7 , // Top-left to bottom-right diagonal resize/move arrow shape
2020-10-21 11:08:37 +02:00
MOUSE_CURSOR_RESIZE_NESW = 8 , // The top-right to bottom-left diagonal resize/move arrow shape
2023-02-09 07:17:47 -05:00
MOUSE_CURSOR_RESIZE_ALL = 9 , // The omnidirectional resize/move cursor shape
2020-10-21 11:08:37 +02:00
MOUSE_CURSOR_NOT_ALLOWED = 10 // The operation-not-allowed shape
2020-10-21 03:55:52 -05:00
} MouseCursor ;
2020-10-24 10:37:15 +02:00
// Gamepad buttons
2019-04-28 18:23:21 +02:00
typedef enum {
2021-06-26 22:13:45 +02:00
GAMEPAD_BUTTON_UNKNOWN = 0 , // Unknown button, just for error checking
GAMEPAD_BUTTON_LEFT_FACE_UP , // Gamepad left DPAD up button
GAMEPAD_BUTTON_LEFT_FACE_RIGHT , // Gamepad left DPAD right button
GAMEPAD_BUTTON_LEFT_FACE_DOWN , // Gamepad left DPAD down button
GAMEPAD_BUTTON_LEFT_FACE_LEFT , // Gamepad left DPAD left button
GAMEPAD_BUTTON_RIGHT_FACE_UP , // Gamepad right button up (i.e. PS3: Triangle, Xbox: Y)
2024-03-29 01:40:20 +01:00
GAMEPAD_BUTTON_RIGHT_FACE_RIGHT , // Gamepad right button right (i.e. PS3: Circle, Xbox: B)
2021-06-26 22:13:45 +02:00
GAMEPAD_BUTTON_RIGHT_FACE_DOWN , // Gamepad right button down (i.e. PS3: Cross, Xbox: A)
2024-03-29 01:40:20 +01:00
GAMEPAD_BUTTON_RIGHT_FACE_LEFT , // Gamepad right button left (i.e. PS3: Square, Xbox: X)
2021-06-26 22:13:45 +02:00
GAMEPAD_BUTTON_LEFT_TRIGGER_1 , // Gamepad top/back trigger left (first), it could be a trailing button
GAMEPAD_BUTTON_LEFT_TRIGGER_2 , // Gamepad top/back trigger left (second), it could be a trailing button
2024-04-30 23:47:11 +02:00
GAMEPAD_BUTTON_RIGHT_TRIGGER_1 , // Gamepad top/back trigger right (first), it could be a trailing button
2021-06-26 22:13:45 +02:00
GAMEPAD_BUTTON_RIGHT_TRIGGER_2 , // Gamepad top/back trigger right (second), it could be a trailing button
GAMEPAD_BUTTON_MIDDLE_LEFT , // Gamepad center buttons, left one (i.e. PS3: Select)
GAMEPAD_BUTTON_MIDDLE , // Gamepad center buttons, middle one (i.e. PS3: PS, Xbox: XBOX)
GAMEPAD_BUTTON_MIDDLE_RIGHT , // Gamepad center buttons, right one (i.e. PS3: Start)
GAMEPAD_BUTTON_LEFT_THUMB , // Gamepad joystick pressed button left
GAMEPAD_BUTTON_RIGHT_THUMB // Gamepad joystick pressed button right
2019-04-27 20:49:33 +01:00
} GamepadButton ;
2025-05-29 23:01:43 -03:00
// Gamepad axes
2019-04-28 18:23:21 +02:00
typedef enum {
2021-06-26 22:13:45 +02:00
GAMEPAD_AXIS_LEFT_X = 0 , // Gamepad left stick X axis
GAMEPAD_AXIS_LEFT_Y = 1 , // Gamepad left stick Y axis
GAMEPAD_AXIS_RIGHT_X = 2 , // Gamepad right stick X axis
GAMEPAD_AXIS_RIGHT_Y = 3 , // Gamepad right stick Y axis
GAMEPAD_AXIS_LEFT_TRIGGER = 4 , // Gamepad back trigger left, pressure level: [1..-1]
GAMEPAD_AXIS_RIGHT_TRIGGER = 5 // Gamepad back trigger right, pressure level: [1..-1]
2019-04-27 20:49:33 +01:00
} GamepadAxis ;
2021-03-25 14:28:12 +01:00
// Material map index
typedef enum {
2023-01-02 17:06:52 +01:00
MATERIAL_MAP_ALBEDO = 0 , // Albedo material (same as: MATERIAL_MAP_DIFFUSE)
2023-12-28 22:10:10 +01:00
MATERIAL_MAP_METALNESS , // Metalness material (same as: MATERIAL_MAP_SPECULAR)
2023-12-28 23:17:07 +01:00
MATERIAL_MAP_NORMAL , // Normal material
2021-06-10 11:31:34 +02:00
MATERIAL_MAP_ROUGHNESS , // Roughness material
MATERIAL_MAP_OCCLUSION , // Ambient occlusion material
MATERIAL_MAP_EMISSION , // Emission material
MATERIAL_MAP_HEIGHT , // Heightmap material
MATERIAL_MAP_CUBEMAP , // Cubemap material (NOTE: Uses GL_TEXTURE_CUBE_MAP)
MATERIAL_MAP_IRRADIANCE , // Irradiance material (NOTE: Uses GL_TEXTURE_CUBE_MAP)
2021-06-10 11:38:02 +02:00
MATERIAL_MAP_PREFILTER , // Prefilter material (NOTE: Uses GL_TEXTURE_CUBE_MAP)
2021-10-02 13:07:42 +01:00
MATERIAL_MAP_BRDF // Brdf material
2021-03-25 14:28:12 +01:00
} MaterialMapIndex ;
# define MATERIAL_MAP_DIFFUSE MATERIAL_MAP_ALBEDO
# define MATERIAL_MAP_SPECULAR MATERIAL_MAP_METALNESS
2021-03-19 13:19:54 +01:00
// Shader location index
2017-07-17 00:33:40 +02:00
typedef enum {
2021-06-25 00:46:14 +02:00
SHADER_LOC_VERTEX_POSITION = 0 , // Shader location: vertex attribute: position
SHADER_LOC_VERTEX_TEXCOORD01 , // Shader location: vertex attribute: texcoord01
SHADER_LOC_VERTEX_TEXCOORD02 , // Shader location: vertex attribute: texcoord02
SHADER_LOC_VERTEX_NORMAL , // Shader location: vertex attribute: normal
SHADER_LOC_VERTEX_TANGENT , // Shader location: vertex attribute: tangent
SHADER_LOC_VERTEX_COLOR , // Shader location: vertex attribute: color
SHADER_LOC_MATRIX_MVP , // Shader location: matrix uniform: model-view-projection
SHADER_LOC_MATRIX_VIEW , // Shader location: matrix uniform: view (camera transform)
SHADER_LOC_MATRIX_PROJECTION , // Shader location: matrix uniform: projection
SHADER_LOC_MATRIX_MODEL , // Shader location: matrix uniform: model (transform)
SHADER_LOC_MATRIX_NORMAL , // Shader location: matrix uniform: normal
SHADER_LOC_VECTOR_VIEW , // Shader location: vector uniform: view
SHADER_LOC_COLOR_DIFFUSE , // Shader location: vector uniform: diffuse color
SHADER_LOC_COLOR_SPECULAR , // Shader location: vector uniform: specular color
SHADER_LOC_COLOR_AMBIENT , // Shader location: vector uniform: ambient color
SHADER_LOC_MAP_ALBEDO , // Shader location: sampler2d texture: albedo (same as: SHADER_LOC_MAP_DIFFUSE)
SHADER_LOC_MAP_METALNESS , // Shader location: sampler2d texture: metalness (same as: SHADER_LOC_MAP_SPECULAR)
SHADER_LOC_MAP_NORMAL , // Shader location: sampler2d texture: normal
SHADER_LOC_MAP_ROUGHNESS , // Shader location: sampler2d texture: roughness
SHADER_LOC_MAP_OCCLUSION , // Shader location: sampler2d texture: occlusion
SHADER_LOC_MAP_EMISSION , // Shader location: sampler2d texture: emission
SHADER_LOC_MAP_HEIGHT , // Shader location: sampler2d texture: height
SHADER_LOC_MAP_CUBEMAP , // Shader location: samplerCube texture: cubemap
SHADER_LOC_MAP_IRRADIANCE , // Shader location: samplerCube texture: irradiance
SHADER_LOC_MAP_PREFILTER , // Shader location: samplerCube texture: prefilter
2024-09-20 11:30:37 -04:00
SHADER_LOC_MAP_BRDF , // Shader location: sampler2d texture: brdf
SHADER_LOC_VERTEX_BONEIDS , // Shader location: vertex attribute: boneIds
SHADER_LOC_VERTEX_BONEWEIGHTS , // Shader location: vertex attribute: boneWeights
2024-12-08 12:48:54 +01:00
SHADER_LOC_BONE_MATRICES , // Shader location: array of matrices uniform: boneMatrices
SHADER_LOC_VERTEX_INSTANCE_TX // Shader location: vertex attribute: instanceTransform
2017-07-17 00:33:40 +02:00
} ShaderLocationIndex ;
2021-03-14 11:05:51 +01:00
# define SHADER_LOC_MAP_DIFFUSE SHADER_LOC_MAP_ALBEDO
# define SHADER_LOC_MAP_SPECULAR SHADER_LOC_MAP_METALNESS
2017-07-17 00:33:40 +02:00
2021-03-19 13:19:54 +01:00
// Shader uniform data type
2019-01-10 11:25:26 +01:00
typedef enum {
2021-06-10 11:31:34 +02:00
SHADER_UNIFORM_FLOAT = 0 , // Shader uniform type: float
SHADER_UNIFORM_VEC2 , // Shader uniform type: vec2 (2 float)
SHADER_UNIFORM_VEC3 , // Shader uniform type: vec3 (3 float)
SHADER_UNIFORM_VEC4 , // Shader uniform type: vec4 (4 float)
SHADER_UNIFORM_INT , // Shader uniform type: int
SHADER_UNIFORM_IVEC2 , // Shader uniform type: ivec2 (2 int)
SHADER_UNIFORM_IVEC3 , // Shader uniform type: ivec3 (3 int)
SHADER_UNIFORM_IVEC4 , // Shader uniform type: ivec4 (4 int)
2024-12-08 12:52:06 +01:00
SHADER_UNIFORM_UINT , // Shader uniform type: unsigned int
SHADER_UNIFORM_UIVEC2 , // Shader uniform type: uivec2 (2 unsigned int)
SHADER_UNIFORM_UIVEC3 , // Shader uniform type: uivec3 (3 unsigned int)
SHADER_UNIFORM_UIVEC4 , // Shader uniform type: uivec4 (4 unsigned int)
2021-06-10 11:31:34 +02:00
SHADER_UNIFORM_SAMPLER2D // Shader uniform type: sampler2d
2019-01-10 11:25:26 +01:00
} ShaderUniformDataType ;
2021-06-10 11:31:34 +02:00
// Shader attribute data types
typedef enum {
SHADER_ATTRIB_FLOAT = 0 , // Shader attribute type: float
SHADER_ATTRIB_VEC2 , // Shader attribute type: vec2 (2 float)
SHADER_ATTRIB_VEC3 , // Shader attribute type: vec3 (3 float)
SHADER_ATTRIB_VEC4 // Shader attribute type: vec4 (4 float)
} ShaderAttributeDataType ;
2018-01-06 13:43:48 +01:00
// Pixel formats
2015-05-04 23:46:31 +02:00
// NOTE: Support depends on OpenGL version and platform
2015-04-06 14:02:29 +02:00
typedef enum {
2021-06-10 11:31:34 +02:00
PIXELFORMAT_UNCOMPRESSED_GRAYSCALE = 1 , // 8 bit per pixel (no alpha)
PIXELFORMAT_UNCOMPRESSED_GRAY_ALPHA , // 8*2 bpp (2 channels)
PIXELFORMAT_UNCOMPRESSED_R5G6B5 , // 16 bpp
PIXELFORMAT_UNCOMPRESSED_R8G8B8 , // 24 bpp
PIXELFORMAT_UNCOMPRESSED_R5G5B5A1 , // 16 bpp (1 bit alpha)
PIXELFORMAT_UNCOMPRESSED_R4G4B4A4 , // 16 bpp (4 bit alpha)
PIXELFORMAT_UNCOMPRESSED_R8G8B8A8 , // 32 bpp
PIXELFORMAT_UNCOMPRESSED_R32 , // 32 bpp (1 channel - float)
PIXELFORMAT_UNCOMPRESSED_R32G32B32 , // 32*3 bpp (3 channels - float)
PIXELFORMAT_UNCOMPRESSED_R32G32B32A32 , // 32*4 bpp (4 channels - float)
2023-08-05 23:16:26 +02:00
PIXELFORMAT_UNCOMPRESSED_R16 , // 16 bpp (1 channel - half float)
PIXELFORMAT_UNCOMPRESSED_R16G16B16 , // 16*3 bpp (3 channels - half float)
PIXELFORMAT_UNCOMPRESSED_R16G16B16A16 , // 16*4 bpp (4 channels - half float)
2021-06-10 11:31:34 +02:00
PIXELFORMAT_COMPRESSED_DXT1_RGB , // 4 bpp (no alpha)
PIXELFORMAT_COMPRESSED_DXT1_RGBA , // 4 bpp (1 bit alpha)
PIXELFORMAT_COMPRESSED_DXT3_RGBA , // 8 bpp
PIXELFORMAT_COMPRESSED_DXT5_RGBA , // 8 bpp
PIXELFORMAT_COMPRESSED_ETC1_RGB , // 4 bpp
PIXELFORMAT_COMPRESSED_ETC2_RGB , // 4 bpp
PIXELFORMAT_COMPRESSED_ETC2_EAC_RGBA , // 8 bpp
PIXELFORMAT_COMPRESSED_PVRT_RGB , // 4 bpp
PIXELFORMAT_COMPRESSED_PVRT_RGBA , // 4 bpp
PIXELFORMAT_COMPRESSED_ASTC_4x4_RGBA , // 8 bpp
PIXELFORMAT_COMPRESSED_ASTC_8x8_RGBA // 2 bpp
2018-01-06 13:43:48 +01:00
} PixelFormat ;
2015-04-06 14:02:29 +02:00
2016-10-27 13:41:43 +02:00
// Texture parameters: filter mode
2016-10-29 22:17:19 +02:00
// NOTE 1: Filtering considers mipmaps if available in the texture
// NOTE 2: Filter is accordingly set for minification and magnification
2016-12-22 03:19:49 +02:00
typedef enum {
2021-11-22 02:06:52 +09:00
TEXTURE_FILTER_POINT = 0 , // No filter, just pixel approximation
2021-03-03 19:47:37 +01:00
TEXTURE_FILTER_BILINEAR , // Linear filtering
TEXTURE_FILTER_TRILINEAR , // Trilinear filtering (linear with mipmaps)
TEXTURE_FILTER_ANISOTROPIC_4X , // Anisotropic filtering 4x
TEXTURE_FILTER_ANISOTROPIC_8X , // Anisotropic filtering 8x
TEXTURE_FILTER_ANISOTROPIC_16X , // Anisotropic filtering 16x
2021-03-19 13:19:54 +01:00
} TextureFilter ;
2016-10-27 13:41:43 +02:00
2020-10-24 10:37:15 +02:00
// Texture parameters: wrap mode
typedef enum {
2021-06-10 11:31:34 +02:00
TEXTURE_WRAP_REPEAT = 0 , // Repeats texture in tiled mode
TEXTURE_WRAP_CLAMP , // Clamps texture to edge pixel in tiled mode
TEXTURE_WRAP_MIRROR_REPEAT , // Mirrors and repeats the texture in tiled mode
TEXTURE_WRAP_MIRROR_CLAMP // Mirrors and clamps to border the texture in tiled mode
2021-03-19 13:19:54 +01:00
} TextureWrap ;
2020-10-24 10:37:15 +02:00
// Cubemap layouts
2019-02-04 13:27:36 +01:00
typedef enum {
2021-06-10 11:31:34 +02:00
CUBEMAP_LAYOUT_AUTO_DETECT = 0 , // Automatically detect layout type
CUBEMAP_LAYOUT_LINE_VERTICAL , // Layout is defined by a vertical line with faces
2023-02-09 07:17:47 -05:00
CUBEMAP_LAYOUT_LINE_HORIZONTAL , // Layout is defined by a horizontal line with faces
2021-06-10 11:31:34 +02:00
CUBEMAP_LAYOUT_CROSS_THREE_BY_FOUR , // Layout is defined by a 3x4 cross with cubemap faces
2024-10-24 00:06:24 -07:00
CUBEMAP_LAYOUT_CROSS_FOUR_BY_THREE // Layout is defined by a 4x3 cross with cubemap faces
2021-03-19 13:19:54 +01:00
} CubemapLayout ;
2019-02-04 13:27:36 +01:00
2018-09-06 16:56:21 +02:00
// Font type, defines generation method
typedef enum {
2021-06-10 11:31:34 +02:00
FONT_DEFAULT = 0 , // Default font generation, anti-aliased
FONT_BITMAP , // Bitmap font generation, no anti-aliasing
FONT_SDF // SDF font generation, requires external shader
2018-09-06 16:56:21 +02:00
} FontType ;
2015-08-07 17:24:28 +02:00
// Color blending modes (pre-defined)
2018-06-30 21:56:26 +02:00
typedef enum {
2021-06-10 11:31:34 +02:00
BLEND_ALPHA = 0 , // Blend textures considering alpha (default)
BLEND_ADDITIVE , // Blend textures adding colors
BLEND_MULTIPLIED , // Blend textures multiplying colors
BLEND_ADD_COLORS , // Blend textures adding colors (alternative)
BLEND_SUBTRACT_COLORS , // Blend textures subtracting colors (alternative)
2022-06-07 18:46:14 +02:00
BLEND_ALPHA_PREMULTIPLY , // Blend premultiplied textures considering alpha
2022-11-22 01:02:54 +01:00
BLEND_CUSTOM , // Blend textures using custom src/dst factors (use rlSetBlendFactors())
BLEND_CUSTOM_SEPARATE // Blend textures using custom rgb/alpha separate src/dst factors (use rlSetBlendFactorsSeparate())
2017-04-21 00:08:00 +02:00
} BlendMode ;
2015-08-07 17:24:28 +02:00
2021-09-10 19:01:24 +02:00
// Gesture
2023-01-02 17:06:52 +01:00
// NOTE: Provided as bit-wise flags to enable only desired gestures
2015-05-04 23:46:31 +02:00
typedef enum {
2021-06-10 11:31:34 +02:00
GESTURE_NONE = 0 , // No gesture
GESTURE_TAP = 1 , // Tap gesture
GESTURE_DOUBLETAP = 2 , // Double tap gesture
GESTURE_HOLD = 4 , // Hold gesture
GESTURE_DRAG = 8 , // Drag gesture
GESTURE_SWIPE_RIGHT = 16 , // Swipe right gesture
GESTURE_SWIPE_LEFT = 32 , // Swipe left gesture
GESTURE_SWIPE_UP = 64 , // Swipe up gesture
GESTURE_SWIPE_DOWN = 128 , // Swipe down gesture
GESTURE_PINCH_IN = 256 , // Pinch in gesture
GESTURE_PINCH_OUT = 512 // Pinch out gesture
2021-05-31 20:40:27 +02:00
} Gesture ;
2015-05-04 23:46:31 +02:00
2015-07-29 21:45:28 +02:00
// Camera system modes
2016-12-22 03:19:49 +02:00
typedef enum {
2024-04-28 17:39:28 -03:00
CAMERA_CUSTOM = 0 , // Camera custom, controlled by user (UpdateCamera() does nothing)
CAMERA_FREE , // Camera free mode
CAMERA_ORBITAL , // Camera orbital, around target, zoom supported
CAMERA_FIRST_PERSON , // Camera first person
CAMERA_THIRD_PERSON // Camera third person
2016-09-25 14:28:24 +02:00
} CameraMode ;
2015-07-29 21:45:28 +02:00
2021-03-19 13:19:54 +01:00
// Camera projection
2018-04-11 10:13:00 +02:00
typedef enum {
2021-06-10 11:31:34 +02:00
CAMERA_PERSPECTIVE = 0 , // Perspective projection
CAMERA_ORTHOGRAPHIC // Orthographic projection
2021-03-19 13:19:54 +01:00
} CameraProjection ;
2018-04-11 10:13:00 +02:00
2021-03-19 13:19:54 +01:00
// N-patch layout
2018-08-03 20:50:13 -03:00
typedef enum {
2021-03-19 13:19:54 +01:00
NPATCH_NINE_PATCH = 0 , // Npatch layout: 3x3 tiles
NPATCH_THREE_PATCH_VERTICAL , // Npatch layout: 1x3 tiles
NPATCH_THREE_PATCH_HORIZONTAL // Npatch layout: 3x1 tiles
} NPatchLayout ;
2018-08-03 20:50:13 -03:00
2021-03-04 20:44:22 +01:00
// Callbacks to hook some internal functions
2024-05-30 02:22:07 -04:00
// WARNING: These callbacks are intended for advanced users
2021-03-19 13:19:54 +01:00
typedef void ( * TraceLogCallback ) ( int logLevel , const char * text , va_list args ) ; // Logging: Redirect trace log messages
2023-09-13 17:05:38 +02:00
typedef unsigned char * ( * LoadFileDataCallback ) ( const char * fileName , int * dataSize ) ; // FileIO: Load binary data
typedef bool ( * SaveFileDataCallback ) ( const char * fileName , void * data , int dataSize ) ; // FileIO: Save binary data
2022-06-11 23:24:13 +02:00
typedef char * ( * LoadFileTextCallback ) ( const char * fileName ) ; // FileIO: Load text data
2025-05-12 19:54:34 -07:00
typedef bool ( * SaveFileTextCallback ) ( const char * fileName , const char * text ) ; // FileIO: Save text data
2021-03-04 12:06:28 +01:00
2013-11-18 23:38:44 +01:00
//------------------------------------------------------------------------------------
// Global Variables Definition
//------------------------------------------------------------------------------------
// It's lonely here...
//------------------------------------------------------------------------------------
// Window and Graphics Device Functions (Module: core)
//------------------------------------------------------------------------------------
2017-05-15 11:30:09 +02:00
2021-08-15 13:02:53 +02:00
# if defined(__cplusplus)
extern " C " { // Prevents name mangling of functions
# endif
2017-05-15 11:30:09 +02:00
// Window-related functions
2018-04-02 14:49:01 +02:00
RLAPI void InitWindow ( int width , int height , const char * title ) ; // Initialize window and OpenGL context
2017-12-15 13:44:31 +01:00
RLAPI void CloseWindow ( void ) ; // Close window and unload OpenGL context
2023-10-08 18:10:05 +02:00
RLAPI bool WindowShouldClose ( void ) ; // Check if application should close (KEY_ESCAPE pressed or windows close icon clicked)
2018-02-04 12:26:28 +01:00
RLAPI bool IsWindowReady ( void ) ; // Check if window has been initialized successfully
2020-03-25 18:52:38 +01:00
RLAPI bool IsWindowFullscreen ( void ) ; // Check if window is currently fullscreen
2024-10-24 09:59:54 +02:00
RLAPI bool IsWindowHidden ( void ) ; // Check if window is currently hidden
RLAPI bool IsWindowMinimized ( void ) ; // Check if window is currently minimized
RLAPI bool IsWindowMaximized ( void ) ; // Check if window is currently maximized
RLAPI bool IsWindowFocused ( void ) ; // Check if window is currently focused
2020-11-23 00:49:27 +01:00
RLAPI bool IsWindowResized ( void ) ; // Check if window has been resized last frame
RLAPI bool IsWindowState ( unsigned int flag ) ; // Check if one specific window flag is enabled
2024-10-24 09:59:54 +02:00
RLAPI void SetWindowState ( unsigned int flags ) ; // Set window configuration state using flags
2020-11-23 23:46:05 +01:00
RLAPI void ClearWindowState ( unsigned int flags ) ; // Clear window configuration state flags
2024-10-24 09:59:54 +02:00
RLAPI void ToggleFullscreen ( void ) ; // Toggle window state: fullscreen/windowed, resizes monitor to match window resolution
RLAPI void ToggleBorderlessWindowed ( void ) ; // Toggle window state: borderless windowed, resizes window to match monitor resolution
RLAPI void MaximizeWindow ( void ) ; // Set window state: maximized, if resizable
RLAPI void MinimizeWindow ( void ) ; // Set window state: minimized, if resizable
2025-03-28 10:37:32 -06:00
RLAPI void RestoreWindow ( void ) ; // Restore window from being minimized/maximized
2024-10-24 09:59:54 +02:00
RLAPI void SetWindowIcon ( Image image ) ; // Set icon for window (single image, RGBA 32bit)
RLAPI void SetWindowIcons ( Image * images , int count ) ; // Set icon for window (multiple images, RGBA 32bit)
RLAPI void SetWindowTitle ( const char * title ) ; // Set title for window
RLAPI void SetWindowPosition ( int x , int y ) ; // Set window position on screen
2023-07-28 15:08:41 -03:00
RLAPI void SetWindowMonitor ( int monitor ) ; // Set monitor for the current window
2017-05-02 15:04:32 +02:00
RLAPI void SetWindowMinSize ( int width , int height ) ; // Set window minimum dimensions (for FLAG_WINDOW_RESIZABLE)
2023-09-13 11:37:11 -03:00
RLAPI void SetWindowMaxSize ( int width , int height ) ; // Set window maximum dimensions (for FLAG_WINDOW_RESIZABLE)
2018-03-09 11:43:53 +01:00
RLAPI void SetWindowSize ( int width , int height ) ; // Set window dimensions
2024-10-24 09:59:54 +02:00
RLAPI void SetWindowOpacity ( float opacity ) ; // Set window opacity [0.0f..1.0f]
RLAPI void SetWindowFocused ( void ) ; // Set window focused
2019-01-10 17:06:26 +01:00
RLAPI void * GetWindowHandle ( void ) ; // Get native window handle
2016-08-13 11:31:15 +02:00
RLAPI int GetScreenWidth ( void ) ; // Get current screen width
RLAPI int GetScreenHeight ( void ) ; // Get current screen height
2021-11-25 01:07:54 +01:00
RLAPI int GetRenderWidth ( void ) ; // Get current render width (it considers HiDPI)
RLAPI int GetRenderHeight ( void ) ; // Get current render height (it considers HiDPI)
2018-09-27 16:23:11 +01:00
RLAPI int GetMonitorCount ( void ) ; // Get number of connected monitors
2024-10-24 11:57:36 +02:00
RLAPI int GetCurrentMonitor ( void ) ; // Get current monitor where window is placed
2020-12-05 12:51:20 -08:00
RLAPI Vector2 GetMonitorPosition ( int monitor ) ; // Get specified monitor position
2022-06-09 21:00:04 +02:00
RLAPI int GetMonitorWidth ( int monitor ) ; // Get specified monitor width (current video mode used by monitor)
RLAPI int GetMonitorHeight ( int monitor ) ; // Get specified monitor height (current video mode used by monitor)
2020-12-05 12:51:20 -08:00
RLAPI int GetMonitorPhysicalWidth ( int monitor ) ; // Get specified monitor physical width in millimetres
RLAPI int GetMonitorPhysicalHeight ( int monitor ) ; // Get specified monitor physical height in millimetres
RLAPI int GetMonitorRefreshRate ( int monitor ) ; // Get specified monitor refresh rate
2019-09-10 12:43:44 +02:00
RLAPI Vector2 GetWindowPosition ( void ) ; // Get window position XY on monitor
2020-04-24 23:17:32 +02:00
RLAPI Vector2 GetWindowScaleDPI ( void ) ; // Get window scale DPI factor
2023-07-20 11:56:35 +03:00
RLAPI const char * GetMonitorName ( int monitor ) ; // Get the human-readable, UTF-8 encoded name of the specified monitor
2019-02-11 18:03:06 +01:00
RLAPI void SetClipboardText ( const char * text ) ; // Set clipboard text content
2020-10-24 10:37:15 +02:00
RLAPI const char * GetClipboardText ( void ) ; // Get clipboard text content
2024-11-16 18:45:16 +01:00
RLAPI Image GetClipboardImage ( void ) ; // Get clipboard image content
2022-05-12 16:51:46 +02:00
RLAPI void EnableEventWaiting ( void ) ; // Enable waiting for events on EndDrawing(), no automatic event polling
RLAPI void DisableEventWaiting ( void ) ; // Disable waiting for events on EndDrawing(), automatic events polling
2016-08-13 11:31:15 +02:00
2017-05-15 11:30:09 +02:00
// Cursor-related functions
2017-12-15 13:44:31 +01:00
RLAPI void ShowCursor ( void ) ; // Shows cursor
RLAPI void HideCursor ( void ) ; // Hides cursor
2017-05-09 22:03:46 +02:00
RLAPI bool IsCursorHidden ( void ) ; // Check if cursor is not visible
RLAPI void EnableCursor ( void ) ; // Enables cursor (unlock cursor)
RLAPI void DisableCursor ( void ) ; // Disables cursor (lock cursor)
2021-05-20 19:14:42 +02:00
RLAPI bool IsCursorOnScreen ( void ) ; // Check if cursor is on the screen
2016-08-13 11:31:15 +02:00
2017-05-15 11:30:09 +02:00
// Drawing-related functions
2017-05-09 22:03:46 +02:00
RLAPI void ClearBackground ( Color color ) ; // Set background color (framebuffer clear color)
RLAPI void BeginDrawing ( void ) ; // Setup canvas (framebuffer) to start drawing
RLAPI void EndDrawing ( void ) ; // End canvas drawing and swap buffers (double buffering)
2021-05-22 14:35:10 +02:00
RLAPI void BeginMode2D ( Camera2D camera ) ; // Begin 2D mode with custom camera (2D)
2018-05-04 16:54:05 +02:00
RLAPI void EndMode2D ( void ) ; // Ends 2D mode with custom camera
2021-05-22 14:35:10 +02:00
RLAPI void BeginMode3D ( Camera3D camera ) ; // Begin 3D mode with custom camera (3D)
2018-05-04 16:54:05 +02:00
RLAPI void EndMode3D ( void ) ; // Ends 3D mode and returns to default 2D orthographic mode
2021-05-22 14:35:10 +02:00
RLAPI void BeginTextureMode ( RenderTexture2D target ) ; // Begin drawing to render texture
2016-08-13 11:31:15 +02:00
RLAPI void EndTextureMode ( void ) ; // Ends drawing to render texture
2021-04-06 13:10:12 +02:00
RLAPI void BeginShaderMode ( Shader shader ) ; // Begin custom shader drawing
RLAPI void EndShaderMode ( void ) ; // End custom shader drawing (use default shader)
2021-06-01 10:00:19 -03:00
RLAPI void BeginBlendMode ( int mode ) ; // Begin blending mode (alpha, additive, multiplied, subtract, custom)
2021-04-06 13:10:12 +02:00
RLAPI void EndBlendMode ( void ) ; // End blending mode (reset to default: alpha blending)
2021-04-06 22:49:41 +02:00
RLAPI void BeginScissorMode ( int x , int y , int width , int height ) ; // Begin scissor mode (define screen area for following drawing)
RLAPI void EndScissorMode ( void ) ; // End scissor mode
2021-04-06 23:23:03 +02:00
RLAPI void BeginVrStereoMode ( VrStereoConfig config ) ; // Begin stereo rendering (requires VR simulator)
2021-04-06 22:49:41 +02:00
RLAPI void EndVrStereoMode ( void ) ; // End stereo rendering (requires VR simulator)
// VR stereo config functions for VR simulator
2021-04-06 23:06:03 +02:00
RLAPI VrStereoConfig LoadVrStereoConfig ( VrDeviceInfo device ) ; // Load VR stereo config for VR simulator device parameters
2021-04-06 22:49:41 +02:00
RLAPI void UnloadVrStereoConfig ( VrStereoConfig config ) ; // Unload VR stereo config
2021-04-06 13:10:12 +02:00
// Shader management functions
// NOTE: Shader functionality is not available on OpenGL 1.1
RLAPI Shader LoadShader ( const char * vsFileName , const char * fsFileName ) ; // Load shader from files and bind default locations
RLAPI Shader LoadShaderFromMemory ( const char * vsCode , const char * fsCode ) ; // Load shader from code strings and bind default locations
2024-10-16 19:26:12 +02:00
RLAPI bool IsShaderValid ( Shader shader ) ; // Check if a shader is valid (loaded on GPU)
2021-04-06 13:10:12 +02:00
RLAPI int GetShaderLocation ( Shader shader , const char * uniformName ) ; // Get shader uniform location
RLAPI int GetShaderLocationAttrib ( Shader shader , const char * attribName ) ; // Get shader attribute location
RLAPI void SetShaderValue ( Shader shader , int locIndex , const void * value , int uniformType ) ; // Set shader uniform value
RLAPI void SetShaderValueV ( Shader shader , int locIndex , const void * value , int uniformType , int count ) ; // Set shader uniform value vector
RLAPI void SetShaderValueMatrix ( Shader shader , int locIndex , Matrix mat ) ; // Set shader uniform value (matrix 4x4)
2025-01-19 03:24:48 +08:00
RLAPI void SetShaderValueTexture ( Shader shader , int locIndex , Texture2D texture ) ; // Set shader uniform value and bind the texture (sampler2d)
2021-04-06 13:10:12 +02:00
RLAPI void UnloadShader ( Shader shader ) ; // Unload shader from GPU memory (VRAM)
2016-08-13 11:31:15 +02:00
2017-05-15 11:30:09 +02:00
// Screen-space-related functions
2024-03-07 12:33:37 +01:00
# define GetMouseRay GetScreenToWorldRay // Compatibility hack for previous raylib versions
2024-04-04 13:18:28 +02:00
RLAPI Ray GetScreenToWorldRay ( Vector2 position , Camera camera ) ; // Get a ray trace from screen position (i.e mouse)
2024-04-03 20:10:15 +02:00
RLAPI Ray GetScreenToWorldRayEx ( Vector2 position , Camera camera , int width , int height ) ; // Get a ray trace from screen position (i.e mouse) in a viewport
2024-02-04 12:02:58 +01:00
RLAPI Vector2 GetWorldToScreen ( Vector3 position , Camera camera ) ; // Get the screen space position for a 3d world space position
2021-06-10 17:43:58 +02:00
RLAPI Vector2 GetWorldToScreenEx ( Vector3 position , Camera camera , int width , int height ) ; // Get size position for a 3d world space position
2024-02-04 12:02:58 +01:00
RLAPI Vector2 GetWorldToScreen2D ( Vector2 position , Camera2D camera ) ; // Get the screen space position for a 2d camera world space position
RLAPI Vector2 GetScreenToWorld2D ( Vector2 position , Camera2D camera ) ; // Get the world space position for a 2d camera screen space position
RLAPI Matrix GetCameraMatrix ( Camera camera ) ; // Get camera transform matrix (view matrix)
RLAPI Matrix GetCameraMatrix2D ( Camera2D camera ) ; // Get camera 2d transform matrix
2016-08-13 11:31:15 +02:00
2019-04-12 13:29:37 +02:00
// Timing-related functions
2016-08-13 11:31:15 +02:00
RLAPI void SetTargetFPS ( int fps ) ; // Set target FPS (maximum)
2021-06-10 17:43:58 +02:00
RLAPI float GetFrameTime ( void ) ; // Get time in seconds for last frame drawn (delta time)
RLAPI double GetTime ( void ) ; // Get elapsed time in seconds since InitWindow()
2023-10-11 12:10:38 +02:00
RLAPI int GetFPS ( void ) ; // Get current FPS
// Custom frame control functions
2024-05-30 02:22:07 -04:00
// NOTE: Those functions are intended for advanced users that want full control over the frame processing
2023-10-11 12:10:38 +02:00
// By default EndDrawing() does this job: draws everything + SwapScreenBuffer() + manage frame timing + PollInputEvents()
// To avoid that behaviour and control frame processes manually, enable in config.h: SUPPORT_CUSTOM_FRAME_CONTROL
RLAPI void SwapScreenBuffer ( void ) ; // Swap back buffer with front buffer (screen drawing)
RLAPI void PollInputEvents ( void ) ; // Register all input events
RLAPI void WaitTime ( double seconds ) ; // Wait for some time (halt program execution)
2017-12-14 11:50:35 +01:00
2023-11-03 20:21:43 +01:00
// Random values generation functions
2021-09-17 22:26:21 +03:00
RLAPI void SetRandomSeed ( unsigned int seed ) ; // Set the seed for the random number generator
2023-10-29 21:11:30 +01:00
RLAPI int GetRandomValue ( int min , int max ) ; // Get a random value between min and max (both included)
2023-11-03 20:21:43 +01:00
RLAPI int * LoadRandomSequence ( unsigned int count , int min , int max ) ; // Load random values sequence, no values repeated
RLAPI void UnloadRandomSequence ( int * sequence ) ; // Unload random values sequence
2023-10-29 21:11:30 +01:00
2023-11-03 20:21:43 +01:00
// Misc. functions
2021-02-14 16:47:08 +01:00
RLAPI void TakeScreenshot ( const char * fileName ) ; // Takes a screenshot of current screen (filename extension defines format)
2020-12-18 21:03:08 +01:00
RLAPI void SetConfigFlags ( unsigned int flags ) ; // Setup init configuration flags (view FLAGS)
2023-10-10 11:59:41 +02:00
RLAPI void OpenURL ( const char * url ) ; // Open URL with default system browser (if available)
2020-10-24 10:37:15 +02:00
2023-10-10 11:59:41 +02:00
// NOTE: Following functions implemented in module [utils]
//------------------------------------------------------------------
2021-05-30 18:02:06 +02:00
RLAPI void TraceLog ( int logLevel , const char * text , . . . ) ; // Show trace log messages (LOG_DEBUG, LOG_INFO, LOG_WARNING, LOG_ERROR...)
2021-04-05 13:35:59 +02:00
RLAPI void SetTraceLogLevel ( int logLevel ) ; // Set the current threshold (minimum) log level
2022-09-07 00:39:38 +02:00
RLAPI void * MemAlloc ( unsigned int size ) ; // Internal memory allocator
RLAPI void * MemRealloc ( void * ptr , unsigned int size ) ; // Internal memory reallocator
2020-12-19 19:43:25 +01:00
RLAPI void MemFree ( void * ptr ) ; // Internal memory free
2021-02-14 16:47:08 +01:00
2021-03-04 20:44:22 +01:00
// Set custom callbacks
2024-05-30 02:22:07 -04:00
// WARNING: Callbacks setup is intended for advanced users
2021-04-05 13:35:59 +02:00
RLAPI void SetTraceLogCallback ( TraceLogCallback callback ) ; // Set custom trace log
RLAPI void SetLoadFileDataCallback ( LoadFileDataCallback callback ) ; // Set custom file binary data loader
RLAPI void SetSaveFileDataCallback ( SaveFileDataCallback callback ) ; // Set custom file binary data saver
RLAPI void SetLoadFileTextCallback ( LoadFileTextCallback callback ) ; // Set custom file text data loader
RLAPI void SetSaveFileTextCallback ( SaveFileTextCallback callback ) ; // Set custom file text data saver
2016-08-13 11:31:15 +02:00
2017-05-15 11:30:09 +02:00
// Files management functions
2023-09-02 12:05:34 +02:00
RLAPI unsigned char * LoadFileData ( const char * fileName , int * dataSize ) ; // Load file data as byte array (read)
2020-12-14 20:47:58 +01:00
RLAPI void UnloadFileData ( unsigned char * data ) ; // Unload file data allocated by LoadFileData()
2023-09-02 12:05:34 +02:00
RLAPI bool SaveFileData ( const char * fileName , void * data , int dataSize ) ; // Save data to file from byte array (write), returns true on success
RLAPI bool ExportDataAsCode ( const unsigned char * data , int dataSize , const char * fileName ) ; // Export data to code (.h), returns true on success
2020-03-04 00:21:46 +01:00
RLAPI char * LoadFileText ( const char * fileName ) ; // Load text data from file (read), returns a '\0' terminated string
2021-05-22 16:54:04 +02:00
RLAPI void UnloadFileText ( char * text ) ; // Unload file text data allocated by LoadFileText()
2025-05-11 11:03:49 +02:00
RLAPI bool SaveFileText ( const char * fileName , const char * text ) ; // Save text data to file (write), string must be '\0' terminated, returns true on success
2023-10-10 11:59:41 +02:00
//------------------------------------------------------------------
// File system functions
2018-10-16 10:53:01 +02:00
RLAPI bool FileExists ( const char * fileName ) ; // Check if file exists
2019-08-07 00:27:32 +02:00
RLAPI bool DirectoryExists ( const char * dirPath ) ; // Check if a directory path exists
2021-12-04 19:56:02 +01:00
RLAPI bool IsFileExtension ( const char * fileName , const char * ext ) ; // Check file extension (including point: .png, .wav)
2022-01-28 00:23:28 +01:00
RLAPI int GetFileLength ( const char * fileName ) ; // Get file length in bytes (NOTE: GetFileSize() conflicts with windows.h)
2021-05-29 13:54:05 +02:00
RLAPI const char * GetFileExtension ( const char * fileName ) ; // Get pointer to extension for a filename string (includes dot: '.png')
2018-01-02 02:26:05 +01:00
RLAPI const char * GetFileName ( const char * filePath ) ; // Get pointer to filename for a path string
2019-08-21 18:59:15 +02:00
RLAPI const char * GetFileNameWithoutExt ( const char * filePath ) ; // Get filename string without extension (uses static string)
2019-08-11 12:04:54 +02:00
RLAPI const char * GetDirectoryPath ( const char * filePath ) ; // Get full path for a given fileName with path (uses static string)
RLAPI const char * GetPrevDirectoryPath ( const char * dirPath ) ; // Get previous directory path for a given path (uses static string)
2018-01-02 02:26:05 +01:00
RLAPI const char * GetWorkingDirectory ( void ) ; // Get current working directory (uses static string)
general syntax fixes (#3319)
* Prettified a comment
* fixed broken indentation caused by another commit.
the commit renamed a bool to int and broke indentation: 233cf3970c9148c4963cfdea20e49e761104f9de
* Changed 0.001 and 0.00001 to EPSILON
This commit is untested.
I don't know what consequences this has.
Since the commits that added these numbers were before epsilon was added,
I have assumed that epsilon could replace them.
* Prettied up indentation in a few places
* removed spacing around *, standardizing it.
* I may have gotten overboard with indentation
* removed a few useless parenthesis
* Added fortran-raylib
* Fix examples/others/rlgl_standalone.c compilation issue (#3242)
* Update BINDINGS.md
* Ignore unused return value of GetCodepointNext in GetCodepointCount (#3241)
* Ignore unused return value of GetCodepointNext in GetCodepointCount
Removes the last warning from non-external libraries when compiling with
the default build configuration on x64 Linux.
* Remove unnecessary void cast in GetCodepointCount
* Fix #3246
* Revert "Fix #3246"
This reverts commit e4dcbd518091a5854a517ea4cfc3f7e2d29de1a7.
* Fix text_unicode.c example crashing (#3250)
* Fix text_unicode.c example crashing
* Adjust the text_unicode.c example crashing fix
* tweaks
* add build.zig options for individual modules (#3254)
* Add `IsKeyPressedRepeat` (desktop only) (#3245)
Since the key pressed are handle by comparing current vs previous
state (ie frame), a special way is needed to handle key repeats.
* Reviewed `IsKeyPressedRepeat()` #3248
* Update rcore.c (#3255)
* Match CMakeOptions.txt options default values (#3258)
* Fix SetClipboardText for web (#3257)
* [Image] Validate that ImageDrawRectangleRec is drawing entirely inside the image (#3264)
* Add a function to clone a sound and share data with another sound.
* rename items based on feedback
* PR Feedback, use custom unload for sound alias, not variant of normal sound unloading
* sound_multi example
* Validate that image rect drawing is inside the image so we don't overflow a buffer
* remove files that should not have been added.
* remove changes that should not have been
* revert
* adsfasdfsdfsdf
* Add Vector3 Projecting and Rejection to Raymath (#3263)
* Update raymath.h
* formatting
* [Feature] IsKey... safety checks and more (#3256)
* [Feature] Add GetKeyRepeat
* Update rcore.c
* Simpler design, only one repeat per frame
* Update config.h
* Update rcore.c
* Add KEYBOARD_KEYS_MASK
* Update config.h
* reversions
* Update rcore.c
* Update rcore.c
* change docs
* Update rcore.c
* Update rcore.c
* Update rcore.c
* Update rcore.c
* Update rcore.c
* Update raylib.h
* Update rcore.c
* Update rcore.c
* Update rcore.c
* Update rcore.c
* Update rcore.c
* Update rcore.c
* Update rcore.c
* Update rcore.c
* Fix bug where default shaders was not linking. (#3261)
* Formating review
* Add missing cmake options (#3267)
* Fix CMake extraneous -lglfw (#3266)
Closes #3265.
The problem: LIBS_PRIVATE is a list of library names (used by pkg-config), but the shared library of the same name doesn't always exist.
* Fix example/models/models_loading_gltf.c controls (#3268)
* Fix example/models/models_loading_m3d.c controls (#3269)
* Remove e from secondes (#3270)
* Fix example/audio/audio_module_player.c help instructions and small bug (#3272)
* Fix example/audio/audio_module_player.c help instructions and small bug
* Update example/audio/audio_module_player.png screenshot
* Use type name instead of valid specifier
long long --> long long int
* REVIEWED: `GetFileLength()`, added comment #3262
* Update examples/models/models_loading_gltf.png;m3d.png screenshots (#3273)
* Remove a duplicated screenshot and add missing one (#3275)
* Add examples/shaders/shaders_lightmap.c to Makefiles (#3276)
* Fix examples/others/easings_testbed.c help instructions and small tweak (#3277)
* Fix examples/shaders/shaders_texture_outline.c help instructions (#3278)
* Fix examples/shapes/shapes_collision_area.c help instructions (#3279)
* RENAMED: LoadFont*() parameter names for consistency and coherence
* Fix uninitialized thread-locals in stbi #3282 (#3283)
* REVIEWED: Added `SetTextLineSpacing()` to multiline examples
* REVIEWED: Data size type consistency between functions #3168
* Some tweaks
* Use internal default allocators, instead of user-exposed ones
* Added rudimentary SVG support. (#2738)
* Added rudimentary SVG support. Added 2 functions ImageLoadSvg and ImageLoadSvgWithSize.
* Added an example on how to use ImageLoadSvgWithSize and adjusted Makefiles accordingly.
* Added actual correct example file.
* Reviewed the code to keep the raylib coding conventions in mind.
Moved the LoadImageSvg() code into LoadImage() guarded by SUPPORT_FILEFORMAT_SVG.
Renamed LoadImageSvgWithSize() to LoadImageSvg().
Added a LoadImageSvgFromString() function to parse the loaded SVG into an actual image. This does the bulk of the work.
* Fixed typo.
---------
Co-authored-by: Ray <raysan5@gmail.com>
* REVIEWED: `LoadImageSvg()`
* REVIEWED: `LoadImageSvg()`
* Add SUPPORT_FILEFORMAT_SVG to cmake (#3284)
* Fix examples/textures/textures_fog_of_war.c help instructions (#3285)
* Fix examples/textures/textures_image_rotate.c help instructions (#3286)
* Update rtextures.c
* Fix #3247
* Update config.h
* Fix #3293
* Disable UBSAN in zig builds. (#3292)
Zig debug builds automatically enable ubsan.
As the fix for #1891 had to be reverted, debug builds using zig will crash like so:
```
Illegal instruction at address 0x3237d2
raylib/src/rlgl.h:3690:91: 0x3237d2 in rlDrawVertexArrayElements (/home/rcorre/src/raylib-zig-template/raylib/src/rcore.c)
glDrawElements(GL_TRIANGLES, count, GL_UNSIGNED_SHORT, (const unsigned short *)buffer + offset);
```
This disables UBSAN when using zig to build raylib.
* Update README.md (#3290)
specially -> especially
* Update cmake SUPPORT_FILEFORMAT_SVG default value (#3291)
* Mouse offset and scaling must be considered also on web!
* Update rcore.c
* Update Makefile : clean raygui.c & physac.c (#3296)
* Remove PLATFORM_RPI (#3232)
* Remove PLATFORM_RPI
* remove build artifacts
---------
Co-authored-by: MichaelFiber <michael@cubeofb.org>
Co-authored-by: Ray <raysan5@gmail.com>
* Review to avoid UBSAN complaining #1891
* added raylib-raku to bindings (#3299)
* examples: core: adds 2D camera two player split screen (#3298)
* Reviewed examples for consistency
* Update rtext.c
* Some code restructuring for input functions, consistency review
* Remove unneeded #if (#3301)
Co-authored-by: MichaelFiber <michael@cubeofb.org>
* Revert "Disable UBSAN in zig builds. (#3292)" (#3303)
This reverts commit a316f9e7fc7f8e06852a40544e57f89018672ee4.
Issue #1891 was fixed again, so this is no longer needed.
* rtextures: Fix ImageDraw() source clipping when drawing beyond top left (#3306)
* REVIEWED: `TextToPascal()` issue when first char is uppercase
* Implement FLAG_WINDOW_RESIZABLE for web (#3305)
Fixes #3231
* Update BINDINGS.md (#3307)
Fix Kaylib binding. Reroute to a new repository.
Binding renamed.
* Update webassembly.yml
* Add claw-raylib to BINDINGS.md (#3310)
* Add SetWindowMaxSize for desktop and web (#3309)
* Add SetWindowMaxSize for desktop and web
* Remove SizeInt and respective adjustments
* Update rtextures.c
* Reviewed parameters for consistency
* Rename windowM* to screenM* (#3312)
* Update BINDINGS.md (#3317)
Update TurboRaylib bindings
* Update rmodels.c
* Update BINDINGS.md with vaiorabbit/raylib-bindings (#3318)
* fixed spelling mistake
* put back parenthesis
* reverted major allignment changes
* reverted parser output changes
* reverted one more indentation change
---------
Co-authored-by: Brian-E <brian@intra.fo>
Co-authored-by: Ray <raysan5@gmail.com>
Co-authored-by: ubkp <118854183+ubkp@users.noreply.github.com>
Co-authored-by: ashn <60763262+ashn-dot-dev@users.noreply.github.com>
Co-authored-by: actondev (Christos) <chris.actondev@gmail.com>
Co-authored-by: vitopigno <103512727+VitusVeit@users.noreply.github.com>
Co-authored-by: Asdqwe <asdqwe@asdqwe.com>
Co-authored-by: Jeffery Myers <jeffm2501@gmail.com>
Co-authored-by: Ethan Simpson <ethansimpson@xtra.co.nz>
Co-authored-by: Nickolas McDonald <43690021+n77y@users.noreply.github.com>
Co-authored-by: Branimir Ričko <rickobranimir@gmail.com>
Co-authored-by: iacore <74560659+iacore@users.noreply.github.com>
Co-authored-by: Ethan Conneely <Econn50@outlook.com>
Co-authored-by: Johannes Barthelmes <615914+jbarthelmes@users.noreply.github.com>
Co-authored-by: bXi <bluepunk@gmail.com>
Co-authored-by: Ryan Roden-Corrent <ryan@rcorre.net>
Co-authored-by: Ikko Eltociear Ashimine <eltociear@gmail.com>
Co-authored-by: SuperUserNameMan <yoann@terminajones.com>
Co-authored-by: MichaelFiber <42419558+michaelfiber@users.noreply.github.com>
Co-authored-by: MichaelFiber <michael@cubeofb.org>
Co-authored-by: Dan Vu <danvu.hustle@gmail.com>
Co-authored-by: Gabriel dos Santos Sanches <gabrielssanches@gmail.com>
Co-authored-by: Rob Loach <robloach@gmail.com>
Co-authored-by: Peter0x44 <peter0x44@disroot.org>
Co-authored-by: Kenta <106167071+Its-Kenta@users.noreply.github.com>
Co-authored-by: bohonghuang <1281299809@qq.com>
Co-authored-by: turborium <45082001+turborium@users.noreply.github.com>
Co-authored-by: Wilson Silva <wilson.dsigns@gmail.com>
2023-09-17 19:16:14 +01:00
RLAPI const char * GetApplicationDirectory ( void ) ; // Get the directory of the running application (uses static string)
2024-09-22 22:11:08 +02:00
RLAPI int MakeDirectory ( const char * dirPath ) ; // Create directories (including full path requested), returns 0 on success
2020-11-01 19:06:21 +01:00
RLAPI bool ChangeDirectory ( const char * dir ) ; // Change working directory, return true on success
2022-06-11 23:24:13 +02:00
RLAPI bool IsPathFile ( const char * path ) ; // Check if a given path is a file or a directory
2024-05-29 17:38:19 +02:00
RLAPI bool IsFileNameValid ( const char * fileName ) ; // Check if fileName is valid for the platform/OS
2022-06-11 23:24:13 +02:00
RLAPI FilePathList LoadDirectoryFiles ( const char * dirPath ) ; // Load directory filepaths
2024-09-17 17:30:40 +02:00
RLAPI FilePathList LoadDirectoryFilesEx ( const char * basePath , const char * filter , bool scanSubdirs ) ; // Load directory filepaths with extension filtering and recursive directory scan. Use 'DIR' in the filter string to include directories in the result
2022-06-11 23:24:13 +02:00
RLAPI void UnloadDirectoryFiles ( FilePathList files ) ; // Unload filepaths
2017-05-09 22:03:46 +02:00
RLAPI bool IsFileDropped ( void ) ; // Check if a file has been dropped into window
2022-06-11 23:24:13 +02:00
RLAPI FilePathList LoadDroppedFiles ( void ) ; // Load dropped filepaths
RLAPI void UnloadDroppedFiles ( FilePathList files ) ; // Unload dropped filepaths
2018-10-13 15:59:17 +02:00
RLAPI long GetFileModTime ( const char * fileName ) ; // Get file modification time (last write time)
2016-08-13 11:31:15 +02:00
2021-10-18 14:10:51 +02:00
// Compression/Encoding functionality
2022-05-01 11:14:28 +02:00
RLAPI unsigned char * CompressData ( const unsigned char * data , int dataSize , int * compDataSize ) ; // Compress data (DEFLATE algorithm), memory must be MemFree()
RLAPI unsigned char * DecompressData ( const unsigned char * compData , int compDataSize , int * dataSize ) ; // Decompress data (DEFLATE algorithm), memory must be MemFree()
2025-05-22 17:06:55 +02:00
RLAPI char * EncodeDataBase64 ( const unsigned char * data , int dataSize , int * outputSize ) ; // Encode data to Base64 string (includes NULL terminator), memory must be MemFree()
2025-05-28 17:19:19 +02:00
RLAPI unsigned char * DecodeDataBase64 ( const char * text , int * outputSize ) ; // Decode Base64 string (expected NULL terminated), memory must be MemFree()
2024-12-12 12:13:38 +01:00
RLAPI unsigned int ComputeCRC32 ( unsigned char * data , int dataSize ) ; // Compute CRC32 hash code
RLAPI unsigned int * ComputeMD5 ( unsigned char * data , int dataSize ) ; // Compute MD5 hash code, returns static int[4] (16 bytes)
RLAPI unsigned int * ComputeSHA1 ( unsigned char * data , int dataSize ) ; // Compute SHA1 hash code, returns static int[5] (20 bytes)
2019-09-09 21:56:16 +02:00
2023-10-26 23:59:19 +02:00
// Automation events functionality
2024-12-12 12:13:38 +01:00
RLAPI AutomationEventList LoadAutomationEventList ( const char * fileName ) ; // Load automation events list from file, NULL for empty list, capacity = MAX_AUTOMATION_EVENTS
RLAPI void UnloadAutomationEventList ( AutomationEventList list ) ; // Unload automation events list from file
RLAPI bool ExportAutomationEventList ( AutomationEventList list , const char * fileName ) ; // Export automation events list as text file
RLAPI void SetAutomationEventList ( AutomationEventList * list ) ; // Set automation event list to record to
RLAPI void SetAutomationEventBaseFrame ( int frame ) ; // Set automation event internal base frame to start recording
RLAPI void StartAutomationEventRecording ( void ) ; // Start recording automation events (AutomationEventList must be set)
RLAPI void StopAutomationEventRecording ( void ) ; // Stop recording automation events
RLAPI void PlayAutomationEvent ( AutomationEvent event ) ; // Play a recorded automation event
2023-10-26 23:59:19 +02:00
2013-11-18 23:38:44 +01:00
//------------------------------------------------------------------------------------
// Input Handling Functions (Module: core)
//------------------------------------------------------------------------------------
2017-05-15 11:30:09 +02:00
// Input-related functions: keyboard
2021-06-10 17:49:55 +02:00
RLAPI bool IsKeyPressed ( int key ) ; // Check if a key has been pressed once
2024-10-24 09:59:54 +02:00
RLAPI bool IsKeyPressedRepeat ( int key ) ; // Check if a key has been pressed again
2021-06-10 17:49:55 +02:00
RLAPI bool IsKeyDown ( int key ) ; // Check if a key is being pressed
RLAPI bool IsKeyReleased ( int key ) ; // Check if a key has been released once
RLAPI bool IsKeyUp ( int key ) ; // Check if a key is NOT being pressed
2021-08-11 21:16:39 +02:00
RLAPI int GetKeyPressed ( void ) ; // Get key pressed (keycode), call it multiple times for keys queued, returns 0 when the queue is empty
RLAPI int GetCharPressed ( void ) ; // Get char pressed (unicode), call it multiple times for chars queued, returns 0 when the queue is empty
2024-12-01 23:25:12 +01:00
RLAPI const char * GetKeyName ( int key ) ; // Get name of a QWERTY key on the current keyboard layout (eg returns string 'q' for KEY_A on an AZERTY keyboard)
2023-10-10 11:59:41 +02:00
RLAPI void SetExitKey ( int key ) ; // Set a custom key to exit program (default is ESC)
2019-11-24 20:46:00 +09:00
2017-05-15 11:30:09 +02:00
// Input-related functions: gamepads
2024-12-12 12:13:38 +01:00
RLAPI bool IsGamepadAvailable ( int gamepad ) ; // Check if a gamepad is available
RLAPI const char * GetGamepadName ( int gamepad ) ; // Get gamepad internal name id
RLAPI bool IsGamepadButtonPressed ( int gamepad , int button ) ; // Check if a gamepad button has been pressed once
RLAPI bool IsGamepadButtonDown ( int gamepad , int button ) ; // Check if a gamepad button is being pressed
RLAPI bool IsGamepadButtonReleased ( int gamepad , int button ) ; // Check if a gamepad button has been released once
RLAPI bool IsGamepadButtonUp ( int gamepad , int button ) ; // Check if a gamepad button is NOT being pressed
RLAPI int GetGamepadButtonPressed ( void ) ; // Get the last gamepad button pressed
2025-05-29 23:01:43 -03:00
RLAPI int GetGamepadAxisCount ( int gamepad ) ; // Get axis count for a gamepad
RLAPI float GetGamepadAxisMovement ( int gamepad , int axis ) ; // Get movement value for a gamepad axis
2024-12-12 12:13:38 +01:00
RLAPI int SetGamepadMappings ( const char * mappings ) ; // Set internal gamepad mappings (SDL_GameControllerDB)
2024-10-21 19:06:37 -03:00
RLAPI void SetGamepadVibration ( int gamepad , float leftMotor , float rightMotor , float duration ) ; // Set gamepad vibration for both motors (duration in seconds)
2013-11-28 19:59:56 +01:00
2017-05-15 11:30:09 +02:00
// Input-related functions: mouse
2021-06-10 17:49:55 +02:00
RLAPI bool IsMouseButtonPressed ( int button ) ; // Check if a mouse button has been pressed once
RLAPI bool IsMouseButtonDown ( int button ) ; // Check if a mouse button is being pressed
RLAPI bool IsMouseButtonReleased ( int button ) ; // Check if a mouse button has been released once
RLAPI bool IsMouseButtonUp ( int button ) ; // Check if a mouse button is NOT being pressed
2021-06-10 17:43:58 +02:00
RLAPI int GetMouseX ( void ) ; // Get mouse position X
RLAPI int GetMouseY ( void ) ; // Get mouse position Y
RLAPI Vector2 GetMousePosition ( void ) ; // Get mouse position XY
2021-06-21 00:11:27 +02:00
RLAPI Vector2 GetMouseDelta ( void ) ; // Get mouse delta between frames
2019-01-03 13:53:20 +01:00
RLAPI void SetMousePosition ( int x , int y ) ; // Set mouse position XY
RLAPI void SetMouseOffset ( int offsetX , int offsetY ) ; // Set mouse offset
RLAPI void SetMouseScale ( float scaleX , float scaleY ) ; // Set mouse scaling
2022-06-12 11:30:07 -04:00
RLAPI float GetMouseWheelMove ( void ) ; // Get mouse wheel movement for X or Y, whichever is larger
RLAPI Vector2 GetMouseWheelMoveV ( void ) ; // Get mouse wheel movement for both X and Y
2020-10-21 11:08:37 +02:00
RLAPI void SetMouseCursor ( int cursor ) ; // Set mouse cursor
2015-02-26 13:52:03 +01:00
2017-05-15 11:30:09 +02:00
// Input-related functions: touch
2021-06-10 17:43:58 +02:00
RLAPI int GetTouchX ( void ) ; // Get touch position X for touch point 0 (relative to screen size)
RLAPI int GetTouchY ( void ) ; // Get touch position Y for touch point 0 (relative to screen size)
RLAPI Vector2 GetTouchPosition ( int index ) ; // Get touch position XY for a touch point index (relative to screen size)
2021-09-21 15:11:33 +02:00
RLAPI int GetTouchPointId ( int index ) ; // Get touch point identifier for given index
2021-09-10 15:19:12 +02:00
RLAPI int GetTouchPointCount ( void ) ; // Get number of touch points
2016-01-24 19:17:08 +01:00
2015-10-30 11:30:32 +01:00
//------------------------------------------------------------------------------------
2021-09-22 12:59:40 +02:00
// Gestures and Touch Handling Functions (Module: rgestures)
2015-10-30 11:30:32 +01:00
//------------------------------------------------------------------------------------
2024-12-12 12:13:38 +01:00
RLAPI void SetGesturesEnabled ( unsigned int flags ) ; // Enable a set of gestures using flags
RLAPI bool IsGestureDetected ( unsigned int gesture ) ; // Check if a gesture have been detected
RLAPI int GetGestureDetected ( void ) ; // Get latest detected gesture
RLAPI float GetGestureHoldDuration ( void ) ; // Get gesture hold time in seconds
RLAPI Vector2 GetGestureDragVector ( void ) ; // Get gesture drag vector
RLAPI float GetGestureDragAngle ( void ) ; // Get gesture drag angle
RLAPI Vector2 GetGesturePinchVector ( void ) ; // Get gesture pinch delta
RLAPI float GetGesturePinchAngle ( void ) ; // Get gesture pinch angle
2013-11-18 23:38:44 +01:00
2015-07-29 21:45:28 +02:00
//------------------------------------------------------------------------------------
2021-09-22 12:59:40 +02:00
// Camera System Functions (Module: rcamera)
2015-07-29 21:45:28 +02:00
//------------------------------------------------------------------------------------
2024-12-12 12:13:38 +01:00
RLAPI void UpdateCamera ( Camera * camera , int mode ) ; // Update camera position for selected mode
2023-03-12 20:14:32 +01:00
RLAPI void UpdateCameraPro ( Camera * camera , Vector3 movement , Vector3 rotation , float zoom ) ; // Update camera movement/rotation
2015-07-29 21:45:28 +02:00
2013-11-18 23:38:44 +01:00
//------------------------------------------------------------------------------------
// Basic Shapes Drawing Functions (Module: shapes)
//------------------------------------------------------------------------------------
2021-04-04 14:59:17 +02:00
// Set texture and rectangle to be used on shapes drawing
// NOTE: It can be useful when using basic shapes and one single font,
// defining a font char white rectangle would allow drawing everything in a single draw call
2024-12-12 12:13:38 +01:00
RLAPI void SetShapesTexture ( Texture2D texture , Rectangle source ) ; // Set texture and rectangle to be used on shapes drawing
RLAPI Texture2D GetShapesTexture ( void ) ; // Get texture that is used for shapes drawing
RLAPI Rectangle GetShapesTextureRectangle ( void ) ; // Get texture source rectangle that is used for shapes drawing
2017-05-15 11:30:09 +02:00
// Basic shapes drawing functions
2024-09-27 14:06:54 -07:00
RLAPI void DrawPixel ( int posX , int posY , Color color ) ; // Draw a pixel using geometry [Can be slow, use with care]
RLAPI void DrawPixelV ( Vector2 position , Color color ) ; // Draw a pixel using geometry (Vector version) [Can be slow, use with care]
2016-08-13 11:31:15 +02:00
RLAPI void DrawLine ( int startPosX , int startPosY , int endPosX , int endPosY , Color color ) ; // Draw a line
2023-11-07 19:25:49 +01:00
RLAPI void DrawLineV ( Vector2 startPos , Vector2 endPos , Color color ) ; // Draw a line (using gl lines)
RLAPI void DrawLineEx ( Vector2 startPos , Vector2 endPos , float thick , Color color ) ; // Draw a line (using triangles/quads)
2024-06-11 02:51:49 -07:00
RLAPI void DrawLineStrip ( const Vector2 * points , int pointCount , Color color ) ; // Draw lines sequence (using gl lines)
2023-11-07 19:25:49 +01:00
RLAPI void DrawLineBezier ( Vector2 startPos , Vector2 endPos , float thick , Color color ) ; // Draw line segment cubic-bezier in-out interpolation
2016-08-13 11:31:15 +02:00
RLAPI void DrawCircle ( int centerX , int centerY , float radius , Color color ) ; // Draw a color-filled circle
2021-03-19 18:13:55 +00:00
RLAPI void DrawCircleSector ( Vector2 center , float radius , float startAngle , float endAngle , int segments , Color color ) ; // Draw a piece of a circle
RLAPI void DrawCircleSectorLines ( Vector2 center , float radius , float startAngle , float endAngle , int segments , Color color ) ; // Draw circle sector outline
[rshapes] Review DrawGradient color parameter names (#4270)
void DrawCircleGradient(int centerX, int centerY, float radius, Color color1, Color color2);
void DrawRectangleGradientV(int posX, int posY, int width, int height, Color color1, Color color2);
void DrawRectangleGradientH(int posX, int posY, int width, int height, Color color1, Color color2);
void DrawRectangleGradientEx(Rectangle rec, Color col1, Color col2, Color col3, Color col4);
Have been changed to:
void DrawCircleGradient(int centerX, int centerY, float radius, Color inner, Color outer);
void DrawRectangleGradientV(int posX, int posY, int width, int height, Color top, Color bottom);
void DrawRectangleGradientH(int posX, int posY, int width, int height, Color left, Color right);
void DrawRectangleGradientEx(Rectangle rec, Color topLeft, Color bottomLeft, Color topRight, Color bottomRight);
2024-08-21 20:07:52 +08:00
RLAPI void DrawCircleGradient ( int centerX , int centerY , float radius , Color inner , Color outer ) ; // Draw a gradient-filled circle
2016-08-13 11:31:15 +02:00
RLAPI void DrawCircleV ( Vector2 center , float radius , Color color ) ; // Draw a color-filled circle (Vector version)
RLAPI void DrawCircleLines ( int centerX , int centerY , float radius , Color color ) ; // Draw circle outline
2023-10-22 16:13:49 +01:00
RLAPI void DrawCircleLinesV ( Vector2 center , float radius , Color color ) ; // Draw circle outline (Vector version)
2020-01-27 16:21:37 +01:00
RLAPI void DrawEllipse ( int centerX , int centerY , float radiusH , float radiusV , Color color ) ; // Draw ellipse
2025-05-29 07:05:49 -04:00
RLAPI void DrawEllipseV ( Vector2 center , float radiusH , float radiusV , Color color ) ; // Draw ellipse (Vector version)
2020-01-27 16:21:37 +01:00
RLAPI void DrawEllipseLines ( int centerX , int centerY , float radiusH , float radiusV , Color color ) ; // Draw ellipse outline
2025-05-29 07:05:49 -04:00
RLAPI void DrawEllipseLinesV ( Vector2 center , float radiusH , float radiusV , Color color ) ; // Draw ellipse outline (Vector version)
2021-03-19 18:13:55 +00:00
RLAPI void DrawRing ( Vector2 center , float innerRadius , float outerRadius , float startAngle , float endAngle , int segments , Color color ) ; // Draw ring
RLAPI void DrawRingLines ( Vector2 center , float innerRadius , float outerRadius , float startAngle , float endAngle , int segments , Color color ) ; // Draw ring outline
2016-08-13 11:31:15 +02:00
RLAPI void DrawRectangle ( int posX , int posY , int width , int height , Color color ) ; // Draw a color-filled rectangle
2018-01-01 16:54:32 +01:00
RLAPI void DrawRectangleV ( Vector2 position , Vector2 size , Color color ) ; // Draw a color-filled rectangle (Vector version)
2016-08-13 11:31:15 +02:00
RLAPI void DrawRectangleRec ( Rectangle rec , Color color ) ; // Draw a color-filled rectangle
2018-12-26 10:51:13 +01:00
RLAPI void DrawRectanglePro ( Rectangle rec , Vector2 origin , float rotation , Color color ) ; // Draw a color-filled rectangle with pro parameters
[rshapes] Review DrawGradient color parameter names (#4270)
void DrawCircleGradient(int centerX, int centerY, float radius, Color color1, Color color2);
void DrawRectangleGradientV(int posX, int posY, int width, int height, Color color1, Color color2);
void DrawRectangleGradientH(int posX, int posY, int width, int height, Color color1, Color color2);
void DrawRectangleGradientEx(Rectangle rec, Color col1, Color col2, Color col3, Color col4);
Have been changed to:
void DrawCircleGradient(int centerX, int centerY, float radius, Color inner, Color outer);
void DrawRectangleGradientV(int posX, int posY, int width, int height, Color top, Color bottom);
void DrawRectangleGradientH(int posX, int posY, int width, int height, Color left, Color right);
void DrawRectangleGradientEx(Rectangle rec, Color topLeft, Color bottomLeft, Color topRight, Color bottomRight);
2024-08-21 20:07:52 +08:00
RLAPI void DrawRectangleGradientV ( int posX , int posY , int width , int height , Color top , Color bottom ) ; // Draw a vertical-gradient-filled rectangle
RLAPI void DrawRectangleGradientH ( int posX , int posY , int width , int height , Color left , Color right ) ; // Draw a horizontal-gradient-filled rectangle
[rshapes] Fix incorrect parameter names in DrawRectangleGradientEx
Examining the code shows that the rectangle is drawn winding counterclockwise, starting
with the top left. Therefore the colors used should be in the order: topLeft, bottomLeft,
bottomRight, topRight.
However, the variables actually being used are topLeft, bottomLeft, topRight,
bottomRight. I was confused by this as I was getting striping where I didn't expect any.
Put another way, the last two parameters are misnamed.
This diff swaps the parameter names and their usages. The result is that no runtime
behaviour changes: the same parameter order yields the same visual result both before and
after this change, but the parameter names now correctly reflect what they are actually
used for.
You can actually see this in the implementation of DrawRectangleGradientV, which
(correctly) passes top, bottom, bottom, top to DrawRectangleGradientEx.
2025-05-31 22:58:18 -07:00
RLAPI void DrawRectangleGradientEx ( Rectangle rec , Color topLeft , Color bottomLeft , Color bottomRight , Color topRight ) ; // Draw a gradient-filled rectangle with custom vertex colors
2016-08-13 11:31:15 +02:00
RLAPI void DrawRectangleLines ( int posX , int posY , int width , int height , Color color ) ; // Draw rectangle outline
2021-05-10 11:08:58 -07:00
RLAPI void DrawRectangleLinesEx ( Rectangle rec , float lineThick , Color color ) ; // Draw rectangle outline with extended parameters
2019-04-04 13:50:52 +02:00
RLAPI void DrawRectangleRounded ( Rectangle rec , float roundness , int segments , Color color ) ; // Draw rectangle with rounded edges
2024-04-20 19:53:59 +02:00
RLAPI void DrawRectangleRoundedLines ( Rectangle rec , float roundness , int segments , Color color ) ; // Draw rectangle lines with rounded edges
RLAPI void DrawRectangleRoundedLinesEx ( Rectangle rec , float roundness , int segments , float lineThick , Color color ) ; // Draw rectangle with rounded edges outline
2019-08-11 21:26:12 +02:00
RLAPI void DrawTriangle ( Vector2 v1 , Vector2 v2 , Vector2 v3 , Color color ) ; // Draw a color-filled triangle (vertex in counter-clockwise order!)
RLAPI void DrawTriangleLines ( Vector2 v1 , Vector2 v2 , Vector2 v3 , Color color ) ; // Draw triangle outline (vertex in counter-clockwise order!)
2024-06-11 02:51:49 -07:00
RLAPI void DrawTriangleFan ( const Vector2 * points , int pointCount , Color color ) ; // Draw a triangle fan defined by points (first vertex is the center)
RLAPI void DrawTriangleStrip ( const Vector2 * points , int pointCount , Color color ) ; // Draw a triangle strip defined by points
2016-08-13 11:31:15 +02:00
RLAPI void DrawPoly ( Vector2 center , int sides , float radius , float rotation , Color color ) ; // Draw a regular polygon (Vector version)
2020-01-09 18:34:20 +01:00
RLAPI void DrawPolyLines ( Vector2 center , int sides , float radius , float rotation , Color color ) ; // Draw a polygon outline of n sides
2021-05-10 11:08:58 -07:00
RLAPI void DrawPolyLinesEx ( Vector2 center , int sides , float radius , float rotation , float lineThick , Color color ) ; // Draw a polygon outline of n sides with extended parameters
2016-08-13 11:31:15 +02:00
2023-11-07 19:25:49 +01:00
// Splines drawing functions
2024-12-12 12:13:38 +01:00
RLAPI void DrawSplineLinear ( const Vector2 * points , int pointCount , float thick , Color color ) ; // Draw spline: Linear, minimum 2 points
RLAPI void DrawSplineBasis ( const Vector2 * points , int pointCount , float thick , Color color ) ; // Draw spline: B-Spline, minimum 4 points
RLAPI void DrawSplineCatmullRom ( const Vector2 * points , int pointCount , float thick , Color color ) ; // Draw spline: Catmull-Rom, minimum 4 points
RLAPI void DrawSplineBezierQuadratic ( const Vector2 * points , int pointCount , float thick , Color color ) ; // Draw spline: Quadratic Bezier, minimum 3 points (1 control point): [p1, c2, p3, c4...]
RLAPI void DrawSplineBezierCubic ( const Vector2 * points , int pointCount , float thick , Color color ) ; // Draw spline: Cubic Bezier, minimum 4 points (2 control points): [p1, c2, c3, p4, c5, c6...]
2023-11-08 17:42:35 +01:00
RLAPI void DrawSplineSegmentLinear ( Vector2 p1 , Vector2 p2 , float thick , Color color ) ; // Draw spline segment: Linear, 2 points
RLAPI void DrawSplineSegmentBasis ( Vector2 p1 , Vector2 p2 , Vector2 p3 , Vector2 p4 , float thick , Color color ) ; // Draw spline segment: B-Spline, 4 points
RLAPI void DrawSplineSegmentCatmullRom ( Vector2 p1 , Vector2 p2 , Vector2 p3 , Vector2 p4 , float thick , Color color ) ; // Draw spline segment: Catmull-Rom, 4 points
RLAPI void DrawSplineSegmentBezierQuadratic ( Vector2 p1 , Vector2 c2 , Vector2 p3 , float thick , Color color ) ; // Draw spline segment: Quadratic Bezier, 2 points, 1 control point
RLAPI void DrawSplineSegmentBezierCubic ( Vector2 p1 , Vector2 c2 , Vector2 c3 , Vector2 p4 , float thick , Color color ) ; // Draw spline segment: Cubic Bezier, 2 points, 2 control points
// Spline segment point evaluation functions, for a given t [0.0f .. 1.0f]
RLAPI Vector2 GetSplinePointLinear ( Vector2 startPos , Vector2 endPos , float t ) ; // Get (evaluate) spline point: Linear
2023-11-07 19:25:49 +01:00
RLAPI Vector2 GetSplinePointBasis ( Vector2 p1 , Vector2 p2 , Vector2 p3 , Vector2 p4 , float t ) ; // Get (evaluate) spline point: B-Spline
RLAPI Vector2 GetSplinePointCatmullRom ( Vector2 p1 , Vector2 p2 , Vector2 p3 , Vector2 p4 , float t ) ; // Get (evaluate) spline point: Catmull-Rom
2023-11-08 17:42:35 +01:00
RLAPI Vector2 GetSplinePointBezierQuad ( Vector2 p1 , Vector2 c2 , Vector2 p3 , float t ) ; // Get (evaluate) spline point: Quadratic Bezier
RLAPI Vector2 GetSplinePointBezierCubic ( Vector2 p1 , Vector2 c2 , Vector2 c3 , Vector2 p4 , float t ) ; // Get (evaluate) spline point: Cubic Bezier
2023-11-07 19:25:49 +01:00
2017-05-15 11:30:09 +02:00
// Basic shapes collision detection functions
2016-08-13 11:31:15 +02:00
RLAPI bool CheckCollisionRecs ( Rectangle rec1 , Rectangle rec2 ) ; // Check collision between two rectangles
RLAPI bool CheckCollisionCircles ( Vector2 center1 , float radius1 , Vector2 center2 , float radius2 ) ; // Check collision between two circles
RLAPI bool CheckCollisionCircleRec ( Vector2 center , float radius , Rectangle rec ) ; // Check collision between circle and rectangle
2024-10-23 00:21:14 +02:00
RLAPI bool CheckCollisionCircleLine ( Vector2 center , float radius , Vector2 p1 , Vector2 p2 ) ; // Check if circle collides with a line created betweeen two points [p1] and [p2]
2016-08-13 11:31:15 +02:00
RLAPI bool CheckCollisionPointRec ( Vector2 point , Rectangle rec ) ; // Check if point is inside rectangle
RLAPI bool CheckCollisionPointCircle ( Vector2 point , Vector2 center , float radius ) ; // Check if point is inside circle
RLAPI bool CheckCollisionPointTriangle ( Vector2 point , Vector2 p1 , Vector2 p2 , Vector2 p3 ) ; // Check if point is inside a triangle
2024-10-23 00:21:14 +02:00
RLAPI bool CheckCollisionPointLine ( Vector2 point , Vector2 p1 , Vector2 p2 , int threshold ) ; // Check if point belongs to line created between two points [p1] and [p2] with defined margin in pixels [threshold]
2024-06-11 02:51:49 -07:00
RLAPI bool CheckCollisionPointPoly ( Vector2 point , const Vector2 * points , int pointCount ) ; // Check if point is within a polygon described by array of vertices
2020-12-23 12:45:53 +01:00
RLAPI bool CheckCollisionLines ( Vector2 startPos1 , Vector2 endPos1 , Vector2 startPos2 , Vector2 endPos2 , Vector2 * collisionPoint ) ; // Check the collision between two lines defined by two points each, returns collision point by reference
RLAPI Rectangle GetCollisionRec ( Rectangle rec1 , Rectangle rec2 ) ; // Get collision rectangle for two rectangles collision
2013-11-30 18:12:40 +01:00
2013-11-18 23:38:44 +01:00
//------------------------------------------------------------------------------------
// Texture Loading and Drawing Functions (Module: textures)
//------------------------------------------------------------------------------------
2017-05-15 11:30:09 +02:00
2020-03-29 13:31:12 +02:00
// Image loading functions
2023-02-09 07:17:47 -05:00
// NOTE: These functions do not require GPU access
2016-12-25 02:01:13 +01:00
RLAPI Image LoadImage ( const char * fileName ) ; // Load image from file into CPU memory (RAM)
RLAPI Image LoadImageRaw ( const char * fileName , int width , int height , int format , int headerSize ) ; // Load image from RAW file data
2020-07-10 13:59:01 +02:00
RLAPI Image LoadImageAnim ( const char * fileName , int * frames ) ; // Load image sequence from file (frames appended to image.data)
2023-12-28 19:15:04 -03:00
RLAPI Image LoadImageAnimFromMemory ( const char * fileType , const unsigned char * fileData , int dataSize , int * frames ) ; // Load image sequence from memory buffer
2021-05-29 13:54:05 +02:00
RLAPI Image LoadImageFromMemory ( const char * fileType , const unsigned char * fileData , int dataSize ) ; // Load image from memory buffer, fileType refers to extension: i.e. '.png'
2021-06-28 09:39:31 +02:00
RLAPI Image LoadImageFromTexture ( Texture2D texture ) ; // Load image from GPU texture data
RLAPI Image LoadImageFromScreen ( void ) ; // Load image from screen buffer and (screenshot)
2024-10-16 19:26:12 +02:00
RLAPI bool IsImageValid ( Image image ) ; // Check if an image is valid (data and parameters)
2020-03-29 13:31:12 +02:00
RLAPI void UnloadImage ( Image image ) ; // Unload image from CPU memory (RAM)
2020-11-22 00:10:16 +01:00
RLAPI bool ExportImage ( Image image , const char * fileName ) ; // Export image data to file, returns true on success
2023-06-03 19:51:16 +02:00
RLAPI unsigned char * ExportImageToMemory ( Image image , const char * fileType , int * fileSize ) ; // Export image to memory buffer
2020-11-22 10:56:17 +01:00
RLAPI bool ExportImageAsCode ( Image image , const char * fileName ) ; // Export image as code file defining an array of bytes, returns true on success
2020-03-29 13:31:12 +02:00
// Image generation functions
RLAPI Image GenImageColor ( int width , int height , Color color ) ; // Generate image: plain color
2023-05-21 11:35:25 +02:00
RLAPI Image GenImageGradientLinear ( int width , int height , int direction , Color start , Color end ) ; // Generate image: linear gradient, direction in degrees [0..360], 0=Vertical gradient
2020-03-29 13:31:12 +02:00
RLAPI Image GenImageGradientRadial ( int width , int height , float density , Color inner , Color outer ) ; // Generate image: radial gradient
2023-05-22 23:20:28 +10:00
RLAPI Image GenImageGradientSquare ( int width , int height , float density , Color inner , Color outer ) ; // Generate image: square gradient
2020-03-29 13:31:12 +02:00
RLAPI Image GenImageChecked ( int width , int height , int checksX , int checksY , Color col1 , Color col2 ) ; // Generate image: checked
RLAPI Image GenImageWhiteNoise ( int width , int height , float factor ) ; // Generate image: white noise
2022-09-17 13:39:49 +02:00
RLAPI Image GenImagePerlinNoise ( int width , int height , int offsetX , int offsetY , float scale ) ; // Generate image: perlin noise
2021-08-11 21:16:39 +02:00
RLAPI Image GenImageCellular ( int width , int height , int tileSize ) ; // Generate image: cellular algorithm, bigger tileSize means bigger cells
2022-10-14 10:51:43 +02:00
RLAPI Image GenImageText ( int width , int height , const char * text ) ; // Generate image: grayscale image from text data
2018-04-04 12:02:20 +02:00
2017-05-15 11:30:09 +02:00
// Image manipulation functions
2018-01-07 00:51:26 +01:00
RLAPI Image ImageCopy ( Image image ) ; // Create an image duplicate (useful for transformations)
BREAKING CHANGE: Read description
Changes:
- Font structure has been redesigned, CharInfo structure contained character rectangle within font texture, it has not much sense, considering that it was an information relative to the font atlas generated and not the character itself, so character rectangles have been moved out from CharInfo to Font.
- CharInfo included a data parameters to contain character pixel data (usually grayscale), generated on TTF font generation. It was inconsistent with other fonts types, so, now CharInfo includes directly an Image of the glyph.
- REDESIGNED: GenImageFontAtlas(), additional recs parameter added, loaded and filled inside the function to export atlas characters rectangles, instead of silently modify the input CharInfo data.
- REVIEWED: ImageTextEx(), funtion retrieved the font atlas image from the GPU, that was slow and problematic in several platforms. Now it uses directly the CharInfo image. Support for unicode codepoints has also been added.
- REDESIGNED: ImageDraw(), now it includes an additional parameter, the color tint, not only it could be useful for several situations but also function signature is more consistent with similar functions.
- ADDED: ImageFromImage() to generate a new image from a piece of another image.
- REVIEWED: GetNextCodepoint(), renamed parameters to be more clear.
Also all examples and games that were affected by those changes have been reviewed.
2019-07-24 15:05:14 +02:00
RLAPI Image ImageFromImage ( Image image , Rectangle rec ) ; // Create an image from another image piece
2024-06-30 11:37:58 +02:00
RLAPI Image ImageFromChannel ( Image image , int selectedChannel ) ; // Create an image from a selected channel of another image (GRAYSCALE)
2020-03-29 13:31:12 +02:00
RLAPI Image ImageText ( const char * text , int fontSize , Color color ) ; // Create an image from text (default font)
RLAPI Image ImageTextEx ( Font font , const char * text , float fontSize , float spacing , Color tint ) ; // Create an image from text (custom sprite font)
2016-08-13 11:31:15 +02:00
RLAPI void ImageFormat ( Image * image , int newFormat ) ; // Convert image data to desired format
2020-06-07 18:32:20 +02:00
RLAPI void ImageToPOT ( Image * image , Color fill ) ; // Convert image to POT (power-of-two)
2020-05-09 12:05:00 +02:00
RLAPI void ImageCrop ( Image * image , Rectangle crop ) ; // Crop an image to a defined rectangle
2018-01-11 10:22:32 +01:00
RLAPI void ImageAlphaCrop ( Image * image , float threshold ) ; // Crop image depending on alpha value
2020-05-09 12:05:00 +02:00
RLAPI void ImageAlphaClear ( Image * image , Color color , float threshold ) ; // Clear alpha channel to desired color
RLAPI void ImageAlphaMask ( Image * image , Image alphaMask ) ; // Apply alpha mask to image
2018-01-07 00:51:26 +01:00
RLAPI void ImageAlphaPremultiply ( Image * image ) ; // Premultiply alpha channel
2022-10-25 18:56:06 +03:00
RLAPI void ImageBlurGaussian ( Image * image , int blurSize ) ; // Apply Gaussian blur using a box blur approximation
2024-06-24 18:41:33 +02:00
RLAPI void ImageKernelConvolution ( Image * image , const float * kernel , int kernelSize ) ; // Apply custom square convolution kernel to image
2018-10-13 16:30:44 +02:00
RLAPI void ImageResize ( Image * image , int newWidth , int newHeight ) ; // Resize image (Bicubic scaling algorithm)
2025-02-17 12:12:59 +01:00
RLAPI void ImageResizeNN ( Image * image , int newWidth , int newHeight ) ; // Resize image (Nearest-Neighbor scaling algorithm)
2024-06-16 10:23:38 +02:00
RLAPI void ImageResizeCanvas ( Image * image , int newWidth , int newHeight , int offsetX , int offsetY , Color fill ) ; // Resize canvas and fill with color
2021-05-22 14:35:10 +02:00
RLAPI void ImageMipmaps ( Image * image ) ; // Compute all mipmap levels for a provided image
2018-01-07 00:51:26 +01:00
RLAPI void ImageDither ( Image * image , int rBpp , int gBpp , int bBpp , int aBpp ) ; // Dither image data to 16bpp or lower (Floyd-Steinberg dithering)
2016-08-13 11:31:15 +02:00
RLAPI void ImageFlipVertical ( Image * image ) ; // Flip image vertically
RLAPI void ImageFlipHorizontal ( Image * image ) ; // Flip image horizontally
2023-06-17 16:48:18 +02:00
RLAPI void ImageRotate ( Image * image , int degrees ) ; // Rotate image by input angle in degrees (-359 to 359)
2018-06-03 21:05:01 +02:00
RLAPI void ImageRotateCW ( Image * image ) ; // Rotate image clockwise 90deg
RLAPI void ImageRotateCCW ( Image * image ) ; // Rotate image counter-clockwise 90deg
2016-08-13 11:31:15 +02:00
RLAPI void ImageColorTint ( Image * image , Color color ) ; // Modify image color: tint
RLAPI void ImageColorInvert ( Image * image ) ; // Modify image color: invert
RLAPI void ImageColorGrayscale ( Image * image ) ; // Modify image color: grayscale
RLAPI void ImageColorContrast ( Image * image , float contrast ) ; // Modify image color: contrast (-100 to 100)
RLAPI void ImageColorBrightness ( Image * image , int brightness ) ; // Modify image color: brightness (-255 to 255)
2018-07-03 00:57:58 +02:00
RLAPI void ImageColorReplace ( Image * image , Color color , Color replace ) ; // Modify image color: replace color
2020-12-18 21:03:08 +01:00
RLAPI Color * LoadImageColors ( Image image ) ; // Load color data from image as a Color array (RGBA - 32bit)
2021-09-01 23:11:31 +02:00
RLAPI Color * LoadImagePalette ( Image image , int maxPaletteSize , int * colorCount ) ; // Load colors palette from image as a Color array (RGBA - 32bit)
2020-12-18 21:03:08 +01:00
RLAPI void UnloadImageColors ( Color * colors ) ; // Unload color data loaded with LoadImageColors()
RLAPI void UnloadImagePalette ( Color * colors ) ; // Unload colors palette loaded with LoadImagePalette()
2020-03-29 13:37:33 +02:00
RLAPI Rectangle GetImageAlphaBorder ( Image image , float threshold ) ; // Get image alpha border rectangle
2021-10-03 12:55:52 +02:00
RLAPI Color GetImageColor ( Image image , int x , int y ) ; // Get image pixel color at (x, y) position
2017-05-15 11:30:09 +02:00
2020-03-29 13:31:12 +02:00
// Image drawing functions
// NOTE: Image software-rendering functions (CPU)
RLAPI void ImageClearBackground ( Image * dst , Color color ) ; // Clear image background with given color
RLAPI void ImageDrawPixel ( Image * dst , int posX , int posY , Color color ) ; // Draw pixel within an image
RLAPI void ImageDrawPixelV ( Image * dst , Vector2 position , Color color ) ; // Draw pixel within an image (Vector version)
RLAPI void ImageDrawLine ( Image * dst , int startPosX , int startPosY , int endPosX , int endPosY , Color color ) ; // Draw line within an image
RLAPI void ImageDrawLineV ( Image * dst , Vector2 start , Vector2 end , Color color ) ; // Draw line within an image (Vector version)
2024-06-24 09:27:59 +02:00
RLAPI void ImageDrawLineEx ( Image * dst , Vector2 start , Vector2 end , int thick , Color color ) ; // Draw a line defining thickness within an image
2022-09-26 12:24:10 +02:00
RLAPI void ImageDrawCircle ( Image * dst , int centerX , int centerY , int radius , Color color ) ; // Draw a filled circle within an image
RLAPI void ImageDrawCircleV ( Image * dst , Vector2 center , int radius , Color color ) ; // Draw a filled circle within an image (Vector version)
2022-09-19 12:41:17 -04:00
RLAPI void ImageDrawCircleLines ( Image * dst , int centerX , int centerY , int radius , Color color ) ; // Draw circle outline within an image
RLAPI void ImageDrawCircleLinesV ( Image * dst , Vector2 center , int radius , Color color ) ; // Draw circle outline within an image (Vector version)
2020-03-29 13:31:12 +02:00
RLAPI void ImageDrawRectangle ( Image * dst , int posX , int posY , int width , int height , Color color ) ; // Draw rectangle within an image
RLAPI void ImageDrawRectangleV ( Image * dst , Vector2 position , Vector2 size , Color color ) ; // Draw rectangle within an image (Vector version)
2020-11-03 23:47:33 +01:00
RLAPI void ImageDrawRectangleRec ( Image * dst , Rectangle rec , Color color ) ; // Draw rectangle within an image
2020-03-29 13:31:12 +02:00
RLAPI void ImageDrawRectangleLines ( Image * dst , Rectangle rec , int thick , Color color ) ; // Draw rectangle lines within an image
2024-06-23 22:51:24 +02:00
RLAPI void ImageDrawTriangle ( Image * dst , Vector2 v1 , Vector2 v2 , Vector2 v3 , Color color ) ; // Draw triangle within an image
RLAPI void ImageDrawTriangleEx ( Image * dst , Vector2 v1 , Vector2 v2 , Vector2 v3 , Color c1 , Color c2 , Color c3 ) ; // Draw triangle with interpolated colors within an image
RLAPI void ImageDrawTriangleLines ( Image * dst , Vector2 v1 , Vector2 v2 , Vector2 v3 , Color color ) ; // Draw triangle outline within an image
2025-05-31 14:11:00 -07:00
RLAPI void ImageDrawTriangleFan ( Image * dst , const Vector2 * points , int pointCount , Color color ) ; // Draw a triangle fan defined by points within an image (first vertex is the center)
RLAPI void ImageDrawTriangleStrip ( Image * dst , const Vector2 * points , int pointCount , Color color ) ; // Draw a triangle strip defined by points within an image
2020-03-29 13:31:12 +02:00
RLAPI void ImageDraw ( Image * dst , Image src , Rectangle srcRec , Rectangle dstRec , Color tint ) ; // Draw a source image within a destination image (tint applied to source)
2020-04-10 19:10:15 +02:00
RLAPI void ImageDrawText ( Image * dst , const char * text , int posX , int posY , int fontSize , Color color ) ; // Draw text (using default font) within an image (destination)
RLAPI void ImageDrawTextEx ( Image * dst , Font font , const char * text , Vector2 position , float fontSize , float spacing , Color tint ) ; // Draw text (custom sprite font) within an image (destination)
2020-03-29 13:31:12 +02:00
// Texture loading functions
// NOTE: These functions require GPU access
RLAPI Texture2D LoadTexture ( const char * fileName ) ; // Load texture from file into GPU memory (VRAM)
RLAPI Texture2D LoadTextureFromImage ( Image image ) ; // Load texture from image data
2021-03-22 20:41:33 +01:00
RLAPI TextureCubemap LoadTextureCubemap ( Image image , int layout ) ; // Load cubemap from image, multiple image cubemap layouts supported
2020-03-29 13:31:12 +02:00
RLAPI RenderTexture2D LoadRenderTexture ( int width , int height ) ; // Load texture for rendering (framebuffer)
2024-10-16 19:26:12 +02:00
RLAPI bool IsTextureValid ( Texture2D texture ) ; // Check if a texture is valid (loaded in GPU)
2020-03-29 13:31:12 +02:00
RLAPI void UnloadTexture ( Texture2D texture ) ; // Unload texture from GPU memory (VRAM)
2024-10-16 19:26:12 +02:00
RLAPI bool IsRenderTextureValid ( RenderTexture2D target ) ; // Check if a render texture is valid (loaded in GPU)
2020-03-29 13:31:12 +02:00
RLAPI void UnloadRenderTexture ( RenderTexture2D target ) ; // Unload render texture from GPU memory (VRAM)
RLAPI void UpdateTexture ( Texture2D texture , const void * pixels ) ; // Update GPU texture with new data
2020-06-25 16:26:59 +02:00
RLAPI void UpdateTextureRec ( Texture2D texture , Rectangle rec , const void * pixels ) ; // Update GPU texture rectangle with new data
2017-06-28 12:56:04 +02:00
2020-03-29 13:31:12 +02:00
// Texture configuration functions
2016-11-22 12:14:55 +01:00
RLAPI void GenTextureMipmaps ( Texture2D * texture ) ; // Generate GPU mipmaps for a texture
2021-04-05 13:35:59 +02:00
RLAPI void SetTextureFilter ( Texture2D texture , int filter ) ; // Set texture scaling filter mode
RLAPI void SetTextureWrap ( Texture2D texture , int wrap ) ; // Set texture wrapping mode
2016-08-13 11:31:15 +02:00
2020-03-29 13:31:12 +02:00
// Texture drawing functions
2016-08-13 11:31:15 +02:00
RLAPI void DrawTexture ( Texture2D texture , int posX , int posY , Color tint ) ; // Draw a Texture2D
RLAPI void DrawTextureV ( Texture2D texture , Vector2 position , Color tint ) ; // Draw a Texture2D with position defined as Vector2
RLAPI void DrawTextureEx ( Texture2D texture , Vector2 position , float rotation , float scale , Color tint ) ; // Draw a Texture2D with extended parameters
2021-03-28 20:07:59 +02:00
RLAPI void DrawTextureRec ( Texture2D texture , Rectangle source , Vector2 position , Color tint ) ; // Draw a part of a texture defined by a rectangle
2022-11-10 10:11:28 +01:00
RLAPI void DrawTexturePro ( Texture2D texture , Rectangle source , Rectangle dest , Vector2 origin , float rotation , Color tint ) ; // Draw a part of a texture defined by a rectangle with 'pro' parameters
2022-11-10 10:17:37 +01:00
RLAPI void DrawTextureNPatch ( Texture2D texture , NPatchInfo nPatchInfo , Rectangle dest , Vector2 origin , float rotation , Color tint ) ; // Draws a texture (or part of it) that stretches or shrinks nicely
2013-11-18 23:38:44 +01:00
2020-06-15 12:02:50 +02:00
// Color/pixel related functions
2024-02-29 18:40:10 +01:00
RLAPI bool ColorIsEqual ( Color col1 , Color col2 ) ; // Check if two colors are equal
2021-06-10 17:43:58 +02:00
RLAPI Color Fade ( Color color , float alpha ) ; // Get color with alpha applied, alpha goes from 0.0f to 1.0f
2024-03-07 12:10:02 +01:00
RLAPI int ColorToInt ( Color color ) ; // Get hexadecimal value for a Color (0xRRGGBBAA)
2021-06-10 17:43:58 +02:00
RLAPI Vector4 ColorNormalize ( Color color ) ; // Get Color normalized as float [0..1]
RLAPI Color ColorFromNormalized ( Vector4 normalized ) ; // Get Color from normalized values [0..1]
RLAPI Vector3 ColorToHSV ( Color color ) ; // Get HSV values for a Color, hue [0..360], saturation/value [0..1]
RLAPI Color ColorFromHSV ( float hue , float saturation , float value ) ; // Get a Color from HSV values, hue [0..360], saturation/value [0..1]
2022-12-07 12:52:42 +01:00
RLAPI Color ColorTint ( Color color , Color tint ) ; // Get color multiplied with another color
RLAPI Color ColorBrightness ( Color color , float factor ) ; // Get color with brightness correction, brightness factor goes from -1.0f to 1.0f
RLAPI Color ColorContrast ( Color color , float contrast ) ; // Get color with contrast correction, contrast values between -1.0f and 1.0f
2021-06-10 17:43:58 +02:00
RLAPI Color ColorAlpha ( Color color , float alpha ) ; // Get color with alpha applied, alpha goes from 0.0f to 1.0f
RLAPI Color ColorAlphaBlend ( Color dst , Color src , Color tint ) ; // Get src alpha-blended into dst color with tint
2024-09-15 13:01:59 +02:00
RLAPI Color ColorLerp ( Color color1 , Color color2 , float factor ) ; // Get color lerp interpolation between two colors, factor [0.0f..1.0f]
2021-10-03 12:09:59 +02:00
RLAPI Color GetColor ( unsigned int hexValue ) ; // Get Color structure from hexadecimal value
2020-06-15 12:02:50 +02:00
RLAPI Color GetPixelColor ( void * srcPtr , int format ) ; // Get Color from a source pixel pointer of certain format
RLAPI void SetPixelColor ( void * dstPtr , Color color , int format ) ; // Set color formatted into destination pixel pointer
RLAPI int GetPixelDataSize ( int width , int height , int format ) ; // Get pixel data size in bytes for certain format
2020-06-07 18:32:20 +02:00
2013-11-18 23:38:44 +01:00
//------------------------------------------------------------------------------------
// Font Loading and Text Drawing Functions (Module: text)
//------------------------------------------------------------------------------------
2017-05-15 11:30:09 +02:00
2018-05-04 16:59:48 +02:00
// Font loading/unloading functions
2018-07-05 19:17:06 +02:00
RLAPI Font GetFontDefault ( void ) ; // Get the default Font
2018-06-20 00:52:14 +02:00
RLAPI Font LoadFont ( const char * fileName ) ; // Load font from file into GPU memory (VRAM)
2024-08-25 12:51:55 +02:00
RLAPI Font LoadFontEx ( const char * fileName , int fontSize , int * codepoints , int codepointCount ) ; // Load font from file with extended parameters, use NULL for codepoints and 0 for codepointCount to load the default character set, font size is provided in pixels height
2018-12-20 12:58:27 +01:00
RLAPI Font LoadFontFromImage ( Image image , Color key , int firstChar ) ; // Load font from Image (XNA style)
2023-09-01 23:23:01 +02:00
RLAPI Font LoadFontFromMemory ( const char * fileType , const unsigned char * fileData , int dataSize , int fontSize , int * codepoints , int codepointCount ) ; // Load font from memory buffer, fileType refers to extension: i.e. '.ttf'
2024-10-16 19:26:12 +02:00
RLAPI bool IsFontValid ( Font font ) ; // Check if a font is valid (font data loaded, WARNING: GPU texture not checked)
2023-09-01 23:23:01 +02:00
RLAPI GlyphInfo * LoadFontData ( const unsigned char * fileData , int dataSize , int fontSize , int * codepoints , int codepointCount , int type ) ; // Load font data for further use
RLAPI Image GenImageFontAtlas ( const GlyphInfo * glyphs , Rectangle * * glyphRecs , int glyphCount , int fontSize , int padding , int packMethod ) ; // Generate image font atlas using chars info
2023-09-29 00:28:16 +02:00
RLAPI void UnloadFontData ( GlyphInfo * glyphs , int glyphCount ) ; // Unload font chars info data (RAM)
2022-01-03 20:45:56 +01:00
RLAPI void UnloadFont ( Font font ) ; // Unload font from GPU memory (VRAM)
RLAPI bool ExportFontAsCode ( Font font , const char * fileName ) ; // Export font as code file, returns true on success
2017-05-15 11:30:09 +02:00
// Text drawing functions
2021-03-24 17:06:32 +01:00
RLAPI void DrawFPS ( int posX , int posY ) ; // Draw current FPS
2018-06-20 00:52:14 +02:00
RLAPI void DrawText ( const char * text , int posX , int posY , int fontSize , Color color ) ; // Draw text (using default font)
2021-11-17 13:36:28 +01:00
RLAPI void DrawTextEx ( Font font , const char * text , Vector2 position , float fontSize , float spacing , Color tint ) ; // Draw text using font and additional parameters
2021-08-11 18:31:56 +02:00
RLAPI void DrawTextPro ( Font font , const char * text , Vector2 position , Vector2 origin , float rotation , float fontSize , float spacing , Color tint ) ; // Draw text using Font and pro parameters (rotation)
2021-11-17 13:36:28 +01:00
RLAPI void DrawTextCodepoint ( Font font , int codepoint , Vector2 position , float fontSize , Color tint ) ; // Draw one character (codepoint)
2023-09-01 23:23:01 +02:00
RLAPI void DrawTextCodepoints ( Font font , const int * codepoints , int codepointCount , Vector2 position , float fontSize , float spacing , Color tint ) ; // Draw multiple character (codepoint)
2017-05-15 11:30:09 +02:00
2021-08-11 21:16:39 +02:00
// Text font info functions
2023-07-02 10:52:20 +02:00
RLAPI void SetTextLineSpacing ( int spacing ) ; // Set vertical line spacing when drawing with line-breaks
2018-06-20 00:52:14 +02:00
RLAPI int MeasureText ( const char * text , int fontSize ) ; // Measure string width for default font
RLAPI Vector2 MeasureTextEx ( Font font , const char * text , float fontSize , float spacing ) ; // Measure string size for Font
2021-08-11 21:16:39 +02:00
RLAPI int GetGlyphIndex ( Font font , int codepoint ) ; // Get glyph index position in font for a codepoint (unicode character), fallback to '?' if not found
RLAPI GlyphInfo GetGlyphInfo ( Font font , int codepoint ) ; // Get glyph font info data for a codepoint (unicode character), fallback to '?' if not found
RLAPI Rectangle GetGlyphAtlasRec ( Font font , int codepoint ) ; // Get glyph rectangle in font atlas for a codepoint (unicode character), fallback to '?' if not found
2013-11-18 23:38:44 +01:00
2021-08-11 21:16:39 +02:00
// Text codepoints management functions (unicode characters)
2024-12-12 12:13:38 +01:00
RLAPI char * LoadUTF8 ( const int * codepoints , int length ) ; // Load UTF-8 text encoded from codepoints array
RLAPI void UnloadUTF8 ( char * text ) ; // Unload UTF-8 text encoded from codepoints array
RLAPI int * LoadCodepoints ( const char * text , int * count ) ; // Load all codepoints from a UTF-8 text string, codepoints count returned by parameter
RLAPI void UnloadCodepoints ( int * codepoints ) ; // Unload codepoints data from memory
RLAPI int GetCodepointCount ( const char * text ) ; // Get total number of codepoints in a UTF-8 encoded string
RLAPI int GetCodepoint ( const char * text , int * codepointSize ) ; // Get next codepoint in a UTF-8 encoded string, 0x3f('?') is returned on failure
RLAPI int GetCodepointNext ( const char * text , int * codepointSize ) ; // Get next codepoint in a UTF-8 encoded string, 0x3f('?') is returned on failure
RLAPI int GetCodepointPrevious ( const char * text , int * codepointSize ) ; // Get previous codepoint in a UTF-8 encoded string, 0x3f('?') is returned on failure
RLAPI const char * CodepointToUTF8 ( int codepoint , int * utf8Size ) ; // Encode one codepoint into UTF-8 byte array (array length returned as parameter)
2021-08-11 21:16:39 +02:00
// Text strings management functions (no UTF-8 strings, only byte chars)
2025-01-18 20:19:11 +01:00
// WARNING 1: Most of these functions use internal static buffers, it's recommended to store returned data on user-side for re-use
// WARNING 2: Some strings allocate memory internally for the returned strings, those strings must be free by user using MemFree()
2020-01-26 18:38:46 +01:00
RLAPI int TextCopy ( char * dst , const char * src ) ; // Copy one string to another, returns bytes copied
2018-12-26 13:26:34 +01:00
RLAPI bool TextIsEqual ( const char * text1 , const char * text2 ) ; // Check if two text string are equal
RLAPI unsigned int TextLength ( const char * text ) ; // Get text length, checks for '\0' ending
2021-08-11 21:16:39 +02:00
RLAPI const char * TextFormat ( const char * text , . . . ) ; // Text formatting with variables (sprintf() style)
2018-12-26 13:26:34 +01:00
RLAPI const char * TextSubtext ( const char * text , int position , int length ) ; // Get a piece of a text string
2023-12-28 21:09:49 +02:00
RLAPI char * TextReplace ( const char * text , const char * replace , const char * by ) ; // Replace text string (WARNING: memory must be freed!)
2021-08-11 21:16:39 +02:00
RLAPI char * TextInsert ( const char * text , const char * insert , int position ) ; // Insert text in a position (WARNING: memory must be freed!)
2025-01-11 23:38:21 +01:00
RLAPI char * TextJoin ( char * * textList , int count , const char * delimiter ) ; // Join text strings with delimiter
2025-01-10 13:06:28 +01:00
RLAPI char * * TextSplit ( const char * text , char delimiter , int * count ) ; // Split text into multiple strings
2018-12-26 13:26:34 +01:00
RLAPI void TextAppend ( char * text , const char * append , int * position ) ; // Append text at specific position and move cursor!
RLAPI int TextFindIndex ( const char * text , const char * find ) ; // Find first text occurrence within a string
2025-01-10 13:06:28 +01:00
RLAPI char * TextToUpper ( const char * text ) ; // Get upper case version of provided string
RLAPI char * TextToLower ( const char * text ) ; // Get lower case version of provided string
RLAPI char * TextToPascal ( const char * text ) ; // Get Pascal case notation version of provided string
RLAPI char * TextToSnake ( const char * text ) ; // Get Snake case notation version of provided string
RLAPI char * TextToCamel ( const char * text ) ; // Get Camel case notation version of provided string
2024-06-03 11:13:28 -07:00
2024-12-13 02:21:13 -06:00
RLAPI int TextToInteger ( const char * text ) ; // Get integer value from text
RLAPI float TextToFloat ( const char * text ) ; // Get float value from text
2018-10-23 15:43:19 +02:00
2013-11-18 23:38:44 +01:00
//------------------------------------------------------------------------------------
// Basic 3d Shapes Drawing Functions (Module: models)
//------------------------------------------------------------------------------------
2017-05-15 11:30:09 +02:00
// Basic geometric 3D shapes drawing functions
2016-08-13 11:31:15 +02:00
RLAPI void DrawLine3D ( Vector3 startPos , Vector3 endPos , Color color ) ; // Draw a line in 3D world space
2020-01-29 12:21:22 +01:00
RLAPI void DrawPoint3D ( Vector3 position , Color color ) ; // Draw a point in 3D space, actually a small line
2016-11-17 12:55:30 +01:00
RLAPI void DrawCircle3D ( Vector3 center , float radius , Vector3 rotationAxis , float rotationAngle , Color color ) ; // Draw a circle in 3D world space
2020-05-07 12:46:45 +02:00
RLAPI void DrawTriangle3D ( Vector3 v1 , Vector3 v2 , Vector3 v3 , Color color ) ; // Draw a color-filled triangle (vertex in counter-clockwise order!)
2024-06-11 02:51:49 -07:00
RLAPI void DrawTriangleStrip3D ( const Vector3 * points , int pointCount , Color color ) ; // Draw a triangle strip defined by points
2016-08-25 14:18:43 +02:00
RLAPI void DrawCube ( Vector3 position , float width , float height , float length , Color color ) ; // Draw cube
2016-08-13 11:31:15 +02:00
RLAPI void DrawCubeV ( Vector3 position , Vector3 size , Color color ) ; // Draw cube (Vector version)
2016-08-25 14:18:43 +02:00
RLAPI void DrawCubeWires ( Vector3 position , float width , float height , float length , Color color ) ; // Draw cube wires
2019-03-08 15:06:17 -03:00
RLAPI void DrawCubeWiresV ( Vector3 position , Vector3 size , Color color ) ; // Draw cube wires (Vector version)
2016-08-13 11:31:15 +02:00
RLAPI void DrawSphere ( Vector3 centerPos , float radius , Color color ) ; // Draw sphere
RLAPI void DrawSphereEx ( Vector3 centerPos , float radius , int rings , int slices , Color color ) ; // Draw sphere with extended parameters
RLAPI void DrawSphereWires ( Vector3 centerPos , float radius , int rings , int slices , Color color ) ; // Draw sphere wires
RLAPI void DrawCylinder ( Vector3 position , float radiusTop , float radiusBottom , float height , int slices , Color color ) ; // Draw a cylinder/cone
2021-10-12 19:36:06 +02:00
RLAPI void DrawCylinderEx ( Vector3 startPos , Vector3 endPos , float startRadius , float endRadius , int sides , Color color ) ; // Draw a cylinder with base at startPos and top at endPos
2016-08-13 11:31:15 +02:00
RLAPI void DrawCylinderWires ( Vector3 position , float radiusTop , float radiusBottom , float height , int slices , Color color ) ; // Draw a cylinder/cone wires
2021-10-12 19:36:06 +02:00
RLAPI void DrawCylinderWiresEx ( Vector3 startPos , Vector3 endPos , float startRadius , float endRadius , int sides , Color color ) ; // Draw a cylinder wires with base at startPos and top at endPos
2022-10-17 02:36:53 -07:00
RLAPI void DrawCapsule ( Vector3 startPos , Vector3 endPos , float radius , int slices , int rings , Color color ) ; // Draw a capsule with the center of its sphere caps at startPos and endPos
RLAPI void DrawCapsuleWires ( Vector3 startPos , Vector3 endPos , float radius , int slices , int rings , Color color ) ; // Draw capsule wireframe with the center of its sphere caps at startPos and endPos
2016-08-13 11:31:15 +02:00
RLAPI void DrawPlane ( Vector3 centerPos , Vector2 size , Color color ) ; // Draw a plane XZ
RLAPI void DrawRay ( Ray ray , Color color ) ; // Draw a ray line
RLAPI void DrawGrid ( int slices , float spacing ) ; // Draw a grid (centered at (0, 0, 0))
2013-11-18 23:38:44 +01:00
//------------------------------------------------------------------------------------
// Model 3d Loading and Drawing Functions (Module: models)
//------------------------------------------------------------------------------------
2017-05-15 11:30:09 +02:00
2021-07-28 13:15:10 +02:00
// Model management functions
2021-03-25 14:28:12 +01:00
RLAPI Model LoadModel ( const char * fileName ) ; // Load model from files (meshes and materials)
RLAPI Model LoadModelFromMesh ( Mesh mesh ) ; // Load model from generated mesh (default material)
2024-10-16 19:26:12 +02:00
RLAPI bool IsModelValid ( Model model ) ; // Check if a model is valid (loaded in GPU, VAO/VBOs)
2021-03-25 14:28:12 +01:00
RLAPI void UnloadModel ( Model model ) ; // Unload model (including meshes) from memory (RAM and/or VRAM)
2021-07-28 13:15:10 +02:00
RLAPI BoundingBox GetModelBoundingBox ( Model model ) ; // Compute model bounding box limits (considers all meshes)
2017-07-17 00:33:40 +02:00
2021-07-28 13:15:10 +02:00
// Model drawing functions
2022-11-10 12:03:17 +01:00
RLAPI void DrawModel ( Model model , Vector3 position , float scale , Color tint ) ; // Draw a model (with texture if set)
2021-07-28 13:15:10 +02:00
RLAPI void DrawModelEx ( Model model , Vector3 position , Vector3 rotationAxis , float rotationAngle , Vector3 scale , Color tint ) ; // Draw a model with extended parameters
2022-11-10 12:03:17 +01:00
RLAPI void DrawModelWires ( Model model , Vector3 position , float scale , Color tint ) ; // Draw a model wires (with texture if set)
2021-07-28 13:15:10 +02:00
RLAPI void DrawModelWiresEx ( Model model , Vector3 position , Vector3 rotationAxis , float rotationAngle , Vector3 scale , Color tint ) ; // Draw a model wires (with texture if set) with extended parameters
2024-08-24 12:42:38 -04:00
RLAPI void DrawModelPoints ( Model model , Vector3 position , float scale , Color tint ) ; // Draw a model as points
RLAPI void DrawModelPointsEx ( Model model , Vector3 position , Vector3 rotationAxis , float rotationAngle , Vector3 scale , Color tint ) ; // Draw a model as points with extended parameters
2022-11-10 12:03:17 +01:00
RLAPI void DrawBoundingBox ( BoundingBox box , Color color ) ; // Draw bounding box (wires)
2024-07-08 02:27:51 +08:00
RLAPI void DrawBillboard ( Camera camera , Texture2D texture , Vector3 position , float scale , Color tint ) ; // Draw a billboard texture
2021-07-28 13:15:10 +02:00
RLAPI void DrawBillboardRec ( Camera camera , Texture2D texture , Rectangle source , Vector3 position , Vector2 size , Color tint ) ; // Draw a billboard texture defined by source
2021-09-21 10:22:30 -03:00
RLAPI void DrawBillboardPro ( Camera camera , Texture2D texture , Rectangle source , Vector3 position , Vector3 up , Vector2 size , Vector2 origin , float rotation , Color tint ) ; // Draw a billboard texture defined by source and rotation
2021-07-28 13:15:10 +02:00
// Mesh management functions
2021-04-20 12:16:16 +02:00
RLAPI void UploadMesh ( Mesh * mesh , bool dynamic ) ; // Upload mesh vertex data in GPU and provide VAO/VBO ids
2022-02-20 20:35:28 +01:00
RLAPI void UpdateMeshBuffer ( Mesh mesh , int index , const void * data , int dataSize , int offset ) ; // Update mesh vertex data in GPU for a specific buffer index
2021-07-28 13:15:10 +02:00
RLAPI void UnloadMesh ( Mesh mesh ) ; // Unload mesh data from CPU and GPU
2021-04-05 13:35:59 +02:00
RLAPI void DrawMesh ( Mesh mesh , Material material , Matrix transform ) ; // Draw a 3d mesh with material and transform
2022-02-20 21:12:55 +02:00
RLAPI void DrawMeshInstanced ( Mesh mesh , Material material , const Matrix * transforms , int instances ) ; // Draw multiple mesh instances with material and different transforms
2021-07-28 13:15:10 +02:00
RLAPI BoundingBox GetMeshBoundingBox ( Mesh mesh ) ; // Compute mesh bounding box limits
RLAPI void GenMeshTangents ( Mesh * mesh ) ; // Compute mesh tangents
2023-11-30 13:01:19 +01:00
RLAPI bool ExportMesh ( Mesh mesh , const char * fileName ) ; // Export mesh data to file, returns true on success
RLAPI bool ExportMeshAsCode ( Mesh mesh , const char * fileName ) ; // Export mesh as code file (.h) defining multiple arrays of vertex attributes
2018-02-26 12:10:45 +01:00
2017-09-18 00:59:22 +02:00
// Mesh generation functions
2021-03-25 14:28:12 +01:00
RLAPI Mesh GenMeshPoly ( int sides , float radius ) ; // Generate polygonal mesh
RLAPI Mesh GenMeshPlane ( float width , float length , int resX , int resZ ) ; // Generate plane mesh (with subdivisions)
RLAPI Mesh GenMeshCube ( float width , float height , float length ) ; // Generate cuboid mesh
RLAPI Mesh GenMeshSphere ( float radius , int rings , int slices ) ; // Generate sphere mesh (standard sphere)
RLAPI Mesh GenMeshHemiSphere ( float radius , int rings , int slices ) ; // Generate half-sphere mesh (no bottom cap)
RLAPI Mesh GenMeshCylinder ( float radius , float height , int slices ) ; // Generate cylinder mesh
2021-08-08 11:29:24 +02:00
RLAPI Mesh GenMeshCone ( float radius , float height , int slices ) ; // Generate cone/pyramid mesh
2021-03-25 14:28:12 +01:00
RLAPI Mesh GenMeshTorus ( float radius , float size , int radSeg , int sides ) ; // Generate torus mesh
RLAPI Mesh GenMeshKnot ( float radius , float size , int radSeg , int sides ) ; // Generate trefoil knot mesh
RLAPI Mesh GenMeshHeightmap ( Image heightmap , Vector3 size ) ; // Generate heightmap mesh from image data
RLAPI Mesh GenMeshCubicmap ( Image cubicmap , Vector3 cubeSize ) ; // Generate cubes-based map mesh from image data
2016-12-25 02:01:13 +01:00
2021-07-28 13:15:10 +02:00
// Material loading/unloading functions
RLAPI Material * LoadMaterials ( const char * fileName , int * materialCount ) ; // Load materials from model file
RLAPI Material LoadMaterialDefault ( void ) ; // Load default material (Supports: DIFFUSE, SPECULAR, NORMAL maps)
2024-10-16 19:26:12 +02:00
RLAPI bool IsMaterialValid ( Material material ) ; // Check if a material is valid (shader assigned, map textures loaded in GPU)
2021-07-28 13:15:10 +02:00
RLAPI void UnloadMaterial ( Material material ) ; // Unload material from GPU memory (VRAM)
RLAPI void SetMaterialTexture ( Material * material , int mapType , Texture2D texture ) ; // Set texture for a material map type (MATERIAL_MAP_DIFFUSE, MATERIAL_MAP_SPECULAR...)
RLAPI void SetModelMeshMaterial ( Model * model , int meshId , int materialId ) ; // Set material for a mesh
2016-12-25 02:01:13 +01:00
2021-07-28 13:15:10 +02:00
// Model animations loading/unloading functions
2023-09-02 12:05:34 +02:00
RLAPI ModelAnimation * LoadModelAnimations ( const char * fileName , int * animCount ) ; // Load model animations from file
2024-10-24 12:46:02 +02:00
RLAPI void UpdateModelAnimation ( Model model , ModelAnimation anim , int frame ) ; // Update model animation pose (CPU)
2024-11-03 13:12:01 +01:00
RLAPI void UpdateModelAnimationBones ( Model model , ModelAnimation anim , int frame ) ; // Update model animation mesh bone matrices (GPU skinning)
2021-07-28 13:15:10 +02:00
RLAPI void UnloadModelAnimation ( ModelAnimation anim ) ; // Unload animation data
2023-09-02 12:54:36 +02:00
RLAPI void UnloadModelAnimations ( ModelAnimation * animations , int animCount ) ; // Unload animation array data
2021-07-28 13:15:10 +02:00
RLAPI bool IsModelAnimationValid ( Model model , ModelAnimation anim ) ; // Check model animation skeleton match
2016-12-25 02:01:13 +01:00
2017-05-15 11:30:09 +02:00
// Collision detection functions
2024-12-12 12:13:38 +01:00
RLAPI bool CheckCollisionSpheres ( Vector3 center1 , float radius1 , Vector3 center2 , float radius2 ) ; // Check collision between two spheres
RLAPI bool CheckCollisionBoxes ( BoundingBox box1 , BoundingBox box2 ) ; // Check collision between two bounding boxes
RLAPI bool CheckCollisionBoxSphere ( BoundingBox box , Vector3 center , float radius ) ; // Check collision between box and sphere
RLAPI RayCollision GetRayCollisionSphere ( Ray ray , Vector3 center , float radius ) ; // Get collision info between ray and sphere
RLAPI RayCollision GetRayCollisionBox ( Ray ray , BoundingBox box ) ; // Get collision info between ray and box
RLAPI RayCollision GetRayCollisionMesh ( Ray ray , Mesh mesh , Matrix transform ) ; // Get collision info between ray and mesh
RLAPI RayCollision GetRayCollisionTriangle ( Ray ray , Vector3 p1 , Vector3 p2 , Vector3 p3 ) ; // Get collision info between ray and triangle
RLAPI RayCollision GetRayCollisionQuad ( Ray ray , Vector3 p1 , Vector3 p2 , Vector3 p3 , Vector3 p4 ) ; // Get collision info between ray and quad
2016-12-31 15:06:39 -08:00
2013-11-18 23:38:44 +01:00
//------------------------------------------------------------------------------------
// Audio Loading and Playing Functions (Module: audio)
//------------------------------------------------------------------------------------
2022-03-25 10:19:40 +01:00
typedef void ( * AudioCallback ) ( void * bufferData , unsigned int frames ) ;
2017-05-15 11:30:09 +02:00
// Audio device management functions
2016-08-13 11:31:15 +02:00
RLAPI void InitAudioDevice ( void ) ; // Initialize audio device and context
2016-11-17 12:55:30 +01:00
RLAPI void CloseAudioDevice ( void ) ; // Close the audio device and context
2016-08-13 11:31:15 +02:00
RLAPI bool IsAudioDeviceReady ( void ) ; // Check if audio device has been initialized successfully
2017-02-06 00:44:54 +01:00
RLAPI void SetMasterVolume ( float volume ) ; // Set master volume (listener)
2023-10-18 04:35:38 +07:00
RLAPI float GetMasterVolume ( void ) ; // Get master volume (listener)
2016-08-13 11:31:15 +02:00
2017-05-15 11:30:09 +02:00
// Wave/Sound loading/unloading functions
2016-12-25 02:01:13 +01:00
RLAPI Wave LoadWave ( const char * fileName ) ; // Load wave data from file
2021-05-29 13:54:05 +02:00
RLAPI Wave LoadWaveFromMemory ( const char * fileType , const unsigned char * fileData , int dataSize ) ; // Load wave from memory buffer, fileType refers to extension: i.e. '.wav'
2024-10-16 19:26:12 +02:00
RLAPI bool IsWaveValid ( Wave wave ) ; // Checks if wave data is valid (data loaded and parameters)
2016-12-25 02:01:13 +01:00
RLAPI Sound LoadSound ( const char * fileName ) ; // Load sound from file
RLAPI Sound LoadSoundFromWave ( Wave wave ) ; // Load sound from wave data
2023-09-29 00:28:16 +02:00
RLAPI Sound LoadSoundAlias ( Sound source ) ; // Create a new sound that shares the same sample data as the source sound, does not own the sound data
2024-10-16 19:26:12 +02:00
RLAPI bool IsSoundValid ( Sound sound ) ; // Checks if a sound is valid (data loaded and buffers initialized)
2021-09-01 23:11:31 +02:00
RLAPI void UpdateSound ( Sound sound , const void * data , int sampleCount ) ; // Update sound buffer with new data
2016-10-12 10:27:14 +02:00
RLAPI void UnloadWave ( Wave wave ) ; // Unload wave data
2016-08-13 11:31:15 +02:00
RLAPI void UnloadSound ( Sound sound ) ; // Unload sound
2023-08-04 07:40:10 -07:00
RLAPI void UnloadSoundAlias ( Sound alias ) ; // Unload a sound alias (does not deallocate sample data)
2020-11-22 10:56:17 +01:00
RLAPI bool ExportWave ( Wave wave , const char * fileName ) ; // Export wave data to file, returns true on success
RLAPI bool ExportWaveAsCode ( Wave wave , const char * fileName ) ; // Export wave sample data to code (.h), returns true on success
2017-05-15 11:30:09 +02:00
// Wave/Sound management functions
2016-08-13 11:31:15 +02:00
RLAPI void PlaySound ( Sound sound ) ; // Play a sound
2019-07-24 22:38:06 +02:00
RLAPI void StopSound ( Sound sound ) ; // Stop playing a sound
2016-08-13 11:31:15 +02:00
RLAPI void PauseSound ( Sound sound ) ; // Pause a sound
RLAPI void ResumeSound ( Sound sound ) ; // Resume a paused sound
RLAPI bool IsSoundPlaying ( Sound sound ) ; // Check if a sound is currently playing
RLAPI void SetSoundVolume ( Sound sound , float volume ) ; // Set volume for a sound (1.0 is max level)
RLAPI void SetSoundPitch ( Sound sound , float pitch ) ; // Set pitch for a sound (1.0 is base level)
2022-01-16 17:16:04 +01:00
RLAPI void SetSoundPan ( Sound sound , float pan ) ; // Set pan for a sound (0.5 is center)
2016-09-08 00:20:06 +02:00
RLAPI Wave WaveCopy ( Wave wave ) ; // Copy a wave to a new wave
2024-05-21 03:13:46 -03:00
RLAPI void WaveCrop ( Wave * wave , int initFrame , int finalFrame ) ; // Crop a wave to defined frames range
2022-01-16 17:16:04 +01:00
RLAPI void WaveFormat ( Wave * wave , int sampleRate , int sampleSize , int channels ) ; // Convert wave data to desired format
RLAPI float * LoadWaveSamples ( Wave wave ) ; // Load samples data from wave as a 32bit float data array
2020-12-18 21:03:08 +01:00
RLAPI void UnloadWaveSamples ( float * samples ) ; // Unload samples data loaded with LoadWaveSamples()
2017-05-15 11:30:09 +02:00
// Music management functions
2016-09-08 00:20:06 +02:00
RLAPI Music LoadMusicStream ( const char * fileName ) ; // Load music stream from file
2022-02-20 20:35:28 +01:00
RLAPI Music LoadMusicStreamFromMemory ( const char * fileType , const unsigned char * data , int dataSize ) ; // Load music stream from data
2024-10-16 19:26:12 +02:00
RLAPI bool IsMusicValid ( Music music ) ; // Checks if a music stream is valid (context and buffers initialized)
2016-08-13 11:31:15 +02:00
RLAPI void UnloadMusicStream ( Music music ) ; // Unload music stream
2016-11-17 12:55:30 +01:00
RLAPI void PlayMusicStream ( Music music ) ; // Start music playing
2021-05-20 19:27:04 +02:00
RLAPI bool IsMusicStreamPlaying ( Music music ) ; // Check if music is playing
2016-08-13 11:31:15 +02:00
RLAPI void UpdateMusicStream ( Music music ) ; // Updates buffers for music streaming
2016-11-17 12:55:30 +01:00
RLAPI void StopMusicStream ( Music music ) ; // Stop music playing
2016-08-13 11:31:15 +02:00
RLAPI void PauseMusicStream ( Music music ) ; // Pause music playing
RLAPI void ResumeMusicStream ( Music music ) ; // Resume playing paused music
2021-09-22 16:55:13 -03:00
RLAPI void SeekMusicStream ( Music music , float position ) ; // Seek music to a position (in seconds)
2016-08-13 11:31:15 +02:00
RLAPI void SetMusicVolume ( Music music , float volume ) ; // Set volume for music (1.0 is max level)
RLAPI void SetMusicPitch ( Music music , float pitch ) ; // Set pitch for a music (1.0 is base level)
2022-01-16 17:16:04 +01:00
RLAPI void SetMusicPan ( Music music , float pan ) ; // Set pan for a music (0.5 is center)
2016-08-13 11:31:15 +02:00
RLAPI float GetMusicTimeLength ( Music music ) ; // Get music time length (in seconds)
RLAPI float GetMusicTimePlayed ( Music music ) ; // Get current music time played (in seconds)
2017-05-15 11:30:09 +02:00
// AudioStream management functions
2021-06-03 23:36:47 +02:00
RLAPI AudioStream LoadAudioStream ( unsigned int sampleRate , unsigned int sampleSize , unsigned int channels ) ; // Load audio stream (to stream raw audio pcm data)
2024-10-16 19:26:12 +02:00
RLAPI bool IsAudioStreamValid ( AudioStream stream ) ; // Checks if an audio stream is valid (buffers initialized)
2021-11-17 13:36:28 +01:00
RLAPI void UnloadAudioStream ( AudioStream stream ) ; // Unload audio stream and free memory
2021-09-01 23:11:31 +02:00
RLAPI void UpdateAudioStream ( AudioStream stream , const void * data , int frameCount ) ; // Update audio stream buffers with data
2019-08-13 17:41:31 +02:00
RLAPI bool IsAudioStreamProcessed ( AudioStream stream ) ; // Check if any audio stream buffers requires refill
2016-08-13 11:31:15 +02:00
RLAPI void PlayAudioStream ( AudioStream stream ) ; // Play audio stream
RLAPI void PauseAudioStream ( AudioStream stream ) ; // Pause audio stream
RLAPI void ResumeAudioStream ( AudioStream stream ) ; // Resume audio stream
2017-11-12 21:55:24 +10:00
RLAPI bool IsAudioStreamPlaying ( AudioStream stream ) ; // Check if audio stream is playing
2016-08-13 11:31:15 +02:00
RLAPI void StopAudioStream ( AudioStream stream ) ; // Stop audio stream
2017-12-20 00:34:31 +01:00
RLAPI void SetAudioStreamVolume ( AudioStream stream , float volume ) ; // Set volume for audio stream (1.0 is max level)
RLAPI void SetAudioStreamPitch ( AudioStream stream , float pitch ) ; // Set pitch for audio stream (1.0 is base level)
2022-01-16 17:16:04 +01:00
RLAPI void SetAudioStreamPan ( AudioStream stream , float pan ) ; // Set pan for audio stream (0.5 is centered)
2020-02-14 17:13:37 +01:00
RLAPI void SetAudioStreamBufferSizeDefault ( int size ) ; // Default size for new audio streams
2023-09-29 00:28:16 +02:00
RLAPI void SetAudioStreamCallback ( AudioStream stream , AudioCallback callback ) ; // Audio thread callback to request new data
2019-10-21 08:38:23 -07:00
2025-02-08 11:22:34 +01:00
RLAPI void AttachAudioStreamProcessor ( AudioStream stream , AudioCallback processor ) ; // Attach audio stream processor to stream, receives frames x 2 samples as 'float' (stereo)
2022-08-05 20:01:35 +02:00
RLAPI void DetachAudioStreamProcessor ( AudioStream stream , AudioCallback processor ) ; // Detach audio stream processor from stream
2022-03-30 20:13:02 +02:00
2025-02-08 11:22:34 +01:00
RLAPI void AttachAudioMixedProcessor ( AudioCallback processor ) ; // Attach audio stream processor to the entire audio pipeline, receives frames x 2 samples as 'float' (stereo)
2023-02-20 13:13:24 +03:00
RLAPI void DetachAudioMixedProcessor ( AudioCallback processor ) ; // Detach audio stream processor from the entire audio pipeline
2018-10-16 10:53:01 +02:00
# if defined(__cplusplus)
2013-11-18 23:38:44 +01:00
}
# endif
2013-11-19 00:09:52 +01:00
# endif // RAYLIB_H