Commit Graph

478 Commits

Author SHA1 Message Date
Camilla Löwy
07efe9068e Improved build guide slightly
This was adapted to 3.3-stable from
b864e4baeb590465700744a68d083fe0ebce5d74.
2024-02-20 23:50:30 +01:00
Camilla Löwy
0cac1ad41f Fix spelling
This was adapted to 3.3-stable from
5a0ab56ed79595ee991e51a951f103a1c612b6a7.
2024-02-14 23:31:36 +01:00
Camilla Löwy
8d95aeac69 Remove further traces of IRC channel
(cherry picked from commit 23962c9dc7e0aa59199211b03a6fbb5700c01c30)
2024-02-05 16:25:27 +01:00
Camilla Löwy
a1090c867d Wayland: Fix compilation on FreeBSD
The list of compile-time dependencies on FreeBSD lacked evdev-proto.

Unlike on Linux, the input-event-codes.h header file was not implicitly
included on FreeBSD.

Fixes #2445

This was adapted to 3.3-stable from
51920ede6827962ca2fbcad38d1beed1165400af.
2024-02-05 16:25:27 +01:00
Camilla Löwy
683b7524d2 Improve documentation relating to key tokens
Shifted the documentation away from the term 'named keys' as something
different than keys that glfwGetKeyName will return a name for.  The
already existing term 'key token' should now be used to refer to the
GLFW_KEY_* constants.

The associated term 'named mouse button' was also replaced with
'supported mouse button'.

The parts explaining which key tokens will return a valid scancode from
glfwGetKeyScancode have hopefully been clarified.  This issue was
reported in #2055.

The GLFW_KEY_UNKNOWN constant has been moved out of the list of key
tokens to simplify and hopefully clarify the related documentation.

Various other keyboard key related edits were made, hopefully resulting
in improvements.

Related to #2055

(cherry picked from commit 9959dc69cadd1f7790060846ffbc44e7da56fc56)
2023-12-07 18:04:48 +01:00
Camilla Löwy
6f9686f1f4 Fix unneccessary use of "must"
Passing a context-less window to a function that requires a context only
emits a harmless GLFW_NO_WINDOW_CONTEXT error.

(cherry picked from commit 0bd3e879e1fd8c5ed4562929fb0365a5a7089833)
2023-11-28 22:15:43 +01:00
Camilla Löwy
ff156743ab Update Doxyfile template for Doxygen 1.9.7
This was adapted to 3.3-stable from
938a3c29b2e1b93a681cfde82876dfce97635658.
2023-11-28 22:04:48 +01:00
Camilla Löwy
0c2db4a23e Wayland: Add initial support for libdecor
This is partly based on the implementation of libdecor support in
PR #1693 by @ christianrauch.

Where available, the libdecor library is loaded at init and becomes the
preferred method for window decorations.  On compositors that support
XDG decorations, libdecor in turn uses those.  If not, libdecor has
a plug-in archtecture and may load additional libraries to either use
compositor-specific decorations or draw its own.

If necessary, support for libdecor can be disabled with the
GLFW_WAYLAND_LIBDECOR init hint.  This is mostly in case some part of
the dynamic loading or duplication of header material added here turns
out to cause problems with future versions of libdecor-0.so.0.

Fixes #1639
Closes #1693
Related to #1725

This was adapted to 3.3-stable from
fbdb53b9ca457ab01675e20d9127cb62d8db88b8.
2023-07-19 17:23:25 +02:00
Camilla Löwy
05e28537a3 Remove Doxyfile tags deprecated by Doxygen 1.9.5
(cherry picked from commit d299d9f78857e921b66bdab42c7ea27fe2e31810)
2022-10-31 22:16:33 +01:00
Camilla Löwy
af3e14fbc2 Document X11 WM_CLASS hint behavior
Fixes #2180

(cherry picked from commit ed1d9e1ca75600d80f9956bc3de333987a777cfa)
2022-10-31 22:13:27 +01:00
Camilla Löwy
8b4f1ebbea Wayland: Fix window opacity on older systems
On systems lacking the EGL_EXT_present_opaque extension, some
compositors treat any buffer with an alpha channel as per-pixel
transparent.

