使用 GLFW 实现 LWJGL 窗口的程序化最大化-java教程-PHP中文网

使用 GLFW 实现 LWJGL 窗口的程序化最大化

碧海醫心

发布： 2025-11-30 14:31:02

原创

982人浏览过

使用 GLFW 实现 LWJGL 窗口的程序化最大化

本文详细介绍了如何在 lwjgl 应用程序中通过编程方式最大化窗口，而非进入全屏模式。我们将重点讲解如何利用 glfw 库中的 `glfwmaximizewindow` 方法在运行时最大化窗口，以及如何在窗口创建时通过设置 `glfw_maximized` 提示实现默认最大化。这对于需要窗口适应桌面工作区，同时保留系统任务栏和标题栏的应用场景至关重要。

在开发基于 LWJGL 的图形应用程序时，开发者经常需要控制窗口的行为，例如调整大小、移动或最大化。与简单的全屏模式不同，有时我们需要将窗口最大化到桌面可用区域，同时保留操作系统的任务栏和窗口边框，就像用户点击窗口的最大化按钮一样。LWJGL 3 结合 GLFW 库提供了简洁高效的方法来实现这一需求。

理解窗口最大化与全屏模式的区别

在深入实现细节之前，明确“窗口最大化”和“全屏模式”之间的区别至关重要：

窗口最大化 (Maximized Window): 窗口会扩展到桌面可用区域的最大尺寸，但通常会避开操作系统的任务栏、Dock 栏或顶部面板。窗口仍然有标题栏和边框，允许用户通过拖动或点击来恢复、最小化或关闭。
全屏模式 (Fullscreen Mode): 窗口会占据整个屏幕，通常会隐藏所有操作系统 UI 元素（如任务栏、标题栏），提供沉浸式体验。在全屏模式下，应用程序通常直接控制屏幕分辨率。

本教程专注于实现“窗口最大化”，而非全屏模式。

使用 GLFW 实现窗口最大化

GLFW 库提供了两种主要方式来实现窗口最大化：在窗口创建时默认最大化，或在运行时动态最大化。

1. 运行时动态最大化窗口

如果你希望在应用程序运行过程中，根据特定事件（例如用户点击按钮或程序达到某个状态）来最大化一个已经存在的窗口，可以使用 glfwMaximizeWindow 方法。

方法签名：

void glfwMaximizeWindow(long window);

登录后复制

此方法接受一个 long 类型的参数，即要最大化的窗口的句柄。

示例代码：

以下是一个基本的 LWJGL 应用程序框架，演示了如何在窗口创建并显示后，通过调用 glfwMaximizeWindow 来实现运行时最大化。

工资查查移动工资条

大部分的工资还是以打印工资条的形式进行，偶有公司使用邮件发放工资条，而工资条的现代形式应该是移动工资条，以实现信息的备忘、到达、管理、对帐、环保、高效等需求……，用户已经习惯使用手机（或以其它移动方式）实现一切需求，应用的移动化是大势所趋。工资查查就在这样的背景下诞生，北京亦卓科技于2017的开发并推出了微信小程序工资查查。由于对有用户对数据隐私与安全性的考虑，北京亦卓科技在推出了云端应用--工资

查看详情

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 RuntimeMaximizeExample {

    private long window;

    public void run() {
        init();
        loop();

        // 释放窗口回调并销毁窗口
        glfwFreeCallbacks(window);
        glfwDestroyWindow(window);

        // 终止 GLFW 并释放错误回调
        glfwTerminate();
        glfwSetErrorCallback(null).free();
    }

    private void init() {
        // 设置错误回调
        glfwSetErrorCallback((error, description) -> System.err.println("GLFW Error " + error + ": " + description));

        // 初始化 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 Runtime Maximize Example", NULL, NULL);
        if (window == NULL) {
            throw new RuntimeException("Failed to create the GLFW window");
        }

        // 获取主显示器的视频模式
        GLFWVidMode vidmode = glfwGetVideoMode(glfwGetPrimaryMonitor());
        // 居中显示窗口
        glfwSetWindowPos(
                window,
                (vidmode.width() - 800) / 2,
                (vidmode.height() - 600) / 2
        );

        // 使 OpenGL 上下文成为当前上下文
        glfwMakeContextCurrent(window);
        // 启用垂直同步
        glfwSwapInterval(1);

        // 使窗口可见
        glfwShowWindow(window);

        // !!! 关键步骤：在窗口显示后，调用 glfwMaximizeWindow 来最大化窗口
        System.out.println("Maximizing window at runtime...");
        glfwMaximizeWindow(window);
    }

    private void loop() {
        // 确保 LWJGL 与 GLFW 的 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 RuntimeMaximizeExample().run();
    }
}

