Go to file
Ahmad Fatoum 3f09726331
CMake: Major cleanup to support find_package(raylib)
Remove that link_libraries_to_executable() hack and defines a proper
raylib target that can be used with target_link_libraries.

The same target is also available for external (user) code by using
find_package(raylib).

This results in:

- Remove hardcoded build directories from examples and games CMakeLists.txt
- Allow rlgl_standalone and other special examples to be built easily
- Allow CMake projects to find_package(raylib instead of fiddling with pkg-config
- Makes code a little more maintainable
- Fixes #471, #606.
- Makes code less confusing by removing the double use of PLATFORM (#584).

Note that this is still not _The Right Way_(TM), because normally
raylib-config.cmake (or its includes) would be automatically generated.
I didn't manage to get that to work though, so I went the easier route
of just wrapping pkg_check_modules for consumption by find_package.
2018-07-29 12:35:35 +02:00
cmake CMake: Major cleanup to support find_package(raylib) 2018-07-29 12:35:35 +02:00
examples CMake: Major cleanup to support find_package(raylib) 2018-07-29 12:35:35 +02:00
games CMake: Major cleanup to support find_package(raylib) 2018-07-29 12:35:35 +02:00
logo Renamed iconography 2018-02-10 23:29:40 +01:00
projects Corrected timing typo 2018-07-28 18:13:19 +02:00
release Corrected timing typo 2018-07-28 18:13:19 +02:00
src CMake: Major cleanup to support find_package(raylib) 2018-07-29 12:35:35 +02:00
templates Review formatting 2018-07-21 17:19:44 +02:00
.gitignore Added Android Makefile for games 2018-07-21 17:38:47 +02:00
.travis.yml CMake: Major cleanup to support find_package(raylib) 2018-07-29 12:35:35 +02:00
CHANGELOG Corrected timing typo 2018-07-28 18:13:19 +02:00
CMakeLists.txt CMake: Major cleanup to support find_package(raylib) 2018-07-29 12:35:35 +02:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2018-07-23 13:37:25 +02:00
CONTRIBUTING.md Update CONTRIBUTING.md 2018-07-16 10:06:30 +02:00
HELPME.md Updated common documents 2018-07-16 02:07:48 +02:00
HISTORY.md Corrected timing typo 2018-07-28 18:13:19 +02:00
LICENSE.md Removed dwarf 3d model 2018-06-21 00:35:50 +02:00
README.md Remove period 2018-07-22 23:31:03 -07:00
ROADMAP.md Updated common documents 2018-07-16 02:07:48 +02:00
appveyor.yml CI: Build with all optional formats enabled 2018-07-29 12:13:01 +02:00
raylib.pc.in CMake: Add Libs.private to Libs if installing static only 2018-07-10 21:20:01 +02:00
raylib.rc.o Looking for a place for raylib resource file 2018-07-21 16:18:33 +02:00

README.md

raylib is a simple and easy-to-use library to learn videogames programming.

raylib is highly inspired by Borland BGI graphics lib and by XNA framework.

raylib could be useful for prototyping, tools development, graphic applications, embedded systems and education.

NOTE for ADVENTURERS: raylib is a programming library to learn videogames programming; no fancy interface, no visual helpers, no auto-debugging... just coding in the most pure spartan-programmers way. Are you ready to learn? Jump to code examples!

Build Status https://ci.appveyor.com/api/projects/status/github/raysan5/raylib?svg=true Chat on Discord License Twitter URL

features

  • NO external dependencies, all required libraries included with raylib
  • Multiple platforms supported: Windows, Linux, MacOS, Android... and many more!
  • Written in plain C code (C99) in PascalCase/camelCase notation
  • Hardware accelerated with OpenGL (1.1, 2.1, 3.3 or ES 2.0)
  • Unique OpenGL abstraction layer (usable as standalone module): rlgl
  • Multiple Fonts formats supported (XNA fonts, AngelCode fonts, TTF)
  • Outstanding texture formats support, including compressed formats (DXT, ETC, ASTC)
  • Full 3d support for 3d Shapes, Models, Billboards, Heightmaps and more!
  • Flexible Materials system, supporting classic maps and PBR maps
  • Shaders support, including Model shaders and Postprocessing shaders
  • Powerful math module for Vector, Matrix and Quaternion operations: raymath
  • Audio loading and playing with streaming support (WAV, OGG, MP3, FLAC, XM, MOD)
  • VR stereo rendering support with configurable HMD device parameters
  • Bindings to Lua (raylib-lua), Go (raylib-go) and more!

raylib uses on its core module the outstanding GLFW3 library, embedded inside raylib in the form of rglfw module, avoiding that way external dependencies.

raylib uses on its audio module, the amazing mini_al audio library, single-file header-only and supporting multiple platforms and multiple audio backends.

raylib uses internally multiple single-file header-only libraries to support multiple fileformats loading and saving, all those libraries are embedded with raylib and available in src/external directory.

On Android, native_app_glue module (provided by Android NDK) and native Android libraries are used to manage window/context, inputs and activity life cycle.

On Raspberry Pi, Videocore API and EGL libraries are used for window/context management and raw inputs reading.

build and installation

Binary releases for Windows, Linux and macOS are available at the Github Releases page. raylib is also available via multiple package managers on multiple OS distributions. For more info check raylib Wiki.

To build raylib yourself, check out also the raylib Wiki for detailed instructions.

raylib has been developed using exclusively two tools:

Those are the tools recommended to develop with raylib, in fact, those are the tools my students use.

contact

If you are using raylib and you enjoy it, please, let me know.

If you feel you can help, then, helpme!

license

raylib is licensed under an unmodified zlib/libpng license, which is an OSI-certified, BSD-like license that allows static linking with closed source software. Check LICENSE for further details.