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 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
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级别并提供更好的压缩比。 |
使用绑定需遵守相应许可证的条款。