Zengtudor/glfw
1
0
Fork 0
mirror of https://github.com/glfw/glfw.git synced 2024-11-14 06:23:50 +00:00
Code Issues Packages Projects Releases Wiki Activity
c807f386c2
glfw/README.md

201 lines
9.3 KiB
Markdown
Raw Normal View History

Removed version noise.
2013-06-13 13:07:28 +00: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 09:46:02 +00: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 20:21:23 +00: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 13:58:44 +00: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 14:09:55 +00: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 21:47:17 +00: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 09:46:02 +00:00
## Introduction
Documentation work
2016-08-08 23:34:56 +00: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 09:46:02 +00:00
Documentation work
2019-04-15 23:36:49 +00: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 19:28:23 +00:00
Linux both X11 and Wayland are supported.
Documentation work
2017-01-29 19:10:53 +00:00
Documentation work
2016-08-17 14:48:22 +00: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 20:43:27 +00:00
license](https://www.glfw.org/license.html).
Start 3.2.1
2016-06-05 17:35:39 +00: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 20:43:27 +00:00
You can [download](https://www.glfw.org/download.html) the latest stable release
Documentation work
2019-04-15 23:36:49 +00: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 14:48:22 +00: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 20:43:27 +00:00
The [documentation](https://www.glfw.org/docs/latest/) is available online and is
Documentation work
2019-04-15 23:36:49 +00: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 20:43:27 +00:00
history](https://www.glfw.org/changelog.html).
Documentation work
2017-01-29 19:10:53 +00: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 21:42:15 +00:00
Updated readme links to guides.
2013-04-07 11:26:06 +00: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 20:43:27 +00:00
[tutorial](https://www.glfw.org/docs/latest/quick.html) for GLFW 3 useful. If
Documentation work
2017-07-11 22:21:17 +00: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 20:43:27 +00:00
guide](https://www.glfw.org/docs/latest/moving.html) for moving to the GLFW
Documentation work
2017-07-11 22:21:17 +00: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 09:46:02 +00:00
Move list of contributors to separate file Fixes #1839 (cherry picked from commit 53d7622a3a78757d5297ecafa235fac64a62b0a9)
2021-07-19 16:25:50 +00: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 09:46:02 +00:00
Moved GLFW compilation guide to docs.
2013-10-27 11:50:33 +00:00
## Compiling GLFW
Cross-linked build guides.
2013-10-21 20:23:15 +00:00
Documentation work
2019-04-15 23:36:49 +00: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 16:32:30 +00:00
Documentation work [ci skip]
2016-07-14 16:29:39 +00: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-19 22:50:54 +00:00
MinGW-w64, on macOS with Clang and on Linux and other Unix-like systems with GCC
Documentation work [ci skip]
2016-07-14 16:29:39 +00: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 09:46:02 +00: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 20:43:27 +00:00
There are [pre-compiled Windows binaries](https://www.glfw.org/download.html)
Documentation work
2017-07-11 22:21:17 +00: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 09:46:02 +00: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 20:43:27 +00:00
See the [compilation guide](https://www.glfw.org/docs/latest/compile.html) for
Documentation work
2017-07-11 22:21:17 +00: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 09:46:02 +00:00
Documentation work
2016-07-14 16:02:44 +00:00
Documentation work [ci skip]
2016-07-14 16:11:17 +00:00
## Using GLFW
Documentation work
2016-07-14 16:02:44 +00: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 20:43:27 +00:00
See the [documentation](https://www.glfw.org/docs/latest/) for tutorials, guides
Documentation work
2017-01-29 19:10:53 +00:00
and the API reference.
## Contributing to GLFW
See the [contribution
Move contribution guide to visible directory
2017-11-20 17:55:43 +00:00
guide](https://github.com/glfw/glfw/blob/master/docs/CONTRIBUTING.md) for
Documentation work
2017-01-29 19:10:53 +00:00
more information.
Documentation work
2016-07-14 16:02:44 +00:00
Documentation work [ci skip]
2016-07-14 16:11:17 +00:00
## System requirements
Documentation work
2016-07-14 16:02:44 +00:00
Cocoa: Move slightly towards modern Objective-C
2019-01-03 18:32:45 +00:00
GLFW supports Windows XP and later and macOS 10.8 and later. Linux and other
Documentation work
2017-01-29 19:10:53 +00: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 16:02:44 +00: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 20:43:27 +00:00
See the [compatibility guide](https://www.glfw.org/docs/latest/compat.html)
Documentation work [ci skip]
2016-07-14 16:19:46 +00:00
in the documentation for more information.
Documentation work
2016-07-14 16:02:44 +00:00
Added dependency section to readme.
2014-01-12 04:40:36 +00:00
## Dependencies
Documentation work
2016-08-08 23:34:56 +00: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 14:32:24 +00:00
The (experimental) Wayland backend also depends on the `extra-cmake-modules`
Fix typo (cherry picked from commit 7e03bce1387696918bef4a7022cb5cc3db39e2ea)
2019-12-10 19:10:12 +00: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 14:32:24 +00:00
Documentation work [ci skip]
2016-02-08 15:23:44 +00: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 04:40:36 +00:00
Clarified dependency list.
2014-06-18 14:13:49 +00:00
- [getopt\_port](https://github.com/kimgr/getopt_port/) for examples
with command-line options
Updated TinyCThread URL.
2014-10-15 01:55:25 +00:00
- [TinyCThread](https://github.com/tinycthread/tinycthread) for threaded
Clarified dependency list.
2014-06-18 14:13:49 +00: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 15:34:38 +00:00
- [glad2](https://github.com/Dav1dde/glad) for loading OpenGL and Vulkan
functions
Add linmath.h to readme dependency list
2015-08-09 14:58:25 +00: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 20:13:02 +00:00
- [Nuklear](https://github.com/Immediate-Mode-UI/Nuklear) for test and example UI
Add stb_image_write
2016-10-13 15:42:44 +00: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 18:19:04 +00: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 20:43:27 +00:00
The documentation is generated with [Doxygen](https://doxygen.org/) if CMake can
Documentation work
2017-07-11 22:21:17 +00:00
find that tool.
Documentation work [ci skip]
2016-02-08 15:23:44 +00:00
Added dependency section to readme.
2014-01-12 04:40:36 +00:00
Documentation work [ci skip]
2016-07-14 16:32:30 +00: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 17:55:43 +00:00
guide](https://github.com/glfw/glfw/blob/master/docs/CONTRIBUTING.md) for
Documentation work [ci skip]
2016-07-14 16:32:30 +00:00
information on what to include when reporting a bug.
Removed more version noise.
2013-06-13 13:09:10 +00: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 09:46:02 +00:00
Add support for GLFW_NATIVE_INCLUDE_NONE macro By default, the glfw3native.h header will include the platform-specific headers necessary for the return types of GLFW native access functions. Sometimes it is preferrable to declare those types This commit adds support for the GLFW_NATIVE_INCLUDE_NONE macro, which when defined disables the inclusion of all platform-specific headers. Fixes #1348 (cherry picked from commit 05f6c13d119ea2662c97527d2421fb4cffd3dbfc)
2022-04-18 21:09:47 +00:00
- Added `GLFW_NATIVE_INCLUDE_NONE` for disabling inclusion of native headers (#1348)
Fix glfwMakeContextCurrent using uninitialized TLS Issue reported by danhambleton on the GLFW forum: https://discourse.glfw.org/t/posix-thread-local-storage-tls-error-when-making-context-current/2034 (cherry picked from commit f843d533335db275e0b014311cd7163a2a003b03)
2022-04-08 16:22:39 +00:00
- Bugfix: `glfwMakeContextCurrent` would access TLS slot before initialization
Fix order of error checks in glfwSetGammaRamp Initialization should be checked before arguments. (cherry picked from commit 29523dbfbfe097bec9ae3a5ec08b08915e1e4a59)
2022-04-21 13:37:31 +00:00
- Bugfix: `glfwSetGammaRamp` could emit `GLFW_INVALID_VALUE` before initialization
Fix joystick user pointer NULL during disconnect The joystick code did not distinguish between the allocation status of the GLFW joystick object and whether it is connection to an OS level joystick object. These are now tracked separately. Fixes #2092 This is adapted to 3.3-stable from 2c204ab52ecaa51bfd32b777aef715dae937f009 and fd7e737216dfdcecd4522b7d8c8dd2439d3dac3b.
2022-05-05 20:23:12 +00:00
- Bugfix: `glfwGetJoystickUserPointer` returned `NULL` during disconnection (#2092)
Win32: Fix scancode and key for Alt+PrtSc events Alt+PrtSc emits a different scancode than just PrtSc. Since the GLFW API assumes each key corresponds to only one scancode, this cannot be added to the keycodes array. Instead we replace the scancode at the point of entry. Fixes #1993 (cherry picked from commit 03cfe957e739e41cdfd66b554c076b5b31f48c1e)
2022-03-15 18:12:29 +00:00
- [Win32] Bugfix: `Alt+PrtSc` would emit `GLFW_KEY_UNKNOWN` and a different
scancode than `PrtSc` (#1993)
Win32: Fix glfwGetKeyScancode for GLFW_KEY_PAUSE The bug described in 03cfe957e739e41cdfd66b554c076b5b31f48c1e was already present for another key where modifiers changes its scancode. Related to #1993 (cherry picked from commit 8d9231fe5ec82c3a0a7bddfcd3a409759a7a45d8)
2022-03-15 18:22:21 +00:00
- [Win32] Bugfix: `GLFW_KEY_PAUSE` scancode from `glfwGetKeyScancode` did not
match event scancode (#1993)
Win32: Fix using executable instance and not ours Operations that take an instance handle should be passed the handle of whatever module we are inside instead of blindly passing the handle of the executable. This commit makes GLFW retrieve its own instance on initialization. This makes the most difference for window classes, which are per-instance. Using the executable instance led to name conflicts if there were several copies of GLFW in a single process. Note that having this is still a bad idea unless you know what things to avoid, and those things are mostly platform-specific. This is partly because the library wasn't designed for it and partly because it needs to save, update and restore various per-process and per-session settings like current context and video mode. However, multiple simultaneous copies of GLFW in a single Win32 process should now at least initialize, like is already the case on other platforms. Fixes #469 Fixes #1296 Fixes #1395 Related to #927 Related to #1885 (cherry picked from commit 07a5518c3e42f4412a5d9fa8620950d8f5041e28)
2022-03-17 22:54:39 +00:00
- [Win32] Bugfix: Instance-local operations used executable instance (#469,#1296,#1395)
Win32: Fix OSMesa library not being unloaded (cherry picked from commit 10e9033a29ba088275da4363cd2d821ca577416a)
2022-04-28 19:12:36 +00:00
- [Win32] Bugfix: The OSMesa library was not unloaded on termination
Cocoa: Fix AirPlay causing harmless init error Emitting an error for one specific type of failure in retrieving the correct name for a display is not very useful, especially when initialization is otherwise unaffected. There should be a path for information like that but this isn't it. Fixes #1791 (cherry picked from commit 955fbd9d265fa95adf9cb94896eb9a516aa50420)
2022-03-17 23:31:34 +00:00
- [Cocoa] Bugfix: A connected Apple AirPlay would emit a useless error (#1791)
Cocoa: Fix EGL and OSMesa not being unloaded (cherry picked from commit 89514cf0fc33aed4db1310a57cc7436999492d14)
2022-04-28 19:14:11 +00:00
- [Cocoa] Bugfix: The EGL and OSMesa libraries were not unloaded on termination
X11: Fix OSMesa library not being unloaded (cherry picked from commit a8d8b760fb6bffb9c7f65297a0bc3d6bf6b54262)
2022-04-28 19:17:39 +00:00
- [X11] Bugfix: The OSMesa libray was not unloaded on termination
X11: Fix segfault on malformed INCR response The code assumed that at least some data would be received via the INCR mechanism and that, as a result, the string buffer would be allocated. Bug found by Clang static analysis. (cherry picked from commit 23e6e8e4b7ffe8f7604bd4f6ad1b183d0927bfe2)
2022-04-18 21:22:25 +00:00
- [X11] Bugfix: A malformed response during selection transfer could cause a segfault
X11: Fix previous error handler not being restored GLFW did not restore the previous Xlib error handler when removing its own, instead resetting to the default handler. This commit saves and restores the previous error handler. None of this is thread-safe or could ever be. Fixes #2108 (cherry picked from commit 26920a1a38d7c4c5b7908cf2e04b750d941f1faa)
2022-05-25 17:43:55 +00:00
- [X11] Bugfix: Some calls would reset Xlib to the default error handler (#2108)
Wayland: Add support for file drop events This adds support for file path drop events in text/uri-list format. It is based on work by Pilzschaf in #2040. Closes #2040 (cherry picked from commit 4cb36872a5fe448c205d0b46f0e8c8b57530cfe0)
2022-03-31 17:56:48 +00:00
- [Wayland] Added support for file path drop events (#2040)
Wayland: Add support for wl_output::name We now use wl_output::name as the GLFW monitor name, on compositors that provide this event. (cherry picked from commit 209f6cf0935412e067e6595790cf3d3d5866923d)
2022-06-14 16:20:56 +00:00
- [Wayland] Added support for more human-readable monitor names where available
Wayland: Remove support for wl_shell This is adapted to 3.3-stable from 599fb3de348f73134b4e9d2ee5cabc62ca0b84ab and 27295b508ffd098de8673bfe5f7f4154235cb1cc.
2022-07-12 13:24:52 +00:00
- [Wayland] Removed support for the deprecated wl\_shell protocol
Wayland: Fix handling of clipboard set to self Passing any part of the result of glfwGetClipboardString to glfwSetClipboardString would result in, at best, a use-after-free error. (cherry picked from commit 9c95cfb9f1cdf073856e5b479447f5fca6492cd9)
2022-03-22 17:46:57 +00:00
- [Wayland] Bugfix: `glfwSetClipboardString` would fail if set to result of
`glfwGetClipboardString`
Wayland: Fix double free on data source error If data source creation fails, the string containing the data for it would be freed a second time during termination. (cherry picked from commit b386371f57ba45e6ef15d16e994c6fbe71437427)
2022-03-22 17:55:31 +00:00
- [Wayland] Bugfix: Data source creation error would cause double free at termination
Wayland: Fix partial writes of clipboard string The string pointer used to write the contents of our clipboard data offer was never updated, causing it to repeat parts of the beginning of the string until the correct number of bytes had been written. (cherry picked from commit 4c110bba41b0df8a3b295fdd5e4e95aed6615001)
2022-03-22 18:23:25 +00:00
- [Wayland] Bugfix: Partial writes of clipboard string would cause beginning to repeat
Wayland: Fix error paths not closing sending fd Whatever error happens on our end, we should still close the fd so the other end can move on. (cherry picked from commit 990dc4b3888bbaffdc7c3da65ab6c2f8d24285d4)
2022-03-23 19:08:12 +00:00
- [Wayland] Bugfix: Some errors would cause clipboard string transfer to hang
Wayland: Improve handling of pending data offers The code assumed that all data offers were selections that supported plaintext UTF-8. The initial data offer events are now handled almost tolerably. Only selection data offers are used for clipboard string and only if they provide plaintext UTF-8. Drag and drop data offers are now rejected as soon as they enter a surface. Related to #2040 (cherry picked from commit 8d87be1268869af69d59400a1b0403e9ecbc5c0c)
2022-03-23 18:58:33 +00:00
- [Wayland] Bugfix: Drag and drop data was misinterpreted as clipboard string
- [Wayland] Bugfix: MIME type matching was not performed for clipboard string
Wayland: Fix OSMesa library not being unloaded (cherry picked from commit 2d281d7928552c15ea2bc6dd185f7d7a780b1917)
2022-04-28 19:16:06 +00:00
- [Wayland] Bugfix: The OSMesa library was not unloaded on termination
Move last bits of window setup to platform code This avoids glfwCreateWindow emitting GLFW_PLATFORM_ERROR on Wayland because shared code was calling unimplemented or unavailable platform functions during final setup. It also makes it consistent with the final setup of full screen windows. This is adapted to 3.3-stable from 09653b8c5490ebb605933537e897587c9129f159.
2022-04-06 19:13:48 +00:00
- [Wayland] Bugfix: `glfwCreateWindow` could emit `GLFW_PLATFORM_ERROR`
Wayland: Fix missing lock key modifier bits The modifier bits for lock keys were only set when the corresponding key was reported as held down or latched, but not when it was released and locked. (cherry picked from commit e9c58bc1815656403b736000469f2ae5d2f0303a)
2022-06-08 17:14:13 +00:00
- [Wayland] Bugfix: Lock key modifier bits were only set when lock keys were pressed
Wayland: Fix behavior of leaving full screen mode These changes make GLFW fullscreen more consistent, but unfortunately also make GLFW even more oblivious to user-initiated XDG shell fullscreen changes. Fixes #1995 (cherry picked from commit ddd087d6627d19655d78196b5836c1d090b59506)
2022-06-09 19:31:44 +00:00
- [Wayland] Bugfix: A window leaving full screen mode would be iconified (#1995)
- [Wayland] Bugfix: A window leaving full screen mode ignored its desired size
- [Wayland] Bugfix: `glfwSetWindowMonitor` did not update windowed mode size
- [Wayland] Bugfix: `glfwRestoreWindow` would make a full screen window windowed
Wayland: Fix maximization by user being ignored The internal maximization state was not updated when an event was received that the user had changed the maximization state of a window, and no maximization events were emitted. This affected both the GLFW_MAXIMIZED attribute and glfwRestoreWindow. (cherry picked from commit f39ffefb6a754677305efab556216f99f90c778a)
2022-06-10 11:29:24 +00:00
- [Wayland] Bugfix: A window maximized or restored by the user would enter an
inconsistent state
- [Wayland] Bugfix: Window maximization events were not emitted
Wayland: Fix missing fullscreen code path glfwRestoreWindow assumed it was only called in windowed mode. (cherry picked from commit fdc72edf8177f74b9565094559ebd0a717af93a0)
2022-06-19 16:30:03 +00:00
- [Wayland] Bugfix: `glfwRestoreWindow` assumed it was always in windowed mode
Wayland: Fix glfwSetWindowSize resizing fs windows glfwSetWindowSize would change the size of fullscreen mode windows as if they were windowed mode. (cherry picked from commit 6857995498d6628b3052b547ecd7cdecfee342d6)
2022-06-10 12:10:25 +00:00
- [Wayland] Bugfix: `glfwSetWindowSize` would resize a full screen window
Wayland: Fix duplicate window content scale events The window content scale event was emitted every time the window content area was resized, even if its scale had not changed. (cherry picked from commit 0b76e3a6f158549b96d1ae3424f094c63177b2ce)
2022-06-10 12:19:13 +00:00
- [Wayland] Bugfix: A window content scale event would be emitted every time
the window resized
Wayland: Fix glfwInit closing stdin on failure If platform initialization failed before either timer fd member had been set to -1 or a valid fd, termination would close stdin. (cherry picked from commit 3bbb41eacc294d3030303eabfd16f66d452e9a72)
2022-06-10 13:45:07 +00:00
- [Wayland] Bugfix: If `glfwInit` failed it would close stdin
Wayland: Fix erratic fallback decoration behavior The handler for xdg_toplevel::configure treated the provided size as the content area size when instead it is the size of the bounding rectangle of the wl_surface and all its subsurfaces. This caused the fallback decorations to try positioning themselves outside themselves, causing feedback loops during interactive resizing. Fixes #1991 Fixes #2115 Closes #2127 Related to #1914 (cherry picked from commit 0f5b095042842006747f8dc04aded64ea3e05d2a)
2022-06-15 23:36:55 +00:00
- [Wayland] Bugfix: Manual resizing with fallback decorations behaved erratically
(#1991,#2115,#2127)
Wayland: Fix size limits for fallback decorations The size limits set on our XDG surface did not include the sizes of the fallback decorations on all sides, when in use. This led to its content area being too small. Related to #2127 (cherry picked from commit a7b6f355008237c28faad86c2188cc5f132aec64)
2022-06-12 19:36:26 +00:00
- [Wayland] Bugfix: Size limits included frame size for fallback decorations
Wayland: Fix toggling of server-side decorations This is a temporary local fix to have updates to GLFW_DECORATED mostly work as intended. The whole decoration state machine needs to be restructured, but not by this commit. (cherry picked from commit 229d628ec47073c3778ba2e37c02c8d94140be77)
2022-06-13 17:37:34 +00:00
- [Wayland] Bugfix: Updating `GLFW_DECORATED` had no effect on server-side
decorations
Wayland: Fix duplicate monitor connection events GLFW would report a monitor as connected each time its wl_output received an update, for example if its scale changed. This would also cause the monitor to be added to the monitor array again, causing glfwTerminate to segfault when it attempted to destroy its already destroyed wl_output. (cherry picked from commit c3ad3d49ed8b436582a6fbba1c3e64f97087e362)
2022-06-14 16:44:24 +00:00
- [Wayland] Bugfix: A monitor would be reported as connected again if its scale
changed
- [Wayland] Bugfix: `glfwTerminate` would segfault if any monitor had changed
scale
Wayland: Fix reporting of monitor scale changes Content scale events would be emitted when a window surface entered or left an output, but not when one of a window's current outputs had its scale changed. (cherry picked from commit e37ba80b1343f46d1b380fd3b9816e1260d8ee0a)
2022-06-14 16:46:47 +00:00
- [Wayland] Bugfix: Window content scale events were not emitted when monitor
scale changed
Wayland: Fix error from glfwSetWindowAspectRatio The aspect ratio was applied during resize but any call to glfwSetWindowAspectRatio emitted a GLFW_FEATURE_UNIMPLEMENTED error. (cherry picked from commit 91f18fb57697c57bf9da64ad546eed5c60518618)
2022-06-14 18:37:31 +00:00
- [Wayland] Bugfix: `glfwSetWindowAspectRatio` reported an error instead of
applying the specified ratio
Wayland: Fix maximized state lost while hidden If a window was created as maximized, or created as hidden and then iconified or maximized before first being shown, that state was lost and the window was shown as restored. (cherry picked from commit 77819c0c549fa9c1aa40ff74289bd7cfae61f296)
2022-06-15 16:20:16 +00:00
- [Wayland] Bugfix: `GLFW_MAXIMIZED` window hint had no effect
- [Wayland] Bugfix: `glfwRestoreWindow` had no effect before first show
Wayland: Fix mapping failure on wlroots compositor When showing a window that had already been shown once (and so already had its shell objects), GLFW would attach a new buffer and commit it before waiting for the next configure event. This was a violation of the XDG shell protocol. This was allowed to work as intended on GNOME and KDE without error. However wlroots based compositors would (correctly) emit an error. Unfortunately, I haven't been able to find a way to get both KDE, GNOME and Sway to send the configure event we need in order to map the wl_surface again while keeping our existing shell objects, so with this commit we now create them for each call to glfwShowWindow and destroy them for each call to glfwHideWindow. Fixes #1268 (cherry picked from commit 83a134a92fa8642fe50c6e9b2400044e442d038a)
2022-06-19 22:43:24 +00:00
- [Wayland] Bugfix: Hiding and then showing a window caused program abort on
wlroots compositors (#1268)
Fix glfwMaximizeWindow not checking window mode
2016-06-16 10:52:22 +00: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 09:46:02 +00: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 20:43:27 +00:00
On [glfw.org](https://www.glfw.org/) you can find the latest version of GLFW, as
Documentation work
2016-08-02 13:58:58 +00: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 09:46:02 +00: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 14:42:54 +00: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 20:36:13 +00: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 09:46:02 +00: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 12:28:42 +00: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 09:46:02 +00:00
Finally, if you're interested in helping out with the development of GLFW or
Documentation work
2016-08-17 14:48:22 +00: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 09:46:02 +00:00
Reference in New Issue Copy Permalink