登录后复制

在上述代码中，glfwMaximizeWindow(window); 这一行是实现运行时最大化的核心。它会在窗口被创建并显示后，立即将其最大化到桌面可用区域。

2. 窗口创建时默认最大化

如果你希望窗口在创建时就以最大化状态显示，而不需要额外的运行时调用，可以在创建窗口之前设置一个 GLFW 窗口提示 (window hint)。

方法签名：

void glfwWindowHint(int hint, int value);

登录后复制

你需要使用 GLFW_MAXIMIZED 作为 hint 参数，并将其 value 设置为 GLFW_TRUE。

示例代码：

在 glfwCreateWindow 调用之前添加 glfwWindowHint(GLFW_MAXIMIZED, GLFW_TRUE); 即可。

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 DefaultMaximizeExample {

    private long window;

    public void run() {
        init();
        loop();

        glfwFreeCallbacks(window);
        glfwDestroyWindow(window);

        glfwTerminate();
        glfwSetErrorCallback(null).free();
    }

    private void init() {
        glfwSetErrorCallback((error, description) -> System.err.println("GLFW Error " + error + ": " + description));

        if (!glfwInit()) {
            throw new IllegalStateException("Unable to initialize GLFW");
        }

        // 配置 GLFW 窗口提示
        glfwDefaultWindowHints();
        glfwWindowHint(GLFW_VISIBLE, GLFW_FALSE); // 窗口创建后默认隐藏
        glfwWindowHint(GLFW_RESIZABLE, GLFW_TRUE); // 窗口可调整大小
        // !!! 关键步骤：在创建窗口前设置 GLFW_MAXIMIZED 提示
        glfwWindowHint(GLFW_MAXIMIZED, GLFW_TRUE); 

        // 创建窗口。注意：即使指定了初始宽度和高度，如果设置了GLFW_MAXIMIZED，窗口也会以最大化状态启动。
        window = glfwCreateWindow(800, 600, "LWJGL Default Maximize Example", NULL, NULL);
        if (window == NULL) {
            throw new RuntimeException("Failed to create the GLFW window");
        }

        // 由于窗口会默认最大化，居中设置可能不再必要，但可以保留以防万一或作为回退。
        // GLFWVidMode vidmode = glfwGetVideoMode(glfwGetPrimaryMonitor());
        // glfwSetWindowPos(window, (vidmode.width() - 800) / 2, (vidmode.height() - 600) / 2);

        glfwMakeContextCurrent(window);
        glfwSwapInterval(1);
        glfwShowWindow(window);
        System.out.println("Window created and maximized by default.");
    }

    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 DefaultMaximizeExample().run();
    }
}

登录后复制

在这种方法中，你不需要手动计算窗口的宽度和高度，GLFW 会自动处理这些细节，确保窗口最大化到适合桌面的尺寸。

注意事项

GLFW 初始化： 确保在调用任何 GLFW 窗口相关的函数之前，已经通过 glfwInit() 正确初始化了 GLFW 库。
窗口句柄： glfwMaximizeWindow 需要一个有效的窗口句柄 (long 类型)。确保你传递的是由 glfwCreateWindow 返回的句柄。
可调整大小： 为了确保最大化功能正常工作，建议在创建窗口时设置 glfwWindowHint(GLFW_RESIZABLE, GLFW_TRUE);。虽然不是强制要求，但一个不可调整大小的窗口通常不应该被最大化。
平台差异： 尽管 GLFW 旨在提供跨平台的一致性，但最大化窗口的具体行为（例如，是否精确避开所有系统面板）可能因操作系统和窗口管理器而略有差异。
用户体验： 在运行时触发最大化时，请考虑其对用户体验的影响。突然的窗口大小变化可能会让用户感到突兀。

总结

通过 GLFW 库，LWJGL 应用程序可以轻松实现窗口的程序化最大化。无论是通过 glfwMaximizeWindow 在运行时动态调整，还是通过 GLFW_MAXIMIZED 窗口提示在创建时默认最大化，这两种方法都提供了灵活且高效的解决方案，同时保留了操作系统桌面环境的完整性，避免了全屏模式的侵入性。掌握这些技术，将有助于开发者创建更加用户友好和适应性强的 LWJGL 应用程序。

以上就是使用 GLFW 实现 LWJGL 窗口的程序化最大化的详细内容，更多请关注php中文网其它相关文章！