raylib/README.md

87 lines
6.8 KiB
Markdown
Raw Normal View History

2018-02-12 13:53:47 +03:00
<img align="left" src="https://github.com/raysan5/raylib/blob/master/logo/raylib_256x256.png" width=256>
2018-09-09 18:36:24 +03:00
**raylib is a simple and easy-to-use library to enjoy videogames programming.**
2019-04-23 16:22:20 +03:00
raylib is highly inspired by Borland BGI graphics lib and by XNA framework and it's specially well suited for prototyping, tooling, graphical applications, embedded systems and education.
2017-07-25 12:40:04 +03:00
2019-05-27 16:31:57 +03:00
*NOTE for ADVENTURERS: raylib is a programming library to enjoy videogames programming; no fancy interface, no visual helpers, no auto-debugging... just coding in the most pure spartan-programmers way.*
2019-03-25 12:12:38 +03:00
Ready to learn? Jump to [code examples!](http://www.raylib.com/examples.html)
2014-12-31 21:25:50 +03:00
2020-03-21 15:01:50 +03:00
<br>
2020-03-21 20:48:04 +03:00
[![GitHub contributors](https://img.shields.io/github/contributors/raysan5/raylib)](https://github.com/raysan5/raylib/graphs/contributors)
[![GitHub All Releases](https://img.shields.io/github/downloads/raysan5/raylib/total)](https://github.com/raysan5/raylib/releases)
[![GitHub commits since tagged version](https://img.shields.io/github/commits-since/raysan5/raylib/2.5.0)](https://github.com/raysan5/raylib/commits/master)
2020-03-21 15:22:06 +03:00
[![License](https://img.shields.io/badge/license-zlib%2Flibpng-blue.svg)](LICENSE)
2020-03-21 15:01:50 +03:00
2019-04-27 23:42:22 +03:00
[![Chat on Discord](https://img.shields.io/discord/426912293134270465.svg?logo=discord)](https://discord.gg/VkzNHUE)
2020-03-21 20:48:04 +03:00
[![GitHub stars](https://img.shields.io/github/stars/raysan5/raylib?style=social)](https://github.com/raysan5/raylib/stargazers)
[![Twitter Follow](https://img.shields.io/twitter/follow/raysan5?style=social)](https://twitter.com/raysan5)
[![Subreddit subscribers](https://img.shields.io/reddit/subreddit-subscribers/raylib?style=social)](https://www.reddit.com/r/raylib/)
2020-03-21 14:43:27 +03:00
2020-03-21 15:50:24 +03:00
[![Travis (.org)](https://img.shields.io/travis/raysan5/raylib?label=Travis%20CI%20Build%20Status)](https://travis-ci.org/raysan5/raylib)
[![AppVeyor](https://img.shields.io/appveyor/build/raysan5/raylib?label=AppVeyor%20CI%20Build%20Status)](https://ci.appveyor.com/project/raysan5/raylib)
2020-03-21 15:48:53 +03:00
2020-01-10 15:45:30 +03:00
[![Actions Status](https://github.com/raysan5/raylib/workflows/CI%20-%20Source%20&%20Examples%20-%20Windows/badge.svg)](https://github.com/raysan5/raylib/actions)
[![Actions Status](https://github.com/raysan5/raylib/workflows/CI%20-%20Source%20&%20Examples%20-%20Linux/badge.svg)](https://github.com/raysan5/raylib/actions)
[![Actions Status](https://github.com/raysan5/raylib/workflows/CI%20-%20Source%20&%20Examples%20-%20macOS/badge.svg)](https://github.com/raysan5/raylib/actions)
features
--------
2019-03-25 12:12:38 +03:00
- **NO external dependencies**, all required libraries are bundled into raylib
2020-03-16 22:46:28 +03:00
- Multiple platforms supported: **Windows, Linux, MacOS, Android, HTML5... and more!**
2018-07-16 03:07:48 +03:00
- 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](https://github.com/raysan5/raylib/blob/master/src/rlgl.h)
2020-03-16 22:46:28 +03:00
- Multiple **Fonts** formats supported (TTF, XNA fonts, AngelCode fonts)
2018-07-16 03:07:48 +03:00
- Outstanding texture formats support, including compressed formats (DXT, ETC, ASTC)
2019-03-25 12:12:38 +03:00
- **Full 3D support**, including 3D Shapes, Models, Billboards, Heightmaps and more!
2018-07-16 03:07:48 +03:00
- Flexible Materials system, supporting classic maps and **PBR maps**
2019-05-27 16:25:41 +03:00
- **Animated 3D models** supported (skeletal bones animation)
2020-03-16 22:46:28 +03:00
- Shaders support, including model and **postprocessing** shaders.
2018-07-16 03:07:48 +03:00
- **Powerful math module** for Vector, Matrix and Quaternion operations: [raymath](https://github.com/raysan5/raylib/blob/master/src/raymath.h)
- Audio loading and playing with streaming support (WAV, OGG, MP3, FLAC, XM, MOD)
- **VR stereo rendering** support with configurable HMD device parameters
2020-03-16 22:46:28 +03:00
- Huge examples collection with [+115 code examples](https://github.com/raysan5/raylib/tree/master/examples)!
- Bindings to [+40 programming languages](https://github.com/raysan5/raylib/blob/master/BINDINGS.md)!
2019-05-27 16:31:57 +03:00
raylib uses on its [core](https://github.com/raysan5/raylib/blob/master/src/core.c) module the outstanding [GLFW3](http://www.glfw.org/) library, embedded in the form of [rglfw](https://github.com/raysan5/raylib/blob/master/src/rglfw.c) module, to avoid external dependencies.
2019-05-27 16:25:41 +03:00
raylib uses on its [raudio](https://github.com/raysan5/raylib/blob/master/src/raudio.c) module, the amazing [miniaudio](https://github.com/dr-soft/miniaudio) library to support multiple platforms and multiple audio backends.
2018-02-20 13:04:02 +03:00
2020-03-16 22:46:28 +03:00
raylib uses internally several single-file header-only libraries to support different fileformats loading and saving, all those libraries are embedded with raylib and available in [src/external](https://github.com/raysan5/raylib/tree/master/src/external) directory. Check [raylib Wiki](https://github.com/raysan5/raylib/wiki/raylib-dependencies) for a detailed list.
2020-03-16 22:46:28 +03:00
*On Android platform, `native_app_glue` module (provided by Android NDK) and native Android libraries are used to manage window/context, inputs and activity life cycle.*
2019-04-23 16:22:20 +03:00
*On Raspberry Pi platform (native mode), `Videocore API` and `EGL` libraries are used for window/context management. Inputs are processed using `evdev` Linux libraries*
2020-03-16 22:46:28 +03:00
*On Web platform, raylib uses `emscripten` provided libraries for several input events management, specially noticeable the touch events support.*
build and installation
----------------------
2020-03-16 22:46:28 +03:00
raylib binary releases for Windows, Linux and macOS are available at the [Github Releases page](https://github.com/raysan5/raylib/releases). raylib is also available via multiple [package managers](https://github.com/raysan5/raylib/issues/613) on multiple OS distributions.
2020-03-21 14:43:27 +03:00
raylib has been developed on Windows platform using Notepad++ and MinGW GCC compiler but it can be used with multiple IDEs on multiple platforms, [projects directory](https://github.com/raysan5/raylib/tree/master/projects) contains several ready-to-use project templates to build raylib and code examples.
2020-03-21 14:43:27 +03:00
[raylib Wiki](https://github.com/raysan5/raylib/wiki#development-platforms) contains detailed instructions on building and usage on multiple platforms.
contact
-------
* Webpage: [http://www.raylib.com](http://www.raylib.com)
2019-04-23 16:22:20 +03:00
* Discord: [https://discord.gg/raylib](https://discord.gg/VkzNHUE)
* Twitter: [http://www.twitter.com/raysan5](http://www.twitter.com/raysan5)
2016-02-21 04:27:34 +03:00
* Twitch: [http://www.twitch.tv/raysan5](http://www.twitch.tv/raysan5)
2019-05-27 16:25:41 +03:00
* Reddit: [https://www.reddit.com/r/raylib](https://www.reddit.com/r/raylib)
2018-04-23 21:59:10 +03:00
* Patreon: [https://www.patreon.com/raylib](https://www.patreon.com/raylib)
* YouTube: [https://www.youtube.com/channel/raylib](https://www.youtube.com/channel/UC8WIBkhYb5sBNqXO1mZ7WSQ)
2020-03-21 14:43:27 +03:00
If you are using raylib and enjoying it, please, join our [Discord server](https://discord.gg/VkzNHUE) and let us know! :)
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](LICENSE.md) for further details.