glfw

glfw

介绍

glfw是用于OpenGL，OpenGL ES和Vulkan应用程序开发的开源，多平台库。它提供了一个简单的，独立于平台的API，用于创建窗口，上下文和表面，阅读输入，处理事件等。

glfw本地支持Windows，MacOS和Linux以及其他类似Unix的系统。在Linux上，Wayland和X11都得到了支持。

glfw获得Zlib/LIBPNG许可证的许可。

您可以下载最新的稳定版本作为源或Windows二进制文件。每个版本以3.0开始，还具有带有源和二进制档案的相应注释标签。

该文档可在线获得，并包含在所有来源和二进制档案中。有关最新版本中的新功能，警告和贬值，请参见发行说明。有关更多详细信息，请参见版本历史记录。

master分支是稳定的集成分支，应始终在所有受支持的平台上编译并运行，尽管新添加的功能的详细信息可能会更改，直到将其包含在版本中为止。新功能和许多错误修复在其他分支机构中直到稳定到足以合并为止。

如果您是glfw的新手，则可能会发现glfw 3的教程有用。如果您过去使用过glfw 2，则有一个转移到glfw 3 API的过渡指南。

glfw之所以存在，是因为世界各地许多人的贡献，无论是通过报告错误，提供社区支持，添加功能，审查或测试代码，调试代码，校对文档，建议功能还是修复错误。

编译glfw

glfw主要写在C99中，其中MacOS支持的一部分是在Objective-C中编写的。 glfw本身仅需要您的操作系统和窗口系统的标题和库。它不需要任何其他标题来进行上下文创建API（WGL，GLX，EGL，NSGL，OSMESA）或渲染API（OpenGL，OpenGL ES，Vulkan）来支持它们。

glfw用Visual C ++（2013年及以后）和MINGW-W64在Windows上的汇编，带有Clang，Linux和Linux和其他类似于GCC和Clang的Unix的系统。它也可能在其他环境中进行编译，但这并不经常测试。

Windows和MacOS上的所有受支持的编译器都有预编译的二进制文件。

有关如何汇编glfw更多信息，请参见《汇编指南》。

使用glfw

有关教程，指南和API参考，请参见文档。

为glfw做出贡献

有关更多信息，请参见贡献指南。

系统要求

glfw支持Windows 7及更高版本，MacOS 10.11及以后。即使没有桌面环境或现代扩展，也支持Linux和其他类似于UNIX的系统，尽管某些功能需要运行的窗口或剪贴板管理器，但也支持了。 OSMESA后端需要Mesa 6.3。

有关更多信息，请参见文档中的兼容性指南。

依赖性

glfw本身仅需要CMAKE 3.16或更高版本，以及您的操作系统和窗口系统的标题和库。

示例和测试程序取决于许多很小的库。这些位于deps/目录中。

getopt_port获取具有命令行选项的示例
用于螺纹示例的TinyCthread
GLAD2加载OpenGL和Vulkan功能
linmath.h用于示例中的线性代数
Nuklear测试和示例UI
stb_image_write用于将图像写入磁盘

如果Cmake可以找到该工具，则使用Doxygen生成文档。

报告错误

错误报告给我们的问题跟踪器。请检查贡献指南以获取有关报告错误时要包含的信息的信息。

自3.4以来的变更

添加了glfw _UNLIMITED_MOUSE_BUTTONS输入模式，该模式允许鼠标按钮超出鼠标按钮令牌的限制（＃2423）
更新的最小CMAKE版本为3.16（＃2541）
删除了使用原始mingw（＃2540）建造的支持
[WIN32]删除了对Windows XP和Vista的支持（＃2505）
[可可]添加了QuartzCore框架作为链接时间依赖性
[可可]删除了对OS X 10.10优胜美地和更早的支持（＃2506）
[Wayland] BugFix：分数缩放相关的对象没有被破坏
[Wayland] BugFix： glfw Init将在没有座位的Compositor上（＃2517）
[Wayland] BugFix：进入非glfw表面的阻力可能会导致segfault
[Wayland] BugFix：忽略关键重复事件时，没有窗口的键盘焦点（＃2727）
[Wayland] BugFix：重置窗口被破坏时重复计时器（＃2741，＃2727）
[Wayland] BugFix：如果读取数据报价失败，则内存将泄漏
[x11] bugfix：无wm运行可以触发断言（＃2593，＃2601，＃2631）
[null]通过VK_EXT_headless_surface添加了Vulkan'Window'表面创建
[null]通过EGL_MESA_platform_surfaceless在MESA上添加了EGL上下文创建
[EGL]允许使用glfw _CONTEXT_CREATION_API设置为glfw _NATIVE_CONTEXT_API （＃2518）的wayland访问本机访问