Skip to content

raylib architecture

Ray edited this page May 27, 2019 · 7 revisions


raylib is a very modular library, defined by a small number of specific and self-contained modules. Every module is organized by its main functionality (avoiding hundreds of modules depending on other modules, like other C libraries).

raylib main modules are 7:

  • core: Window / Graphic Context / Inputs management.
  • rlgl: Graphic API (OpenGL) wrapper and pseudo-OpenGL 1.1 translation layer.
  • shapes: Basic 2D shapes drawing functions.
  • textures: Textures / Image loading and management.
  • text: Font data loading and text drawing.
  • models: 3D models loading and drawing.
  • raudio: Audio device management and sounds / music loading and playing.

Those 7 modules share a common header: raylib.h, all user functions are defined in that header, despite the fact they are divided internally in 7 modules. That way, the user just needs to include raylib.h to get all raylib functionality. Other libraries use one header for every module (that way the user can choose included modules) or also headers that refer to other headers. raylib uses a simpler approach that's easier for novice (and expert) users.

Apart from those 7 main modules, some other modules have been implemented with additional features:

  • raymath: Vector2, Vector3, Matrix and Quaternion math related functions
  • camera: 3D Camera system (free, 1st person, 3rd person, custom)
  • gestures: Touch gestures detection and processing (Tap, Swipe, Drag, Pinch)
  • raygui: Simple IMGUI system with several controls for tools development
  • easings: Easing functions for animations (based on Robert Penner implementation)
  • physac: 2D physics library (collision detection, resolution, dinamics...)

Most of the modules have been designed to be as decoupled as possible from other modules, so, some modules can be used independently of raylib, as standalone libraries. For example, two such modules are rlgl (example) and audio (example).

Most of the secondary modules can also be used as standalone libraries: raymath, camera, gestures, raygui, easings, physac. All those modules are distributed as configurable single-file header-only libraries to be independently added to any project. Being header-only means the header also contains function implementations; that's extremely useful if you have a library (a bunch of functions) that you only want to drop on your code-base to cover a very specific functionality. However, creating a header-only module is not trivial. That module has to minimize external dependencies and global variables and give a very specific functionality; let's say it has to be completely portable.

NOTE: raymath, camera and gestures are compiled by default with raylib.

raylib also uses some external libraries—most of them included as single-file header-only libraries, like the well-known stb libraries and similar ones.

And that's currently the raylib internal structure.

Clone this wiki locally
You can’t perform that action at this time.