glfw

C/C++ 2025-08-14

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访问本机访问

接触

在glfw .org上,您可以找到最新版本的glfw ,以及有关该项目的新闻,文档和其他信息。

如果您有与glfw使用有关的问题,我们有一个论坛。

如果您有一个错误报告,要提交的补丁程序或要请求的功能,请在GitHub上的“ essead Tracker”中提交。

最后,如果您有兴趣帮助开发glfw或将其移植到您喜欢的平台上,请加入我们的论坛或Github。

下载源码

通过命令行克隆项目:

git clone https://github.com/glfw/glfw.git