Окно и главный цикл

Откроешь окно GLFW и напишешь главный цикл, который держит окно на экране, пока окно не закроют крестиком.

Откроем наш проект в Visual Studio. GLFW уже собрана и подключена, но app пользуется библиотекой только ради одной строки в консоли и сразу завершается, как обычная консольная утилита. Движку нужна программа другого рода: окно, которое остаётся на экране, пока пользователь не закроет окно крестиком, и в котором потом видеокарта будет рисовать картинку.

Запустить GLFW

Почти любую функцию GLFW можно вызывать только после glfwInit. Функция glfwInit готовит GLFW к работе: загружает библиотеки Windows и узнаёт, какие мониторы подключены. Пара к glfwInit — функция glfwTerminate: она закрывает окна, которые программа не закрыла сама, и отдаёт Windows всё, что glfwInit взяла. Поэтому glfwTerminate вызывают перед тем, как программа завершится.

GLFW сообщает об ошибке не исключением и не текстом в консоли: GLFW вызывает функцию, которую ты передал заранее. Такую функцию называют функцией обратного вызова (по-английски callback): ты отдаёшь функцию библиотеке, а библиотека сама вызывает функцию, когда нужно. Функцию для ошибок программа передаёт в GLFW через glfwSetErrorCallback («задать функцию для ошибок»).

D:\dev\MyEngine\out\build\vs2026\Debug\app.exe (process 14220) exited with code 0 (0x0).Press any key to close this window . . .

#include <format>#include <iostream>#include <GLFW/glfw3.h>int main(){    glfwSetErrorCallback([](int code, const char* description) {        std::cerr << std::format("GLFW error {}: {}\n", code, description);    });    if (!glfwInit())    {        return 1;    }    glfwTerminate();    return 0;}

В новом коде две непривычные вещи: функция без имени, записанная прямо в скобках, и библиотека, которая сама вызывает твой код. Схема ниже разбирает по шагам обе вещи: как обычная функция становится лямбдой и как GLFW находит лямбду, когда случается ошибка.

Как работает callback в C++ на примере glfwSetErrorCallback

typedef void (* GLFWerrorfun)(int error_code, const char* description);

Открыть окно

GLFW работает, и теперь программа откроет окно. Окно создаёт функция glfwCreateWindow, а убирает функция glfwDestroyWindow.

#include <format>#include <iostream>#include <GLFW/glfw3.h>int main(){    glfwSetErrorCallback([](int code, const char* description) {        std::cerr << std::format("GLFW error {}: {}\n", code, description);    });    if (!glfwInit())    {        return 1;    }    GLFWwindow* window = glfwCreateWindow(1280, 720, "Engine", nullptr, nullptr);    if (!window)    {        glfwTerminate();        return 1;    }    glfwDestroyWindow(window);    glfwTerminate();    return 0;}

Окно мелькнуло и сразу пропало. Схема ниже показывает почему: в каком порядке программа выполняет вызовы GLFW и сколько времени окно существует между этими вызовами.

Почему окно GLFW сразу закрывается

Главный цикл

Чтобы окно оставалось на экране, программа не должна доходить до glfwDestroyWindow, пока окно не закрыли. Для этого в движке есть главный цикл: цикл while, который крутится между созданием окна и glfwDestroyWindow.

    GLFWwindow* window = glfwCreateWindow(1280, 720, "Engine", nullptr, nullptr);    if (!window)    {        glfwTerminate();        return 1;    }    while (!glfwWindowShouldClose(window))    {        glfwPollEvents();    }    glfwDestroyWindow(window);    glfwTerminate();    return 0;}

Схема ниже показывает, как две строки цикла управляют окном: откуда берутся движения мыши и щелчок по крестику и как щелчок заканчивает цикл.

Как окно получает события: зачем нужен glfwPollEvents

На схеме цикл замедлен, чтобы было видно каждый шаг. Настоящий цикл ничего не ждёт: как только glfwPollEvents разобрала очередь, цикл сразу начинает новую итерацию, даже если событий не было. Поэтому пустое окно целиком занимает один логический процессор. Проверить это можно в Visual Studio. Запусти программу с отладчиком, зелёной кнопкой или клавишей F5, и не закрывай окно Engine: цикл должен работать. Справа от кода откроется окно Diagnostic Tools. В окне найди нижний график с подписью CPU (% of all processors), то есть «процессор, процентов от всех процессоров». График показывает, какую долю всей мощности процессора занимает программа. Пока окно Engine открыто, линия графика стоит примерно на одном уровне: около 12%, если логических процессоров 8, и около 6%, если 16.

Итог

Программа app запускает GLFW, открывает окно 1280 на 720 и крутит главный цикл: каждая итерация забирает события окна, а после крестика выходит из цикла, убирает окно и выключает GLFW.

Так выглядит main.cpp после главы. CMakeLists.txt в этой главе не менялся.

#include <format>#include <iostream>#include <GLFW/glfw3.h>int main(){    glfwSetErrorCallback([](int code, const char* description) {        std::cerr << std::format("GLFW error {}: {}\n", code, description);    });    if (!glfwInit())    {        return 1;    }    GLFWwindow* window = glfwCreateWindow(1280, 720, "Engine", nullptr, nullptr);    if (!window)    {        glfwTerminate();        return 1;    }    while (!glfwWindowShouldClose(window))    {        glfwPollEvents();    }    glfwDestroyWindow(window);    glfwTerminate();    return 0;}