glfw/docs/main.dox

48 lines
1.9 KiB
Plaintext
Raw Normal View History

/*!
@mainpage notitle
@section main_intro Introduction
2014-09-18 13:03:29 +00:00
__GLFW__ is a free, Open Source, multi-platform library for creating windows
with OpenGL or OpenGL ES contexts and receiving many kinds of input. It is easy
to integrate into existing applications and does not lay claim to the main loop.
2015-06-01 20:55:06 +00:00
See @ref news_32 for release highlights or the
2015-01-18 00:55:25 +00:00
[version history](http://www.glfw.org/changelog.html) for details.
2014-09-18 13:03:29 +00:00
@ref quick is a guide for those new to GLFW. It takes you through how to write
a small but complete program. For people coming from GLFW 2, the @ref moving
guide explains what has changed and how to update existing code to use the new
API.
2013-03-29 13:06:23 +00:00
2014-09-18 13:03:29 +00:00
There are guides for each of the various areas of the API.
2014-10-02 15:35:10 +00:00
- @ref intro initialization, error handling and high-level design
- @ref window creating and working with windows and framebuffers
- @ref context working with OpenGL and OpenGL ES contexts
- @ref monitor enumerating and working with monitors and video modes
- @ref input receiving events, polling and processing input
2014-09-18 13:03:29 +00:00
2015-01-18 00:55:25 +00:00
Once you have written a program, see the @ref compile and @ref build guides.
2014-09-18 13:03:29 +00:00
The [reference documentation](modules.html) provides more detailed information
about specific functions.
2015-01-18 00:55:25 +00:00
There is a section on @ref guarantees_limitations for pointer lifetimes,
reentrancy, thread safety, event order and backward and forward compatibility.
The @ref rift fills in the gaps for how to use LibOVR with GLFW.
The [FAQ](http://www.glfw.org/faq.html) answers many common questions about the
design, implementation and use of GLFW.
2014-09-18 13:03:29 +00:00
Finally, the @ref compat guide explains what APIs, standards and protocols GLFW
uses and what happens when they are not present on a given machine.
This documentation was generated with Doxygen. The sources for it are available
in both the [source distribution](http://www.glfw.org/download.html) and
[GitHub repository](https://github.com/glfw/glfw).
2013-03-29 13:06:23 +00:00
*/