This commit ignores any EGLConfig with an alpha channel if the extension
is missing and the window is created with GLFW_TRANSPARENT_FRAMEBUFFER
set to false.

This is technically not a breaking change since GLFW_ALPHA_BITS is not
a hard constraint, but it is still going to inconvenience anyone using
the framebuffer alpa channel to store other kinds of data.

Related to #1895

(cherry picked from commit ef6c9d8b4f957c2a53374558e393bdb5c4264fa5)
2022-10-31 22:02:06 +01:00
TheChocolateOre
34bfb52641 Fix typos and other issues in docs
This fixes spelling, grammar and punctuation issues, missing words and
stray words across the documentation.  A confusing sentence was removed
from the tutorial.

Closes #2085

(cherry picked from commit 2e12ef00bb4b96c7b4c6ea14f594cc8f50ea718f)
2022-10-31 21:47:01 +01:00
Camilla Löwy
7482de6071 Documentation work
Fixes #1596

(cherry picked from commit aa80d24d01d150e26d664ff2d5da22e95db6bb82)
2022-07-15 00:11:23 +02:00
JoelNiemela
5324177d90 Fix typos in docs
Closes #2150

(cherry picked from commit 060631c9658010945c6b89935e5ac41a5b4a991c)
2022-07-15 00:11:23 +02:00
Camilla Löwy
8c63c935ea Documentation work
Related to #2113
Related to #2120

(cherry picked from commit 78b19548d9395898ecca6b792a37125520f93f5c)
2022-07-15 00:11:23 +02:00
Emmanuel Gil Peyrot
581fed38be Wayland: Remove support for wl_shell
This is adapted to 3.3-stable from
599fb3de348f73134b4e9d2ee5cabc62ca0b84ab and
27295b508ffd098de8673bfe5f7f4154235cb1cc.
2022-07-13 22:40:46 +02:00
Camilla Löwy
af9eb79de4 Move CODEOWNERS to .github directory
This slightly de-clutters a directory mostly intended for human-readable
documentation.

(cherry picked from commit d3c2121221f7bcd9cce2e164acfbdee8820aec06)
2022-06-09 19:55:25 +02:00
Camilla Löwy
45ce5ddd19 Fix button field names in input guide
Fixes #2056

(cherry picked from commit 46950a5e61ae6febb6dd554aea212f9130927b98)
2022-03-20 16:03:55 +01:00
Camilla Löwy
8d08426725 Fix dependency list for X11 on Cygwin
(cherry picked from commit 1eef3a363e2f64718c82122c5d48bff44c4b2e5d)
2022-03-20 15:53:59 +01:00
Camilla Löwy
5ccc756c56 X11: Fix empty event race condition with a pipe
There is a seemingly unavoidable race condition when waiting for data on
the X11 display connection, as long as any other thread is also making
Xlib calls.  The event data we are waiting for could be read by the
other thread as part of looking for the reply to its request, before our
poll has begun.

This commit replaces the X11 event sent by glfwPostEmptyEvent with
writing to an unnamed pipe.  The race condition remains if other Xlib
calls are made on other threads, but glfwPostEmptyEvent should now be
race-free.

This commit is based on work by pcwalton, OlivierSohn, kovidgoyal and
joaodasilva.

Closes #2033
Related to #379
Related to #1281
Related to #1285

(cherry picked from commit cd22e2849512a88d0ab77bc7a3458646625f2c50)
2022-03-13 16:17:25 +01:00
Camilla Löwy
cec0b33ee1 Remove Doxyfile tags obsoleted by Doxygen 1.9.2
Fixes #1932
2021-10-17 20:34:05 +02:00
Camilla Löwy
b3b82cdd78 Add custom target for updating gamepad mappings
(cherry picked from commit 01778329ec0ccc485eab2a90cc42d3ff88624c35)
2021-08-03 16:00:30 +02:00
Camilla Löwy
44ad296813 Expand list of distro derivatives slightly
(cherry picked from commit 3dc7349c3518c4bb38fbf406707bccd6c510a333)
2021-08-03 15:59:24 +02:00
Camilla Löwy
1b0eac9c58 Add Fedora package names to compilation guide
(cherry picked from commit 9e1ee3f2634fdbcb9107c3c57be7eafaf5ff87cd)
2021-08-03 15:46:11 +02:00
Camilla Löwy
9a5511b311 Improve library compilation guide somewhat
Related to #1931.

