mirror of
https://github.com/raysan5/raylib.git
synced 2025-10-06 09:56:28 +00:00
584bc14929
* add base of rlsw.h * implement state support Also replace the triangle rasterization functions with macros that generate specific functions for each state of the rendering system. Also, add the OpenGL definitions in order to add a binding for rlgl. * branchless float saturation * apply perspective correction to colors * impl line clipping and rasterization + tweak function names * impl face culling * impl color blending * fixes and tweaks * add clear buffer bitmasks * small optimizations / tweaks * review ndc to screen projection * avoid to recalculate MVP when its not needed + tweaks * review the loading and management of textures to be closer to the OpenGL API * texture sampling optimization * review get pixel functions + review unorm/float conversion * add several buffer format support Several depth and color formats have been added for the framebuffer. 8-bit, 16-bit, and 24-bit formats are now available for depth. RGB 8-bit (332), RGB 16-bit (565), and RGB 24-bit (888) formats are now available for color. Alpha support is no longer present for the framebuffer at the moment, but it can easily be restored by adding the formats and reinterpolating the alpha in the areas that do not perform color blending. Additionally, this commit brings performance improvements. * tweaks * impl line width * impl points + point size * fix and improve polygon clipping functions * impl polygone modes * add some not planned functions - `glDepthMask` - `glColorMask` * framebuffer resizing + handle init failure * add quick notes about line clipping algorithms used * start to impl scissor test + review line clipping The support for the scissor test has been implemented for clearing as well as for triangle clipping. The implementation for lines and points is still missing. I also removed the 2D clipping of lines that used the Cohen-Sutherland algorithm, opting instead to always use the Liang-Barsky algorithm in all cases. This simplifies the implementation, and the 2D version would have caused issues when interpolating vertices in the future if we want to implement additional features. * review scissor clear * review `swScissor` * impl line scissor clipping * round screen coordinate (line rasterization) * impl point scissor clipping * remove unused defs * add getter functions * gl binding * add `glHint` and `glShadeModel` macros (not implmented) * binding tweaks * impl copy framebuffer function + glReadPixels * review `swCopyFramebuffer` * update rlgl.h * update rlgl.h * texture copy support * fix typo.. * add get error function * def sw alloc macros * reimpl get color buffer func just in case * remove normal interpolation * review texture wrap * fix ndc projection (viewport/scissor) * impl framebuffer blit function * reduce matrix compuations and memory usage * swBegin tweaks * preventing a possible division by zero * remove useless scissor related data * review color blending system * greatly improve float saturation * tweak lerp vertex function * use opitmized fract function in sw_texture_map * tweak framebuffer functions for better readability * optimized copy/blit functions for each dst format * review framebuffer filling functions * impl specific quad rendering func * use of a single global vertex buffer * fix 'sw_poly_point_render' * added `SW_RESTRICT` and redesigned `sw_lerp_vertex_PNCTH` * tweak the pipeline flow regarding the face culling avoids misprediction, improves vectorization if possible * new rendering path for axis aligned quads * oops, translating some comments * use of `restrict` for blending function parameters * update rlgl.h * adding `GRAPHICS_API_OPENGL_11_SOFTWARE` in `DrawMesh` * add `RL_OPENGL_11_SOFTWARE` enum * temp tweak * build fixes * fix DrawMesh for GL 1.1 * update swClose * review texture format + fix copy * set minimum req vertices to 3 (quads) * check swInit * review pixelformat * tweaks * fix animNormals (DrawMesh) * fallback color/texcoord (swDrawArrays) * review swMultMatrixf * fix texture pool alloc.. * review triangle scanlines increment all data * fix `sw_quad_sort_cw` * impl sdl platform * rm def * increase max clipped polygon vertices * improve triangle rasterization along Y axis improved robustness against numerical errors incremental interpolation along Y simplified function, fewer jumps * review current vertex data + increase max clipped polygon vertices (for extreme cases) * fix and improve polygon clipping Sets the vertex count to zero when the polygon is invalid Stops clipping when the vertex count drops below 3 * fix gradient calculation * cache texture size minus one + comments * tweaks * BGRA copy support * adding software backend option (cmake) * update Makefile * fix face culling * excluse some exemple with the software backend * review SW_CLAMP case in sw_texture_map * review sw_saturate * review line raster * fix sw_quad_is_aligned * review sw_raster_quad_axis_aligned * tweaks * codepoint fix (?) * fix var name... * rcore_drm software renderering * cleanup and tweaks * adding support for `GL_POINT_SIZE` and `GL_LINE_WIDTH` get * fix sampling issue * fix swBlendFunc --------- Co-authored-by: Ray <raysan5@gmail.com>
Building the Examples
The examples assume you have already built the raylib library in ../src.
With GNU make
makebuilds all examplesmake [module]builds all examples for a particular module (e.gmake core)make [module]/[name]builds one examples for a particular module (e.gmake core/core_basic_window)
With Zig
The Zig toolchain can compile C and C++ in addition to Zig.
You may find it easier to use than other toolchains, especially when it comes to cross-compiling.
zig buildto compile all exampleszig build [module]to compile all examples for a module (e.g.zig build core)zig build [example]to compile and run a particular example (e.g.zig build core_basic_window)
EXAMPLES COLLECTION [TOTAL: 164]
category: core [38]
Examples using raylibcore platform functionality like window creation, inputs, drawing modes and system functionality.
category: shapes [20]
Examples using raylib shapes drawing functionality, provided by raylib shapes module.
category: textures [26]
Examples using raylib textures functionality, including image/textures loading/generation and drawing, provided by raylib textures module.
category: text [14]
Examples using raylib text functionality, including sprite fonts loading/generation and text drawing, provided by raylib text module.
| example | image | difficulty level |
version created |
last version updated |
original developer |
|---|---|---|---|---|---|
| text_sprite_fonts |  |
⭐☆☆☆ | 1.7 | 3.7 | Ramon Santamaria |
| text_font_spritefont |  |
⭐☆☆☆ | 1.0 | 1.0 | Ramon Santamaria |
| text_font_filters |  |
⭐⭐☆☆ | 1.3 | 4.2 | Ramon Santamaria |
| text_font_loading |  |
⭐☆☆☆ | 1.4 | 3.0 | Ramon Santamaria |
| text_font_sdf |  |
⭐⭐⭐☆ | 1.3 | 4.0 | Ramon Santamaria |
| text_format_text |  |
⭐☆☆☆ | 1.1 | 3.0 | Ramon Santamaria |
| text_input_box |  |
⭐⭐☆☆ | 1.7 | 3.5 | Ramon Santamaria |
| text_writing_anim |  |
⭐⭐☆☆ | 1.4 | 1.4 | Ramon Santamaria |
| text_rectangle_bounds |  |
⭐⭐⭐⭐️ | 2.5 | 4.0 | Vlad Adrian |
| text_unicode_emojis |  |
⭐⭐⭐⭐️ | 2.5 | 4.0 | Vlad Adrian |
| text_unicode_ranges |  |
⭐⭐⭐⭐️ | 5.5 | 5.6 | Vlad Adrian |
| text_3d_drawing |  |
⭐⭐⭐⭐️ | 3.5 | 4.0 | Vlad Adrian |
| text_codepoints_loading |  |
⭐⭐⭐☆ | 4.2 | 4.2 | Ramon Santamaria |
| text_inline_styling |  |
⭐⭐⭐☆ | 5.6-dev | 5.6-dev | Wagner Barongello |
category: models [24]
Examples using raylib models functionality, including models loading/generation and drawing, provided by raylib models module.
category: shaders [29]
Examples using raylib shaders functionality, including shaders loading, parameters configuration and drawing using them (model shaders and postprocessing shaders). This functionality is directly provided by raylib rlgl module.
category: audio [8]
Examples using raylib audio functionality, including sound/music loading and playing. This functionality is provided by raylib raudio module. Note this module can be used standalone independently of raylib.
| example | image | difficulty level |
version created |
last version updated |
original developer |
|---|---|---|---|---|---|
| audio_module_playing |  |
⭐☆☆☆ | 1.5 | 3.5 | Ramon Santamaria |
| audio_music_stream |  |
⭐☆☆☆ | 1.3 | 4.2 | Ramon Santamaria |
| audio_raw_stream |  |
⭐⭐⭐☆ | 1.6 | 4.2 | Ramon Santamaria |
| audio_sound_loading |  |
⭐☆☆☆ | 1.1 | 3.5 | Ramon Santamaria |
| audio_mixed_processor |  |
⭐⭐⭐⭐️ | 4.2 | 4.2 | hkc |
| audio_stream_effects |  |
⭐⭐⭐⭐️ | 4.2 | 5.0 | Ramon Santamaria |
| audio_sound_multi |  |
⭐⭐☆☆ | 5.0 | 5.0 | Jeffery Myers |
| audio_sound_positioning |  |
⭐⭐☆☆ | 5.5 | 5.5 | Le Juez Victor |
category: others [6]
Examples showing raylib misc functionality that does not fit in other categories, like standalone modules usage or examples integrating external libraries.
| example | image | difficulty level |
version created |
last version updated |
original developer |
|---|---|---|---|---|---|
| rlgl_standalone |  |
⭐⭐⭐⭐️ | 1.6 | 4.0 | Ramon Santamaria |
| rlgl_compute_shader |  |
⭐⭐⭐⭐️ | 4.0 | 4.0 | Teddy Astie |
| easings_testbed |  |
⭐⭐⭐☆ | 2.5 | 3.0 | Juan Miguel López |
| raylib_opengl_interop |  |
⭐⭐⭐⭐️ | 3.8 | 4.0 | Stephan Soller |
| embedded_files_loading |  |
⭐⭐☆☆ | 3.0 | 3.5 | Kristian Holmgren |
| raymath_vector_angle |  |
⭐⭐☆☆ | 1.0 | 5.0 | Ramon Santamaria |
Some example missing? As always, contributions are welcome, feel free to send new examples! Here is anexamples template with instructions to start with!