Looking for raylib examples contributors

[raysan5]

raylib new examples ideas

raylib examples are the main documentation and learning resource for raylib; they illustrate the library provided functionality and they can be used as a direct test and copy-paste resource for new projects.

But there is always room for improvement and here it is a list of examples that could be interesting for the library, to illustrate not only certain functionality but also how to implement certain features in games or demos.

raylib has a collection of +160 examples at the moment, organized in 7 categories: core, shapes, textures, text, models, shaders and audio. Aligned with raylib main code modules.

About adding new examples

IMPORTANT: Examples must follow raylib examples structure template and raylib code conventions. Examples must be simple and focused to the feature they try to teach but also attractive with care for detail; it's recommended to keep nex examples under 250 lines of code, with comments and explanations when required.

A contributed example consist of, at least, the <category>_example_name.c code file and the <category>_example_name.png screenshot (800x450). Recently rexm tool was created to populate the new example to all required build systems and web. It can be done on command-line with:

rexm add `<category>_example_name.c`

NOTE: The <category>_example_name.png must be in same directory as the code file.

New potential examples

module: core

• core_directory_files - loading and display of current directory files
• core_text_file_loading - loading a sample text file (lorem ipsum?) and draw text by lines?
• core_input_mouse_drag - illustrate box mouse dragging/panning and scaling with mouse wheel
• core_translate_rotate_scale - illustrate rlgl immediate-mode usage for a box transformation
• core_3d_camera_view - show camera prism and view result - https://threejs.org/examples/#webgl_camera
• core_monitor_change – switching between monitors, querying refresh rate/resolution
• core_delta_time – GetFrameTime() vs fixed timestep updates for animations/logic
• core_clipboard_text - GetClipboardText()/SetClipboardText() usage
• core_input_remapping – simple key/button remapping system --> core_input_actions

module: shapes

• shapes/math_sine_cosine - https://p5js.org/examples/angles-and-motion-sine-cosine/
• shapes_simple_particles - https://processing.org/examples/simpleparticlesystem.html
• shapes_lines_drawing - lines drawing with mouse - https://p5js.org/examples/animation-and-variables-drawing-lines/
• shapes/math_angle_rotation - https://p5js.org/examples/transformation-rotate/
• shapes_analog/digital_clock - https://p5js.org/examples/calculating-values-clock/
• shapes_color_wheel - Hue color wheel/ring with angles - https://p5js.org/examples/repetition-color-wheel/
• shapes_kaleidoscope - https://p5js.org/examples/repetition-kaleidoscope/
• shapes_triangle_strip
• shapes_starfield_drawing – classic starfield simulation using simple lines/points
• shapes_pie_chart - https://processing.org/examples/piechart.html
• shapes_penrose_tile - https://processing.org/examples/penrosetile.html
• shapes_recursive_tree - https://processing.org/examples/tree.html
• shapes_bouncing_ball - REVIEW: add gravity - https://processing.org/examples/bouncingball.html
• shapes_bullet_hell

module: textures

• textures_particles_smoke - https://p5js.org/examples/math-and-physics-smoke-particle-system/ - https://processing.org/examples/smokeparticlesystem.html
• textures_alpha_mask
• texture_blending_modes - https://threejs.org/examples/webgl_materials_blending.html - https://threejs.org/examples/webgl_materials_blending_custom.html
• texture_framebuffer_rendering - https://threejs.org/examples/#webgl_framebuffer_texture

module: text

• text_words_alignment - Align words left, center, right inside a rectangle, also vertical alignment
• text_strings_management - show usage of Text*() functionality
• text_multiline_drawing

module: models

• models/geometry_textures_cube - rotating crate - https://threejs.org/examples/#webgl_geometry_cube
• models/geometry_extrude_spline - mesh extruded along spline - https://threejs.org/examples/#webgl_geometry_extrude_splines
• models_spline_editor - https://threejs.org/examples/#webgl_geometry_spline_editor
• models_text_mesh
• models_mesh_lods
• models_basic_voxel
• models_projected_decals - apply decals to models - https://threejs.org/examples/#webgl_decals
• models_instanced_rendering
• models_billboard_particles
• models_metaballs_rendering
• models_occlusion_culling

module: shaders

• shaders_color_correction - Illustrate basic contrast/saturation/brightness shader over a texture
• shaders_maldelbrot_set
• shaders_anaglyph_effect - https://threejs.org/examples/#webgl_effects_anaglyph
• shaders_ascii_effect - https://threejs.org/examples/#webgl_effects_ascii
• shaders_parallaxbarrier_effect - https://threejs.org/examples/#webgl_effects_parallaxbarrier
• shaders_heat_distortion
• shaders_water_surface – simple Gerstner waves or ripple effect
• shaders_tonemaping_correction
• shaders_volumetric_fog
• shaders_2d_glowing
• shaders_hdr_rendering
• shaders_deferred_rendering

module: audio

• audio_wave/spectrum_visualizer - wave and frequency spectrum visualization (FFT)
• audio_input_microphone - read data from microphone (API not implemented yet)
• audio_soundfx_generator - using rfxgen.h library
• audio_rythm_sync - audio sync with basic demo

References

Examples collections from other similar frameworks/libraries.

• https://github.com/libsdl-org/SDL/tree/main/examples/renderer
• https://github.com/bkaradzic/bgfx/tree/master/examples
• https://github.com/openframeworks/openFrameworks/tree/master/examples/graphics
• https://github.com/godotengine/godot-demo-projects/tree/master
• https://threejs.org/examples/#webgl_animation_keyframes
• https://processing.org/examples/
• https://p5js.org/examples/
• https://www.shadertoy.com/

[timlittle]

models_basic_voxel: #5212

[maiconpintoabreu]

shaders_ascii_effect: #5213
core_monitor_change: #5215

[Jopestpe]

shapes_bouncing_ball add gravity: #5217
models_geometry_textures_cube - rotating crate: #5221
shapes_recursive_tree: #5229
shapes_triangle_strip: #5240

[zerohorsepower]

shapes_bullet_hell: #5218

[zerasul]

Hi @raysan5; i have a little question, I see that the example core_translate_rotate_scale has the next description: "illustrate rlgl immediate-mode usage for a box transformation" this can be done using a 2d example (using a rectangle) or needs to be a 3d Box?

This is because i already have an example to illustrate the transformations using the Raylib library and can be useful to include.

[GideonSerf]

shapes_pie_chart: #5227 😊

[raysan5]

@GideonSerf Looks nice but I think it can be improved, people looking at that example will probably want to configure multiplr data values, configurable, that map to a percentatge and reflect changes in the pie, also pie should show numbers for each value

[GideonSerf]

Alright, I'll see what I can do

[GideonSerf]

I've added some of your suggestions

[zerasul]

shapes_translation_rotation_scale: #5228

[hugoarnal]

core_directory_files: #5230

[hugoarnal]

shapes_kaleidoscope: #5233

[oqu]

shapes/math_sine_cosine: #5237

[midiphony]

Aaaaaaaah shit, I didn't see your PR... I was asking last week-end on the Discord if someone was on it and thought it was ok :(
#5243

[raysan5]

No worries, I'll review both and get an unified version. In any case thanks to you both for working on this example!