2013-06-13 09:07:28 -04:00
|
|
|
# GLFW
|
2013-02-04 04:46:02 -05:00
|
|
|
|
|
|
|
|
## Introduction
|
|
|
|
|
|
2014-02-10 09:33:41 -05:00
|
|
|
GLFW is a free, Open Source, multi-platform library for OpenGL and OpenGL ES
|
2013-02-04 04:46:02 -05:00
|
|
|
application development. It provides a simple, platform-independent API for
|
|
|
|
|
creating windows and contexts, reading input, handling events, etc.
|
|
|
|
|
|
2015-06-01 16:55:06 -04:00
|
|
|
Version 3.2 is _not yet described_.
|
2013-04-18 18:19:22 -04:00
|
|
|
|
2013-04-07 07:26:06 -04:00
|
|
|
If you are new to GLFW, you may find the
|
2013-07-10 09:51:10 -04:00
|
|
|
[introductory tutorial](http://www.glfw.org/docs/latest/quick.html) for GLFW
|
2013-06-17 05:58:46 -04:00
|
|
|
3 useful. If you have used GLFW 2 in the past, there is a
|
2013-07-10 09:51:10 -04:00
|
|
|
[transition guide](http://www.glfw.org/docs/latest/moving.html) for moving to
|
|
|
|
|
the GLFW 3 API.
|
2013-02-04 04:46:02 -05:00
|
|
|
|
|
|
|
|
|
2013-10-27 07:50:33 -04:00
|
|
|
## Compiling GLFW
|
2013-10-21 16:23:15 -04:00
|
|
|
|
2013-10-27 07:50:33 -04:00
|
|
|
See the [Compiling GLFW](http://www.glfw.org/docs/latest/compile.html) guide in
|
|
|
|
|
the GLFW documentation.
|
2013-02-04 04:46:02 -05:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## Using GLFW
|
|
|
|
|
|
2013-10-27 07:50:33 -04:00
|
|
|
See the
|
|
|
|
|
[Building programs that use GLFW](http://www.glfw.org/docs/latest/build.html)
|
|
|
|
|
guide in the GLFW documentation.
|
2013-02-04 04:46:02 -05:00
|
|
|
|
|
|
|
|
|
2014-10-12 09:47:38 -04:00
|
|
|
## Reporting bugs
|
|
|
|
|
|
|
|
|
|
Bugs are reported to our [issue tracker](https://github.com/glfw/glfw/issues).
|
|
|
|
|
Please always include the name and version of the OS where the bug occurs and
|
|
|
|
|
the version of GLFW used. If you have cloned it, include the commit ID used.
|
|
|
|
|
|
|
|
|
|
If it's a build issue, please also include the build log and the name and
|
|
|
|
|
version of your development environment.
|
|
|
|
|
|
|
|
|
|
If it's a context creation issue, please also include the make and model of your
|
|
|
|
|
graphics card and the version of your driver.
|
|
|
|
|
|
|
|
|
|
This will help both us and other people experiencing the same bug.
|
|
|
|
|
|
|
|
|
|
|
2014-01-11 23:40:36 -05:00
|
|
|
## Dependencies
|
|
|
|
|
|
|
|
|
|
GLFW bundles a number of dependencies in the `deps/` directory.
|
|
|
|
|
|
2014-06-18 10:13:49 -04:00
|
|
|
- [getopt\_port](https://github.com/kimgr/getopt_port/) for examples
|
|
|
|
|
with command-line options
|
2014-10-14 21:55:25 -04:00
|
|
|
- [TinyCThread](https://github.com/tinycthread/tinycthread) for threaded
|
2014-06-18 10:13:49 -04:00
|
|
|
examples
|
|
|
|
|
- An OpenGL 3.2 core loader generated by
|
|
|
|
|
[glad](https://github.com/Dav1dde/glad) for examples using modern OpenGL
|
2015-08-09 10:58:25 -04:00
|
|
|
- [linmath.h](https://github.com/datenwolf/linmath.h) for linear algebra in
|
|
|
|
|
examples
|
2014-01-11 23:40:36 -05:00
|
|
|
|
|
|
|
|
|
2013-06-13 09:09:10 -04:00
|
|
|
## Changelog
|
2013-02-04 04:46:02 -05:00
|
|
|
|
2014-02-12 20:57:59 -05:00
|
|
|
- Added `glfwSetWindowSizeLimits` and `glfwSetWindowAspectRatio` for setting
|
|
|
|
|
absolute and relative window size limits
|
2015-10-17 19:20:31 -04:00
|
|
|
- Added `GLFW_TRUE` and `GLFW_FALSE` as client API independent boolean values
|
|
|
|
|
- Removed dependency on external OpenGL or OpenGL ES headers
|
2015-10-18 13:15:36 -04:00
|
|
|
- [Cocoa] Removed support for OS X 10.6
|
2015-10-17 19:20:31 -04:00
|
|
|
- [WGL] Removed dependency on external WGL headers
|
|
|
|
|
- [GLX] Removed dependency on external GLX headers
|
|
|
|
|
- [EGL] Removed dependency on external EGL headers
|
2015-08-23 13:30:04 -04:00
|
|
|
|
2013-02-04 04:46:02 -05:00
|
|
|
|
|
|
|
|
## Contact
|
|
|
|
|
|
|
|
|
|
The official website for GLFW is [glfw.org](http://www.glfw.org/). There you
|
|
|
|
|
can find the latest version of GLFW, as well as news, documentation and other
|
|
|
|
|
information about the project.
|
|
|
|
|
|
|
|
|
|
If you have questions related to the use of GLFW, we have a
|
|
|
|
|
[support forum](https://sourceforge.net/p/glfw/discussion/247562/), and the IRC
|
|
|
|
|
channel `#glfw` on [Freenode](http://freenode.net/).
|
|
|
|
|
|
|
|
|
|
If you have a bug to report, a patch to submit or a feature you'd like to
|
2013-06-24 08:28:42 -04:00
|
|
|
request, please file it in the
|
|
|
|
|
[issue tracker](https://github.com/glfw/glfw/issues) on GitHub.
|
2013-02-04 04:46:02 -05:00
|
|
|
|
|
|
|
|
Finally, if you're interested in helping out with the development of GLFW or
|
2015-05-14 11:14:30 -04:00
|
|
|
porting it to your favorite platform, join us on GitHub or IRC.
|
2013-02-04 04:46:02 -05:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## Acknowledgements
|
|
|
|
|
|
|
|
|
|
GLFW exists because people around the world donated their time and lent their
|
|
|
|
|
skills.
|
|
|
|
|
|
2013-06-09 06:49:13 -04:00
|
|
|
- Bobyshev Alexander
|
|
|
|
|
- artblanc
|
2013-07-30 09:52:23 -04:00
|
|
|
- arturo
|
2013-06-09 06:49:13 -04:00
|
|
|
- Matt Arsenault
|
|
|
|
|
- Keith Bauer
|
|
|
|
|
- John Bartholomew
|
2013-06-16 06:35:46 -04:00
|
|
|
- Niklas Behrens
|
2013-06-09 06:49:13 -04:00
|
|
|
- Niklas Bergström
|
2013-08-16 11:48:11 -04:00
|
|
|
- Doug Binks
|
2013-06-09 06:49:13 -04:00
|
|
|
- blanco
|
2014-08-10 10:35:09 -04:00
|
|
|
- Martin Capitanio
|
2015-04-09 10:09:39 -04:00
|
|
|
- Chi-kwan Chan
|
2013-06-09 06:49:13 -04:00
|
|
|
- Lambert Clara
|
2013-10-06 05:37:16 -04:00
|
|
|
- Andrew Corrigan
|
2013-06-09 06:49:13 -04:00
|
|
|
- Noel Cower
|
|
|
|
|
- Jarrod Davis
|
|
|
|
|
- Olivier Delannoy
|
|
|
|
|
- Paul R. Deppe
|
2014-02-13 18:45:27 -05:00
|
|
|
- Michael Dickens
|
2013-06-09 06:49:13 -04:00
|
|
|
- Jonathan Dummer
|
|
|
|
|
- Ralph Eastwood
|
2015-03-17 11:33:21 -04:00
|
|
|
- Siavash Eliasi
|
2013-12-10 07:45:21 -05:00
|
|
|
- Michael Fogleman
|
2013-12-11 08:41:51 -05:00
|
|
|
- Gerald Franz
|
2013-06-09 06:49:13 -04:00
|
|
|
- GeO4d
|
|
|
|
|
- Marcus Geelnard
|
2014-09-09 17:15:52 -04:00
|
|
|
- Eloi Marín Gratacós
|
2013-06-09 06:49:13 -04:00
|
|
|
- Stefan Gustavson
|
|
|
|
|
- Sylvain Hellegouarch
|
2014-03-10 11:50:20 -04:00
|
|
|
- Matthew Henry
|
2013-06-09 06:49:13 -04:00
|
|
|
- heromyth
|
2014-09-20 20:13:41 -04:00
|
|
|
- Lucas Hinderberger
|
2013-06-16 12:32:16 -04:00
|
|
|
- Paul Holden
|
2015-06-26 07:31:37 -04:00
|
|
|
- Aaron Jacobs
|
2013-06-09 06:49:13 -04:00
|
|
|
- Toni Jovanoski
|
2014-05-02 01:39:21 -04:00
|
|
|
- Arseny Kapoulkine
|
2013-06-09 06:49:13 -04:00
|
|
|
- Osman Keskin
|
|
|
|
|
- Cameron King
|
|
|
|
|
- Peter Knut
|
2015-04-14 15:15:50 -04:00
|
|
|
- Eric Larson
|
2013-06-09 06:49:13 -04:00
|
|
|
- Robin Leffmann
|
|
|
|
|
- Glenn Lewis
|
|
|
|
|
- Shane Liesegang
|
2015-08-14 07:49:52 -04:00
|
|
|
- Eyal Lotem
|
2013-06-09 06:49:13 -04:00
|
|
|
- Дмитри Малышев
|
|
|
|
|
- Martins Mozeiko
|
|
|
|
|
- Tristam MacDonald
|
|
|
|
|
- Hans Mackowiak
|
2013-06-16 12:40:10 -04:00
|
|
|
- Kyle McDonald
|
2013-06-09 06:49:13 -04:00
|
|
|
- David Medlock
|
2015-02-22 23:14:24 -05:00
|
|
|
- Bryce Mehring
|
2013-06-09 06:49:13 -04:00
|
|
|
- Jonathan Mercier
|
|
|
|
|
- Marcel Metz
|
2015-01-23 16:53:41 -05:00
|
|
|
- Jonathan Miller
|
2013-06-09 06:49:13 -04:00
|
|
|
- Kenneth Miller
|
2013-07-01 07:18:05 -04:00
|
|
|
- Bruce Mitchener
|
2013-10-28 08:22:34 -04:00
|
|
|
- Jack Moffitt
|
2013-06-09 06:49:13 -04:00
|
|
|
- Jeff Molofee
|
|
|
|
|
- Jon Morton
|
2013-09-13 08:41:13 -04:00
|
|
|
- Pierre Moulon
|
2013-06-09 06:49:13 -04:00
|
|
|
- Julian Møller
|
2013-11-13 06:59:49 -05:00
|
|
|
- Kamil Nowakowski
|
2013-06-17 05:58:46 -04:00
|
|
|
- Ozzy
|
2013-10-09 13:03:47 -04:00
|
|
|
- Andri Pálsson
|
2013-06-09 06:49:13 -04:00
|
|
|
- Peoro
|
|
|
|
|
- Braden Pellett
|
|
|
|
|
- Arturo J. Pérez
|
2015-04-19 07:27:27 -04:00
|
|
|
- Emmanuel Gil Peyrot
|
2014-11-27 09:39:24 -05:00
|
|
|
- Cyril Pichard
|
2013-10-09 17:58:43 -04:00
|
|
|
- Pieroman
|
2013-06-09 06:49:13 -04:00
|
|
|
- Jorge Rodriguez
|
|
|
|
|
- Ed Ropple
|
2015-01-23 12:38:12 -05:00
|
|
|
- Aleksey Rybalkin
|
2013-06-09 06:49:13 -04:00
|
|
|
- Riku Salminen
|
2014-11-06 17:57:53 -05:00
|
|
|
- Brandon Schaefer
|
2013-06-09 06:49:13 -04:00
|
|
|
- Sebastian Schuberth
|
|
|
|
|
- Matt Sealey
|
|
|
|
|
- SephiRok
|
|
|
|
|
- Steve Sexton
|
2013-10-09 13:45:39 -04:00
|
|
|
- Systemcluster
|
2013-06-09 06:49:13 -04:00
|
|
|
- Dmitri Shuralyov
|
|
|
|
|
- Daniel Skorupski
|
|
|
|
|
- Bradley Smith
|
|
|
|
|
- Julian Squires
|
|
|
|
|
- Johannes Stein
|
2013-06-17 11:42:22 -04:00
|
|
|
- Justin Stoecker
|
2015-04-09 08:03:26 -04:00
|
|
|
- Elviss Strazdins
|
2013-06-09 06:49:13 -04:00
|
|
|
- Nathan Sweet
|
|
|
|
|
- TTK-Bandit
|
|
|
|
|
- Sergey Tikhomirov
|
2015-03-10 07:01:38 -04:00
|
|
|
- A. Tombs
|
2013-06-09 06:49:13 -04:00
|
|
|
- Samuli Tuomola
|
2013-10-07 09:30:57 -04:00
|
|
|
- urraka
|
2013-06-09 06:49:13 -04:00
|
|
|
- Jari Vetoniemi
|
2014-07-01 04:49:50 -04:00
|
|
|
- Ricardo Vieira
|
2013-06-09 06:49:13 -04:00
|
|
|
- Simon Voordouw
|
|
|
|
|
- Torsten Walluhn
|
2014-10-21 01:41:58 -04:00
|
|
|
- Patrick Walton
|
2013-06-09 06:49:13 -04:00
|
|
|
- Jay Weisskopf
|
|
|
|
|
- Frank Wille
|
|
|
|
|
- yuriks
|
|
|
|
|
- Santi Zupancic
|
2014-03-18 16:43:24 -04:00
|
|
|
- Jonas Ådahl
|
2013-06-09 06:49:13 -04:00
|
|
|
- Lasse Öörni
|
|
|
|
|
- All the unmentioned and anonymous contributors in the GLFW community, for bug
|
2013-02-04 04:46:02 -05:00
|
|
|
reports, patches, feedback, testing and encouragement
|
|
|
|
|
|