(cherry picked from commit 3b9597048259a198f8f27db7d5eb0eab7de0d3b3)
2021-08-03 14:31:31 +02:00
David V. McKay
3bf580ad1d realizing "as you would" is platform dependent
specified "for linux or unix" and added a bit about using Visual Studio on Windows.

(cherry picked from commit 1a5e07fd4b0a5b6a70e99bbc52470962824d6979)
2021-08-03 14:04:48 +02:00
David V. McKay
014ce9c74f Clarify "as you would" for beginners.
fixes #1088

(cherry picked from commit f010d8b77dda7fa62a16e6afaf7156222be468b5)
2021-08-03 14:04:45 +02:00
A. Tombs
bd346b64d6 Consistent subsections in compile guide
In the compile guide, the "Dependencies for Linux and OSMesa" section
looks to be one level too high in the hierarchy. I've moved it to be in
line with the similarly-named sub-sub-sections.

Closes #1923.

(cherry picked from commit 52d8347d34b51229cb6029a351ef19cfe60835ca)
2021-08-03 14:03:20 +02:00
Camilla Löwy
db34aea144 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-25 00:23:11 +02:00
Camilla Löwy
6518847f4d 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-25 00:23:11 +02:00
Camilla Löwy
020ce99170 Remove claim that EGL is not supported on macOS
(cherry picked from commit a39115a27b3f4695729e1a72e41b3217a841b94f)
2021-06-09 18:36:42 +02:00
Camilla Löwy
a149810df9 Clarify documentation for hints
(cherry picked from commit bbbbd3e87094d44191197659ab07081262f07d06)
2021-06-09 18:36:13 +02:00
Camilla Löwy
583dcbcc19 Replace GL_ARB_debug_output in context guide
New code should use GL_KHR_debug instead but it's not as good an example
to use in this case as the symbols it adds has no suffixes.

(cherry picked from commit ec621a00bd96cbc41a7e1f630adf155ae2d08267)
2021-06-09 18:26:36 +02:00
Camilla Löwy
658744e222 Update USE_MSVC_RUNTIME_LIBRARY_DLL for CMake 3.15
This makes USE_MSVC_RUNTIME_LIBRARY_DLL update the directory scope
CMAKE_MSVC_RUNTIME_LIBRARY variable instead of CMAKE_C_FLAGS on CMake
3.15 and later.

Solution proposed by @moritz-h.

Fixes #1783.
Closes #1796.

(cherry picked from commit f4a73296049b432720c9b6c230e479f9b41d74d3)
2021-06-09 18:24:31 +02:00
Bhee
0d7acffd47 Fix minor typo: If if -> If.
(cherry picked from commit 0b9e48fa3df9c184ff1abfb2452fd1a4b696ecd8)
2021-02-09 21:49:17 +01:00
Camilla Löwy
e341080489 Update CODEOWNERS for move to SCSS
(cherry picked from commit 73ef5f0abb3316bfb34aea0b3f754819705d17d4)
2020-09-30 16:09:54 +02:00
Luflosi
77dffb341b Use consistent indentation for Doxygen custom stylesheet
Most of this file is indented with tabs but parts are indented with spaces.

Closes #1770.

(cherry picked from commit 58df92acad5ec924274b3c33d277279475a6a645)
2020-09-30 16:09:46 +02:00
Siavash Eliasi
cb8aee8437 Migrate to Sass for Doxygen custom stylesheets
Closes #1759.

(cherry picked from commit 96f9f5c4b970140ab5380fb9886ba787c8698937)
2020-09-16 13:31:29 +02:00
Siavash Eliasi
c0704e4a63 Improve docs scaling on mobile and small screens
Closes #1757.

