Navy.gif/glfw
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
1f675ab62f
glfw/README.md

148 lines
5.9 KiB
Markdown
Raw Normal View History

Removed version noise.
2013-06-13 15:07:28 +02:00
# GLFW
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
Migrate from Travis CI to GitHub Actions The old Travis CI .org service has been throttled for a while now and is said to be shutting down completely next week. This migrates the Travis CI build jobs to GitHub Actions, with minor changes. - The trailing whitespace detection has been removed for now. - The libegl1-mesa-dev dependency for Wayland has been removed as it appears to no longer be necessary for building. (cherry picked from commit 5a6001a83be1c788e7795d891b6a9dd5931e460e)
2021-06-07 22:21:23 +02:00
[![Build status](https://github.com/glfw/glfw/actions/workflows/build.yml/badge.svg)](https://github.com/glfw/glfw/actions)
CI file fixes
2016-02-04 14:58:44 +01:00
[![Build status](https://ci.appveyor.com/api/projects/status/0kf0ct9831i5l6sp/branch/master?svg=true)](https://ci.appveyor.com/project/elmindreda/glfw)
Add Coverity badge, I guess
2016-06-23 16:09:55 +02:00
[![Coverity Scan](https://scan.coverity.com/projects/4884/badge.svg)](https://scan.coverity.com/projects/glfw-glfw)
Add initial Travis CI file
2015-04-14 23:47:17 +02:00
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
## Introduction
Documentation work
2016-08-09 01:34:56 +02:00
GLFW is an 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.
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
Documentation work
2019-04-16 01:36:49 +02:00
GLFW natively supports Windows, macOS and Linux and other Unix-like systems. On
Fix typo Fixes #1601. (cherry picked from commit ac30ef3e0c6cac8bbd54b142eadfedd8dd3fe91b)
2019-08-28 21:28:23 +02:00
Linux both X11 and Wayland are supported.
Documentation work
2017-01-29 20:10:53 +01:00
Documentation work
2016-08-17 16:48:22 +02:00
GLFW is licensed under the [zlib/libpng
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
license](https://www.glfw.org/license.html).
Start 3.2.1
2016-06-05 19:35:39 +02:00
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
You can [download](https://www.glfw.org/download.html) the latest stable release
Documentation work
2019-04-16 01:36:49 +02:00
as source or Windows binaries, or fetch the `latest` branch from GitHub. Each
release starting with 3.0 also has a corresponding [annotated
Documentation work
2016-08-17 16:48:22 +02:00
tag](https://github.com/glfw/glfw/releases) with source and binary archives.
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
The [documentation](https://www.glfw.org/docs/latest/) is available online and is
Documentation work
2019-04-16 01:36:49 +02:00
included in all source and binary archives. See the [release
notes](https://www.glfw.org/docs/latest/news.html) for new features, caveats and
deprecations in the latest release. For more details see the [version
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
history](https://www.glfw.org/changelog.html).
Documentation work
2017-01-29 20:10:53 +01:00
The `master` branch is the stable integration branch and _should_ always compile
and run on all supported platforms, although details of newly added features may
change until they have been included in a release. New features and many bug
fixes live in [other branches](https://github.com/glfw/glfw/branches/all) until
they are stable enough to merge.
Start 3.3
2016-08-18 23:42:15 +02:00
Updated readme links to guides.
2013-04-07 13:26:06 +02:00
If you are new to GLFW, you may find the
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
[tutorial](https://www.glfw.org/docs/latest/quick.html) for GLFW 3 useful. If
Documentation work
2017-07-12 00:21:17 +02:00
you have used GLFW 2 in the past, there is a [transition
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
guide](https://www.glfw.org/docs/latest/moving.html) for moving to the GLFW
Documentation work
2017-07-12 00:21:17 +02:00
3 API.
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
Move list of contributors to separate file Fixes #1839 (cherry picked from commit 53d7622a3a78757d5297ecafa235fac64a62b0a9)
2021-07-19 18:25:50 +02:00
GLFW exists because of the contributions of [many people](CONTRIBUTORS.md)
around the world, whether by reporting bugs, providing community support, adding
features, reviewing or testing code, debugging, proofreading docs, suggesting
features or fixing bugs.
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
Moved GLFW compilation guide to docs.
2013-10-27 12:50:33 +01:00
## Compiling GLFW
Cross-linked build guides.
2013-10-21 22:23:15 +02:00
Documentation work
2019-04-16 01:36:49 +02:00
GLFW itself requires only the headers and libraries for your OS and window
system. It does not need the headers for any context creation API (WGL, GLX,
EGL, NSGL, OSMesa) or rendering API (OpenGL, OpenGL ES, Vulkan) to enable
support for them.
Documentation work [ci skip]
2016-07-14 18:32:30 +02:00
Documentation work [ci skip]
2016-07-14 18:29:39 +02:00
GLFW supports compilation on Windows with Visual C++ 2010 and later, MinGW and
Update default name from OS X to macOS Note that earlier releases are still referred to by their proper names; OS X <version> or Mac OS X <version>.
2016-10-20 00:50:54 +02:00
MinGW-w64, on macOS with Clang and on Linux and other Unix-like systems with GCC
Documentation work [ci skip]
2016-07-14 18:29:39 +02:00
and Clang. It will likely compile in other environments as well, but this is
not regularly tested.
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
There are [pre-compiled Windows binaries](https://www.glfw.org/download.html)
Documentation work
2017-07-12 00:21:17 +02:00
available for all supported compilers.
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
See the [compilation guide](https://www.glfw.org/docs/latest/compile.html) for
Documentation work
2017-07-12 00:21:17 +02:00
more information about how to compile GLFW yourself.
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
Documentation work
2016-07-14 18:02:44 +02:00
Documentation work [ci skip]
2016-07-14 18:11:17 +02:00
## Using GLFW
Documentation work
2016-07-14 18:02:44 +02:00
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
See the [documentation](https://www.glfw.org/docs/latest/) for tutorials, guides
Documentation work
2017-01-29 20:10:53 +01:00
and the API reference.
## Contributing to GLFW
See the [contribution
Move contribution guide to visible directory
2017-11-20 18:55:43 +01:00
guide](https://github.com/glfw/glfw/blob/master/docs/CONTRIBUTING.md) for
Documentation work
2017-01-29 20:10:53 +01:00
more information.
Documentation work
2016-07-14 18:02:44 +02:00
Documentation work [ci skip]
2016-07-14 18:11:17 +02:00
## System requirements
Documentation work
2016-07-14 18:02:44 +02:00
Cocoa: Move slightly towards modern Objective-C
2019-01-03 19:32:45 +01:00
GLFW supports Windows XP and later and macOS 10.8 and later. Linux and other
Documentation work
2017-01-29 20:10:53 +01:00
Unix-like systems running the X Window System are supported even without
a desktop environment or modern extensions, although some features require
a running window or clipboard manager. The OSMesa backend requires Mesa 6.3.
Documentation work
2016-07-14 18:02:44 +02:00
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
See the [compatibility guide](https://www.glfw.org/docs/latest/compat.html)
Documentation work [ci skip]
2016-07-14 18:19:46 +02:00
in the documentation for more information.
Documentation work
2016-07-14 18:02:44 +02:00
Added dependency section to readme.
2014-01-12 05:40:36 +01:00
## Dependencies
Documentation work
2016-08-09 01:34:56 +02:00
GLFW itself depends only on the headers and libraries for your window system.
Add note on extra-cmake-modules dependency The Wayland backend requires this package to generate headers from XML protocol descriptions. Although this package was created by the KDE project, it does not depend on any part of KDE. Fixes #1013. [ci skip]
2017-06-09 16:32:24 +02:00
The (experimental) Wayland backend also depends on the `extra-cmake-modules`
Fix typo (cherry picked from commit 7e03bce1387696918bef4a7022cb5cc3db39e2ea)
2019-12-10 20:10:12 +01:00
package, which is used to generate Wayland protocol headers.
Add note on extra-cmake-modules dependency The Wayland backend requires this package to generate headers from XML protocol descriptions. Although this package was created by the KDE project, it does not depend on any part of KDE. Fixes #1013. [ci skip]
2017-06-09 16:32:24 +02:00
Documentation work [ci skip]
2016-02-08 16:23:44 +01:00
The examples and test programs depend on a number of tiny libraries. These are
located in the `deps/` directory.
Added dependency section to readme.
2014-01-12 05:40:36 +01:00
Clarified dependency list.
2014-06-18 16:13:49 +02:00
- [getopt\_port](https://github.com/kimgr/getopt_port/) for examples
with command-line options
Updated TinyCThread URL.
2014-10-15 03:55:25 +02:00
- [TinyCThread](https://github.com/tinycthread/tinycthread) for threaded
Clarified dependency list.
2014-06-18 16:13:49 +02:00
examples
Replace glad and the Vulkan SDK with glad2 This removes all dependencies from the GLFW test programs on the Vulkan SDK. It also removes support for linking the GLFW shared library (dynamic library, DLL) against the Vulkan loader static library.
2019-04-14 17:34:38 +02:00
- [glad2](https://github.com/Dav1dde/glad) for loading OpenGL and Vulkan
functions
Add linmath.h to readme dependency list
2015-08-09 16:58:25 +02:00
- [linmath.h](https://github.com/datenwolf/linmath.h) for linear algebra in
examples
Update repo URL for Nuklear Fixes #1826. (cherry picked from commit 5d1d1a01e3a05c068289487831940896d9a5902e)
2021-01-03 21:13:02 +01:00
- [Nuklear](https://github.com/Immediate-Mode-UI/Nuklear) for test and example UI
Add stb_image_write
2016-10-13 17:42:44 +02:00
- [stb\_image\_write](https://github.com/nothings/stb) for writing images to disk
Add basic Vulkan support Added GLFW_INCLUDE_VULKAN. Added glfwVulkanSupported, glfwGetRequiredInstanceExtensions, glfwGetInstanceProcAddress, glfwGetPhysicalDevicePresentationSupport and glfwCreateWindowSurface. Added port of LunarG SDK tri example.
2015-08-10 20:19:04 +02:00
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
The documentation is generated with [Doxygen](https://doxygen.org/) if CMake can
Documentation work
2017-07-12 00:21:17 +02:00
find that tool.
Documentation work [ci skip]
2016-02-08 16:23:44 +01:00
Added dependency section to readme.
2014-01-12 05:40:36 +01:00
Documentation work [ci skip]
2016-07-14 18:32:30 +02:00
## Reporting bugs
Bugs are reported to our [issue tracker](https://github.com/glfw/glfw/issues).
Please check the [contribution
Move contribution guide to visible directory
2017-11-20 18:55:43 +01:00
guide](https://github.com/glfw/glfw/blob/master/docs/CONTRIBUTING.md) for
Documentation work [ci skip]
2016-07-14 18:32:30 +02:00
information on what to include when reporting a bug.
Removed more version noise.
2013-06-13 15:09:10 +02:00
## Changelog
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
Wayland: Fix crash if mouse connected after init The cursor theme was only loaded if the chosen seat had a mouse (wl_pointer) during initialization. If a mouse was connected only after glfwInit, there would be no cursor theme but the rest of the cursor related code assumed one had already been loaded. This also moves the details of cursor theme loading out into a separate function to declutter platform init. Because the original cursor theme loading code checked whether we got a wl_shm, and because the rest of the code just assumes we have a wl_shm, initialization will now fail if there isn't one. Fixes #1450 (cherry picked from commit 71be34a6c30825aef502b652c86cc31fdcbb5457)
2022-07-15 13:12:58 +02:00
- [Wayland] Bugfix: Connecting a mouse after `glfwInit` would segfault (#1450)
Update changelog and add credit Related to #2042 Related to #2043 (cherry picked from commit 91a96ed4343944add92bc02619319bb9ae9379fd)
2022-07-15 15:54:35 +02:00
- [Linux] Bugfix: Joysticks without buttons were ignored (#2042,#2043)
EGL: Add support for loading glvnd libOpenGL (cherry picked from commit 55aad3c37b67f17279378db52da0a3ab81bbf26d)
2022-07-27 15:03:16 +02:00
[EGL] Added loading of glvnd `libOpenGL.so.0` where available for OpenGL
GLX: Add support for loading glvnd libGLX (cherry picked from commit c18851f52ec9704eb06464058a600845ec1eada1)
2022-07-27 15:05:23 +02:00
- [GLX] Added loading of glvnd `libGLX.so.0` where available
Fix glfwMaximizeWindow not checking window mode
2016-06-16 12:52:22 +02:00
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
## Contact
Fix some documentation URLs still using http: Some URLs in the documentation were overlooked during the switch to https: for the GLFW website. This updates those and a few third-party URLs. (cherry picked from commit 787295b3aff950abd45bee3495ac1200eb6bc5e1)
2021-06-09 22:43:27 +02:00
On [glfw.org](https://www.glfw.org/) you can find the latest version of GLFW, as
Documentation work
2016-08-02 15:58:58 +02:00
well as news, documentation and other information about the project.
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
If you have questions related to the use of GLFW, we have a
Use HTTPS for Discourse forum (cherry picked from commit 1e20218b3da47691ab5589592f41ce50856f7273)
2019-10-13 16:42:54 +02:00
[forum](https://discourse.glfw.org/), and the `#glfw` IRC channel on
Update IRC network to Libera.Chat The `#glfw` IRC channel is moving to the Libera.Chat network due to the recent takeover of the Freenode network. (cherry picked from commit 78380c7761043b0e4ab1190e3cccbe4d94359aa6)
2021-06-09 22:36:13 +02:00
[Libera.Chat](https://libera.chat/).
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
If you have a bug to report, a patch to submit or a feature you'd like to
Updated contact information.
2013-06-24 14:28:42 +02:00
request, please file it in the
[issue tracker](https://github.com/glfw/glfw/issues) on GitHub.
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
Finally, if you're interested in helping out with the development of GLFW or
Documentation work
2016-08-17 16:48:22 +02:00
porting it to your favorite platform, join us on the forum, GitHub or IRC.
Replaced readme.html with README.md. Removed historic changelog, updated build and use documentation, reformatted contributor list, removed structure table, etc.
2013-02-04 10:46:02 +01:00
Reference in New Issue Copy Permalink