本教程将指导开发者如何在LWJGL/GLFW应用中通过代码实现窗口的最大化操作，而非进入全屏模式。文章详细介绍了使用`glfwMaximizeWindow`方法在运行时最大化窗口，以及通过设置`GLFW_MAXIMIZED`窗口提示在窗口创建时即实现最大化的两种策略，确保窗口可见任务栏和标题栏，提供清晰的代码示例。
在开发基于LWJGL和GLFW的桌面应用程序时，经常需要对窗口进行灵活的控制。其中一个常见的需求是程序化地最大化窗口，使其占据屏幕可用空间，但同时保留操作系统的任务栏和窗口边框（即非全屏模式）。传统的Display.setDisplayMode(new DisplayMode(width, height))方法虽然可以改变窗口尺寸，但要精确计算出在保留任务栏和标题栏情况下的最大化尺寸则相对复杂。幸运的是，GLFW提供了更直接、更优雅的解决方案。
1. 运行时最大化窗口
GLFW库提供了一个专门的函数glfwMaximizeWindow来实现窗口的运行时最大化。这个方法非常简单直观，只需要传入目标窗口的句柄即可。
1.1 glfwMaximizeWindow 方法介绍
glfwMaximizeWindow函数定义在org.lwjgl.glfw.GLFW类中，其签名如下：
public static void glfwMaximizeWindow(long window)
其中，window参数是您希望最大化的GLFW窗口的句柄。这个句柄通常在调用glfwCreateWindow创建窗口时返回。
1.2 使用示例
以下是一个简单的LWJGL/GLFW应用程序骨架，演示如何在窗口创建后通过代码最大化它：
import org.lwjgl.glfw.*;
import org.lwjgl.opengl.*;
import static org.lwjgl.glfw.Callbacks.*;
import static org.lwjgl.glfw.GLFW.*;
import static org.lwjgl.opengl.GL11.*;
import static org.lwjgl.system.MemoryUtil.*;
public class WindowMaximizationExample {
private long window; // 窗口句柄
public void run() {
init();
loop();
// 释放窗口回调和销毁窗口
glfwFreeCallbacks(window);
glfwDestroyWindow(window);
// 终止GLFW并释放错误回调
glfwTerminate();
glfwSetErrorCallback(null).free();
}
private void init() {
// 设置错误回调。默认情况下，GLFW会将错误打印到System.err。
GLFWErrorCallback.createPrint(System.err).set();
// 初始化GLFW。如果失败，则抛出异常。
if (!glfwInit()) {
throw new IllegalStateException("Unable to initialize GLFW");
}
// 配置GLFW
glfwDefaultWindowHints(); // 设置默认窗口提示
glfwWindowHint(GLFW_VISIBLE, GLFW_FALSE); // 窗口创建后不可见
glfwWindowHint(GLFW_RESIZABLE, GLFW_TRUE); // 窗口可调整大小
// 创建窗口
window = glfwCreateWindow(800, 600, "LWJGL Window Maximization", NULL, NULL);
if (window == NULL) {
throw new RuntimeException("Failed to create the GLFW window");
}
// 设置按ESC键关闭窗口的回调
glfwSetKeyCallback(window, (window, key, scancode, action, mods) -> {
if (key == GLFW_KEY_ESCAPE && action == GLFW_RELEASE) {
glfwSetWindowShouldClose(window, true); // 设置窗口关闭标志
}
});
// 获取主显示器的视频模式
GLFWVidMode vidmode = glfwGetVideoMode(glfwGetPrimaryMonitor());
// 将窗口居中
glfwSetWindowPos(
window,
(vidmode.width() - 800) / 2,
(vidmode.height() - 600) / 2
);
// 使OpenGL上下文成为当前上下文
glfwMakeContextCurrent(window);
// 启用v-sync
glfwSwapInterval(1);
// 使窗口可见
glfwShowWindow(window);
// 在这里调用 glfwMaximizeWindow 来最大化窗口
glfwMaximizeWindow(window); // 关键一步：最大化窗口
}
private void loop() {
// 创建OpenGL功能
GL.createCapabilities();
// 设置清除颜色
glClearColor(0.2f, 0.3f, 0.3f, 1.0f);
// 渲染循环直到用户请求关闭窗口
while (!glfwWindowShouldClose(window)) {
glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); // 清除帧缓冲
glfwSwapBuffers(window); // 交换颜色缓冲
glfwPollEvents(); // 处理窗口事件
}
}
public static void main(String[] args) {
new WindowMaximizationExample().run();
}
}在上述代码中，glfwMaximizeWindow(window); 这一行确保了在窗口显示后立即将其最大化。
2. 在窗口创建时最大化
如果您希望窗口在程序启动时就以最大化状态显示，而无需在创建后再手动调用glfwMaximizeWindow，可以通过设置GLFW窗口提示来实现。
2.1 GLFW_MAXIMIZED 窗口提示
GLFW提供了一个窗口提示GLFW_MAXIMIZED，可以在调用glfwCreateWindow之前设置。当此提示设置为GLFW_TRUE时，新创建的窗口将立即处于最大化状态。
2.2 使用示例
以下代码演示了如何在创建窗口之前设置GLFW_MAXIMIZED提示：
import org.lwjgl.glfw.*;
import org.lwjgl.opengl.*;
import static org.lwjgl.glfw.Callbacks.*;
import static org.lwjgl.glfw.GLFW.*;
import static org.lwjgl.opengl.GL11.*;
import static org.lwjgl.system.MemoryUtil.*;
public class WindowMaximizedOnCreationExample {
private long window;
public void run() {
init();
loop();
glfwFreeCallbacks(window);
glfwDestroyWindow(window);
glfwTerminate();
glfwSetErrorCallback(null).free();
}
private void init() {
GLFWErrorCallback.createPrint(System.err).set();
if (!glfwInit()) {
throw new IllegalStateException("Unable to initialize GLFW");
}
glfwDefaultWindowHints();
glfwWindowHint(GLFW_VISIBLE, GLFW_FALSE);
glfwWindowHint(GLFW_RESIZABLE, GLFW_TRUE);
// 关键一步：在创建窗口前设置GLFW_MAXIMIZED提示
glfwWindowHint(GLFW_MAXIMIZED, GLFW_TRUE);
window = glfwCreateWindow(800, 600, "LWJGL Window Maximized on Creation", NULL, NULL);
if (window == NULL) {
throw new RuntimeException("Failed to create the GLFW window");
}
glfwSetKeyCallback(window, (window, key, scancode, action, mods) -> {
if (key == GLFW_KEY_ESCAPE && action == GLFW_RELEASE) {
glfwSetWindowShouldClose(window, true);
}
});
// 窗口将自动最大化，因此无需手动设置位置或大小
// glfwSetWindowPos(...) 此时可能不再需要，因为最大化会覆盖它
glfwMakeContextCurrent(window);
glfwSwapInterval(1);
glfwShowWindow(window);
}
private void loop() {
GL.createCapabilities();
glClearColor(0.2f, 0.3f, 0.3f, 1.0f);
while (!glfwWindowShouldClose(window)) {
glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
glfwSwapBuffers(window);
glfwPollEvents();
}
}
public static void main(String[] args) {
new WindowMaximizedOnCreationExample().run();
}
}在这个例子中，glfwWindowHint(GLFW_MAXIMIZED, GLFW_TRUE); 确保了窗口在被操作系统渲染时就已经处于最大化状态。
3. 注意事项与总结
- 非全屏模式： glfwMaximizeWindow 和 GLFW_MAXIMIZED 提示实现的都是操作系统的“最大化”行为，这意味着窗口仍然会有标题栏、边框，并且任务栏或其他桌面元素依然可见。这与glfwSetWindowMonitor切换到全屏独占模式是不同的。
- 兼容性： 这些GLFW函数和提示在大多数现代操作系统（Windows, macOS, Linux）上都得到良好支持。
- 窗口状态： 您可以使用 glfwGetWindowAttrib(window, GLFW_MAXIMIZED) 来查询窗口当前是否处于最大化状态。
- 最佳实践： 如果您的应用程序需要根据用户偏好或其他运行时条件来决定是否最大化，那么在运行时调用 glfwMaximizeWindow 更合适。如果应用程序总是以最大化状态启动，则设置 GLFW_MAXIMIZED 提示更为简洁。
通过利用glfwMaximizeWindow方法或GLFW_MAXIMIZED窗口提示，LWJGL/GLFW开发者可以轻松地在应用程序中实现窗口的程序化最大化功能，从而提供更灵活的用户体验。
