raylib 5.0.0.3__pp38-pypy38_pp73-manylinux2014_x86_64.whl → 5.0.0.5__pp38-pypy38_pp73-manylinux2014_x86_64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of raylib might be problematic. Click here for more details.

@@ -0,0 +1,1409 @@
1
+ /**********************************************************************************************
2
+ *
3
+ * raylib v5.0 - A simple and easy-to-use library to enjoy videogames programming (www.raylib.com)
4
+ *
5
+ * FEATURES:
6
+ * - NO external dependencies, all required libraries included with raylib
7
+ * - Multiplatform: Windows, Linux, FreeBSD, OpenBSD, NetBSD, DragonFly,
8
+ * MacOS, Haiku, Android, Raspberry Pi, DRM native, HTML5.
9
+ * - Written in plain C code (C99) in PascalCase/camelCase notation
10
+ * - Hardware accelerated with OpenGL (1.1, 2.1, 3.3, 4.3 or ES2 - choose at compile)
11
+ * - Unique OpenGL abstraction layer (usable as standalone module): [rlgl]
12
+ * - Multiple Fonts formats supported (TTF, XNA fonts, AngelCode fonts)
13
+ * - Outstanding texture formats support, including compressed formats (DXT, ETC, ASTC)
14
+ * - Full 3d support for 3d Shapes, Models, Billboards, Heightmaps and more!
15
+ * - Flexible Materials system, supporting classic maps and PBR maps
16
+ * - Animated 3D models supported (skeletal bones animation) (IQM)
17
+ * - Shaders support, including Model shaders and Postprocessing shaders
18
+ * - Powerful math module for Vector, Matrix and Quaternion operations: [raymath]
19
+ * - Audio loading and playing with streaming support (WAV, OGG, MP3, FLAC, XM, MOD)
20
+ * - VR stereo rendering with configurable HMD device parameters
21
+ * - Bindings to multiple programming languages available!
22
+ *
23
+ * NOTES:
24
+ * - One default Font is loaded on InitWindow()->LoadFontDefault() [core, text]
25
+ * - One default Texture2D is loaded on rlglInit(), 1x1 white pixel R8G8B8A8 [rlgl] (OpenGL 3.3 or ES2)
26
+ * - One default Shader is loaded on rlglInit()->rlLoadShaderDefault() [rlgl] (OpenGL 3.3 or ES2)
27
+ * - One default RenderBatch is loaded on rlglInit()->rlLoadRenderBatch() [rlgl] (OpenGL 3.3 or ES2)
28
+ *
29
+ * DEPENDENCIES (included):
30
+ * [rcore] rglfw (Camilla Löwy - github.com/glfw/glfw) for window/context management and input (PLATFORM_DESKTOP)
31
+ * [rlgl] glad (David Herberth - github.com/Dav1dde/glad) for OpenGL 3.3 extensions loading (PLATFORM_DESKTOP)
32
+ * [raudio] miniaudio (David Reid - github.com/mackron/miniaudio) for audio device/context management
33
+ *
34
+ * OPTIONAL DEPENDENCIES (included):
35
+ * [rcore] msf_gif (Miles Fogle) for GIF recording
36
+ * [rcore] sinfl (Micha Mettke) for DEFLATE decompression algorithm
37
+ * [rcore] sdefl (Micha Mettke) for DEFLATE compression algorithm
38
+ * [rtextures] stb_image (Sean Barret) for images loading (BMP, TGA, PNG, JPEG, HDR...)
39
+ * [rtextures] stb_image_write (Sean Barret) for image writing (BMP, TGA, PNG, JPG)
40
+ * [rtextures] stb_image_resize (Sean Barret) for image resizing algorithms
41
+ * [rtext] stb_truetype (Sean Barret) for ttf fonts loading
42
+ * [rtext] stb_rect_pack (Sean Barret) for rectangles packing
43
+ * [rmodels] par_shapes (Philip Rideout) for parametric 3d shapes generation
44
+ * [rmodels] tinyobj_loader_c (Syoyo Fujita) for models loading (OBJ, MTL)
45
+ * [rmodels] cgltf (Johannes Kuhlmann) for models loading (glTF)
46
+ * [rmodels] Model3D (bzt) for models loading (M3D, https://bztsrc.gitlab.io/model3d)
47
+ * [raudio] dr_wav (David Reid) for WAV audio file loading
48
+ * [raudio] dr_flac (David Reid) for FLAC audio file loading
49
+ * [raudio] dr_mp3 (David Reid) for MP3 audio file loading
50
+ * [raudio] stb_vorbis (Sean Barret) for OGG audio loading
51
+ * [raudio] jar_xm (Joshua Reisenauer) for XM audio module loading
52
+ * [raudio] jar_mod (Joshua Reisenauer) for MOD audio module loading
53
+ *
54
+ *
55
+ * LICENSE: zlib/libpng
56
+ *
57
+ * raylib is licensed under an unmodified zlib/libpng license, which is an OSI-certified,
58
+ * BSD-like license that allows static linking with closed source software:
59
+ *
60
+ * Copyright (c) 2013-2023 Ramon Santamaria (@raysan5)
61
+ *
62
+ * This software is provided "as-is", without any express or implied warranty. In no event
63
+ * will the authors be held liable for any damages arising from the use of this software.
64
+ *
65
+ * Permission is granted to anyone to use this software for any purpose, including commercial
66
+ * applications, and to alter it and redistribute it freely, subject to the following restrictions:
67
+ *
68
+ * 1. The origin of this software must not be misrepresented; you must not claim that you
69
+ * wrote the original software. If you use this software in a product, an acknowledgment
70
+ * in the product documentation would be appreciated but is not required.
71
+ *
72
+ * 2. Altered source versions must be plainly marked as such, and must not be misrepresented
73
+ * as being the original software.
74
+ *
75
+ * 3. This notice may not be removed or altered from any source distribution.
76
+ *
77
+ **********************************************************************************************/
78
+ // Function specifiers in case library is build/used as a shared library (Windows)
79
+ // NOTE: Microsoft specifiers to tell compiler that symbols are imported/exported from a .dll
80
+ //----------------------------------------------------------------------------------
81
+ // Some basic Defines
82
+ //----------------------------------------------------------------------------------
83
+ // Allow custom memory allocators
84
+ // NOTE: Require recompiling raylib sources
85
+ // NOTE: MSVC C++ compiler does not support compound literals (C99 feature)
86
+ // Plain structures in C++ (without constructors) can be initialized with { }
87
+ // This is called aggregate initialization (C++11 feature)
88
+ // Some compilers (mostly macos clang) default to C++98,
89
+ // where aggregate initialization can't be used
90
+ // So, give a more clear error stating how to fix this
91
+ // NOTE: We set some defines with some data types declared by raylib
92
+ // Other modules (raymath, rlgl) also require some of those types, so,
93
+ // to be able to use those other modules as standalone (not depending on raylib)
94
+ // this defines are very useful for internal check and avoid type (re)definitions
95
+ // Some Basic Colors
96
+ // NOTE: Custom raylib color palette for amazing visuals on WHITE background
97
+ //----------------------------------------------------------------------------------
98
+ // Structures Definition
99
+ //----------------------------------------------------------------------------------
100
+ // Boolean type
101
+ // Vector2, 2 components
102
+ typedef struct Vector2 {
103
+ float x; // Vector x component
104
+ float y; // Vector y component
105
+ } Vector2;
106
+ // Vector3, 3 components
107
+ typedef struct Vector3 {
108
+ float x; // Vector x component
109
+ float y; // Vector y component
110
+ float z; // Vector z component
111
+ } Vector3;
112
+ // Vector4, 4 components
113
+ typedef struct Vector4 {
114
+ float x; // Vector x component
115
+ float y; // Vector y component
116
+ float z; // Vector z component
117
+ float w; // Vector w component
118
+ } Vector4;
119
+ // Quaternion, 4 components (Vector4 alias)
120
+ typedef Vector4 Quaternion;
121
+ // Matrix, 4x4 components, column major, OpenGL style, right-handed
122
+ typedef struct Matrix {
123
+ float m0, m4, m8, m12; // Matrix first row (4 components)
124
+ float m1, m5, m9, m13; // Matrix second row (4 components)
125
+ float m2, m6, m10, m14; // Matrix third row (4 components)
126
+ float m3, m7, m11, m15; // Matrix fourth row (4 components)
127
+ } Matrix;
128
+ // Color, 4 components, R8G8B8A8 (32bit)
129
+ typedef struct Color {
130
+ unsigned char r; // Color red value
131
+ unsigned char g; // Color green value
132
+ unsigned char b; // Color blue value
133
+ unsigned char a; // Color alpha value
134
+ } Color;
135
+ // Rectangle, 4 components
136
+ typedef struct Rectangle {
137
+ float x; // Rectangle top-left corner position x
138
+ float y; // Rectangle top-left corner position y
139
+ float width; // Rectangle width
140
+ float height; // Rectangle height
141
+ } Rectangle;
142
+ // Image, pixel data stored in CPU memory (RAM)
143
+ typedef struct Image {
144
+ void *data; // Image raw data
145
+ int width; // Image base width
146
+ int height; // Image base height
147
+ int mipmaps; // Mipmap levels, 1 by default
148
+ int format; // Data format (PixelFormat type)
149
+ } Image;
150
+ // Texture, tex data stored in GPU memory (VRAM)
151
+ typedef struct Texture {
152
+ unsigned int id; // OpenGL texture id
153
+ int width; // Texture base width
154
+ int height; // Texture base height
155
+ int mipmaps; // Mipmap levels, 1 by default
156
+ int format; // Data format (PixelFormat type)
157
+ } Texture;
158
+ // Texture2D, same as Texture
159
+ typedef Texture Texture2D;
160
+ // TextureCubemap, same as Texture
161
+ typedef Texture TextureCubemap;
162
+ // RenderTexture, fbo for texture rendering
163
+ typedef struct RenderTexture {
164
+ unsigned int id; // OpenGL framebuffer object id
165
+ Texture texture; // Color buffer attachment texture
166
+ Texture depth; // Depth buffer attachment texture
167
+ } RenderTexture;
168
+ // RenderTexture2D, same as RenderTexture
169
+ typedef RenderTexture RenderTexture2D;
170
+ // NPatchInfo, n-patch layout info
171
+ typedef struct NPatchInfo {
172
+ Rectangle source; // Texture source rectangle
173
+ int left; // Left border offset
174
+ int top; // Top border offset
175
+ int right; // Right border offset
176
+ int bottom; // Bottom border offset
177
+ int layout; // Layout of the n-patch: 3x3, 1x3 or 3x1
178
+ } NPatchInfo;
179
+ // GlyphInfo, font characters glyphs info
180
+ typedef struct GlyphInfo {
181
+ int value; // Character value (Unicode)
182
+ int offsetX; // Character offset X when drawing
183
+ int offsetY; // Character offset Y when drawing
184
+ int advanceX; // Character advance position X
185
+ Image image; // Character image data
186
+ } GlyphInfo;
187
+ // Font, font texture and GlyphInfo array data
188
+ typedef struct Font {
189
+ int baseSize; // Base size (default chars height)
190
+ int glyphCount; // Number of glyph characters
191
+ int glyphPadding; // Padding around the glyph characters
192
+ Texture2D texture; // Texture atlas containing the glyphs
193
+ Rectangle *recs; // Rectangles in texture for the glyphs
194
+ GlyphInfo *glyphs; // Glyphs info data
195
+ } Font;
196
+ // Camera, defines position/orientation in 3d space
197
+ typedef struct Camera3D {
198
+ Vector3 position; // Camera position
199
+ Vector3 target; // Camera target it looks-at
200
+ Vector3 up; // Camera up vector (rotation over its axis)
201
+ float fovy; // Camera field-of-view aperture in Y (degrees) in perspective, used as near plane width in orthographic
202
+ int projection; // Camera projection: CAMERA_PERSPECTIVE or CAMERA_ORTHOGRAPHIC
203
+ } Camera3D;
204
+ typedef Camera3D Camera; // Camera type fallback, defaults to Camera3D
205
+ // Camera2D, defines position/orientation in 2d space
206
+ typedef struct Camera2D {
207
+ Vector2 offset; // Camera offset (displacement from target)
208
+ Vector2 target; // Camera target (rotation and zoom origin)
209
+ float rotation; // Camera rotation in degrees
210
+ float zoom; // Camera zoom (scaling), should be 1.0f by default
211
+ } Camera2D;
212
+ // Mesh, vertex data and vao/vbo
213
+ typedef struct Mesh {
214
+ int vertexCount; // Number of vertices stored in arrays
215
+ int triangleCount; // Number of triangles stored (indexed or not)
216
+ // Vertex attributes data
217
+ float *vertices; // Vertex position (XYZ - 3 components per vertex) (shader-location = 0)
218
+ float *texcoords; // Vertex texture coordinates (UV - 2 components per vertex) (shader-location = 1)
219
+ float *texcoords2; // Vertex texture second coordinates (UV - 2 components per vertex) (shader-location = 5)
220
+ float *normals; // Vertex normals (XYZ - 3 components per vertex) (shader-location = 2)
221
+ float *tangents; // Vertex tangents (XYZW - 4 components per vertex) (shader-location = 4)
222
+ unsigned char *colors; // Vertex colors (RGBA - 4 components per vertex) (shader-location = 3)
223
+ unsigned short *indices; // Vertex indices (in case vertex data comes indexed)
224
+ // Animation vertex data
225
+ float *animVertices; // Animated vertex positions (after bones transformations)
226
+ float *animNormals; // Animated normals (after bones transformations)
227
+ unsigned char *boneIds; // Vertex bone ids, max 255 bone ids, up to 4 bones influence by vertex (skinning)
228
+ float *boneWeights; // Vertex bone weight, up to 4 bones influence by vertex (skinning)
229
+ // OpenGL identifiers
230
+ unsigned int vaoId; // OpenGL Vertex Array Object id
231
+ unsigned int *vboId; // OpenGL Vertex Buffer Objects id (default vertex data)
232
+ } Mesh;
233
+ // Shader
234
+ typedef struct Shader {
235
+ unsigned int id; // Shader program id
236
+ int *locs; // Shader locations array (RL_MAX_SHADER_LOCATIONS)
237
+ } Shader;
238
+ // MaterialMap
239
+ typedef struct MaterialMap {
240
+ Texture2D texture; // Material map texture
241
+ Color color; // Material map color
242
+ float value; // Material map value
243
+ } MaterialMap;
244
+ // Material, includes shader and maps
245
+ typedef struct Material {
246
+ Shader shader; // Material shader
247
+ MaterialMap *maps; // Material maps array (MAX_MATERIAL_MAPS)
248
+ float params[4]; // Material generic parameters (if required)
249
+ } Material;
250
+ // Transform, vertex transformation data
251
+ typedef struct Transform {
252
+ Vector3 translation; // Translation
253
+ Quaternion rotation; // Rotation
254
+ Vector3 scale; // Scale
255
+ } Transform;
256
+ // Bone, skeletal animation bone
257
+ typedef struct BoneInfo {
258
+ char name[32]; // Bone name
259
+ int parent; // Bone parent
260
+ } BoneInfo;
261
+ // Model, meshes, materials and animation data
262
+ typedef struct Model {
263
+ Matrix transform; // Local transform matrix
264
+ int meshCount; // Number of meshes
265
+ int materialCount; // Number of materials
266
+ Mesh *meshes; // Meshes array
267
+ Material *materials; // Materials array
268
+ int *meshMaterial; // Mesh material number
269
+ // Animation data
270
+ int boneCount; // Number of bones
271
+ BoneInfo *bones; // Bones information (skeleton)
272
+ Transform *bindPose; // Bones base transformation (pose)
273
+ } Model;
274
+ // ModelAnimation
275
+ typedef struct ModelAnimation {
276
+ int boneCount; // Number of bones
277
+ int frameCount; // Number of animation frames
278
+ BoneInfo *bones; // Bones information (skeleton)
279
+ Transform **framePoses; // Poses array by frame
280
+ char name[32]; // Animation name
281
+ } ModelAnimation;
282
+ // Ray, ray for raycasting
283
+ typedef struct Ray {
284
+ Vector3 position; // Ray position (origin)
285
+ Vector3 direction; // Ray direction
286
+ } Ray;
287
+ // RayCollision, ray hit information
288
+ typedef struct RayCollision {
289
+ bool hit; // Did the ray hit something?
290
+ float distance; // Distance to the nearest hit
291
+ Vector3 point; // Point of the nearest hit
292
+ Vector3 normal; // Surface normal of hit
293
+ } RayCollision;
294
+ // BoundingBox
295
+ typedef struct BoundingBox {
296
+ Vector3 min; // Minimum vertex box-corner
297
+ Vector3 max; // Maximum vertex box-corner
298
+ } BoundingBox;
299
+ // Wave, audio wave data
300
+ typedef struct Wave {
301
+ unsigned int frameCount; // Total number of frames (considering channels)
302
+ unsigned int sampleRate; // Frequency (samples per second)
303
+ unsigned int sampleSize; // Bit depth (bits per sample): 8, 16, 32 (24 not supported)
304
+ unsigned int channels; // Number of channels (1-mono, 2-stereo, ...)
305
+ void *data; // Buffer data pointer
306
+ } Wave;
307
+ // Opaque structs declaration
308
+ // NOTE: Actual structs are defined internally in raudio module
309
+ typedef struct rAudioBuffer rAudioBuffer;
310
+ typedef struct rAudioProcessor rAudioProcessor;
311
+ // AudioStream, custom audio stream
312
+ typedef struct AudioStream {
313
+ rAudioBuffer *buffer; // Pointer to internal data used by the audio system
314
+ rAudioProcessor *processor; // Pointer to internal data processor, useful for audio effects
315
+ unsigned int sampleRate; // Frequency (samples per second)
316
+ unsigned int sampleSize; // Bit depth (bits per sample): 8, 16, 32 (24 not supported)
317
+ unsigned int channels; // Number of channels (1-mono, 2-stereo, ...)
318
+ } AudioStream;
319
+ // Sound
320
+ typedef struct Sound {
321
+ AudioStream stream; // Audio stream
322
+ unsigned int frameCount; // Total number of frames (considering channels)
323
+ } Sound;
324
+ // Music, audio stream, anything longer than ~10 seconds should be streamed
325
+ typedef struct Music {
326
+ AudioStream stream; // Audio stream
327
+ unsigned int frameCount; // Total number of frames (considering channels)
328
+ bool looping; // Music looping enable
329
+ int ctxType; // Type of music context (audio filetype)
330
+ void *ctxData; // Audio context data, depends on type
331
+ } Music;
332
+ // VrDeviceInfo, Head-Mounted-Display device parameters
333
+ typedef struct VrDeviceInfo {
334
+ int hResolution; // Horizontal resolution in pixels
335
+ int vResolution; // Vertical resolution in pixels
336
+ float hScreenSize; // Horizontal size in meters
337
+ float vScreenSize; // Vertical size in meters
338
+ float vScreenCenter; // Screen center in meters
339
+ float eyeToScreenDistance; // Distance between eye and display in meters
340
+ float lensSeparationDistance; // Lens separation distance in meters
341
+ float interpupillaryDistance; // IPD (distance between pupils) in meters
342
+ float lensDistortionValues[4]; // Lens distortion constant parameters
343
+ float chromaAbCorrection[4]; // Chromatic aberration correction parameters
344
+ } VrDeviceInfo;
345
+ // VrStereoConfig, VR stereo rendering configuration for simulator
346
+ typedef struct VrStereoConfig {
347
+ Matrix projection[2]; // VR projection matrices (per eye)
348
+ Matrix viewOffset[2]; // VR view offset matrices (per eye)
349
+ float leftLensCenter[2]; // VR left lens center
350
+ float rightLensCenter[2]; // VR right lens center
351
+ float leftScreenCenter[2]; // VR left screen center
352
+ float rightScreenCenter[2]; // VR right screen center
353
+ float scale[2]; // VR distortion scale
354
+ float scaleIn[2]; // VR distortion scale in
355
+ } VrStereoConfig;
356
+ // File path list
357
+ typedef struct FilePathList {
358
+ unsigned int capacity; // Filepaths max entries
359
+ unsigned int count; // Filepaths entries count
360
+ char **paths; // Filepaths entries
361
+ } FilePathList;
362
+ // Automation event
363
+ typedef struct AutomationEvent {
364
+ unsigned int frame; // Event frame
365
+ unsigned int type; // Event type (AutomationEventType)
366
+ int params[4]; // Event parameters (if required)
367
+ } AutomationEvent;
368
+ // Automation event list
369
+ typedef struct AutomationEventList {
370
+ unsigned int capacity; // Events max entries (MAX_AUTOMATION_EVENTS)
371
+ unsigned int count; // Events entries count
372
+ AutomationEvent *events; // Events entries
373
+ } AutomationEventList;
374
+ //----------------------------------------------------------------------------------
375
+ // Enumerators Definition
376
+ //----------------------------------------------------------------------------------
377
+ // System/Window config flags
378
+ // NOTE: Every bit registers one state (use it with bit masks)
379
+ // By default all flags are set to 0
380
+ typedef enum {
381
+ FLAG_VSYNC_HINT = 0x00000040, // Set to try enabling V-Sync on GPU
382
+ FLAG_FULLSCREEN_MODE = 0x00000002, // Set to run program in fullscreen
383
+ FLAG_WINDOW_RESIZABLE = 0x00000004, // Set to allow resizable window
384
+ FLAG_WINDOW_UNDECORATED = 0x00000008, // Set to disable window decoration (frame and buttons)
385
+ FLAG_WINDOW_HIDDEN = 0x00000080, // Set to hide window
386
+ FLAG_WINDOW_MINIMIZED = 0x00000200, // Set to minimize window (iconify)
387
+ FLAG_WINDOW_MAXIMIZED = 0x00000400, // Set to maximize window (expanded to monitor)
388
+ FLAG_WINDOW_UNFOCUSED = 0x00000800, // Set to window non focused
389
+ FLAG_WINDOW_TOPMOST = 0x00001000, // Set to window always on top
390
+ FLAG_WINDOW_ALWAYS_RUN = 0x00000100, // Set to allow windows running while minimized
391
+ FLAG_WINDOW_TRANSPARENT = 0x00000010, // Set to allow transparent framebuffer
392
+ FLAG_WINDOW_HIGHDPI = 0x00002000, // Set to support HighDPI
393
+ FLAG_WINDOW_MOUSE_PASSTHROUGH = 0x00004000, // Set to support mouse passthrough, only supported when FLAG_WINDOW_UNDECORATED
394
+ FLAG_BORDERLESS_WINDOWED_MODE = 0x00008000, // Set to run program in borderless windowed mode
395
+ FLAG_MSAA_4X_HINT = 0x00000020, // Set to try enabling MSAA 4X
396
+ FLAG_INTERLACED_HINT = 0x00010000 // Set to try enabling interlaced video format (for V3D)
397
+ } ConfigFlags;
398
+ // Trace log level
399
+ // NOTE: Organized by priority level
400
+ typedef enum {
401
+ LOG_ALL = 0, // Display all logs
402
+ LOG_TRACE, // Trace logging, intended for internal use only
403
+ LOG_DEBUG, // Debug logging, used for internal debugging, it should be disabled on release builds
404
+ LOG_INFO, // Info logging, used for program execution info
405
+ LOG_WARNING, // Warning logging, used on recoverable failures
406
+ LOG_ERROR, // Error logging, used on unrecoverable failures
407
+ LOG_FATAL, // Fatal logging, used to abort program: exit(EXIT_FAILURE)
408
+ LOG_NONE // Disable logging
409
+ } TraceLogLevel;
410
+ // Keyboard keys (US keyboard layout)
411
+ // NOTE: Use GetKeyPressed() to allow redefining
412
+ // required keys for alternative layouts
413
+ typedef enum {
414
+ KEY_NULL = 0, // Key: NULL, used for no key pressed
415
+ // Alphanumeric keys
416
+ KEY_APOSTROPHE = 39, // Key: '
417
+ KEY_COMMA = 44, // Key: ,
418
+ KEY_MINUS = 45, // Key: -
419
+ KEY_PERIOD = 46, // Key: .
420
+ KEY_SLASH = 47, // Key: /
421
+ KEY_ZERO = 48, // Key: 0
422
+ KEY_ONE = 49, // Key: 1
423
+ KEY_TWO = 50, // Key: 2
424
+ KEY_THREE = 51, // Key: 3
425
+ KEY_FOUR = 52, // Key: 4
426
+ KEY_FIVE = 53, // Key: 5
427
+ KEY_SIX = 54, // Key: 6
428
+ KEY_SEVEN = 55, // Key: 7
429
+ KEY_EIGHT = 56, // Key: 8
430
+ KEY_NINE = 57, // Key: 9
431
+ KEY_SEMICOLON = 59, // Key: ;
432
+ KEY_EQUAL = 61, // Key: =
433
+ KEY_A = 65, // Key: A | a
434
+ KEY_B = 66, // Key: B | b
435
+ KEY_C = 67, // Key: C | c
436
+ KEY_D = 68, // Key: D | d
437
+ KEY_E = 69, // Key: E | e
438
+ KEY_F = 70, // Key: F | f
439
+ KEY_G = 71, // Key: G | g
440
+ KEY_H = 72, // Key: H | h
441
+ KEY_I = 73, // Key: I | i
442
+ KEY_J = 74, // Key: J | j
443
+ KEY_K = 75, // Key: K | k
444
+ KEY_L = 76, // Key: L | l
445
+ KEY_M = 77, // Key: M | m
446
+ KEY_N = 78, // Key: N | n
447
+ KEY_O = 79, // Key: O | o
448
+ KEY_P = 80, // Key: P | p
449
+ KEY_Q = 81, // Key: Q | q
450
+ KEY_R = 82, // Key: R | r
451
+ KEY_S = 83, // Key: S | s
452
+ KEY_T = 84, // Key: T | t
453
+ KEY_U = 85, // Key: U | u
454
+ KEY_V = 86, // Key: V | v
455
+ KEY_W = 87, // Key: W | w
456
+ KEY_X = 88, // Key: X | x
457
+ KEY_Y = 89, // Key: Y | y
458
+ KEY_Z = 90, // Key: Z | z
459
+ KEY_LEFT_BRACKET = 91, // Key: [
460
+ KEY_BACKSLASH = 92, // Key: '\'
461
+ KEY_RIGHT_BRACKET = 93, // Key: ]
462
+ KEY_GRAVE = 96, // Key: `
463
+ // Function keys
464
+ KEY_SPACE = 32, // Key: Space
465
+ KEY_ESCAPE = 256, // Key: Esc
466
+ KEY_ENTER = 257, // Key: Enter
467
+ KEY_TAB = 258, // Key: Tab
468
+ KEY_BACKSPACE = 259, // Key: Backspace
469
+ KEY_INSERT = 260, // Key: Ins
470
+ KEY_DELETE = 261, // Key: Del
471
+ KEY_RIGHT = 262, // Key: Cursor right
472
+ KEY_LEFT = 263, // Key: Cursor left
473
+ KEY_DOWN = 264, // Key: Cursor down
474
+ KEY_UP = 265, // Key: Cursor up
475
+ KEY_PAGE_UP = 266, // Key: Page up
476
+ KEY_PAGE_DOWN = 267, // Key: Page down
477
+ KEY_HOME = 268, // Key: Home
478
+ KEY_END = 269, // Key: End
479
+ KEY_CAPS_LOCK = 280, // Key: Caps lock
480
+ KEY_SCROLL_LOCK = 281, // Key: Scroll down
481
+ KEY_NUM_LOCK = 282, // Key: Num lock
482
+ KEY_PRINT_SCREEN = 283, // Key: Print screen
483
+ KEY_PAUSE = 284, // Key: Pause
484
+ KEY_F1 = 290, // Key: F1
485
+ KEY_F2 = 291, // Key: F2
486
+ KEY_F3 = 292, // Key: F3
487
+ KEY_F4 = 293, // Key: F4
488
+ KEY_F5 = 294, // Key: F5
489
+ KEY_F6 = 295, // Key: F6
490
+ KEY_F7 = 296, // Key: F7
491
+ KEY_F8 = 297, // Key: F8
492
+ KEY_F9 = 298, // Key: F9
493
+ KEY_F10 = 299, // Key: F10
494
+ KEY_F11 = 300, // Key: F11
495
+ KEY_F12 = 301, // Key: F12
496
+ KEY_LEFT_SHIFT = 340, // Key: Shift left
497
+ KEY_LEFT_CONTROL = 341, // Key: Control left
498
+ KEY_LEFT_ALT = 342, // Key: Alt left
499
+ KEY_LEFT_SUPER = 343, // Key: Super left
500
+ KEY_RIGHT_SHIFT = 344, // Key: Shift right
501
+ KEY_RIGHT_CONTROL = 345, // Key: Control right
502
+ KEY_RIGHT_ALT = 346, // Key: Alt right
503
+ KEY_RIGHT_SUPER = 347, // Key: Super right
504
+ KEY_KB_MENU = 348, // Key: KB menu
505
+ // Keypad keys
506
+ KEY_KP_0 = 320, // Key: Keypad 0
507
+ KEY_KP_1 = 321, // Key: Keypad 1
508
+ KEY_KP_2 = 322, // Key: Keypad 2
509
+ KEY_KP_3 = 323, // Key: Keypad 3
510
+ KEY_KP_4 = 324, // Key: Keypad 4
511
+ KEY_KP_5 = 325, // Key: Keypad 5
512
+ KEY_KP_6 = 326, // Key: Keypad 6
513
+ KEY_KP_7 = 327, // Key: Keypad 7
514
+ KEY_KP_8 = 328, // Key: Keypad 8
515
+ KEY_KP_9 = 329, // Key: Keypad 9
516
+ KEY_KP_DECIMAL = 330, // Key: Keypad .
517
+ KEY_KP_DIVIDE = 331, // Key: Keypad /
518
+ KEY_KP_MULTIPLY = 332, // Key: Keypad *
519
+ KEY_KP_SUBTRACT = 333, // Key: Keypad -
520
+ KEY_KP_ADD = 334, // Key: Keypad +
521
+ KEY_KP_ENTER = 335, // Key: Keypad Enter
522
+ KEY_KP_EQUAL = 336, // Key: Keypad =
523
+ // Android key buttons
524
+ KEY_BACK = 4, // Key: Android back button
525
+ KEY_MENU = 82, // Key: Android menu button
526
+ KEY_VOLUME_UP = 24, // Key: Android volume up button
527
+ KEY_VOLUME_DOWN = 25 // Key: Android volume down button
528
+ } KeyboardKey;
529
+ // Add backwards compatibility support for deprecated names
530
+ // Mouse buttons
531
+ typedef enum {
532
+ MOUSE_BUTTON_LEFT = 0, // Mouse button left
533
+ MOUSE_BUTTON_RIGHT = 1, // Mouse button right
534
+ MOUSE_BUTTON_MIDDLE = 2, // Mouse button middle (pressed wheel)
535
+ MOUSE_BUTTON_SIDE = 3, // Mouse button side (advanced mouse device)
536
+ MOUSE_BUTTON_EXTRA = 4, // Mouse button extra (advanced mouse device)
537
+ MOUSE_BUTTON_FORWARD = 5, // Mouse button forward (advanced mouse device)
538
+ MOUSE_BUTTON_BACK = 6, // Mouse button back (advanced mouse device)
539
+ } MouseButton;
540
+ // Mouse cursor
541
+ typedef enum {
542
+ MOUSE_CURSOR_DEFAULT = 0, // Default pointer shape
543
+ MOUSE_CURSOR_ARROW = 1, // Arrow shape
544
+ MOUSE_CURSOR_IBEAM = 2, // Text writing cursor shape
545
+ MOUSE_CURSOR_CROSSHAIR = 3, // Cross shape
546
+ MOUSE_CURSOR_POINTING_HAND = 4, // Pointing hand cursor
547
+ MOUSE_CURSOR_RESIZE_EW = 5, // Horizontal resize/move arrow shape
548
+ MOUSE_CURSOR_RESIZE_NS = 6, // Vertical resize/move arrow shape
549
+ MOUSE_CURSOR_RESIZE_NWSE = 7, // Top-left to bottom-right diagonal resize/move arrow shape
550
+ MOUSE_CURSOR_RESIZE_NESW = 8, // The top-right to bottom-left diagonal resize/move arrow shape
551
+ MOUSE_CURSOR_RESIZE_ALL = 9, // The omnidirectional resize/move cursor shape
552
+ MOUSE_CURSOR_NOT_ALLOWED = 10 // The operation-not-allowed shape
553
+ } MouseCursor;
554
+ // Gamepad buttons
555
+ typedef enum {
556
+ GAMEPAD_BUTTON_UNKNOWN = 0, // Unknown button, just for error checking
557
+ GAMEPAD_BUTTON_LEFT_FACE_UP, // Gamepad left DPAD up button
558
+ GAMEPAD_BUTTON_LEFT_FACE_RIGHT, // Gamepad left DPAD right button
559
+ GAMEPAD_BUTTON_LEFT_FACE_DOWN, // Gamepad left DPAD down button
560
+ GAMEPAD_BUTTON_LEFT_FACE_LEFT, // Gamepad left DPAD left button
561
+ GAMEPAD_BUTTON_RIGHT_FACE_UP, // Gamepad right button up (i.e. PS3: Triangle, Xbox: Y)
562
+ GAMEPAD_BUTTON_RIGHT_FACE_RIGHT, // Gamepad right button right (i.e. PS3: Square, Xbox: X)
563
+ GAMEPAD_BUTTON_RIGHT_FACE_DOWN, // Gamepad right button down (i.e. PS3: Cross, Xbox: A)
564
+ GAMEPAD_BUTTON_RIGHT_FACE_LEFT, // Gamepad right button left (i.e. PS3: Circle, Xbox: B)
565
+ GAMEPAD_BUTTON_LEFT_TRIGGER_1, // Gamepad top/back trigger left (first), it could be a trailing button
566
+ GAMEPAD_BUTTON_LEFT_TRIGGER_2, // Gamepad top/back trigger left (second), it could be a trailing button
567
+ GAMEPAD_BUTTON_RIGHT_TRIGGER_1, // Gamepad top/back trigger right (one), it could be a trailing button
568
+ GAMEPAD_BUTTON_RIGHT_TRIGGER_2, // Gamepad top/back trigger right (second), it could be a trailing button
569
+ GAMEPAD_BUTTON_MIDDLE_LEFT, // Gamepad center buttons, left one (i.e. PS3: Select)
570
+ GAMEPAD_BUTTON_MIDDLE, // Gamepad center buttons, middle one (i.e. PS3: PS, Xbox: XBOX)
571
+ GAMEPAD_BUTTON_MIDDLE_RIGHT, // Gamepad center buttons, right one (i.e. PS3: Start)
572
+ GAMEPAD_BUTTON_LEFT_THUMB, // Gamepad joystick pressed button left
573
+ GAMEPAD_BUTTON_RIGHT_THUMB // Gamepad joystick pressed button right
574
+ } GamepadButton;
575
+ // Gamepad axis
576
+ typedef enum {
577
+ GAMEPAD_AXIS_LEFT_X = 0, // Gamepad left stick X axis
578
+ GAMEPAD_AXIS_LEFT_Y = 1, // Gamepad left stick Y axis
579
+ GAMEPAD_AXIS_RIGHT_X = 2, // Gamepad right stick X axis
580
+ GAMEPAD_AXIS_RIGHT_Y = 3, // Gamepad right stick Y axis
581
+ GAMEPAD_AXIS_LEFT_TRIGGER = 4, // Gamepad back trigger left, pressure level: [1..-1]
582
+ GAMEPAD_AXIS_RIGHT_TRIGGER = 5 // Gamepad back trigger right, pressure level: [1..-1]
583
+ } GamepadAxis;
584
+ // Material map index
585
+ typedef enum {
586
+ MATERIAL_MAP_ALBEDO = 0, // Albedo material (same as: MATERIAL_MAP_DIFFUSE)
587
+ MATERIAL_MAP_METALNESS, // Metalness material (same as: MATERIAL_MAP_SPECULAR)
588
+ MATERIAL_MAP_NORMAL, // Normal material
589
+ MATERIAL_MAP_ROUGHNESS, // Roughness material
590
+ MATERIAL_MAP_OCCLUSION, // Ambient occlusion material
591
+ MATERIAL_MAP_EMISSION, // Emission material
592
+ MATERIAL_MAP_HEIGHT, // Heightmap material
593
+ MATERIAL_MAP_CUBEMAP, // Cubemap material (NOTE: Uses GL_TEXTURE_CUBE_MAP)
594
+ MATERIAL_MAP_IRRADIANCE, // Irradiance material (NOTE: Uses GL_TEXTURE_CUBE_MAP)
595
+ MATERIAL_MAP_PREFILTER, // Prefilter material (NOTE: Uses GL_TEXTURE_CUBE_MAP)
596
+ MATERIAL_MAP_BRDF // Brdf material
597
+ } MaterialMapIndex;
598
+ // Shader location index
599
+ typedef enum {
600
+ SHADER_LOC_VERTEX_POSITION = 0, // Shader location: vertex attribute: position
601
+ SHADER_LOC_VERTEX_TEXCOORD01, // Shader location: vertex attribute: texcoord01
602
+ SHADER_LOC_VERTEX_TEXCOORD02, // Shader location: vertex attribute: texcoord02
603
+ SHADER_LOC_VERTEX_NORMAL, // Shader location: vertex attribute: normal
604
+ SHADER_LOC_VERTEX_TANGENT, // Shader location: vertex attribute: tangent
605
+ SHADER_LOC_VERTEX_COLOR, // Shader location: vertex attribute: color
606
+ SHADER_LOC_MATRIX_MVP, // Shader location: matrix uniform: model-view-projection
607
+ SHADER_LOC_MATRIX_VIEW, // Shader location: matrix uniform: view (camera transform)
608
+ SHADER_LOC_MATRIX_PROJECTION, // Shader location: matrix uniform: projection
609
+ SHADER_LOC_MATRIX_MODEL, // Shader location: matrix uniform: model (transform)
610
+ SHADER_LOC_MATRIX_NORMAL, // Shader location: matrix uniform: normal
611
+ SHADER_LOC_VECTOR_VIEW, // Shader location: vector uniform: view
612
+ SHADER_LOC_COLOR_DIFFUSE, // Shader location: vector uniform: diffuse color
613
+ SHADER_LOC_COLOR_SPECULAR, // Shader location: vector uniform: specular color
614
+ SHADER_LOC_COLOR_AMBIENT, // Shader location: vector uniform: ambient color
615
+ SHADER_LOC_MAP_ALBEDO, // Shader location: sampler2d texture: albedo (same as: SHADER_LOC_MAP_DIFFUSE)
616
+ SHADER_LOC_MAP_METALNESS, // Shader location: sampler2d texture: metalness (same as: SHADER_LOC_MAP_SPECULAR)
617
+ SHADER_LOC_MAP_NORMAL, // Shader location: sampler2d texture: normal
618
+ SHADER_LOC_MAP_ROUGHNESS, // Shader location: sampler2d texture: roughness
619
+ SHADER_LOC_MAP_OCCLUSION, // Shader location: sampler2d texture: occlusion
620
+ SHADER_LOC_MAP_EMISSION, // Shader location: sampler2d texture: emission
621
+ SHADER_LOC_MAP_HEIGHT, // Shader location: sampler2d texture: height
622
+ SHADER_LOC_MAP_CUBEMAP, // Shader location: samplerCube texture: cubemap
623
+ SHADER_LOC_MAP_IRRADIANCE, // Shader location: samplerCube texture: irradiance
624
+ SHADER_LOC_MAP_PREFILTER, // Shader location: samplerCube texture: prefilter
625
+ SHADER_LOC_MAP_BRDF // Shader location: sampler2d texture: brdf
626
+ } ShaderLocationIndex;
627
+ // Shader uniform data type
628
+ typedef enum {
629
+ SHADER_UNIFORM_FLOAT = 0, // Shader uniform type: float
630
+ SHADER_UNIFORM_VEC2, // Shader uniform type: vec2 (2 float)
631
+ SHADER_UNIFORM_VEC3, // Shader uniform type: vec3 (3 float)
632
+ SHADER_UNIFORM_VEC4, // Shader uniform type: vec4 (4 float)
633
+ SHADER_UNIFORM_INT, // Shader uniform type: int
634
+ SHADER_UNIFORM_IVEC2, // Shader uniform type: ivec2 (2 int)
635
+ SHADER_UNIFORM_IVEC3, // Shader uniform type: ivec3 (3 int)
636
+ SHADER_UNIFORM_IVEC4, // Shader uniform type: ivec4 (4 int)
637
+ SHADER_UNIFORM_SAMPLER2D // Shader uniform type: sampler2d
638
+ } ShaderUniformDataType;
639
+ // Shader attribute data types
640
+ typedef enum {
641
+ SHADER_ATTRIB_FLOAT = 0, // Shader attribute type: float
642
+ SHADER_ATTRIB_VEC2, // Shader attribute type: vec2 (2 float)
643
+ SHADER_ATTRIB_VEC3, // Shader attribute type: vec3 (3 float)
644
+ SHADER_ATTRIB_VEC4 // Shader attribute type: vec4 (4 float)
645
+ } ShaderAttributeDataType;
646
+ // Pixel formats
647
+ // NOTE: Support depends on OpenGL version and platform
648
+ typedef enum {
649
+ PIXELFORMAT_UNCOMPRESSED_GRAYSCALE = 1, // 8 bit per pixel (no alpha)
650
+ PIXELFORMAT_UNCOMPRESSED_GRAY_ALPHA, // 8*2 bpp (2 channels)
651
+ PIXELFORMAT_UNCOMPRESSED_R5G6B5, // 16 bpp
652
+ PIXELFORMAT_UNCOMPRESSED_R8G8B8, // 24 bpp
653
+ PIXELFORMAT_UNCOMPRESSED_R5G5B5A1, // 16 bpp (1 bit alpha)
654
+ PIXELFORMAT_UNCOMPRESSED_R4G4B4A4, // 16 bpp (4 bit alpha)
655
+ PIXELFORMAT_UNCOMPRESSED_R8G8B8A8, // 32 bpp
656
+ PIXELFORMAT_UNCOMPRESSED_R32, // 32 bpp (1 channel - float)
657
+ PIXELFORMAT_UNCOMPRESSED_R32G32B32, // 32*3 bpp (3 channels - float)
658
+ PIXELFORMAT_UNCOMPRESSED_R32G32B32A32, // 32*4 bpp (4 channels - float)
659
+ PIXELFORMAT_UNCOMPRESSED_R16, // 16 bpp (1 channel - half float)
660
+ PIXELFORMAT_UNCOMPRESSED_R16G16B16, // 16*3 bpp (3 channels - half float)
661
+ PIXELFORMAT_UNCOMPRESSED_R16G16B16A16, // 16*4 bpp (4 channels - half float)
662
+ PIXELFORMAT_COMPRESSED_DXT1_RGB, // 4 bpp (no alpha)
663
+ PIXELFORMAT_COMPRESSED_DXT1_RGBA, // 4 bpp (1 bit alpha)
664
+ PIXELFORMAT_COMPRESSED_DXT3_RGBA, // 8 bpp
665
+ PIXELFORMAT_COMPRESSED_DXT5_RGBA, // 8 bpp
666
+ PIXELFORMAT_COMPRESSED_ETC1_RGB, // 4 bpp
667
+ PIXELFORMAT_COMPRESSED_ETC2_RGB, // 4 bpp
668
+ PIXELFORMAT_COMPRESSED_ETC2_EAC_RGBA, // 8 bpp
669
+ PIXELFORMAT_COMPRESSED_PVRT_RGB, // 4 bpp
670
+ PIXELFORMAT_COMPRESSED_PVRT_RGBA, // 4 bpp
671
+ PIXELFORMAT_COMPRESSED_ASTC_4x4_RGBA, // 8 bpp
672
+ PIXELFORMAT_COMPRESSED_ASTC_8x8_RGBA // 2 bpp
673
+ } PixelFormat;
674
+ // Texture parameters: filter mode
675
+ // NOTE 1: Filtering considers mipmaps if available in the texture
676
+ // NOTE 2: Filter is accordingly set for minification and magnification
677
+ typedef enum {
678
+ TEXTURE_FILTER_POINT = 0, // No filter, just pixel approximation
679
+ TEXTURE_FILTER_BILINEAR, // Linear filtering
680
+ TEXTURE_FILTER_TRILINEAR, // Trilinear filtering (linear with mipmaps)
681
+ TEXTURE_FILTER_ANISOTROPIC_4X, // Anisotropic filtering 4x
682
+ TEXTURE_FILTER_ANISOTROPIC_8X, // Anisotropic filtering 8x
683
+ TEXTURE_FILTER_ANISOTROPIC_16X, // Anisotropic filtering 16x
684
+ } TextureFilter;
685
+ // Texture parameters: wrap mode
686
+ typedef enum {
687
+ TEXTURE_WRAP_REPEAT = 0, // Repeats texture in tiled mode
688
+ TEXTURE_WRAP_CLAMP, // Clamps texture to edge pixel in tiled mode
689
+ TEXTURE_WRAP_MIRROR_REPEAT, // Mirrors and repeats the texture in tiled mode
690
+ TEXTURE_WRAP_MIRROR_CLAMP // Mirrors and clamps to border the texture in tiled mode
691
+ } TextureWrap;
692
+ // Cubemap layouts
693
+ typedef enum {
694
+ CUBEMAP_LAYOUT_AUTO_DETECT = 0, // Automatically detect layout type
695
+ CUBEMAP_LAYOUT_LINE_VERTICAL, // Layout is defined by a vertical line with faces
696
+ CUBEMAP_LAYOUT_LINE_HORIZONTAL, // Layout is defined by a horizontal line with faces
697
+ CUBEMAP_LAYOUT_CROSS_THREE_BY_FOUR, // Layout is defined by a 3x4 cross with cubemap faces
698
+ CUBEMAP_LAYOUT_CROSS_FOUR_BY_THREE, // Layout is defined by a 4x3 cross with cubemap faces
699
+ CUBEMAP_LAYOUT_PANORAMA // Layout is defined by a panorama image (equirrectangular map)
700
+ } CubemapLayout;
701
+ // Font type, defines generation method
702
+ typedef enum {
703
+ FONT_DEFAULT = 0, // Default font generation, anti-aliased
704
+ FONT_BITMAP, // Bitmap font generation, no anti-aliasing
705
+ FONT_SDF // SDF font generation, requires external shader
706
+ } FontType;
707
+ // Color blending modes (pre-defined)
708
+ typedef enum {
709
+ BLEND_ALPHA = 0, // Blend textures considering alpha (default)
710
+ BLEND_ADDITIVE, // Blend textures adding colors
711
+ BLEND_MULTIPLIED, // Blend textures multiplying colors
712
+ BLEND_ADD_COLORS, // Blend textures adding colors (alternative)
713
+ BLEND_SUBTRACT_COLORS, // Blend textures subtracting colors (alternative)
714
+ BLEND_ALPHA_PREMULTIPLY, // Blend premultiplied textures considering alpha
715
+ BLEND_CUSTOM, // Blend textures using custom src/dst factors (use rlSetBlendFactors())
716
+ BLEND_CUSTOM_SEPARATE // Blend textures using custom rgb/alpha separate src/dst factors (use rlSetBlendFactorsSeparate())
717
+ } BlendMode;
718
+ // Gesture
719
+ // NOTE: Provided as bit-wise flags to enable only desired gestures
720
+ typedef enum {
721
+ GESTURE_NONE = 0, // No gesture
722
+ GESTURE_TAP = 1, // Tap gesture
723
+ GESTURE_DOUBLETAP = 2, // Double tap gesture
724
+ GESTURE_HOLD = 4, // Hold gesture
725
+ GESTURE_DRAG = 8, // Drag gesture
726
+ GESTURE_SWIPE_RIGHT = 16, // Swipe right gesture
727
+ GESTURE_SWIPE_LEFT = 32, // Swipe left gesture
728
+ GESTURE_SWIPE_UP = 64, // Swipe up gesture
729
+ GESTURE_SWIPE_DOWN = 128, // Swipe down gesture
730
+ GESTURE_PINCH_IN = 256, // Pinch in gesture
731
+ GESTURE_PINCH_OUT = 512 // Pinch out gesture
732
+ } Gesture;
733
+ // Camera system modes
734
+ typedef enum {
735
+ CAMERA_CUSTOM = 0, // Custom camera
736
+ CAMERA_FREE, // Free camera
737
+ CAMERA_ORBITAL, // Orbital camera
738
+ CAMERA_FIRST_PERSON, // First person camera
739
+ CAMERA_THIRD_PERSON // Third person camera
740
+ } CameraMode;
741
+ // Camera projection
742
+ typedef enum {
743
+ CAMERA_PERSPECTIVE = 0, // Perspective projection
744
+ CAMERA_ORTHOGRAPHIC // Orthographic projection
745
+ } CameraProjection;
746
+ // N-patch layout
747
+ typedef enum {
748
+ NPATCH_NINE_PATCH = 0, // Npatch layout: 3x3 tiles
749
+ NPATCH_THREE_PATCH_VERTICAL, // Npatch layout: 1x3 tiles
750
+ NPATCH_THREE_PATCH_HORIZONTAL // Npatch layout: 3x1 tiles
751
+ } NPatchLayout;
752
+ // Callbacks to hook some internal functions
753
+ // WARNING: These callbacks are intended for advance users
754
+ typedef void (*TraceLogCallback)(int logLevel, const char *text, void * args); // Logging: Redirect trace log messages
755
+ typedef unsigned char *(*LoadFileDataCallback)(const char *fileName, int *dataSize); // FileIO: Load binary data
756
+ typedef bool (*SaveFileDataCallback)(const char *fileName, void *data, int dataSize); // FileIO: Save binary data
757
+ typedef char *(*LoadFileTextCallback)(const char *fileName); // FileIO: Load text data
758
+ typedef bool (*SaveFileTextCallback)(const char *fileName, char *text); // FileIO: Save text data
759
+ //------------------------------------------------------------------------------------
760
+ // Global Variables Definition
761
+ //------------------------------------------------------------------------------------
762
+ // It's lonely here...
763
+ //------------------------------------------------------------------------------------
764
+ // Window and Graphics Device Functions (Module: core)
765
+ //------------------------------------------------------------------------------------
766
+ // Window-related functions
767
+ void InitWindow(int width, int height, const char *title); // Initialize window and OpenGL context
768
+ void CloseWindow(void); // Close window and unload OpenGL context
769
+ bool WindowShouldClose(void); // Check if application should close (KEY_ESCAPE pressed or windows close icon clicked)
770
+ bool IsWindowReady(void); // Check if window has been initialized successfully
771
+ bool IsWindowFullscreen(void); // Check if window is currently fullscreen
772
+ bool IsWindowHidden(void); // Check if window is currently hidden (only PLATFORM_DESKTOP)
773
+ bool IsWindowMinimized(void); // Check if window is currently minimized (only PLATFORM_DESKTOP)
774
+ bool IsWindowMaximized(void); // Check if window is currently maximized (only PLATFORM_DESKTOP)
775
+ bool IsWindowFocused(void); // Check if window is currently focused (only PLATFORM_DESKTOP)
776
+ bool IsWindowResized(void); // Check if window has been resized last frame
777
+ bool IsWindowState(unsigned int flag); // Check if one specific window flag is enabled
778
+ void SetWindowState(unsigned int flags); // Set window configuration state using flags (only PLATFORM_DESKTOP)
779
+ void ClearWindowState(unsigned int flags); // Clear window configuration state flags
780
+ void ToggleFullscreen(void); // Toggle window state: fullscreen/windowed (only PLATFORM_DESKTOP)
781
+ void ToggleBorderlessWindowed(void); // Toggle window state: borderless windowed (only PLATFORM_DESKTOP)
782
+ void MaximizeWindow(void); // Set window state: maximized, if resizable (only PLATFORM_DESKTOP)
783
+ void MinimizeWindow(void); // Set window state: minimized, if resizable (only PLATFORM_DESKTOP)
784
+ void RestoreWindow(void); // Set window state: not minimized/maximized (only PLATFORM_DESKTOP)
785
+ void SetWindowIcon(Image image); // Set icon for window (single image, RGBA 32bit, only PLATFORM_DESKTOP)
786
+ void SetWindowIcons(Image *images, int count); // Set icon for window (multiple images, RGBA 32bit, only PLATFORM_DESKTOP)
787
+ void SetWindowTitle(const char *title); // Set title for window (only PLATFORM_DESKTOP and PLATFORM_WEB)
788
+ void SetWindowPosition(int x, int y); // Set window position on screen (only PLATFORM_DESKTOP)
789
+ void SetWindowMonitor(int monitor); // Set monitor for the current window
790
+ void SetWindowMinSize(int width, int height); // Set window minimum dimensions (for FLAG_WINDOW_RESIZABLE)
791
+ void SetWindowMaxSize(int width, int height); // Set window maximum dimensions (for FLAG_WINDOW_RESIZABLE)
792
+ void SetWindowSize(int width, int height); // Set window dimensions
793
+ void SetWindowOpacity(float opacity); // Set window opacity [0.0f..1.0f] (only PLATFORM_DESKTOP)
794
+ void SetWindowFocused(void); // Set window focused (only PLATFORM_DESKTOP)
795
+ void *GetWindowHandle(void); // Get native window handle
796
+ int GetScreenWidth(void); // Get current screen width
797
+ int GetScreenHeight(void); // Get current screen height
798
+ int GetRenderWidth(void); // Get current render width (it considers HiDPI)
799
+ int GetRenderHeight(void); // Get current render height (it considers HiDPI)
800
+ int GetMonitorCount(void); // Get number of connected monitors
801
+ int GetCurrentMonitor(void); // Get current connected monitor
802
+ Vector2 GetMonitorPosition(int monitor); // Get specified monitor position
803
+ int GetMonitorWidth(int monitor); // Get specified monitor width (current video mode used by monitor)
804
+ int GetMonitorHeight(int monitor); // Get specified monitor height (current video mode used by monitor)
805
+ int GetMonitorPhysicalWidth(int monitor); // Get specified monitor physical width in millimetres
806
+ int GetMonitorPhysicalHeight(int monitor); // Get specified monitor physical height in millimetres
807
+ int GetMonitorRefreshRate(int monitor); // Get specified monitor refresh rate
808
+ Vector2 GetWindowPosition(void); // Get window position XY on monitor
809
+ Vector2 GetWindowScaleDPI(void); // Get window scale DPI factor
810
+ const char *GetMonitorName(int monitor); // Get the human-readable, UTF-8 encoded name of the specified monitor
811
+ void SetClipboardText(const char *text); // Set clipboard text content
812
+ const char *GetClipboardText(void); // Get clipboard text content
813
+ void EnableEventWaiting(void); // Enable waiting for events on EndDrawing(), no automatic event polling
814
+ void DisableEventWaiting(void); // Disable waiting for events on EndDrawing(), automatic events polling
815
+ // Cursor-related functions
816
+ void ShowCursor(void); // Shows cursor
817
+ void HideCursor(void); // Hides cursor
818
+ bool IsCursorHidden(void); // Check if cursor is not visible
819
+ void EnableCursor(void); // Enables cursor (unlock cursor)
820
+ void DisableCursor(void); // Disables cursor (lock cursor)
821
+ bool IsCursorOnScreen(void); // Check if cursor is on the screen
822
+ // Drawing-related functions
823
+ void ClearBackground(Color color); // Set background color (framebuffer clear color)
824
+ void BeginDrawing(void); // Setup canvas (framebuffer) to start drawing
825
+ void EndDrawing(void); // End canvas drawing and swap buffers (double buffering)
826
+ void BeginMode2D(Camera2D camera); // Begin 2D mode with custom camera (2D)
827
+ void EndMode2D(void); // Ends 2D mode with custom camera
828
+ void BeginMode3D(Camera3D camera); // Begin 3D mode with custom camera (3D)
829
+ void EndMode3D(void); // Ends 3D mode and returns to default 2D orthographic mode
830
+ void BeginTextureMode(RenderTexture2D target); // Begin drawing to render texture
831
+ void EndTextureMode(void); // Ends drawing to render texture
832
+ void BeginShaderMode(Shader shader); // Begin custom shader drawing
833
+ void EndShaderMode(void); // End custom shader drawing (use default shader)
834
+ void BeginBlendMode(int mode); // Begin blending mode (alpha, additive, multiplied, subtract, custom)
835
+ void EndBlendMode(void); // End blending mode (reset to default: alpha blending)
836
+ void BeginScissorMode(int x, int y, int width, int height); // Begin scissor mode (define screen area for following drawing)
837
+ void EndScissorMode(void); // End scissor mode
838
+ void BeginVrStereoMode(VrStereoConfig config); // Begin stereo rendering (requires VR simulator)
839
+ void EndVrStereoMode(void); // End stereo rendering (requires VR simulator)
840
+ // VR stereo config functions for VR simulator
841
+ VrStereoConfig LoadVrStereoConfig(VrDeviceInfo device); // Load VR stereo config for VR simulator device parameters
842
+ void UnloadVrStereoConfig(VrStereoConfig config); // Unload VR stereo config
843
+ // Shader management functions
844
+ // NOTE: Shader functionality is not available on OpenGL 1.1
845
+ Shader LoadShader(const char *vsFileName, const char *fsFileName); // Load shader from files and bind default locations
846
+ Shader LoadShaderFromMemory(const char *vsCode, const char *fsCode); // Load shader from code strings and bind default locations
847
+ bool IsShaderReady(Shader shader); // Check if a shader is ready
848
+ int GetShaderLocation(Shader shader, const char *uniformName); // Get shader uniform location
849
+ int GetShaderLocationAttrib(Shader shader, const char *attribName); // Get shader attribute location
850
+ void SetShaderValue(Shader shader, int locIndex, const void *value, int uniformType); // Set shader uniform value
851
+ void SetShaderValueV(Shader shader, int locIndex, const void *value, int uniformType, int count); // Set shader uniform value vector
852
+ void SetShaderValueMatrix(Shader shader, int locIndex, Matrix mat); // Set shader uniform value (matrix 4x4)
853
+ void SetShaderValueTexture(Shader shader, int locIndex, Texture2D texture); // Set shader uniform value for texture (sampler2d)
854
+ void UnloadShader(Shader shader); // Unload shader from GPU memory (VRAM)
855
+ // Screen-space-related functions
856
+ Ray GetMouseRay(Vector2 mousePosition, Camera camera); // Get a ray trace from mouse position
857
+ Matrix GetCameraMatrix(Camera camera); // Get camera transform matrix (view matrix)
858
+ Matrix GetCameraMatrix2D(Camera2D camera); // Get camera 2d transform matrix
859
+ Vector2 GetWorldToScreen(Vector3 position, Camera camera); // Get the screen space position for a 3d world space position
860
+ Vector2 GetScreenToWorld2D(Vector2 position, Camera2D camera); // Get the world space position for a 2d camera screen space position
861
+ Vector2 GetWorldToScreenEx(Vector3 position, Camera camera, int width, int height); // Get size position for a 3d world space position
862
+ Vector2 GetWorldToScreen2D(Vector2 position, Camera2D camera); // Get the screen space position for a 2d camera world space position
863
+ // Timing-related functions
864
+ void SetTargetFPS(int fps); // Set target FPS (maximum)
865
+ float GetFrameTime(void); // Get time in seconds for last frame drawn (delta time)
866
+ double GetTime(void); // Get elapsed time in seconds since InitWindow()
867
+ int GetFPS(void); // Get current FPS
868
+ // Custom frame control functions
869
+ // NOTE: Those functions are intended for advance users that want full control over the frame processing
870
+ // By default EndDrawing() does this job: draws everything + SwapScreenBuffer() + manage frame timing + PollInputEvents()
871
+ // To avoid that behaviour and control frame processes manually, enable in config.h: SUPPORT_CUSTOM_FRAME_CONTROL
872
+ void SwapScreenBuffer(void); // Swap back buffer with front buffer (screen drawing)
873
+ void PollInputEvents(void); // Register all input events
874
+ void WaitTime(double seconds); // Wait for some time (halt program execution)
875
+ // Random values generation functions
876
+ void SetRandomSeed(unsigned int seed); // Set the seed for the random number generator
877
+ int GetRandomValue(int min, int max); // Get a random value between min and max (both included)
878
+ int *LoadRandomSequence(unsigned int count, int min, int max); // Load random values sequence, no values repeated
879
+ void UnloadRandomSequence(int *sequence); // Unload random values sequence
880
+ // Misc. functions
881
+ void TakeScreenshot(const char *fileName); // Takes a screenshot of current screen (filename extension defines format)
882
+ void SetConfigFlags(unsigned int flags); // Setup init configuration flags (view FLAGS)
883
+ void OpenURL(const char *url); // Open URL with default system browser (if available)
884
+ // NOTE: Following functions implemented in module [utils]
885
+ //------------------------------------------------------------------
886
+ void TraceLog(int logLevel, const char *text, ...); // Show trace log messages (LOG_DEBUG, LOG_INFO, LOG_WARNING, LOG_ERROR...)
887
+ void SetTraceLogLevel(int logLevel); // Set the current threshold (minimum) log level
888
+ void *MemAlloc(unsigned int size); // Internal memory allocator
889
+ void *MemRealloc(void *ptr, unsigned int size); // Internal memory reallocator
890
+ void MemFree(void *ptr); // Internal memory free
891
+ // Set custom callbacks
892
+ // WARNING: Callbacks setup is intended for advance users
893
+ void SetTraceLogCallback(TraceLogCallback callback); // Set custom trace log
894
+ void SetLoadFileDataCallback(LoadFileDataCallback callback); // Set custom file binary data loader
895
+ void SetSaveFileDataCallback(SaveFileDataCallback callback); // Set custom file binary data saver
896
+ void SetLoadFileTextCallback(LoadFileTextCallback callback); // Set custom file text data loader
897
+ void SetSaveFileTextCallback(SaveFileTextCallback callback); // Set custom file text data saver
898
+ // Files management functions
899
+ unsigned char *LoadFileData(const char *fileName, int *dataSize); // Load file data as byte array (read)
900
+ void UnloadFileData(unsigned char *data); // Unload file data allocated by LoadFileData()
901
+ bool SaveFileData(const char *fileName, void *data, int dataSize); // Save data to file from byte array (write), returns true on success
902
+ bool ExportDataAsCode(const unsigned char *data, int dataSize, const char *fileName); // Export data to code (.h), returns true on success
903
+ char *LoadFileText(const char *fileName); // Load text data from file (read), returns a '\0' terminated string
904
+ void UnloadFileText(char *text); // Unload file text data allocated by LoadFileText()
905
+ bool SaveFileText(const char *fileName, char *text); // Save text data to file (write), string must be '\0' terminated, returns true on success
906
+ //------------------------------------------------------------------
907
+ // File system functions
908
+ bool FileExists(const char *fileName); // Check if file exists
909
+ bool DirectoryExists(const char *dirPath); // Check if a directory path exists
910
+ bool IsFileExtension(const char *fileName, const char *ext); // Check file extension (including point: .png, .wav)
911
+ int GetFileLength(const char *fileName); // Get file length in bytes (NOTE: GetFileSize() conflicts with windows.h)
912
+ const char *GetFileExtension(const char *fileName); // Get pointer to extension for a filename string (includes dot: '.png')
913
+ const char *GetFileName(const char *filePath); // Get pointer to filename for a path string
914
+ const char *GetFileNameWithoutExt(const char *filePath); // Get filename string without extension (uses static string)
915
+ const char *GetDirectoryPath(const char *filePath); // Get full path for a given fileName with path (uses static string)
916
+ const char *GetPrevDirectoryPath(const char *dirPath); // Get previous directory path for a given path (uses static string)
917
+ const char *GetWorkingDirectory(void); // Get current working directory (uses static string)
918
+ const char *GetApplicationDirectory(void); // Get the directory of the running application (uses static string)
919
+ bool ChangeDirectory(const char *dir); // Change working directory, return true on success
920
+ bool IsPathFile(const char *path); // Check if a given path is a file or a directory
921
+ FilePathList LoadDirectoryFiles(const char *dirPath); // Load directory filepaths
922
+ FilePathList LoadDirectoryFilesEx(const char *basePath, const char *filter, bool scanSubdirs); // Load directory filepaths with extension filtering and recursive directory scan
923
+ void UnloadDirectoryFiles(FilePathList files); // Unload filepaths
924
+ bool IsFileDropped(void); // Check if a file has been dropped into window
925
+ FilePathList LoadDroppedFiles(void); // Load dropped filepaths
926
+ void UnloadDroppedFiles(FilePathList files); // Unload dropped filepaths
927
+ long GetFileModTime(const char *fileName); // Get file modification time (last write time)
928
+ // Compression/Encoding functionality
929
+ unsigned char *CompressData(const unsigned char *data, int dataSize, int *compDataSize); // Compress data (DEFLATE algorithm), memory must be MemFree()
930
+ unsigned char *DecompressData(const unsigned char *compData, int compDataSize, int *dataSize); // Decompress data (DEFLATE algorithm), memory must be MemFree()
931
+ char *EncodeDataBase64(const unsigned char *data, int dataSize, int *outputSize); // Encode data to Base64 string, memory must be MemFree()
932
+ unsigned char *DecodeDataBase64(const unsigned char *data, int *outputSize); // Decode Base64 string data, memory must be MemFree()
933
+ // Automation events functionality
934
+ AutomationEventList LoadAutomationEventList(const char *fileName); // Load automation events list from file, NULL for empty list, capacity = MAX_AUTOMATION_EVENTS
935
+ void UnloadAutomationEventList(AutomationEventList *list); // Unload automation events list from file
936
+ bool ExportAutomationEventList(AutomationEventList list, const char *fileName); // Export automation events list as text file
937
+ void SetAutomationEventList(AutomationEventList *list); // Set automation event list to record to
938
+ void SetAutomationEventBaseFrame(int frame); // Set automation event internal base frame to start recording
939
+ void StartAutomationEventRecording(void); // Start recording automation events (AutomationEventList must be set)
940
+ void StopAutomationEventRecording(void); // Stop recording automation events
941
+ void PlayAutomationEvent(AutomationEvent event); // Play a recorded automation event
942
+ //------------------------------------------------------------------------------------
943
+ // Input Handling Functions (Module: core)
944
+ //------------------------------------------------------------------------------------
945
+ // Input-related functions: keyboard
946
+ bool IsKeyPressed(int key); // Check if a key has been pressed once
947
+ bool IsKeyPressedRepeat(int key); // Check if a key has been pressed again (Only PLATFORM_DESKTOP)
948
+ bool IsKeyDown(int key); // Check if a key is being pressed
949
+ bool IsKeyReleased(int key); // Check if a key has been released once
950
+ bool IsKeyUp(int key); // Check if a key is NOT being pressed
951
+ int GetKeyPressed(void); // Get key pressed (keycode), call it multiple times for keys queued, returns 0 when the queue is empty
952
+ int GetCharPressed(void); // Get char pressed (unicode), call it multiple times for chars queued, returns 0 when the queue is empty
953
+ void SetExitKey(int key); // Set a custom key to exit program (default is ESC)
954
+ // Input-related functions: gamepads
955
+ bool IsGamepadAvailable(int gamepad); // Check if a gamepad is available
956
+ const char *GetGamepadName(int gamepad); // Get gamepad internal name id
957
+ bool IsGamepadButtonPressed(int gamepad, int button); // Check if a gamepad button has been pressed once
958
+ bool IsGamepadButtonDown(int gamepad, int button); // Check if a gamepad button is being pressed
959
+ bool IsGamepadButtonReleased(int gamepad, int button); // Check if a gamepad button has been released once
960
+ bool IsGamepadButtonUp(int gamepad, int button); // Check if a gamepad button is NOT being pressed
961
+ int GetGamepadButtonPressed(void); // Get the last gamepad button pressed
962
+ int GetGamepadAxisCount(int gamepad); // Get gamepad axis count for a gamepad
963
+ float GetGamepadAxisMovement(int gamepad, int axis); // Get axis movement value for a gamepad axis
964
+ int SetGamepadMappings(const char *mappings); // Set internal gamepad mappings (SDL_GameControllerDB)
965
+ // Input-related functions: mouse
966
+ bool IsMouseButtonPressed(int button); // Check if a mouse button has been pressed once
967
+ bool IsMouseButtonDown(int button); // Check if a mouse button is being pressed
968
+ bool IsMouseButtonReleased(int button); // Check if a mouse button has been released once
969
+ bool IsMouseButtonUp(int button); // Check if a mouse button is NOT being pressed
970
+ int GetMouseX(void); // Get mouse position X
971
+ int GetMouseY(void); // Get mouse position Y
972
+ Vector2 GetMousePosition(void); // Get mouse position XY
973
+ Vector2 GetMouseDelta(void); // Get mouse delta between frames
974
+ void SetMousePosition(int x, int y); // Set mouse position XY
975
+ void SetMouseOffset(int offsetX, int offsetY); // Set mouse offset
976
+ void SetMouseScale(float scaleX, float scaleY); // Set mouse scaling
977
+ float GetMouseWheelMove(void); // Get mouse wheel movement for X or Y, whichever is larger
978
+ Vector2 GetMouseWheelMoveV(void); // Get mouse wheel movement for both X and Y
979
+ void SetMouseCursor(int cursor); // Set mouse cursor
980
+ // Input-related functions: touch
981
+ int GetTouchX(void); // Get touch position X for touch point 0 (relative to screen size)
982
+ int GetTouchY(void); // Get touch position Y for touch point 0 (relative to screen size)
983
+ Vector2 GetTouchPosition(int index); // Get touch position XY for a touch point index (relative to screen size)
984
+ int GetTouchPointId(int index); // Get touch point identifier for given index
985
+ int GetTouchPointCount(void); // Get number of touch points
986
+ //------------------------------------------------------------------------------------
987
+ // Gestures and Touch Handling Functions (Module: rgestures)
988
+ //------------------------------------------------------------------------------------
989
+ void SetGesturesEnabled(unsigned int flags); // Enable a set of gestures using flags
990
+ bool IsGestureDetected(unsigned int gesture); // Check if a gesture have been detected
991
+ int GetGestureDetected(void); // Get latest detected gesture
992
+ float GetGestureHoldDuration(void); // Get gesture hold time in milliseconds
993
+ Vector2 GetGestureDragVector(void); // Get gesture drag vector
994
+ float GetGestureDragAngle(void); // Get gesture drag angle
995
+ Vector2 GetGesturePinchVector(void); // Get gesture pinch delta
996
+ float GetGesturePinchAngle(void); // Get gesture pinch angle
997
+ //------------------------------------------------------------------------------------
998
+ // Camera System Functions (Module: rcamera)
999
+ //------------------------------------------------------------------------------------
1000
+ void UpdateCamera(Camera *camera, int mode); // Update camera position for selected mode
1001
+ void UpdateCameraPro(Camera *camera, Vector3 movement, Vector3 rotation, float zoom); // Update camera movement/rotation
1002
+ //------------------------------------------------------------------------------------
1003
+ // Basic Shapes Drawing Functions (Module: shapes)
1004
+ //------------------------------------------------------------------------------------
1005
+ // Set texture and rectangle to be used on shapes drawing
1006
+ // NOTE: It can be useful when using basic shapes and one single font,
1007
+ // defining a font char white rectangle would allow drawing everything in a single draw call
1008
+ void SetShapesTexture(Texture2D texture, Rectangle source); // Set texture and rectangle to be used on shapes drawing
1009
+ // Basic shapes drawing functions
1010
+ void DrawPixel(int posX, int posY, Color color); // Draw a pixel
1011
+ void DrawPixelV(Vector2 position, Color color); // Draw a pixel (Vector version)
1012
+ void DrawLine(int startPosX, int startPosY, int endPosX, int endPosY, Color color); // Draw a line
1013
+ void DrawLineV(Vector2 startPos, Vector2 endPos, Color color); // Draw a line (using gl lines)
1014
+ void DrawLineEx(Vector2 startPos, Vector2 endPos, float thick, Color color); // Draw a line (using triangles/quads)
1015
+ void DrawLineStrip(Vector2 *points, int pointCount, Color color); // Draw lines sequence (using gl lines)
1016
+ void DrawLineBezier(Vector2 startPos, Vector2 endPos, float thick, Color color); // Draw line segment cubic-bezier in-out interpolation
1017
+ void DrawCircle(int centerX, int centerY, float radius, Color color); // Draw a color-filled circle
1018
+ void DrawCircleSector(Vector2 center, float radius, float startAngle, float endAngle, int segments, Color color); // Draw a piece of a circle
1019
+ void DrawCircleSectorLines(Vector2 center, float radius, float startAngle, float endAngle, int segments, Color color); // Draw circle sector outline
1020
+ void DrawCircleGradient(int centerX, int centerY, float radius, Color color1, Color color2); // Draw a gradient-filled circle
1021
+ void DrawCircleV(Vector2 center, float radius, Color color); // Draw a color-filled circle (Vector version)
1022
+ void DrawCircleLines(int centerX, int centerY, float radius, Color color); // Draw circle outline
1023
+ void DrawCircleLinesV(Vector2 center, float radius, Color color); // Draw circle outline (Vector version)
1024
+ void DrawEllipse(int centerX, int centerY, float radiusH, float radiusV, Color color); // Draw ellipse
1025
+ void DrawEllipseLines(int centerX, int centerY, float radiusH, float radiusV, Color color); // Draw ellipse outline
1026
+ void DrawRing(Vector2 center, float innerRadius, float outerRadius, float startAngle, float endAngle, int segments, Color color); // Draw ring
1027
+ void DrawRingLines(Vector2 center, float innerRadius, float outerRadius, float startAngle, float endAngle, int segments, Color color); // Draw ring outline
1028
+ void DrawRectangle(int posX, int posY, int width, int height, Color color); // Draw a color-filled rectangle
1029
+ void DrawRectangleV(Vector2 position, Vector2 size, Color color); // Draw a color-filled rectangle (Vector version)
1030
+ void DrawRectangleRec(Rectangle rec, Color color); // Draw a color-filled rectangle
1031
+ void DrawRectanglePro(Rectangle rec, Vector2 origin, float rotation, Color color); // Draw a color-filled rectangle with pro parameters
1032
+ void DrawRectangleGradientV(int posX, int posY, int width, int height, Color color1, Color color2);// Draw a vertical-gradient-filled rectangle
1033
+ void DrawRectangleGradientH(int posX, int posY, int width, int height, Color color1, Color color2);// Draw a horizontal-gradient-filled rectangle
1034
+ void DrawRectangleGradientEx(Rectangle rec, Color col1, Color col2, Color col3, Color col4); // Draw a gradient-filled rectangle with custom vertex colors
1035
+ void DrawRectangleLines(int posX, int posY, int width, int height, Color color); // Draw rectangle outline
1036
+ void DrawRectangleLinesEx(Rectangle rec, float lineThick, Color color); // Draw rectangle outline with extended parameters
1037
+ void DrawRectangleRounded(Rectangle rec, float roundness, int segments, Color color); // Draw rectangle with rounded edges
1038
+ void DrawRectangleRoundedLines(Rectangle rec, float roundness, int segments, float lineThick, Color color); // Draw rectangle with rounded edges outline
1039
+ void DrawTriangle(Vector2 v1, Vector2 v2, Vector2 v3, Color color); // Draw a color-filled triangle (vertex in counter-clockwise order!)
1040
+ void DrawTriangleLines(Vector2 v1, Vector2 v2, Vector2 v3, Color color); // Draw triangle outline (vertex in counter-clockwise order!)
1041
+ void DrawTriangleFan(Vector2 *points, int pointCount, Color color); // Draw a triangle fan defined by points (first vertex is the center)
1042
+ void DrawTriangleStrip(Vector2 *points, int pointCount, Color color); // Draw a triangle strip defined by points
1043
+ void DrawPoly(Vector2 center, int sides, float radius, float rotation, Color color); // Draw a regular polygon (Vector version)
1044
+ void DrawPolyLines(Vector2 center, int sides, float radius, float rotation, Color color); // Draw a polygon outline of n sides
1045
+ void DrawPolyLinesEx(Vector2 center, int sides, float radius, float rotation, float lineThick, Color color); // Draw a polygon outline of n sides with extended parameters
1046
+ // Splines drawing functions
1047
+ void DrawSplineLinear(Vector2 *points, int pointCount, float thick, Color color); // Draw spline: Linear, minimum 2 points
1048
+ void DrawSplineBasis(Vector2 *points, int pointCount, float thick, Color color); // Draw spline: B-Spline, minimum 4 points
1049
+ void DrawSplineCatmullRom(Vector2 *points, int pointCount, float thick, Color color); // Draw spline: Catmull-Rom, minimum 4 points
1050
+ void DrawSplineBezierQuadratic(Vector2 *points, int pointCount, float thick, Color color); // Draw spline: Quadratic Bezier, minimum 3 points (1 control point): [p1, c2, p3, c4...]
1051
+ void DrawSplineBezierCubic(Vector2 *points, int pointCount, float thick, Color color); // Draw spline: Cubic Bezier, minimum 4 points (2 control points): [p1, c2, c3, p4, c5, c6...]
1052
+ void DrawSplineSegmentLinear(Vector2 p1, Vector2 p2, float thick, Color color); // Draw spline segment: Linear, 2 points
1053
+ void DrawSplineSegmentBasis(Vector2 p1, Vector2 p2, Vector2 p3, Vector2 p4, float thick, Color color); // Draw spline segment: B-Spline, 4 points
1054
+ void DrawSplineSegmentCatmullRom(Vector2 p1, Vector2 p2, Vector2 p3, Vector2 p4, float thick, Color color); // Draw spline segment: Catmull-Rom, 4 points
1055
+ void DrawSplineSegmentBezierQuadratic(Vector2 p1, Vector2 c2, Vector2 p3, float thick, Color color); // Draw spline segment: Quadratic Bezier, 2 points, 1 control point
1056
+ void DrawSplineSegmentBezierCubic(Vector2 p1, Vector2 c2, Vector2 c3, Vector2 p4, float thick, Color color); // Draw spline segment: Cubic Bezier, 2 points, 2 control points
1057
+ // Spline segment point evaluation functions, for a given t [0.0f .. 1.0f]
1058
+ Vector2 GetSplinePointLinear(Vector2 startPos, Vector2 endPos, float t); // Get (evaluate) spline point: Linear
1059
+ Vector2 GetSplinePointBasis(Vector2 p1, Vector2 p2, Vector2 p3, Vector2 p4, float t); // Get (evaluate) spline point: B-Spline
1060
+ Vector2 GetSplinePointCatmullRom(Vector2 p1, Vector2 p2, Vector2 p3, Vector2 p4, float t); // Get (evaluate) spline point: Catmull-Rom
1061
+ Vector2 GetSplinePointBezierQuad(Vector2 p1, Vector2 c2, Vector2 p3, float t); // Get (evaluate) spline point: Quadratic Bezier
1062
+ Vector2 GetSplinePointBezierCubic(Vector2 p1, Vector2 c2, Vector2 c3, Vector2 p4, float t); // Get (evaluate) spline point: Cubic Bezier
1063
+ // Basic shapes collision detection functions
1064
+ bool CheckCollisionRecs(Rectangle rec1, Rectangle rec2); // Check collision between two rectangles
1065
+ bool CheckCollisionCircles(Vector2 center1, float radius1, Vector2 center2, float radius2); // Check collision between two circles
1066
+ bool CheckCollisionCircleRec(Vector2 center, float radius, Rectangle rec); // Check collision between circle and rectangle
1067
+ bool CheckCollisionPointRec(Vector2 point, Rectangle rec); // Check if point is inside rectangle
1068
+ bool CheckCollisionPointCircle(Vector2 point, Vector2 center, float radius); // Check if point is inside circle
1069
+ bool CheckCollisionPointTriangle(Vector2 point, Vector2 p1, Vector2 p2, Vector2 p3); // Check if point is inside a triangle
1070
+ bool CheckCollisionPointPoly(Vector2 point, Vector2 *points, int pointCount); // Check if point is within a polygon described by array of vertices
1071
+ 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
1072
+ 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]
1073
+ Rectangle GetCollisionRec(Rectangle rec1, Rectangle rec2); // Get collision rectangle for two rectangles collision
1074
+ //------------------------------------------------------------------------------------
1075
+ // Texture Loading and Drawing Functions (Module: textures)
1076
+ //------------------------------------------------------------------------------------
1077
+ // Image loading functions
1078
+ // NOTE: These functions do not require GPU access
1079
+ Image LoadImage(const char *fileName); // Load image from file into CPU memory (RAM)
1080
+ Image LoadImageRaw(const char *fileName, int width, int height, int format, int headerSize); // Load image from RAW file data
1081
+ Image LoadImageSvg(const char *fileNameOrString, int width, int height); // Load image from SVG file data or string with specified size
1082
+ Image LoadImageAnim(const char *fileName, int *frames); // Load image sequence from file (frames appended to image.data)
1083
+ Image LoadImageFromMemory(const char *fileType, const unsigned char *fileData, int dataSize); // Load image from memory buffer, fileType refers to extension: i.e. '.png'
1084
+ Image LoadImageFromTexture(Texture2D texture); // Load image from GPU texture data
1085
+ Image LoadImageFromScreen(void); // Load image from screen buffer and (screenshot)
1086
+ bool IsImageReady(Image image); // Check if an image is ready
1087
+ void UnloadImage(Image image); // Unload image from CPU memory (RAM)
1088
+ bool ExportImage(Image image, const char *fileName); // Export image data to file, returns true on success
1089
+ unsigned char *ExportImageToMemory(Image image, const char *fileType, int *fileSize); // Export image to memory buffer
1090
+ bool ExportImageAsCode(Image image, const char *fileName); // Export image as code file defining an array of bytes, returns true on success
1091
+ // Image generation functions
1092
+ Image GenImageColor(int width, int height, Color color); // Generate image: plain color
1093
+ Image GenImageGradientLinear(int width, int height, int direction, Color start, Color end); // Generate image: linear gradient, direction in degrees [0..360], 0=Vertical gradient
1094
+ Image GenImageGradientRadial(int width, int height, float density, Color inner, Color outer); // Generate image: radial gradient
1095
+ Image GenImageGradientSquare(int width, int height, float density, Color inner, Color outer); // Generate image: square gradient
1096
+ Image GenImageChecked(int width, int height, int checksX, int checksY, Color col1, Color col2); // Generate image: checked
1097
+ Image GenImageWhiteNoise(int width, int height, float factor); // Generate image: white noise
1098
+ Image GenImagePerlinNoise(int width, int height, int offsetX, int offsetY, float scale); // Generate image: perlin noise
1099
+ Image GenImageCellular(int width, int height, int tileSize); // Generate image: cellular algorithm, bigger tileSize means bigger cells
1100
+ Image GenImageText(int width, int height, const char *text); // Generate image: grayscale image from text data
1101
+ // Image manipulation functions
1102
+ Image ImageCopy(Image image); // Create an image duplicate (useful for transformations)
1103
+ Image ImageFromImage(Image image, Rectangle rec); // Create an image from another image piece
1104
+ Image ImageText(const char *text, int fontSize, Color color); // Create an image from text (default font)
1105
+ Image ImageTextEx(Font font, const char *text, float fontSize, float spacing, Color tint); // Create an image from text (custom sprite font)
1106
+ void ImageFormat(Image *image, int newFormat); // Convert image data to desired format
1107
+ void ImageToPOT(Image *image, Color fill); // Convert image to POT (power-of-two)
1108
+ void ImageCrop(Image *image, Rectangle crop); // Crop an image to a defined rectangle
1109
+ void ImageAlphaCrop(Image *image, float threshold); // Crop image depending on alpha value
1110
+ void ImageAlphaClear(Image *image, Color color, float threshold); // Clear alpha channel to desired color
1111
+ void ImageAlphaMask(Image *image, Image alphaMask); // Apply alpha mask to image
1112
+ void ImageAlphaPremultiply(Image *image); // Premultiply alpha channel
1113
+ void ImageBlurGaussian(Image *image, int blurSize); // Apply Gaussian blur using a box blur approximation
1114
+ void ImageResize(Image *image, int newWidth, int newHeight); // Resize image (Bicubic scaling algorithm)
1115
+ void ImageResizeNN(Image *image, int newWidth,int newHeight); // Resize image (Nearest-Neighbor scaling algorithm)
1116
+ void ImageResizeCanvas(Image *image, int newWidth, int newHeight, int offsetX, int offsetY, Color fill); // Resize canvas and fill with color
1117
+ void ImageMipmaps(Image *image); // Compute all mipmap levels for a provided image
1118
+ void ImageDither(Image *image, int rBpp, int gBpp, int bBpp, int aBpp); // Dither image data to 16bpp or lower (Floyd-Steinberg dithering)
1119
+ void ImageFlipVertical(Image *image); // Flip image vertically
1120
+ void ImageFlipHorizontal(Image *image); // Flip image horizontally
1121
+ void ImageRotate(Image *image, int degrees); // Rotate image by input angle in degrees (-359 to 359)
1122
+ void ImageRotateCW(Image *image); // Rotate image clockwise 90deg
1123
+ void ImageRotateCCW(Image *image); // Rotate image counter-clockwise 90deg
1124
+ void ImageColorTint(Image *image, Color color); // Modify image color: tint
1125
+ void ImageColorInvert(Image *image); // Modify image color: invert
1126
+ void ImageColorGrayscale(Image *image); // Modify image color: grayscale
1127
+ void ImageColorContrast(Image *image, float contrast); // Modify image color: contrast (-100 to 100)
1128
+ void ImageColorBrightness(Image *image, int brightness); // Modify image color: brightness (-255 to 255)
1129
+ void ImageColorReplace(Image *image, Color color, Color replace); // Modify image color: replace color
1130
+ Color *LoadImageColors(Image image); // Load color data from image as a Color array (RGBA - 32bit)
1131
+ Color *LoadImagePalette(Image image, int maxPaletteSize, int *colorCount); // Load colors palette from image as a Color array (RGBA - 32bit)
1132
+ void UnloadImageColors(Color *colors); // Unload color data loaded with LoadImageColors()
1133
+ void UnloadImagePalette(Color *colors); // Unload colors palette loaded with LoadImagePalette()
1134
+ Rectangle GetImageAlphaBorder(Image image, float threshold); // Get image alpha border rectangle
1135
+ Color GetImageColor(Image image, int x, int y); // Get image pixel color at (x, y) position
1136
+ // Image drawing functions
1137
+ // NOTE: Image software-rendering functions (CPU)
1138
+ void ImageClearBackground(Image *dst, Color color); // Clear image background with given color
1139
+ void ImageDrawPixel(Image *dst, int posX, int posY, Color color); // Draw pixel within an image
1140
+ void ImageDrawPixelV(Image *dst, Vector2 position, Color color); // Draw pixel within an image (Vector version)
1141
+ void ImageDrawLine(Image *dst, int startPosX, int startPosY, int endPosX, int endPosY, Color color); // Draw line within an image
1142
+ void ImageDrawLineV(Image *dst, Vector2 start, Vector2 end, Color color); // Draw line within an image (Vector version)
1143
+ void ImageDrawCircle(Image *dst, int centerX, int centerY, int radius, Color color); // Draw a filled circle within an image
1144
+ void ImageDrawCircleV(Image *dst, Vector2 center, int radius, Color color); // Draw a filled circle within an image (Vector version)
1145
+ void ImageDrawCircleLines(Image *dst, int centerX, int centerY, int radius, Color color); // Draw circle outline within an image
1146
+ void ImageDrawCircleLinesV(Image *dst, Vector2 center, int radius, Color color); // Draw circle outline within an image (Vector version)
1147
+ void ImageDrawRectangle(Image *dst, int posX, int posY, int width, int height, Color color); // Draw rectangle within an image
1148
+ void ImageDrawRectangleV(Image *dst, Vector2 position, Vector2 size, Color color); // Draw rectangle within an image (Vector version)
1149
+ void ImageDrawRectangleRec(Image *dst, Rectangle rec, Color color); // Draw rectangle within an image
1150
+ void ImageDrawRectangleLines(Image *dst, Rectangle rec, int thick, Color color); // Draw rectangle lines within an image
1151
+ void ImageDraw(Image *dst, Image src, Rectangle srcRec, Rectangle dstRec, Color tint); // Draw a source image within a destination image (tint applied to source)
1152
+ void ImageDrawText(Image *dst, const char *text, int posX, int posY, int fontSize, Color color); // Draw text (using default font) within an image (destination)
1153
+ 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)
1154
+ // Texture loading functions
1155
+ // NOTE: These functions require GPU access
1156
+ Texture2D LoadTexture(const char *fileName); // Load texture from file into GPU memory (VRAM)
1157
+ Texture2D LoadTextureFromImage(Image image); // Load texture from image data
1158
+ TextureCubemap LoadTextureCubemap(Image image, int layout); // Load cubemap from image, multiple image cubemap layouts supported
1159
+ RenderTexture2D LoadRenderTexture(int width, int height); // Load texture for rendering (framebuffer)
1160
+ bool IsTextureReady(Texture2D texture); // Check if a texture is ready
1161
+ void UnloadTexture(Texture2D texture); // Unload texture from GPU memory (VRAM)
1162
+ bool IsRenderTextureReady(RenderTexture2D target); // Check if a render texture is ready
1163
+ void UnloadRenderTexture(RenderTexture2D target); // Unload render texture from GPU memory (VRAM)
1164
+ void UpdateTexture(Texture2D texture, const void *pixels); // Update GPU texture with new data
1165
+ void UpdateTextureRec(Texture2D texture, Rectangle rec, const void *pixels); // Update GPU texture rectangle with new data
1166
+ // Texture configuration functions
1167
+ void GenTextureMipmaps(Texture2D *texture); // Generate GPU mipmaps for a texture
1168
+ void SetTextureFilter(Texture2D texture, int filter); // Set texture scaling filter mode
1169
+ void SetTextureWrap(Texture2D texture, int wrap); // Set texture wrapping mode
1170
+ // Texture drawing functions
1171
+ void DrawTexture(Texture2D texture, int posX, int posY, Color tint); // Draw a Texture2D
1172
+ void DrawTextureV(Texture2D texture, Vector2 position, Color tint); // Draw a Texture2D with position defined as Vector2
1173
+ void DrawTextureEx(Texture2D texture, Vector2 position, float rotation, float scale, Color tint); // Draw a Texture2D with extended parameters
1174
+ void DrawTextureRec(Texture2D texture, Rectangle source, Vector2 position, Color tint); // Draw a part of a texture defined by a rectangle
1175
+ 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
1176
+ 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
1177
+ // Color/pixel related functions
1178
+ Color Fade(Color color, float alpha); // Get color with alpha applied, alpha goes from 0.0f to 1.0f
1179
+ int ColorToInt(Color color); // Get hexadecimal value for a Color
1180
+ Vector4 ColorNormalize(Color color); // Get Color normalized as float [0..1]
1181
+ Color ColorFromNormalized(Vector4 normalized); // Get Color from normalized values [0..1]
1182
+ Vector3 ColorToHSV(Color color); // Get HSV values for a Color, hue [0..360], saturation/value [0..1]
1183
+ Color ColorFromHSV(float hue, float saturation, float value); // Get a Color from HSV values, hue [0..360], saturation/value [0..1]
1184
+ Color ColorTint(Color color, Color tint); // Get color multiplied with another color
1185
+ Color ColorBrightness(Color color, float factor); // Get color with brightness correction, brightness factor goes from -1.0f to 1.0f
1186
+ Color ColorContrast(Color color, float contrast); // Get color with contrast correction, contrast values between -1.0f and 1.0f
1187
+ Color ColorAlpha(Color color, float alpha); // Get color with alpha applied, alpha goes from 0.0f to 1.0f
1188
+ Color ColorAlphaBlend(Color dst, Color src, Color tint); // Get src alpha-blended into dst color with tint
1189
+ Color GetColor(unsigned int hexValue); // Get Color structure from hexadecimal value
1190
+ Color GetPixelColor(void *srcPtr, int format); // Get Color from a source pixel pointer of certain format
1191
+ void SetPixelColor(void *dstPtr, Color color, int format); // Set color formatted into destination pixel pointer
1192
+ int GetPixelDataSize(int width, int height, int format); // Get pixel data size in bytes for certain format
1193
+ //------------------------------------------------------------------------------------
1194
+ // Font Loading and Text Drawing Functions (Module: text)
1195
+ //------------------------------------------------------------------------------------
1196
+ // Font loading/unloading functions
1197
+ Font GetFontDefault(void); // Get the default Font
1198
+ Font LoadFont(const char *fileName); // Load font from file into GPU memory (VRAM)
1199
+ 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
1200
+ Font LoadFontFromImage(Image image, Color key, int firstChar); // Load font from Image (XNA style)
1201
+ 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'
1202
+ bool IsFontReady(Font font); // Check if a font is ready
1203
+ GlyphInfo *LoadFontData(const unsigned char *fileData, int dataSize, int fontSize, int *codepoints, int codepointCount, int type); // Load font data for further use
1204
+ Image GenImageFontAtlas(const GlyphInfo *glyphs, Rectangle **glyphRecs, int glyphCount, int fontSize, int padding, int packMethod); // Generate image font atlas using chars info
1205
+ void UnloadFontData(GlyphInfo *glyphs, int glyphCount); // Unload font chars info data (RAM)
1206
+ void UnloadFont(Font font); // Unload font from GPU memory (VRAM)
1207
+ bool ExportFontAsCode(Font font, const char *fileName); // Export font as code file, returns true on success
1208
+ // Text drawing functions
1209
+ void DrawFPS(int posX, int posY); // Draw current FPS
1210
+ void DrawText(const char *text, int posX, int posY, int fontSize, Color color); // Draw text (using default font)
1211
+ void DrawTextEx(Font font, const char *text, Vector2 position, float fontSize, float spacing, Color tint); // Draw text using font and additional parameters
1212
+ 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)
1213
+ void DrawTextCodepoint(Font font, int codepoint, Vector2 position, float fontSize, Color tint); // Draw one character (codepoint)
1214
+ void DrawTextCodepoints(Font font, const int *codepoints, int codepointCount, Vector2 position, float fontSize, float spacing, Color tint); // Draw multiple character (codepoint)
1215
+ // Text font info functions
1216
+ void SetTextLineSpacing(int spacing); // Set vertical line spacing when drawing with line-breaks
1217
+ int MeasureText(const char *text, int fontSize); // Measure string width for default font
1218
+ Vector2 MeasureTextEx(Font font, const char *text, float fontSize, float spacing); // Measure string size for Font
1219
+ int GetGlyphIndex(Font font, int codepoint); // Get glyph index position in font for a codepoint (unicode character), fallback to '?' if not found
1220
+ GlyphInfo GetGlyphInfo(Font font, int codepoint); // Get glyph font info data for a codepoint (unicode character), fallback to '?' if not found
1221
+ Rectangle GetGlyphAtlasRec(Font font, int codepoint); // Get glyph rectangle in font atlas for a codepoint (unicode character), fallback to '?' if not found
1222
+ // Text codepoints management functions (unicode characters)
1223
+ char *LoadUTF8(const int *codepoints, int length); // Load UTF-8 text encoded from codepoints array
1224
+ void UnloadUTF8(char *text); // Unload UTF-8 text encoded from codepoints array
1225
+ int *LoadCodepoints(const char *text, int *count); // Load all codepoints from a UTF-8 text string, codepoints count returned by parameter
1226
+ void UnloadCodepoints(int *codepoints); // Unload codepoints data from memory
1227
+ int GetCodepointCount(const char *text); // Get total number of codepoints in a UTF-8 encoded string
1228
+ int GetCodepoint(const char *text, int *codepointSize); // Get next codepoint in a UTF-8 encoded string, 0x3f('?') is returned on failure
1229
+ int GetCodepointNext(const char *text, int *codepointSize); // Get next codepoint in a UTF-8 encoded string, 0x3f('?') is returned on failure
1230
+ int GetCodepointPrevious(const char *text, int *codepointSize); // Get previous codepoint in a UTF-8 encoded string, 0x3f('?') is returned on failure
1231
+ const char *CodepointToUTF8(int codepoint, int *utf8Size); // Encode one codepoint into UTF-8 byte array (array length returned as parameter)
1232
+ // Text strings management functions (no UTF-8 strings, only byte chars)
1233
+ // NOTE: Some strings allocate memory internally for returned strings, just be careful!
1234
+ int TextCopy(char *dst, const char *src); // Copy one string to another, returns bytes copied
1235
+ bool TextIsEqual(const char *text1, const char *text2); // Check if two text string are equal
1236
+ unsigned int TextLength(const char *text); // Get text length, checks for '\0' ending
1237
+ const char *TextFormat(const char *text, ...); // Text formatting with variables (sprintf() style)
1238
+ const char *TextSubtext(const char *text, int position, int length); // Get a piece of a text string
1239
+ char *TextReplace(char *text, const char *replace, const char *by); // Replace text string (WARNING: memory must be freed!)
1240
+ char *TextInsert(const char *text, const char *insert, int position); // Insert text in a position (WARNING: memory must be freed!)
1241
+ const char *TextJoin(const char **textList, int count, const char *delimiter); // Join text strings with delimiter
1242
+ const char **TextSplit(const char *text, char delimiter, int *count); // Split text into multiple strings
1243
+ void TextAppend(char *text, const char *append, int *position); // Append text at specific position and move cursor!
1244
+ int TextFindIndex(const char *text, const char *find); // Find first text occurrence within a string
1245
+ const char *TextToUpper(const char *text); // Get upper case version of provided string
1246
+ const char *TextToLower(const char *text); // Get lower case version of provided string
1247
+ const char *TextToPascal(const char *text); // Get Pascal case notation version of provided string
1248
+ int TextToInteger(const char *text); // Get integer value from text (negative values not supported)
1249
+ //------------------------------------------------------------------------------------
1250
+ // Basic 3d Shapes Drawing Functions (Module: models)
1251
+ //------------------------------------------------------------------------------------
1252
+ // Basic geometric 3D shapes drawing functions
1253
+ void DrawLine3D(Vector3 startPos, Vector3 endPos, Color color); // Draw a line in 3D world space
1254
+ void DrawPoint3D(Vector3 position, Color color); // Draw a point in 3D space, actually a small line
1255
+ void DrawCircle3D(Vector3 center, float radius, Vector3 rotationAxis, float rotationAngle, Color color); // Draw a circle in 3D world space
1256
+ void DrawTriangle3D(Vector3 v1, Vector3 v2, Vector3 v3, Color color); // Draw a color-filled triangle (vertex in counter-clockwise order!)
1257
+ void DrawTriangleStrip3D(Vector3 *points, int pointCount, Color color); // Draw a triangle strip defined by points
1258
+ void DrawCube(Vector3 position, float width, float height, float length, Color color); // Draw cube
1259
+ void DrawCubeV(Vector3 position, Vector3 size, Color color); // Draw cube (Vector version)
1260
+ void DrawCubeWires(Vector3 position, float width, float height, float length, Color color); // Draw cube wires
1261
+ void DrawCubeWiresV(Vector3 position, Vector3 size, Color color); // Draw cube wires (Vector version)
1262
+ void DrawSphere(Vector3 centerPos, float radius, Color color); // Draw sphere
1263
+ void DrawSphereEx(Vector3 centerPos, float radius, int rings, int slices, Color color); // Draw sphere with extended parameters
1264
+ void DrawSphereWires(Vector3 centerPos, float radius, int rings, int slices, Color color); // Draw sphere wires
1265
+ void DrawCylinder(Vector3 position, float radiusTop, float radiusBottom, float height, int slices, Color color); // Draw a cylinder/cone
1266
+ 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
1267
+ void DrawCylinderWires(Vector3 position, float radiusTop, float radiusBottom, float height, int slices, Color color); // Draw a cylinder/cone wires
1268
+ 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
1269
+ 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
1270
+ 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
1271
+ void DrawPlane(Vector3 centerPos, Vector2 size, Color color); // Draw a plane XZ
1272
+ void DrawRay(Ray ray, Color color); // Draw a ray line
1273
+ void DrawGrid(int slices, float spacing); // Draw a grid (centered at (0, 0, 0))
1274
+ //------------------------------------------------------------------------------------
1275
+ // Model 3d Loading and Drawing Functions (Module: models)
1276
+ //------------------------------------------------------------------------------------
1277
+ // Model management functions
1278
+ Model LoadModel(const char *fileName); // Load model from files (meshes and materials)
1279
+ Model LoadModelFromMesh(Mesh mesh); // Load model from generated mesh (default material)
1280
+ bool IsModelReady(Model model); // Check if a model is ready
1281
+ void UnloadModel(Model model); // Unload model (including meshes) from memory (RAM and/or VRAM)
1282
+ BoundingBox GetModelBoundingBox(Model model); // Compute model bounding box limits (considers all meshes)
1283
+ // Model drawing functions
1284
+ void DrawModel(Model model, Vector3 position, float scale, Color tint); // Draw a model (with texture if set)
1285
+ void DrawModelEx(Model model, Vector3 position, Vector3 rotationAxis, float rotationAngle, Vector3 scale, Color tint); // Draw a model with extended parameters
1286
+ void DrawModelWires(Model model, Vector3 position, float scale, Color tint); // Draw a model wires (with texture if set)
1287
+ 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
1288
+ void DrawBoundingBox(BoundingBox box, Color color); // Draw bounding box (wires)
1289
+ void DrawBillboard(Camera camera, Texture2D texture, Vector3 position, float size, Color tint); // Draw a billboard texture
1290
+ void DrawBillboardRec(Camera camera, Texture2D texture, Rectangle source, Vector3 position, Vector2 size, Color tint); // Draw a billboard texture defined by source
1291
+ 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
1292
+ // Mesh management functions
1293
+ void UploadMesh(Mesh *mesh, bool dynamic); // Upload mesh vertex data in GPU and provide VAO/VBO ids
1294
+ void UpdateMeshBuffer(Mesh mesh, int index, const void *data, int dataSize, int offset); // Update mesh vertex data in GPU for a specific buffer index
1295
+ void UnloadMesh(Mesh mesh); // Unload mesh data from CPU and GPU
1296
+ void DrawMesh(Mesh mesh, Material material, Matrix transform); // Draw a 3d mesh with material and transform
1297
+ void DrawMeshInstanced(Mesh mesh, Material material, const Matrix *transforms, int instances); // Draw multiple mesh instances with material and different transforms
1298
+ bool ExportMesh(Mesh mesh, const char *fileName); // Export mesh data to file, returns true on success
1299
+ BoundingBox GetMeshBoundingBox(Mesh mesh); // Compute mesh bounding box limits
1300
+ void GenMeshTangents(Mesh *mesh); // Compute mesh tangents
1301
+ // Mesh generation functions
1302
+ Mesh GenMeshPoly(int sides, float radius); // Generate polygonal mesh
1303
+ Mesh GenMeshPlane(float width, float length, int resX, int resZ); // Generate plane mesh (with subdivisions)
1304
+ Mesh GenMeshCube(float width, float height, float length); // Generate cuboid mesh
1305
+ Mesh GenMeshSphere(float radius, int rings, int slices); // Generate sphere mesh (standard sphere)
1306
+ Mesh GenMeshHemiSphere(float radius, int rings, int slices); // Generate half-sphere mesh (no bottom cap)
1307
+ Mesh GenMeshCylinder(float radius, float height, int slices); // Generate cylinder mesh
1308
+ Mesh GenMeshCone(float radius, float height, int slices); // Generate cone/pyramid mesh
1309
+ Mesh GenMeshTorus(float radius, float size, int radSeg, int sides); // Generate torus mesh
1310
+ Mesh GenMeshKnot(float radius, float size, int radSeg, int sides); // Generate trefoil knot mesh
1311
+ Mesh GenMeshHeightmap(Image heightmap, Vector3 size); // Generate heightmap mesh from image data
1312
+ Mesh GenMeshCubicmap(Image cubicmap, Vector3 cubeSize); // Generate cubes-based map mesh from image data
1313
+ // Material loading/unloading functions
1314
+ Material *LoadMaterials(const char *fileName, int *materialCount); // Load materials from model file
1315
+ Material LoadMaterialDefault(void); // Load default material (Supports: DIFFUSE, SPECULAR, NORMAL maps)
1316
+ bool IsMaterialReady(Material material); // Check if a material is ready
1317
+ void UnloadMaterial(Material material); // Unload material from GPU memory (VRAM)
1318
+ void SetMaterialTexture(Material *material, int mapType, Texture2D texture); // Set texture for a material map type (MATERIAL_MAP_DIFFUSE, MATERIAL_MAP_SPECULAR...)
1319
+ void SetModelMeshMaterial(Model *model, int meshId, int materialId); // Set material for a mesh
1320
+ // Model animations loading/unloading functions
1321
+ ModelAnimation *LoadModelAnimations(const char *fileName, int *animCount); // Load model animations from file
1322
+ void UpdateModelAnimation(Model model, ModelAnimation anim, int frame); // Update model animation pose
1323
+ void UnloadModelAnimation(ModelAnimation anim); // Unload animation data
1324
+ void UnloadModelAnimations(ModelAnimation *animations, int animCount); // Unload animation array data
1325
+ bool IsModelAnimationValid(Model model, ModelAnimation anim); // Check model animation skeleton match
1326
+ // Collision detection functions
1327
+ bool CheckCollisionSpheres(Vector3 center1, float radius1, Vector3 center2, float radius2); // Check collision between two spheres
1328
+ bool CheckCollisionBoxes(BoundingBox box1, BoundingBox box2); // Check collision between two bounding boxes
1329
+ bool CheckCollisionBoxSphere(BoundingBox box, Vector3 center, float radius); // Check collision between box and sphere
1330
+ RayCollision GetRayCollisionSphere(Ray ray, Vector3 center, float radius); // Get collision info between ray and sphere
1331
+ RayCollision GetRayCollisionBox(Ray ray, BoundingBox box); // Get collision info between ray and box
1332
+ RayCollision GetRayCollisionMesh(Ray ray, Mesh mesh, Matrix transform); // Get collision info between ray and mesh
1333
+ RayCollision GetRayCollisionTriangle(Ray ray, Vector3 p1, Vector3 p2, Vector3 p3); // Get collision info between ray and triangle
1334
+ RayCollision GetRayCollisionQuad(Ray ray, Vector3 p1, Vector3 p2, Vector3 p3, Vector3 p4); // Get collision info between ray and quad
1335
+ //------------------------------------------------------------------------------------
1336
+ // Audio Loading and Playing Functions (Module: audio)
1337
+ //------------------------------------------------------------------------------------
1338
+ typedef void (*AudioCallback)(void *bufferData, unsigned int frames);
1339
+ // Audio device management functions
1340
+ void InitAudioDevice(void); // Initialize audio device and context
1341
+ void CloseAudioDevice(void); // Close the audio device and context
1342
+ bool IsAudioDeviceReady(void); // Check if audio device has been initialized successfully
1343
+ void SetMasterVolume(float volume); // Set master volume (listener)
1344
+ float GetMasterVolume(void); // Get master volume (listener)
1345
+ // Wave/Sound loading/unloading functions
1346
+ Wave LoadWave(const char *fileName); // Load wave data from file
1347
+ Wave LoadWaveFromMemory(const char *fileType, const unsigned char *fileData, int dataSize); // Load wave from memory buffer, fileType refers to extension: i.e. '.wav'
1348
+ bool IsWaveReady(Wave wave); // Checks if wave data is ready
1349
+ Sound LoadSound(const char *fileName); // Load sound from file
1350
+ Sound LoadSoundFromWave(Wave wave); // Load sound from wave data
1351
+ Sound LoadSoundAlias(Sound source); // Create a new sound that shares the same sample data as the source sound, does not own the sound data
1352
+ bool IsSoundReady(Sound sound); // Checks if a sound is ready
1353
+ void UpdateSound(Sound sound, const void *data, int sampleCount); // Update sound buffer with new data
1354
+ void UnloadWave(Wave wave); // Unload wave data
1355
+ void UnloadSound(Sound sound); // Unload sound
1356
+ void UnloadSoundAlias(Sound alias); // Unload a sound alias (does not deallocate sample data)
1357
+ bool ExportWave(Wave wave, const char *fileName); // Export wave data to file, returns true on success
1358
+ bool ExportWaveAsCode(Wave wave, const char *fileName); // Export wave sample data to code (.h), returns true on success
1359
+ // Wave/Sound management functions
1360
+ void PlaySound(Sound sound); // Play a sound
1361
+ void StopSound(Sound sound); // Stop playing a sound
1362
+ void PauseSound(Sound sound); // Pause a sound
1363
+ void ResumeSound(Sound sound); // Resume a paused sound
1364
+ bool IsSoundPlaying(Sound sound); // Check if a sound is currently playing
1365
+ void SetSoundVolume(Sound sound, float volume); // Set volume for a sound (1.0 is max level)
1366
+ void SetSoundPitch(Sound sound, float pitch); // Set pitch for a sound (1.0 is base level)
1367
+ void SetSoundPan(Sound sound, float pan); // Set pan for a sound (0.5 is center)
1368
+ Wave WaveCopy(Wave wave); // Copy a wave to a new wave
1369
+ void WaveCrop(Wave *wave, int initSample, int finalSample); // Crop a wave to defined samples range
1370
+ void WaveFormat(Wave *wave, int sampleRate, int sampleSize, int channels); // Convert wave data to desired format
1371
+ float *LoadWaveSamples(Wave wave); // Load samples data from wave as a 32bit float data array
1372
+ void UnloadWaveSamples(float *samples); // Unload samples data loaded with LoadWaveSamples()
1373
+ // Music management functions
1374
+ Music LoadMusicStream(const char *fileName); // Load music stream from file
1375
+ Music LoadMusicStreamFromMemory(const char *fileType, const unsigned char *data, int dataSize); // Load music stream from data
1376
+ bool IsMusicReady(Music music); // Checks if a music stream is ready
1377
+ void UnloadMusicStream(Music music); // Unload music stream
1378
+ void PlayMusicStream(Music music); // Start music playing
1379
+ bool IsMusicStreamPlaying(Music music); // Check if music is playing
1380
+ void UpdateMusicStream(Music music); // Updates buffers for music streaming
1381
+ void StopMusicStream(Music music); // Stop music playing
1382
+ void PauseMusicStream(Music music); // Pause music playing
1383
+ void ResumeMusicStream(Music music); // Resume playing paused music
1384
+ void SeekMusicStream(Music music, float position); // Seek music to a position (in seconds)
1385
+ void SetMusicVolume(Music music, float volume); // Set volume for music (1.0 is max level)
1386
+ void SetMusicPitch(Music music, float pitch); // Set pitch for a music (1.0 is base level)
1387
+ void SetMusicPan(Music music, float pan); // Set pan for a music (0.5 is center)
1388
+ float GetMusicTimeLength(Music music); // Get music time length (in seconds)
1389
+ float GetMusicTimePlayed(Music music); // Get current music time played (in seconds)
1390
+ // AudioStream management functions
1391
+ AudioStream LoadAudioStream(unsigned int sampleRate, unsigned int sampleSize, unsigned int channels); // Load audio stream (to stream raw audio pcm data)
1392
+ bool IsAudioStreamReady(AudioStream stream); // Checks if an audio stream is ready
1393
+ void UnloadAudioStream(AudioStream stream); // Unload audio stream and free memory
1394
+ void UpdateAudioStream(AudioStream stream, const void *data, int frameCount); // Update audio stream buffers with data
1395
+ bool IsAudioStreamProcessed(AudioStream stream); // Check if any audio stream buffers requires refill
1396
+ void PlayAudioStream(AudioStream stream); // Play audio stream
1397
+ void PauseAudioStream(AudioStream stream); // Pause audio stream
1398
+ void ResumeAudioStream(AudioStream stream); // Resume audio stream
1399
+ bool IsAudioStreamPlaying(AudioStream stream); // Check if audio stream is playing
1400
+ void StopAudioStream(AudioStream stream); // Stop audio stream
1401
+ void SetAudioStreamVolume(AudioStream stream, float volume); // Set volume for audio stream (1.0 is max level)
1402
+ void SetAudioStreamPitch(AudioStream stream, float pitch); // Set pitch for audio stream (1.0 is base level)
1403
+ void SetAudioStreamPan(AudioStream stream, float pan); // Set pan for audio stream (0.5 is centered)
1404
+ void SetAudioStreamBufferSizeDefault(int size); // Default size for new audio streams
1405
+ void SetAudioStreamCallback(AudioStream stream, AudioCallback callback); // Audio thread callback to request new data
1406
+ void AttachAudioStreamProcessor(AudioStream stream, AudioCallback processor); // Attach audio stream processor to stream, receives the samples as <float>s
1407
+ void DetachAudioStreamProcessor(AudioStream stream, AudioCallback processor); // Detach audio stream processor from stream
1408
+ void AttachAudioMixedProcessor(AudioCallback processor); // Attach audio stream processor to the entire audio pipeline, receives the samples as <float>s
1409
+ void DetachAudioMixedProcessor(AudioCallback processor); // Detach audio stream processor from the entire audio pipeline