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