2013-06-13 13:07:28 +00:00
|
|
|
# GLFW
|
2013-02-04 09:46:02 +00:00
|
|
|
|
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)
|
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)
|
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)
|
2015-04-14 21:47:17 +00:00
|
|
|
|
2013-02-04 09:46:02 +00:00
|
|
|
## Introduction
|
|
|
|
|
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.
|
2013-02-04 09:46:02 +00:00
|
|
|
|
2019-04-15 23:36:49 +00:00
|
|
|
GLFW natively supports Windows, macOS and Linux and other Unix-like systems. On
|
2019-08-28 19:28:23 +00:00
|
|
|
Linux both X11 and Wayland are supported.
|
2017-01-29 19:10:53 +00:00
|
|
|
|
2016-08-17 14:48:22 +00:00
|
|
|
GLFW is licensed under the [zlib/libpng
|
2021-06-09 20:43:27 +00:00
|
|
|
license](https://www.glfw.org/license.html).
|
2016-06-05 17:35:39 +00:00
|
|
|
|
2021-06-09 20:43:27 +00:00
|
|
|
You can [download](https://www.glfw.org/download.html) the latest stable release
|
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
|
2016-08-17 14:48:22 +00:00
|
|
|
tag](https://github.com/glfw/glfw/releases) with source and binary archives.
|
|
|
|
|
2021-06-09 20:43:27 +00:00
|
|
|
The [documentation](https://www.glfw.org/docs/latest/) is available online and is
|
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
|
2021-06-09 20:43:27 +00:00
|
|
|
history](https://www.glfw.org/changelog.html).
|
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.
|
2016-08-18 21:42:15 +00:00
|
|
|
|
2013-04-07 11:26:06 +00:00
|
|
|
If you are new to GLFW, you may find the
|
2021-06-09 20:43:27 +00:00
|
|
|
[tutorial](https://www.glfw.org/docs/latest/quick.html) for GLFW 3 useful. If
|
2017-07-11 22:21:17 +00:00
|
|
|
you have used GLFW 2 in the past, there is a [transition
|
2021-06-09 20:43:27 +00:00
|
|
|
guide](https://www.glfw.org/docs/latest/moving.html) for moving to the GLFW
|
2017-07-11 22:21:17 +00:00
|
|
|
3 API.
|
2013-02-04 09:46:02 +00:00
|
|
|
|
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.
|
|
|
|
|
2013-02-04 09:46:02 +00:00
|
|
|
|
2013-10-27 11:50:33 +00:00
|
|
|
## Compiling GLFW
|
2013-10-21 20:23:15 +00:00
|
|
|
|
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.
|
2016-07-14 16:32:30 +00:00
|
|
|
|
2016-07-14 16:29:39 +00:00
|
|
|
GLFW supports compilation on Windows with Visual C++ 2010 and later, MinGW and
|
2016-10-19 22:50:54 +00:00
|
|
|
MinGW-w64, on macOS with Clang and on Linux and other Unix-like systems with GCC
|
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.
|
2013-02-04 09:46:02 +00:00
|
|
|
|
2021-06-09 20:43:27 +00:00
|
|
|
There are [pre-compiled Windows binaries](https://www.glfw.org/download.html)
|
2017-07-11 22:21:17 +00:00
|
|
|
available for all supported compilers.
|
2013-02-04 09:46:02 +00:00
|
|
|
|
2021-06-09 20:43:27 +00:00
|
|
|
See the [compilation guide](https://www.glfw.org/docs/latest/compile.html) for
|
2017-07-11 22:21:17 +00:00
|
|
|
more information about how to compile GLFW yourself.
|
2013-02-04 09:46:02 +00:00
|
|
|
|
2016-07-14 16:02:44 +00:00
|
|
|
|
2016-07-14 16:11:17 +00:00
|
|
|
## Using GLFW
|
2016-07-14 16:02:44 +00:00
|
|
|
|
2021-06-09 20:43:27 +00:00
|
|
|
See the [documentation](https://www.glfw.org/docs/latest/) for tutorials, guides
|
2017-01-29 19:10:53 +00:00
|
|
|
and the API reference.
|
|
|
|
|
|
|
|
|
|
|
|
## Contributing to GLFW
|
|
|
|
|
|
|
|
See the [contribution
|
2017-11-20 17:55:43 +00:00
|
|
|
guide](https://github.com/glfw/glfw/blob/master/docs/CONTRIBUTING.md) for
|
2017-01-29 19:10:53 +00:00
|
|
|
more information.
|
2016-07-14 16:02:44 +00:00
|
|
|
|
|
|
|
|
2016-07-14 16:11:17 +00:00
|
|
|
## System requirements
|
2016-07-14 16:02:44 +00:00
|
|
|
|
2024-01-15 18:28:25 +00:00
|
|
|
GLFW is written in C99 and does not support Visual Studio 2012 or earlier.
|
|
|
|
|
2019-01-03 18:32:45 +00:00
|
|
|
GLFW supports Windows XP and later and macOS 10.8 and later. Linux and other
|
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.
|
2016-07-14 16:02:44 +00:00
|
|
|
|
2021-06-09 20:43:27 +00:00
|
|
|
See the [compatibility guide](https://www.glfw.org/docs/latest/compat.html)
|
2016-07-14 16:19:46 +00:00
|
|
|
in the documentation for more information.
|
2016-07-14 16:02:44 +00:00
|
|
|
|
|
|
|
|
2014-01-12 04:40:36 +00:00
|
|
|
## Dependencies
|
|
|
|
|
2019-11-26 17:09:22 +00:00
|
|
|
GLFW itself needs only CMake 3.1 or later and the headers and libraries for your
|
|
|
|
OS and window system.
|
2016-08-08 23:34:56 +00:00
|
|
|
|
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.
|
2014-01-12 04:40:36 +00:00
|
|
|
|
2014-06-18 14:13:49 +00:00
|
|
|
- [getopt\_port](https://github.com/kimgr/getopt_port/) for examples
|
|
|
|
with command-line options
|
2014-10-15 01:55:25 +00:00
|
|
|
- [TinyCThread](https://github.com/tinycthread/tinycthread) for threaded
|
2014-06-18 14:13:49 +00:00
|
|
|
examples
|
2019-04-14 15:34:38 +00:00
|
|
|
- [glad2](https://github.com/Dav1dde/glad) for loading OpenGL and Vulkan
|
|
|
|
functions
|
2015-08-09 14:58:25 +00:00
|
|
|
- [linmath.h](https://github.com/datenwolf/linmath.h) for linear algebra in
|
|
|
|
examples
|
2021-01-03 20:13:02 +00:00
|
|
|
- [Nuklear](https://github.com/Immediate-Mode-UI/Nuklear) for test and example UI
|
2016-10-13 15:42:44 +00:00
|
|
|
- [stb\_image\_write](https://github.com/nothings/stb) for writing images to disk
|
2015-08-10 18:19:04 +00:00
|
|
|
|
2021-06-09 20:43:27 +00:00
|
|
|
The documentation is generated with [Doxygen](https://doxygen.org/) if CMake can
|
2017-07-11 22:21:17 +00:00
|
|
|
find that tool.
|
2016-02-08 15:23:44 +00:00
|
|
|
|
2014-01-12 04:40:36 +00:00
|
|
|
|
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
|
2017-11-20 17:55:43 +00:00
|
|
|
guide](https://github.com/glfw/glfw/blob/master/docs/CONTRIBUTING.md) for
|
2016-07-14 16:32:30 +00:00
|
|
|
information on what to include when reporting a bug.
|
|
|
|
|
|
|
|
|
2013-06-13 13:09:10 +00:00
|
|
|
## Changelog
|
2013-02-04 09:46:02 +00:00
|
|
|
|
2022-03-31 15:49:50 +00:00
|
|
|
|
2021-03-23 12:53:17 +00:00
|
|
|
- Added OpenGL and OpenGL ES user contexts for multiple window contexts via
|
|
|
|
`GLFWusercontext`, `glfwCreateUserContext`, `glfwDestroyUserContext`,
|
2022-03-31 15:49:50 +00:00
|
|
|
`glfwMakeUserContextCurrent`, `glfwGetCurrentUserContext` (#1687)
|
2021-07-13 19:50:09 +00:00
|
|
|
- Added `GLFW_PLATFORM` init hint for runtime platform selection (#1958)
|
|
|
|
- Added `GLFW_ANY_PLATFORM`, `GLFW_PLATFORM_WIN32`, `GLFW_PLATFORM_COCOA`,
|
|
|
|
`GLFW_PLATFORM_WAYLAND`, `GLFW_PLATFORM_X11` and `GLFW_PLATFORM_NULL` symbols to
|
|
|
|
specify the desired platform (#1958)
|
|
|
|
- Added `glfwGetPlatform` function to query what platform was selected (#1655,#1958)
|
|
|
|
- Added `glfwPlatformSupported` function to query if a platform is supported
|
|
|
|
(#1655,#1958)
|
2021-08-03 18:53:48 +00:00
|
|
|
- Added `glfwInitAllocator` for setting a custom memory allocator (#544,#1628,#1947)
|
|
|
|
- Added `GLFWallocator` struct and `GLFWallocatefun`, `GLFWreallocatefun` and
|
|
|
|
`GLFWdeallocatefun` types (#544,#1628,#1947)
|
2021-10-21 18:45:44 +00:00
|
|
|
- Added `glfwInitVulkanLoader` for using a non-default Vulkan loader (#1374,#1890)
|
2019-05-07 18:40:37 +00:00
|
|
|
- Added `GLFW_RESIZE_NWSE_CURSOR`, `GLFW_RESIZE_NESW_CURSOR`,
|
|
|
|
`GLFW_RESIZE_ALL_CURSOR` and `GLFW_NOT_ALLOWED_CURSOR` cursor shapes (#427)
|
|
|
|
- Added `GLFW_RESIZE_EW_CURSOR` alias for `GLFW_HRESIZE_CURSOR` (#427)
|
|
|
|
- Added `GLFW_RESIZE_NS_CURSOR` alias for `GLFW_VRESIZE_CURSOR` (#427)
|
|
|
|
- Added `GLFW_POINTING_HAND_CURSOR` alias for `GLFW_HAND_CURSOR` (#427)
|
2020-07-08 21:21:28 +00:00
|
|
|
- Added `GLFW_MOUSE_PASSTHROUGH` window hint for letting mouse input pass
|
|
|
|
through the window (#1236,#1568)
|
2019-12-03 16:58:20 +00:00
|
|
|
- Added `GLFW_CURSOR_CAPTURED` cursor mode to confine the cursor to the window
|
|
|
|
content area (#58)
|
2021-10-26 12:25:03 +00:00
|
|
|
- Added `GLFW_POSITION_X` and `GLFW_POSITION_Y` window hints for initial position
|
|
|
|
(#1603,#1747)
|
|
|
|
- Added `GLFW_ANY_POSITION` hint value for letting the window manager choose (#1603,#1747)
|
2021-07-13 19:50:09 +00:00
|
|
|
- Added `GLFW_PLATFORM_UNAVAILABLE` error for platform detection failures (#1958)
|
2020-05-20 16:02:58 +00:00
|
|
|
- Added `GLFW_FEATURE_UNAVAILABLE` error for platform limitations (#1692)
|
|
|
|
- Added `GLFW_FEATURE_UNIMPLEMENTED` error for incomplete backends (#1692)
|
2022-05-27 00:33:28 +00:00
|
|
|
- Added `GLFW_WAYLAND_APP_ID` window hint string for Wayland app\_id selection
|
|
|
|
(#2121,#2122)
|
2020-06-25 16:22:08 +00:00
|
|
|
- Added `GLFW_ANGLE_PLATFORM_TYPE` init hint and `GLFW_ANGLE_PLATFORM_TYPE_*`
|
|
|
|
values to select ANGLE backend (#1380)
|
2020-12-09 23:11:44 +00:00
|
|
|
- Added `GLFW_X11_XCB_VULKAN_SURFACE` init hint for selecting X11 Vulkan
|
|
|
|
surface extension (#1793)
|
2022-04-18 21:09:47 +00:00
|
|
|
- Added `GLFW_NATIVE_INCLUDE_NONE` for disabling inclusion of native headers (#1348)
|
2021-07-13 19:50:09 +00:00
|
|
|
- Added `GLFW_BUILD_WIN32` CMake option for enabling Win32 support (#1958)
|
|
|
|
- Added `GLFW_BUILD_COCOA` CMake option for enabling Cocoa support (#1958)
|
|
|
|
- Added `GLFW_BUILD_X11` CMake option for enabling X11 support (#1958)
|
2021-07-06 21:12:05 +00:00
|
|
|
- Added `GLFW_LIBRARY_TYPE` CMake variable for overriding the library type
|
|
|
|
(#279,#1307,#1497,#1574,#1928)
|
2021-07-30 11:19:46 +00:00
|
|
|
- Added `GLFW_PKG_CONFIG_REQUIRES_PRIVATE` and `GLFW_PKG_CONFIG_LIBS_PRIVATE` CMake
|
|
|
|
variables exposing pkg-config dependencies (#1307)
|
2020-07-12 16:31:29 +00:00
|
|
|
- Made joystick subsystem initialize at first use (#1284,#1646)
|
2021-05-13 19:38:46 +00:00
|
|
|
- Made `GLFW_DOUBLEBUFFER` a read-only window attribute
|
2019-11-26 17:09:22 +00:00
|
|
|
- Updated the minimum required CMake version to 3.1
|
2021-10-28 09:48:34 +00:00
|
|
|
- Updated gamepad mappings from upstream
|
2019-05-08 17:04:21 +00:00
|
|
|
- Disabled tests and examples by default when built as a CMake subdirectory
|
2021-07-13 19:50:09 +00:00
|
|
|
- Renamed `GLFW_USE_WAYLAND` CMake option to `GLFW_BUILD_WAYLAND` (#1958)
|
|
|
|
- Removed `GLFW_USE_OSMESA` CMake option enabling the Null platform (#1958)
|
2021-04-15 13:33:19 +00:00
|
|
|
- Removed CMake generated configuration header
|
2019-05-02 19:32:14 +00:00
|
|
|
- Bugfix: The CMake config-file package used an absolute path and was not
|
|
|
|
relocatable (#1470)
|
2019-09-01 18:05:58 +00:00
|
|
|
- Bugfix: Video modes with a duplicate screen area were discarded (#1555,#1556)
|
2019-10-16 15:43:29 +00:00
|
|
|
- Bugfix: Compiling with -Wextra-semi caused warnings (#1440)
|
2020-01-01 00:42:25 +00:00
|
|
|
- Bugfix: Built-in mappings failed because some OEMs re-used VID/PID (#1583)
|
2020-05-28 15:38:21 +00:00
|
|
|
- Bugfix: Some extension loader headers did not prevent default OpenGL header
|
|
|
|
inclusion (#1695)
|
2021-05-13 19:41:51 +00:00
|
|
|
- Bugfix: Buffers were swapped at creation on single-buffered windows (#1873)
|
2021-06-25 17:49:38 +00:00
|
|
|
- Bugfix: Gamepad mapping updates could spam `GLFW_INVALID_VALUE` due to
|
|
|
|
incompatible controllers sharing hardware ID (#1763)
|
2021-10-04 18:32:32 +00:00
|
|
|
- Bugfix: Native access functions for context handles did not check that the API matched
|
2022-04-08 16:22:39 +00:00
|
|
|
- Bugfix: `glfwMakeContextCurrent` would access TLS slot before initialization
|
2022-04-21 13:37:31 +00:00
|
|
|
- Bugfix: `glfwSetGammaRamp` could emit `GLFW_INVALID_VALUE` before initialization
|
2022-05-05 20:23:12 +00:00
|
|
|
- Bugfix: `glfwGetJoystickUserPointer` returned `NULL` during disconnection (#2092)
|
2023-12-01 12:22:11 +00:00
|
|
|
- Bugfix: `glfwGetKeyScancode` returned `0` on error when initialized instead of `-1`
|
2023-12-06 16:02:24 +00:00
|
|
|
- Bugfix: Failure to make a newly created context current could cause segfault (#2327)
|
2019-08-20 17:00:59 +00:00
|
|
|
- [Win32] Added the `GLFW_WIN32_KEYBOARD_MENU` window hint for enabling access
|
|
|
|
to the window menu
|
2019-12-11 18:09:59 +00:00
|
|
|
- [Win32] Added a version info resource to the GLFW DLL
|
2022-03-27 17:40:35 +00:00
|
|
|
- [Win32] Made hidden helper window use its own window class
|
2020-07-27 22:12:45 +00:00
|
|
|
- [Win32] Disabled framebuffer transparency on Windows 7 when DWM windows are
|
|
|
|
opaque (#1512)
|
2019-07-12 12:23:12 +00:00
|
|
|
- [Win32] Bugfix: `GLFW_INCLUDE_VULKAN` plus `VK_USE_PLATFORM_WIN32_KHR` caused
|
|
|
|
symbol redefinition (#1524)
|
2019-07-12 17:04:16 +00:00
|
|
|
- [Win32] Bugfix: The cursor position event was emitted before its cursor enter
|
|
|
|
event (#1490)
|
2019-08-13 13:18:02 +00:00
|
|
|
- [Win32] Bugfix: The window hint `GLFW_MAXIMIZED` did not move or resize the
|
|
|
|
window (#1499)
|
2020-01-01 00:42:25 +00:00
|
|
|
- [Win32] Bugfix: Disabled cursor mode interfered with some non-client actions
|
2020-01-15 15:19:56 +00:00
|
|
|
- [Win32] Bugfix: Super key was not released after Win+V hotkey (#1622)
|
2020-01-15 15:34:58 +00:00
|
|
|
- [Win32] Bugfix: `glfwGetKeyName` could access out of bounds and return an
|
|
|
|
invalid pointer
|
2020-01-15 17:54:42 +00:00
|
|
|
- [Win32] Bugfix: Some synthetic key events were reported as `GLFW_KEY_UNKNOWN`
|
|
|
|
(#1623)
|
2020-06-29 18:43:28 +00:00
|
|
|
- [Win32] Bugfix: Non-BMP Unicode codepoint input was reported as UTF-16
|
2020-09-23 21:34:42 +00:00
|
|
|
- [Win32] Bugfix: Monitor functions could return invalid values after
|
|
|
|
configuration change (#1761)
|
2020-09-29 18:16:59 +00:00
|
|
|
- [Win32] Bugfix: Initialization would segfault on Windows 8 (not 8.1) (#1775)
|
2020-10-07 21:35:17 +00:00
|
|
|
- [Win32] Bugfix: Duplicate size events were not filtered (#1610)
|
2021-01-19 21:25:05 +00:00
|
|
|
- [Win32] Bugfix: Full screen windows were incorrectly resized by DPI changes
|
|
|
|
(#1582)
|
2021-01-20 00:02:24 +00:00
|
|
|
- [Win32] Bugfix: `GLFW_SCALE_TO_MONITOR` had no effect on systems older than
|
|
|
|
Windows 10 version 1703 (#1511)
|
2020-10-12 21:47:35 +00:00
|
|
|
- [Win32] Bugfix: `USE_MSVC_RUNTIME_LIBRARY_DLL` had no effect on CMake 3.15 or
|
|
|
|
later (#1783,#1796)
|
2021-04-12 18:56:53 +00:00
|
|
|
- [Win32] Bugfix: Compilation with LLVM for Windows failed (#1807,#1824,#1874)
|
2021-08-02 19:42:36 +00:00
|
|
|
- [Win32] Bugfix: The foreground lock timeout was overridden, ignoring the user
|
2021-12-01 16:55:16 +00:00
|
|
|
- [Win32] Bugfix: Content scale queries could fail silently (#1615)
|
|
|
|
- [Win32] Bugfix: Content scales could have garbage values if monitor was recently
|
|
|
|
disconnected (#1615)
|
2022-03-07 17:14:16 +00:00
|
|
|
- [Win32] Bugfix: A window created maximized and undecorated would cover the whole
|
|
|
|
monitor (#1806)
|
2022-03-07 18:19:31 +00:00
|
|
|
- [Win32] Bugfix: The default restored window position was lost when creating a maximized
|
|
|
|
window
|
2022-03-08 22:00:47 +00:00
|
|
|
- [Win32] Bugfix: `glfwMaximizeWindow` would make a hidden window visible
|
2022-03-15 18:12:29 +00:00
|
|
|
- [Win32] Bugfix: `Alt+PrtSc` would emit `GLFW_KEY_UNKNOWN` and a different
|
|
|
|
scancode than `PrtSc` (#1993)
|
2022-03-15 18:22:21 +00:00
|
|
|
- [Win32] Bugfix: `GLFW_KEY_PAUSE` scancode from `glfwGetKeyScancode` did not
|
|
|
|
match event scancode (#1993)
|
2022-03-17 22:54:39 +00:00
|
|
|
- [Win32] Bugfix: Instance-local operations used executable instance (#469,#1296,#1395)
|
2022-04-28 19:12:36 +00:00
|
|
|
- [Win32] Bugfix: The OSMesa library was not unloaded on termination
|
2022-06-28 20:26:39 +00:00
|
|
|
- [Win32] Bugfix: Right shift emitted `GLFW_KEY_UNKNOWN` when using a CJK IME (#2050)
|
2023-11-15 16:55:07 +00:00
|
|
|
- [Win32] Bugfix: `glfwWaitEventsTimeout` did not return for some sent messages (#2408)
|
2023-11-27 16:56:58 +00:00
|
|
|
- [Win32] Bugfix: Fix pkg-config for dynamic library on Windows (#2386, #2420)
|
2023-03-08 07:03:06 +00:00
|
|
|
- [Win32] Bugfix: XInput could reportedly provide invalid DPad bit masks (#2291)
|
2020-01-17 02:25:54 +00:00
|
|
|
- [Win32] Bugfix: Rapid clipboard calls could fail due to Clipboard History
|
2020-01-16 00:52:50 +00:00
|
|
|
- [Cocoa] Added support for `VK_EXT_metal_surface` (#1619)
|
2020-01-16 04:09:19 +00:00
|
|
|
- [Cocoa] Added locating the Vulkan loader at runtime in an application bundle
|
2020-03-05 19:32:19 +00:00
|
|
|
- [Cocoa] Moved main menu creation to GLFW initialization time (#1649)
|
2020-06-29 19:14:29 +00:00
|
|
|
- [Cocoa] Changed `EGLNativeWindowType` from `NSView` to `CALayer` (#1169)
|
2020-10-20 18:03:58 +00:00
|
|
|
- [Cocoa] Changed F13 key to report Print Screen for cross-platform consistency
|
|
|
|
(#1786)
|
2022-06-30 19:11:10 +00:00
|
|
|
- [Cocoa] Disabled macOS fullscreen when `GLFW_RESIZABLE` is false
|
2019-12-25 16:09:38 +00:00
|
|
|
- [Cocoa] Removed dependency on the CoreVideo framework
|
2019-08-29 20:08:29 +00:00
|
|
|
- [Cocoa] Bugfix: `glfwSetWindowSize` used a bottom-left anchor point (#1553)
|
2019-11-06 22:34:08 +00:00
|
|
|
- [Cocoa] Bugfix: Window remained on screen after destruction until event poll
|
|
|
|
(#1412)
|
2019-11-27 22:21:13 +00:00
|
|
|
- [Cocoa] Bugfix: Event processing before window creation would assert (#1543)
|
2020-01-01 00:42:25 +00:00
|
|
|
- [Cocoa] Bugfix: Undecorated windows could not be iconified on recent macOS
|
2020-03-05 19:32:19 +00:00
|
|
|
- [Cocoa] Bugfix: Touching event queue from secondary thread before main thread
|
|
|
|
would abort (#1649)
|
2020-06-29 19:16:59 +00:00
|
|
|
- [Cocoa] Bugfix: Non-BMP Unicode codepoint input was reported as UTF-16
|
|
|
|
(#1635)
|
2020-07-23 16:55:29 +00:00
|
|
|
- [Cocoa] Bugfix: Failing to retrieve the refresh rate of built-in displays
|
|
|
|
could leak memory
|
2020-10-18 17:34:23 +00:00
|
|
|
- [Cocoa] Bugfix: Objective-C files were compiled as C with CMake 3.19 (#1787)
|
2021-01-18 15:24:27 +00:00
|
|
|
- [Cocoa] Bugfix: Duplicate video modes were not filtered out (#1830)
|
2021-10-27 21:58:59 +00:00
|
|
|
- [Cocoa] Bugfix: Menu bar was not clickable on macOS 10.15+ until it lost and
|
2020-12-08 22:23:20 +00:00
|
|
|
regained focus (#1648,#1802)
|
2021-01-18 00:34:55 +00:00
|
|
|
- [Cocoa] Bugfix: Monitor name query could segfault on macOS 11 (#1809,#1833)
|
2021-01-18 17:55:17 +00:00
|
|
|
- [Cocoa] Bugfix: The install name of the installed dylib was relative (#1504)
|
2021-07-16 18:04:56 +00:00
|
|
|
- [Cocoa] Bugfix: The MoltenVK layer contents scale was updated only after
|
|
|
|
related events were emitted
|
2021-09-12 15:15:59 +00:00
|
|
|
- [Cocoa] Bugfix: Moving the cursor programmatically would freeze it for
|
|
|
|
a fraction of a second (#1962)
|
2021-10-27 21:58:59 +00:00
|
|
|
- [Cocoa] Bugfix: `kIOMasterPortDefault` was deprecated in macOS 12.0 (#1980)
|
2022-02-02 18:20:32 +00:00
|
|
|
- [Cocoa] Bugfix: `kUTTypeURL` was deprecated in macOS 12.0 (#2003)
|
2022-03-17 23:31:34 +00:00
|
|
|
- [Cocoa] Bugfix: A connected Apple AirPlay would emit a useless error (#1791)
|
2022-04-28 19:14:11 +00:00
|
|
|
- [Cocoa] Bugfix: The EGL and OSMesa libraries were not unloaded on termination
|
2022-06-30 20:08:52 +00:00
|
|
|
- [Cocoa] Bugfix: `GLFW_MAXIMIZED` was always true when `GLFW_RESIZABLE` was false
|
2022-07-01 16:19:19 +00:00
|
|
|
- [Cocoa] Bugfix: Changing `GLFW_DECORATED` in macOS fullscreen would abort
|
|
|
|
application (#1886)
|
|
|
|
- [Cocoa] Bugfix: Setting a monitor from macOS fullscreen would abort
|
|
|
|
application (#2110)
|
2022-07-07 18:01:28 +00:00
|
|
|
- [Cocoa] Bugfix: The Vulkan loader was not loaded from the `Frameworks` bundle
|
|
|
|
subdirectory (#2113,#2120)
|
2023-12-05 19:59:42 +00:00
|
|
|
- [Cocoa] Bugfix: Compilation failed on OS X 10.8 due to unconditional use of 10.9+
|
|
|
|
symbols (#2161)
|
2023-12-12 16:38:52 +00:00
|
|
|
- [Cocoa] Bugfix: Querying joystick elements could reportedly segfault on macOS
|
|
|
|
13 Ventura (#2320)
|
2019-05-07 15:03:55 +00:00
|
|
|
- [X11] Bugfix: The CMake files did not check for the XInput headers (#1480)
|
2019-07-11 18:21:04 +00:00
|
|
|
- [X11] Bugfix: Key names were not updated when the keyboard layout changed
|
|
|
|
(#1462,#1528)
|
2019-09-26 16:29:37 +00:00
|
|
|
- [X11] Bugfix: Decorations could not be enabled after window creation (#1566)
|
2019-10-28 18:18:19 +00:00
|
|
|
- [X11] Bugfix: Content scale fallback value could be inconsistent (#1578)
|
2019-12-16 13:53:06 +00:00
|
|
|
- [X11] Bugfix: `glfwMaximizeWindow` had no effect on hidden windows
|
2019-12-17 00:43:08 +00:00
|
|
|
- [X11] Bugfix: Clearing `GLFW_FLOATING` on a hidden window caused invalid read
|
2019-12-16 15:09:52 +00:00
|
|
|
- [X11] Bugfix: Changing `GLFW_FLOATING` on a hidden window could silently fail
|
2020-01-01 00:42:25 +00:00
|
|
|
- [X11] Bugfix: Disabled cursor mode was interrupted by indicator windows
|
|
|
|
- [X11] Bugfix: Monitor physical dimensions could be reported as zero mm
|
2020-01-01 15:56:32 +00:00
|
|
|
- [X11] Bugfix: Window position events were not emitted during resizing (#1613)
|
2020-01-05 13:34:39 +00:00
|
|
|
- [X11] Bugfix: `glfwFocusWindow` could terminate on older WMs or without a WM
|
2020-01-16 20:12:37 +00:00
|
|
|
- [X11] Bugfix: Querying a disconnected monitor could segfault (#1602)
|
2020-02-06 14:46:37 +00:00
|
|
|
- [X11] Bugfix: IME input of CJK was broken for "C" locale (#1587,#1636)
|
2020-01-22 19:12:36 +00:00
|
|
|
- [X11] Bugfix: Termination would segfault if the IM had been destroyed
|
|
|
|
- [X11] Bugfix: Any IM started after initialization would not be detected
|
2020-03-16 16:13:59 +00:00
|
|
|
- [X11] Bugfix: Xlib errors caused by other parts of the application could be
|
|
|
|
reported as GLFW errors
|
2020-03-19 22:28:21 +00:00
|
|
|
- [X11] Bugfix: A handle race condition could cause a `BadWindow` error (#1633)
|
2020-03-31 15:30:22 +00:00
|
|
|
- [X11] Bugfix: XKB path used keysyms instead of physical locations for
|
|
|
|
non-printable keys (#1598)
|
|
|
|
- [X11] Bugfix: Function keys were mapped to `GLFW_KEY_UNKNOWN` for some layout
|
2021-10-27 21:58:59 +00:00
|
|
|
combinations (#1598)
|
2020-06-30 18:57:24 +00:00
|
|
|
- [X11] Bugfix: Keys pressed simultaneously with others were not always
|
|
|
|
reported (#1112,#1415,#1472,#1616)
|
2021-03-08 18:32:36 +00:00
|
|
|
- [X11] Bugfix: Some window attributes were not applied on leaving fullscreen
|
2021-03-19 13:47:28 +00:00
|
|
|
(#1863)
|
2021-08-15 12:55:13 +00:00
|
|
|
- [X11] Bugfix: Changing `GLFW_FLOATING` could leak memory
|
2021-11-02 22:15:05 +00:00
|
|
|
- [X11] Bugfix: Icon pixel format conversion worked only by accident, relying on
|
|
|
|
undefined behavior (#1986)
|
2021-12-22 21:19:25 +00:00
|
|
|
- [X11] Bugfix: Dynamic loading on OpenBSD failed due to soname differences
|
2022-02-01 21:05:55 +00:00
|
|
|
- [X11] Bugfix: Waiting for events would fail if file descriptor was too large
|
|
|
|
(#2024)
|
2022-02-18 14:19:16 +00:00
|
|
|
- [X11] Bugfix: Joystick events could lead to busy-waiting (#1872)
|
2022-02-18 14:20:10 +00:00
|
|
|
- [X11] Bugfix: `glfwWaitEvents*` did not continue for joystick events
|
2022-02-18 13:29:43 +00:00
|
|
|
- [X11] Bugfix: `glfwPostEmptyEvent` could be ignored due to race condition
|
|
|
|
(#379,#1281,#1285,#2033)
|
2022-02-23 17:47:30 +00:00
|
|
|
- [X11] Bugfix: Dynamic loading on NetBSD failed due to soname differences
|
2022-03-10 19:04:56 +00:00
|
|
|
- [X11] Bugfix: Left shift of int constant relied on undefined behavior (#1951)
|
2022-04-28 19:17:39 +00:00
|
|
|
- [X11] Bugfix: The OSMesa libray was not unloaded on termination
|
2022-04-18 21:22:25 +00:00
|
|
|
- [X11] Bugfix: A malformed response during selection transfer could cause a segfault
|
2022-05-25 17:43:55 +00:00
|
|
|
- [X11] Bugfix: Some calls would reset Xlib to the default error handler (#2108)
|
2022-12-27 13:37:27 +00:00
|
|
|
- [Wayland] Added improved fallback window decorations via libdecor (#1639,#1693)
|
2021-07-13 16:12:43 +00:00
|
|
|
- [Wayland] Added dynamic loading of all Wayland libraries
|
2021-12-29 22:45:06 +00:00
|
|
|
- [Wayland] Added support for key names via xkbcommon
|
2022-03-31 17:56:48 +00:00
|
|
|
- [Wayland] Added support for file path drop events (#2040)
|
2022-06-14 16:20:56 +00:00
|
|
|
- [Wayland] Added support for more human-readable monitor names where available
|
2022-07-25 18:33:47 +00:00
|
|
|
- [Wayland] Disabled alpha channel for opaque windows on systems lacking
|
|
|
|
`EGL_EXT_present_opaque` (#1895)
|
2020-01-01 00:43:40 +00:00
|
|
|
- [Wayland] Removed support for `wl_shell` (#1443)
|
2019-05-17 16:30:02 +00:00
|
|
|
- [Wayland] Bugfix: The `GLFW_HAND_CURSOR` shape used the wrong image (#1432)
|
2019-12-15 16:24:26 +00:00
|
|
|
- [Wayland] Bugfix: `CLOCK_MONOTONIC` was not correctly enabled
|
2020-06-02 17:54:30 +00:00
|
|
|
- [Wayland] Bugfix: Repeated keys could be reported with `NULL` window (#1704)
|
2020-07-15 19:56:52 +00:00
|
|
|
- [Wayland] Bugfix: Retrieving partial framebuffer size would segfault
|
2020-07-15 21:11:19 +00:00
|
|
|
- [Wayland] Bugfix: Scrolling offsets were inverted compared to other platforms
|
|
|
|
(#1463)
|
2021-10-27 21:58:59 +00:00
|
|
|
- [Wayland] Bugfix: Client-Side Decorations were destroyed in the wrong order
|
2020-11-19 01:49:14 +00:00
|
|
|
(#1798)
|
2021-02-17 20:21:49 +00:00
|
|
|
- [Wayland] Bugfix: Monitors physical size could report zero (#1784,#1792)
|
2021-06-01 20:40:44 +00:00
|
|
|
- [Wayland] Bugfix: Some keys were not repeating in Wayland (#1908)
|
2021-05-12 07:30:14 +00:00
|
|
|
- [Wayland] Bugfix: Non-arrow cursors are offset from the hotspot (#1706,#1899)
|
2021-10-28 09:48:34 +00:00
|
|
|
- [Wayland] Bugfix: The `O_CLOEXEC` flag was not defined on FreeBSD
|
2021-12-14 08:29:01 +00:00
|
|
|
- [Wayland] Bugfix: Key repeat could lead to a race condition (#1710)
|
2021-12-22 13:16:19 +00:00
|
|
|
- [Wayland] Bugfix: Activating a window would emit two input focus events
|
2021-12-22 13:19:55 +00:00
|
|
|
- [Wayland] Bugfix: Disable key repeat mechanism when window loses input focus
|
2020-07-13 00:47:50 +00:00
|
|
|
- [Wayland] Bugfix: Window hiding and showing did not work (#1492,#1731)
|
2021-12-26 21:51:20 +00:00
|
|
|
- [Wayland] Bugfix: A key being repeated was not released when window lost focus
|
2021-12-28 00:39:06 +00:00
|
|
|
- [Wayland] Bugfix: Showing a hidden window did not emit a window refresh event
|
2021-12-28 14:33:58 +00:00
|
|
|
- [Wayland] Bugfix: Full screen window creation did not ignore `GLFW_VISIBLE`
|
2021-12-30 01:59:15 +00:00
|
|
|
- [Wayland] Bugfix: Some keys were reported as wrong key or `GLFW_KEY_UNKNOWN`
|
2021-12-30 20:09:23 +00:00
|
|
|
- [Wayland] Bugfix: Text input did not repeat along with key repeat
|
2022-03-03 20:46:50 +00:00
|
|
|
- [Wayland] Bugfix: `glfwPostEmptyEvent` sometimes had no effect (#1520,#1521)
|
2022-03-22 17:46:57 +00:00
|
|
|
- [Wayland] Bugfix: `glfwSetClipboardString` would fail if set to result of
|
|
|
|
`glfwGetClipboardString`
|
2022-03-22 17:55:31 +00:00
|
|
|
- [Wayland] Bugfix: Data source creation error would cause double free at termination
|
2022-03-22 18:23:25 +00:00
|
|
|
- [Wayland] Bugfix: Partial writes of clipboard string would cause beginning to repeat
|
2022-03-23 19:08:12 +00:00
|
|
|
- [Wayland] Bugfix: Some errors would cause clipboard string transfer to hang
|
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
|
2022-04-28 19:16:06 +00:00
|
|
|
- [Wayland] Bugfix: The OSMesa library was not unloaded on termination
|
2022-04-06 19:13:48 +00:00
|
|
|
- [Wayland] Bugfix: `glfwCreateWindow` could emit `GLFW_FEATURE_UNAVAILABLE`
|
2022-06-08 17:14:13 +00:00
|
|
|
- [Wayland] Bugfix: Lock key modifier bits were only set when lock keys were pressed
|
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
|
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
|
2022-06-19 16:30:03 +00:00
|
|
|
- [Wayland] Bugfix: `glfwRestoreWindow` assumed it was always in windowed mode
|
2022-06-10 12:10:25 +00:00
|
|
|
- [Wayland] Bugfix: `glfwSetWindowSize` would resize a full screen window
|
2022-06-10 12:19:13 +00:00
|
|
|
- [Wayland] Bugfix: A window content scale event would be emitted every time
|
|
|
|
the window resized
|
2022-06-10 13:45:07 +00:00
|
|
|
- [Wayland] Bugfix: If `glfwInit` failed it would close stdin
|
2022-06-15 23:36:55 +00:00
|
|
|
- [Wayland] Bugfix: Manual resizing with fallback decorations behaved erratically
|
|
|
|
(#1991,#2115,#2127)
|
2022-06-12 19:36:26 +00:00
|
|
|
- [Wayland] Bugfix: Size limits included frame size for fallback decorations
|
2022-06-13 17:37:34 +00:00
|
|
|
- [Wayland] Bugfix: Updating `GLFW_DECORATED` had no effect on server-side
|
|
|
|
decorations
|
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
|
2022-06-14 16:46:47 +00:00
|
|
|
- [Wayland] Bugfix: Window content scale events were not emitted when monitor
|
|
|
|
scale changed
|
2022-06-14 18:37:31 +00:00
|
|
|
- [Wayland] Bugfix: `glfwSetWindowAspectRatio` reported an error instead of
|
|
|
|
applying the specified ratio
|
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
|
2022-06-19 22:43:24 +00:00
|
|
|
- [Wayland] Bugfix: Hiding and then showing a window caused program abort on
|
|
|
|
wlroots compositors (#1268)
|
2022-06-20 20:36:23 +00:00
|
|
|
- [Wayland] Bugfix: `GLFW_DECORATED` was ignored when showing a window with XDG
|
|
|
|
decorations
|
2022-07-15 11:12:58 +00:00
|
|
|
- [Wayland] Bugfix: Connecting a mouse after `glfwInit` would segfault (#1450)
|
2023-03-31 13:30:20 +00:00
|
|
|
- [Wayland] Bugfix: Joysticks connected after `glfwInit` were not detected (#2198)
|
2023-04-25 20:47:18 +00:00
|
|
|
- [Wayland] Bugfix: Fallback decorations emitted `GLFW_CURSOR_UNAVAILABLE` errors
|
2021-06-21 20:14:40 +00:00
|
|
|
- [POSIX] Removed use of deprecated function `gettimeofday`
|
2019-12-15 16:24:26 +00:00
|
|
|
- [POSIX] Bugfix: `CLOCK_MONOTONIC` was not correctly tested for or enabled
|
2022-07-15 13:54:35 +00:00
|
|
|
- [Linux] Bugfix: Joysticks without buttons were ignored (#2042,#2043)
|
2023-11-16 19:47:27 +00:00
|
|
|
- [Linux] Bugfix: A small amount of memory could leak if initialization failed (#2229)
|
2021-10-17 23:05:09 +00:00
|
|
|
- [WGL] Disabled the DWM swap interval hack for Windows 8 and later (#1072)
|
2019-05-19 18:51:50 +00:00
|
|
|
- [NSGL] Removed enforcement of forward-compatible flag for core contexts
|
2019-12-09 17:53:29 +00:00
|
|
|
- [NSGL] Bugfix: `GLFW_COCOA_RETINA_FRAMEBUFFER` had no effect on newer
|
|
|
|
macOS versions (#1442)
|
2019-11-07 14:13:49 +00:00
|
|
|
- [NSGL] Bugfix: Workaround for swap interval on 10.14 broke on 10.12 (#1483)
|
2021-07-29 19:27:02 +00:00
|
|
|
- [NSGL] Bugfix: Defining `GL_SILENCE_DEPRECATION` externally caused
|
|
|
|
a duplicate definition warning (#1840)
|
2020-06-03 20:02:25 +00:00
|
|
|
- [EGL] Added platform selection via the `EGL_EXT_platform_base` extension
|
2020-08-04 15:21:17 +00:00
|
|
|
(#442)
|
2020-06-25 16:22:08 +00:00
|
|
|
- [EGL] Added ANGLE backend selection via `EGL_ANGLE_platform_angle` extension
|
|
|
|
(#1380)
|
2023-12-12 12:46:48 +00:00
|
|
|
- [EGL] Added loading of glvnd `libOpenGL.so.0` where available for OpenGL
|
2021-06-15 16:14:56 +00:00
|
|
|
- [EGL] Bugfix: The `GLFW_DOUBLEBUFFER` context attribute was ignored (#1843)
|
2023-12-12 12:39:54 +00:00
|
|
|
- [EGL] Bugfix: Setting `GLFW_CONTEXT_DEBUG` caused creation to fail (#2348)
|
2022-07-27 13:05:23 +00:00
|
|
|
- [GLX] Added loading of glvnd `libGLX.so.0` where available
|
2022-01-06 06:07:53 +00:00
|
|
|
- [GLX] Bugfix: Context creation failed if GLX 1.4 was not exported by GLX library
|
2016-06-16 10:52:22 +00:00
|
|
|
|
2013-02-04 09:46:02 +00:00
|
|
|
|
|
|
|
## Contact
|
|
|
|
|
2021-06-09 20:43:27 +00:00
|
|
|
On [glfw.org](https://www.glfw.org/) you can find the latest version of GLFW, as
|
2016-08-02 13:58:58 +00:00
|
|
|
well as news, documentation and other information about the project.
|
2013-02-04 09:46:02 +00:00
|
|
|
|
|
|
|
If you have questions related to the use of GLFW, we have a
|
2019-10-13 14:42:54 +00:00
|
|
|
[forum](https://discourse.glfw.org/), and the `#glfw` IRC channel on
|
2021-06-09 20:36:13 +00:00
|
|
|
[Libera.Chat](https://libera.chat/).
|
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
|
2013-06-24 12:28:42 +00:00
|
|
|
request, please file it in the
|
|
|
|
[issue tracker](https://github.com/glfw/glfw/issues) on GitHub.
|
2013-02-04 09:46:02 +00:00
|
|
|
|
|
|
|
Finally, if you're interested in helping out with the development of GLFW or
|
2016-08-17 14:48:22 +00:00
|
|
|
porting it to your favorite platform, join us on the forum, GitHub or IRC.
|
2013-02-04 09:46:02 +00:00
|
|
|
|