lwjgl3

LWJGL - 轻量级Java游戏库3

LWJGL (https://www.lwjgl.org) 是一个Java库，它支持跨平台访问流行的原生API，这些API在开发图形（OpenGL/Vulkan）、音频（OpenAL）和并行计算（OpenCL）应用程序时非常有用。这种访问方式直接且高效，同时还包裹在一个类型安全和用户友好的层中，适合Java生态系统。

LWJGL是一种使能技术，提供低级访问。它不是一个框架，也不提供比原生库所公开的更高级的工具。因此，建议新手程序员在直接使用该库之前，先尝试使用一些利用LWJGL的框架或游戏引擎。

LWJGL是开源软件，免费提供。

有用的链接：

联系方式：

如果您想贡献，请参阅doc/README，了解项目结构的快速概览、安装说明和配置选项。

入门

从3.1.0版本开始，LWJGL以模块集的形式分发。只有核心模块是必需的，所有绑定都是可选的（但有些绑定依赖于其他绑定）。下载LWJGL最简单的方法是使用网站上的构建配置器。

构建配置器生成可以添加到现有项目中的Maven和Gradle声明。这是开发时使用LWJGL的最简单方法。

LWJGL也可以作为一组简单的JAR文件下载。每个模块包含以下文件：

lwjgl-<module>.jar
lwjgl-<module>-sources.jar
lwjgl-<module>-javadoc.jar
lwjgl-<module>-natives-<platform>.jar（适用于某些绑定）

要编译和运行LWJGL应用程序，应将核心模块和每个使用的绑定的基础和原生JAR文件添加到类路径中。LWJGL会自动将原生库提取到临时文件夹并加载它们，因此无需进行进一步配置。如果需要更多自定义（例如创建特定平台的安装程序时），可以手动提取原生库并通过java.library.path加载。有关更多选项，请参阅Configuration类。

LWJGL 3需要Java 8或更高版本才能构建和运行，目前支持以下平台/架构：

FreeBSD x64
Linux x64
Linux arm64 (ARMv8/AArch64)
Linux arm32 (ARMv7/armhf)
Linux ppc64le
Linux riscv64
macOS x64
macOS arm64
Windows x64
Windows x86
Windows arm64

示例代码：

示例（涵盖LWJGL绑定基本用法的简单示例）
演示套件（包括高级OpenGL和Vulkan演示）
Wiki教程

关于将LWJGL 2代码迁移到LWJGL 3，请参阅迁移指南。

故障排除

LWJGL用户面临的大多数常见问题都可以通过以下方式轻松解决：

安装指南（lwjgl3-wiki）
故障排除指南（lwjgl3-wiki）
内存FAQ（lwjgl3-wiki） LWJGLX/debug是一个Java代理，可以自动检测许多这类问题。它还可以生成跟踪日志，在向LWJGL报告问题时很有用。

当寻求帮助或怀疑LWJGL存在bug时，准备一个能重现问题的MVCE（最小、完整、可验证的示例）将提高得到快速有用回应的机会。

支持的绑定列表

Khronos APIs

库	描述
EGL	Khronos渲染API（如OpenGL ES或OpenVG）与底层本地平台窗口系统之间的接口。
KTX (Khronos Texture)	用于OpenGL®、Vulkan®和其他GPU API的轻量级纹理容器。
OpenCL	一个开放、免版税的标准，用于跨平台并行编程，适用于个人电脑、服务器、移动设备和嵌入式平台中的各种处理器。
OpenGL	业界最广泛采用的2D和3D图形API，为各种计算机平台带来数千种应用程序。
OpenGL ES	一个免版税、跨平台的API，用于嵌入式系统（包括游戏机、手机、家电和车辆）的全功能2D和3D图形。
OpenXR	一个免版税、开放标准，为增强现实（AR）和虚拟现实（VR）（统称为XR）平台和设备提供高性能访问。
Vulkan	新一代图形和计算API，提供高效、跨平台访问现代GPU，适用于从PC和游戏机到移动电话和嵌入式平台的各种设备。

显示和输入

库	描述
GLFW	创建多个窗口，处理用户输入（键盘、鼠标、游戏外设）并管理上下文。还具有多显示器支持、剪贴板访问、文件拖放等更多功能。
JAWT	AWT原生接口。
Native File Dialog Extended	一个小型C库，可跨平台调用原生文件打开、文件夹选择和文件保存对话框。
tinyfd	一个原生对话框库。

音频

库	描述
FMOD	为任何游戏添加声音和音乐的端到端解决方案。
OpenAL	一个跨平台的3D音频API，适用于游戏应用程序和许多其他类型的音频应用程序。
OpenAL Soft	一个LGPL许可的、跨平台的OpenAL 3D音频API软件实现。
Opus	一个完全开放、免版税、高度通用的音频编解码器。

图形

库	描述
Assimp	一个可移植的开源库，用于以统一方式导入各种知名3D模型格式。
bgfx	跨平台、图形API无关的"自带引擎/框架"风格渲染库，采用宽松的BSD-2条款开源许可。
FreeType	一个免费提供的软件库，用于渲染字体。
HarfBuzz	一个文本整形库，允许程序将Unicode输入序列转换为正确格式和位置的字形输出 — 适用于任何书写系统和语言。
meshoptimizer	一个网格优化库，使网格更小、渲染更快。
msdfgen	多通道有符号距离场生成器。
NanoSVG	一个简单的SVG解析器。
NanoVG	一个用于OpenGL的小型抗锯齿矢量图形渲染库。
Nuklear	一个用ANSI C编写的最小状态即时模式图形用户界面工具包，以公共域许可发布。
par_octasphere	生成球体、圆角盒子和胶囊体的三角形网格。
par_shapes	生成参数化表面和其他简单形状。
par_streamlines	三角化宽线条和曲线。
Shaderc	用于着色器编译的库集合。
SPIRV-Cross	一个用于对SPIR-V进行反射并将SPIR-V反汇编回高级语言的库。
Tiny OpenEXR	一个小型、仅头文件的库，用于加载和保存OpenEXR(.exr)图像。
Tootle (AMD)	一个3D三角形网格优化库，改进了现有的网格预处理技术。
Vulkan Memory Allocator	一个易于集成的Vulkan内存分配库。
Yoga	一个开源、跨平台的布局库，实现了Flexbox。

AR/VR

库	描述
LibOVR	Oculus SDK的API。
OpenVR	一个API和运行时，允许访问多个厂商的VR硬件，而无需应用程序具有针对特定硬件的知识。

stb - C/C++单文件公共域库

库	描述
stb_easy_font	快速简便、易于部署的位图字体，用于打印帧率等信息。
stb_image	从文件/内存加载/解码图像：JPG、PNG、TGA、BMP、PSD、GIF、HDR、PIC
stb_image_resize	高质量放大/缩小图像。
stb_image_write	将图像写入磁盘：PNG、TGA、BMP
stb_perlin	修订版柏林噪声（3D输入，1D输出）。
stb_rect_pack	简单的2D矩形打包器，质量不错。
stb_truetype	解析、解码和光栅化TrueType字体中的字符。
stb_vorbis	从文件/内存解码ogg vorbis文件为浮点/16位有符号输出。

其他

库	描述
CUDA	NVIDIA开发的用于GPU通用计算的并行计算平台和编程模型。
hwloc	现代架构层次拓扑的可移植抽象，包括NUMA内存节点、插槽、共享缓存、核心和同时多线程。
jemalloc	强调碎片避免和可扩展并发支持的通用malloc实现。
libffi	各种调用约定的可移植、高级编程接口。
libdivide	一个用相对便宜的乘法和位移替换昂贵整数除法的库。
LLVM	模块化和可重用的编译器和工具链技术集合。
LMDB	一个极快、内存高效的数据库。通过内存映射文件，它具有纯内存数据库的读取性能，同时保留了标准磁盘数据库的持久性。
LZ4	专注于压缩和解压缩速度的无损数据压缩算法。
Meow hash	一个极快的非加密哈希。
ODBC	C语言编程接口，使应用程序能够访问各种数据库管理系统（DBMS）的数据。
Remotery	实时CPU/GPU分析器，托管在单个C文件中，查看器在Web浏览器中运行。
rpmalloc	公共域跨平台无锁线程缓存16字节对齐内存分配器，用C实现。
xxHash	极快的哈希算法，运行速度达到RAM速度限制。
Zstandard (zstd)	快速无损压缩算法，针对实时压缩场景，达到zlib级别并提供更好的压缩比。