raylib

raylib is configurable and can be built in a variety of ways. Following is a listing of available CMake options and values, extracted from src/CMakeOptions.txt and src/config.h

You must set CUSTOMIZE_BUILD to ON in order for many of these options to apply.

Tip

: You can use the curses UI provided by ccmake(1) for interactively configuring raylib.

Option	Description	Possible Values (first is default)
`USE_EXTERNAL_GLFW`	Link raylib against system GLFW instead of embedded one	`OFF` `ON` `IF_POSSIBLE`
`PLATFORM`	Platform to build for.	`Desktop` `Web` `Android` `Raspberry Pi` `SDL`
`OPENGL_VERSION`	Force a specific OpenGL Version?	`OFF` `4.3` `3.3` `2.1` `1.1` `ES 2.0` `ES 3.0`
`BUILD_EXAMPLES`	Build examples	`OFF` `ON`

Binary Option	Description	Default Value
`GLFW_BUILD_WAYLAND`	Build the bundled GLFW with Wayland support	`OFF`
`GLFW_BUILD_X11`	Build the bundled GLFW with X11 support	`OFF`
`WITH_PIC`	Compile static library as position-independent code	`OFF`
`BUILD_SHARED_LIBS`	Build raylib as a dynamic or static library	`OFF`
`INCLUDE_EVERYTHING`	Include all optional off-by-default formats in build	`OFF`
`USE_AUDIO`	Build raylib with audio module	`ON`
`SUPPORT_MODULE_RSHAPES`	...	`ON`
`SUPPORT_MODULE_RTEXTURES`	...	`ON`
`SUPPORT_MODULE_RTEXT`	WARNING: It requires SUPPORT_MODULE_RTEXTURES to load sprite font textures	`ON`
`SUPPORT_MODULE_RMODELS`	...	`ON`
`SUPPORT_MODULE_RAUDIO`	...	`ON`
`SUPPORT_BUSY_WAIT_LOOP`	Use busy wait loop for timing sync instead of a high-resolution timer	`OFF`
`SUPPORT_CAMERA_SYSTEM`	Provide camera module (camera.h) with multiple predefined cameras: free, 1st/3rd person, orbital	`ON`
`SUPPORT_GESTURES_SYSTEM`	Gestures module is included (gestures.h) to support gestures detection: tap, hold, swipe, drag	`ON`
`SUPPORT_RPRAND_GENERATOR`	pseudo-random numbers generator (rprand.h), based on Xoshiro128** and SplitMix64	`ON`
`SUPPORT_MOUSE_GESTURES`	Mouse gestures are directly mapped like touches and processed by gestures system	`ON`
`SUPPORT_SSH_KEYBOARD_RPI`	...	`ON`
`SUPPORT_WINMM_HIGHRES_TIMER`	...	`ON`
`SUPPORT_PARTIALBUSY_WAIT_LOOP`	...	`ON`
`SUPPORT_GIF_RECORDING`	Allow automatic gif recording of current screen pressing CTRL+F12, defined in KeyCallback()	`ON`
`SUPPORT_COMPRESSION_API`	...	`ON`
`SUPPORT_AUTOMATION_EVENTS`	...	`ON`
`SUPPORT_CUSTOM_FRAME_CONTROL`	...	`OFF`
`SUPPORT_CLIPBOARD_IMAGE`	...	`ON`
`SUPPORT_QUADS_DRAW_MODE`	Use QUADS instead of TRIANGLES for drawing when possible. Some lines-based shapes could still use lines	`ON`
`SUPPORT_FILEFORMAT_PNG`	Support loading PNG as textures	`ON`
`SUPPORT_FILEFORMAT_BMP`	Support loading BMP as textures	`OFF`
`SUPPORT_FILEFORMAT_TGA`	Support loading TGA as textures	`OFF`
`SUPPORT_FILEFORMAT_JPG`	Support loading JPG as textures	`OFF`
`SUPPORT_FILEFORMAT_GIF`	Support loading GIF as textures	`ON`
`SUPPORT_FILEFORMAT_QOI`	Support loading QOI as textures	`ON`
`SUPPORT_FILEFORMAT_PSD`	Support loading PSD as textures	`OFF`
`SUPPORT_FILEFORMAT_DDS`	Support loading DDS as textures	`ON`
`SUPPORT_FILEFORMAT_HDR`	Support loading HDR as textures	`OFF`
`SUPPORT_FILEFORMAT_PIC`	Support loading PIC as textures	`OFF`
`SUPPORT_FILEFORMAT_KTX`	Support loading KTX as textures	`OFF`
`SUPPORT_FILEFORMAT_ASTC`	Support loading ASTC as textures	`OFF`
`SUPPORT_FILEFORMAT_PKM`	Support loading PKM as textures	`OFF`
`SUPPORT_FILEFORMAT_PVR`	Support loading PVR as textures	`OFF`
`SUPPORT_IMAGE_EXPORT`	...	`ON`
`SUPPORT_IMAGE_GENERATION`	Support procedural image generation functionality (gradient, spot, perlin-noise, cellular)	`ON`
`SUPPORT_IMAGE_MANIPULATION`	Support multiple image editing functions to scale, adjust colors, flip, draw on images, crop... If not defined only three image editing functions supported: ImageFormat(), ImageAlphaMask(), ImageToPOT()	`ON`
`SUPPORT_DEFAULT_FONT`	Default font is loaded on window initialization to be available for the user to render simple text. If enabled, uses external module functions to load default raylib font (module: text)	`ON`
`SUPPORT_FILEFORMAT_TTF`	Support loading fonts in TTF format	`ON`
`SUPPORT_FILEFORMAT_FNT`	Support loading fonts in FNT format	`ON`
`SUPPORT_FILEFORMAT_BDF`	Support loading fonts in BDF format	`OFF`
`SUPPORT_TEXT_MANIPULATION`	...	`ON`
`SUPPORT_FONT_ATLAS_WHITE_REC`	Draw rectangle shapes using font texture white character instead of default white texture. Allows drawing rectangles and text with a single draw call, very useful for GUI systems!	`ON`
`SUPPORT_FILEFORMAT_OBJ`	Support loading OBJ file format	`ON`
`SUPPORT_FILEFORMAT_MTL`	Support loading MTL file format	`ON`
`SUPPORT_FILEFORMAT_IQM`	Support loading IQM file format	`ON`
`SUPPORT_FILEFORMAT_GLTF`	Support loading GLTF file format	`ON`
`SUPPORT_FILEFORMAT_VOX`	Support loading VOX file format	`ON`
`SUPPORT_FILEFORMAT_M3D`	Support loading M3D file format	`ON`
`SUPPORT_MESH_GENERATION`	Support procedural mesh generation functions, uses external par_shapes.h library. NOTE: Some generated meshes DO NOT include generated texture coordinates	`ON`
`SUPPORT_FILEFORMAT_WAV`	Support loading WAV for sound	`ON`
`SUPPORT_FILEFORMAT_OGG`	Support loading OGG for sound	`ON`
`SUPPORT_FILEFORMAT_MP3`	Support loading MP3 for sound	`ON`
`SUPPORT_FILEFORMAT_QOA`	Support loading QOA for sound	`ON`
`SUPPORT_FILEFORMAT_FLAC`	Support loading FLAC for sound	`OFF`
`SUPPORT_FILEFORMAT_XM`	Support loading XM for sound	`ON`
`SUPPORT_FILEFORMAT_MOD`	Support loading MOD for sound	`ON`
`SUPPORT_STANDARD_FILEIO`	Standard file io library (stdio.h) included. Warning: If off, raylib can't read files	`ON`
`SUPPORT_SAVE_PNG`	Support saving image data in PNG file format	`ON`
`SUPPORT_SAVE_BMP`	Support saving image data in BMP file format	`OFF`
`SUPPORT_TRACELOG`	Show TraceLog() output messages. NOTE: By default LOG_DEBUG traces not shown	`ON`
`SUPPORT_SCREEN_CAPTURE`	Allow automatic screen capture of current screen pressing F12, defined in KeyCallback()	`ON`

Frequently Asked Questions

Library Design

Development Platforms

IDE Configurations

Misc Help