1
0
Fork 0
mirror of https://github.com/gwm17/glfw.git synced 2024-10-08 07:07:25 -04:00
glfw/docs/main.dox

48 lines
1.9 KiB
Plaintext
Raw Normal View History

/*!
@mainpage notitle
@section main_intro Introduction
GLFW is a free, Open Source, multi-platform library for OpenGL, OpenGL ES and
Vulkan application development. It provides a simple, platform-independent API
for creating windows, contexts and surfaces, reading input, handling events, etc.
2017-06-11 12:04:17 -04:00
See @ref news_33 for highlights or the
2018-11-02 15:55:02 -04:00
[version history](https://www.glfw.org/changelog.html) for details.
2016-02-19 04:42:28 -05:00
@ref quick_guide is a guide for users new to GLFW. It takes you through how to
write a small but complete program.
2013-03-29 09:06:23 -04:00
2016-02-19 04:42:28 -05:00
There are guides for each section of the API:
2014-09-18 09:03:29 -04:00
- @ref intro_guide initialization, error handling and high-level design
- @ref window_guide creating and working with windows and framebuffers
- @ref context_guide working with OpenGL and OpenGL ES contexts
2016-02-19 04:42:28 -05:00
- @ref vulkan_guide - working with Vulkan objects and extensions
- @ref monitor_guide enumerating and working with monitors and video modes
- @ref input_guide receiving events, polling and processing input
2014-09-18 09:03:29 -04:00
Once you have written a program, see @ref compile_guide and @ref build_guide.
2014-09-18 09:03:29 -04:00
The [reference documentation](modules.html) provides more detailed information
about specific functions.
2016-02-19 04:42:28 -05:00
@ref moving_guide explains what has changed and how to update existing code to
use the new API.
2015-01-17 19:55:25 -05:00
There is a section on @ref guarantees_limitations for pointer lifetimes,
reentrancy, thread safety, event order and backward and forward compatibility.
2018-11-02 15:55:02 -04:00
The [FAQ](https://www.glfw.org/faq.html) answers many common questions about the
2015-01-17 19:55:25 -05:00
design, implementation and use of GLFW.
2014-09-18 09:03:29 -04:00
2016-02-19 04:42:28 -05:00
Finally, @ref compat_guide explains what APIs, standards and protocols GLFW uses
and what happens when they are not present on a given machine.
2014-09-18 09:03:29 -04:00
This documentation was generated with Doxygen. The sources for it are available
2018-11-02 15:55:02 -04:00
in both the [source distribution](https://www.glfw.org/download.html) and
2014-09-18 09:03:29 -04:00
[GitHub repository](https://github.com/glfw/glfw).
2013-03-29 09:06:23 -04:00
*/