(cherry picked from commit bb1d917c2fc0db03debf77c711fc37bef5231c88)
2020-09-02 22:30:43 +02:00
Camilla Löwy
7728a6a3aa Fix formatting in transition guide
(cherry picked from commit b9dfce0070b4d70b857b87d5fda02ee82eb3d6a8)
2020-09-02 22:29:37 +02:00
Camilla Löwy
8363179eee Win32: Disable fb transparency when it is broken
On Windows 7, when GLFW framebuffer transparency and the DWM are enabled
but DWM transparency is disabled (i.e. when the Transparency setting is
disabled under Personalization > Color), the contents of the framebuffer
is combined with the last frame using additive blending instead of
replacing the previous contents.

This commit limits GLFW framebuffer transparency on Windows 7 to when
DWM transparency is enabled, removing the previous workaround of setting
a layered window color key that led to rendering artifacts.

Fixes #1512.

(cherry picked from commit 05dd2fa2986c37e7aee3cba917b1d02a3a189390)
2020-09-02 22:27:45 +02:00
Camilla Löwy
2a5ac9a6d6 Documentation fix
"Joystick token" is not used anywhere else in the documentation.

(cherry picked from commit e0f7ce402b46f5ef4c1cc422413056b8a83fb6df)
2020-07-22 18:08:20 +02:00
Camilla Löwy
f921caf4a6 Re-word docs for GLFW_OPENGL_DEBUG_CONTEXT attrib
Related to #1720.

(cherry picked from commit 4e3b43383a1e738dfcf47205671246f2008a8d94)
2020-06-30 17:10:50 +02:00
A. Tombs
9aefb67358 Re-word docs for OPENGL_DEBUG_CONTEXT hint
Re-worded documentation for the `GLFW_OPENGL_DEBUG_CONTEXT` window hint
to avoid implying that it only applies to OpenGL contexts. Added a link
to the relevant Khronos extension description.

Closes #1720.

(cherry picked from commit 8a69a0d7e545a88de3dd88710e4a881932ca07ed)
2020-06-30 17:10:44 +02:00
Camilla Löwy
63af05c419 Clarify docs on default GL header inclusion
The documentation claims that any extension loader library header
included before the GLFW one will prevent the inclusion of the
default OpenGL header.  In reality this only worked if the loader
defined the canonical desktop OpenGL __gl_h_ inclusion guard and even
then relied on the OpenGL header to detect this.

This is the companion to 105cf32e0b05e207d4cd5efa462887569ca2116a, which
added the preprocessor logic to check for many known OpenGL and OpenGL
ES inclusion guards and not even attempt to include the default header
if any are present.

Some clarification of the language around header inclusion has also been
attempted, including making GLFW_INCLUDE_NONE more prominent.

Fixes #1695.

(cherry picked from commit 399c2a1fadbe6a1019c54f63d3839ef97a77d783)
2020-06-02 19:02:10 +02:00
Camilla Löwy
e336288eeb Fix typo in header option macro docs
(cherry picked from commit fbf8aae44f4e37dc32747dacec86c255aad228c4)
2020-06-02 19:01:28 +02:00
Camilla Löwy
10c01512f2 Update community resource links
(cherry picked from commit d7ae90a790416f150a39e8f42f8278598bafae29)
2020-05-19 14:33:23 +02:00
Camilla Löwy
8216a148cf Disambiguate Vulkan support reference link
(cherry picked from commit 41a19ed49c5ace44949f58b157714d59c2aebf2f)
2020-05-19 14:33:20 +02:00
Camilla Löwy
aee62d3c16 Fix unclear language in build guide
Fixes #1658.

(cherry picked from commit 9516df52a4745a67f4e1d58d3de32c74b8c33ecf)
2020-04-03 17:01:40 +02:00
Camilla Löwy
3604cc72fc Put docs target in GLFW3 folder
(cherry picked from commit d1ae7bac608e082ef7dad302811dc4cf3fdf3ab8)
2020-02-13 22:02:06 +01:00