1. Clone the Project Repository 1. Клонирование репозитория проекта

You can clone or download the complete ready-to-run 3D demo project directly from GitHub: github.com/ivan-enzhaev/textured-cube-cglm-sdl3-image-webp-qt-desktop Вы можете клонировать или скачать готовый к запуску 3D демонстрационный проект с GitHub: github.com/ivan-enzhaev/textured-cube-cglm-sdl3-image-webp-qt-desktop

git clone https://github.com/ivan-enzhaev/textured-cube-cglm-sdl3-image-webp-qt-desktop.git

2. Project Directory Structure 2. Структура каталогов проекта

The repository contains the following files: Репозиторий содержит следующие файлы:

textured-cube-cglm-sdl3-image-webp-qt-desktop/
├── assets/
│   └── textures/
│       └── clear_01.webp
├── src/
│   ├── main.cpp
│   ├── mainwindow.h
│   └── mainwindow.cpp
└── CMakeLists.txt

• assets/textures/clear_01.webp: The WebP texture loaded at runtime and mapped across all 6 faces of the cube.Текстура формата WebP, загружаемая во время выполнения и накладываемая на все 6 граней куба.
• src/mainwindow.h / src/mainwindow.cpp: Subclasses QOpenGLWidget, defines 36 cube vertices, configures a dedicated UV buffer, enables GL_DEPTH_TEST, calculates Model, View, and Perspective matrices using cglm, passes the general MVP matrix to the vertex shader uniform u_mvp, and updates continuous rotation at 90°/s via QTimer and QElapsedTimer.Наследует QOpenGLWidget, определяет 36 вершин куба, настраивает выделенный UV-буфер, включает GL_DEPTH_TEST, вычисляет матрицы модели, вида и перспективы с помощью cglm, передаёт результирующую MVP-матрицу в uniform-переменную вершинного шейдера u_mvp и непрерывно вращает куб со скоростью 90°/с с помощью QTimer и QElapsedTimer.
• src/main.cpp: Initializes SDL3, sets OpenGL 3.3 Core profile format with a 24-bit depth buffer (format.setDepthBufferSize(24)), and starts the Qt application.Инициализирует SDL3, задаёт профиль OpenGL 3.3 Core с 24-битным буфером глубины (format.setDepthBufferSize(24)) и запускает приложение Qt.
• CMakeLists.txt: Adds the cglm include directory (C:/libs/cglm-0.9.6/include) and configures static linking for Qt 6, GLAD, SDL3, SDL3_image, and libwebp.Добавляет каталог включения cglm (C:/libs/cglm-0.9.6/include) и настраивает статическую компоновку с Qt 6, GLAD, SDL3, SDL3_image и libwebp.

3. Project Configuration & Testing in Qt Creator (Windows) 3. Конфигурация проекта и запуск в Qt Creator (Windows)

How to Open and Run in Qt Creator: Как открыть и запустить проект в Qt Creator:

1. In Qt Creator, click File > Open File or Project... (or press Ctrl+O). В Qt Creator нажмите File > Open File or Project... (или нажмите Ctrl+O).
2. Navigate to the cloned repository folder and select the CMakeLists.txt file. Перейдите в папку склонированного репозитория и выберите файл CMakeLists.txt.
3. In the Configure Project screen, select your kit Qt 6.12.0 Static (MinGW 16.2).
   Important: Only Debug is checked by default. Make sure to also check the Release checkbox so that Qt Creator configures the optimized release build! Then click Configure Project. На экране Configure Project выберите ваш Kit Qt 6.12.0 Static (MinGW 16.2).
   Важно: По умолчанию галочка стоит только на Debug. Обязательно поставьте галочку напротив Release, чтобы Qt Creator сконфигурировал оптимизированную Release-сборку! После этого нажмите Configure Project.
4. Switch the active build configuration to Release (click the monitor icon in the bottom-left corner of Qt Creator or press Ctrl+T). Переключите активную конфигурацию сборки на Release (нажмите на значок монитора в левом нижнем углу окна Qt Creator или нажмите Ctrl+T).
5. Press Ctrl+R to build and launch! The resulting single executable in the release build folder will run smoothly without needing any external DLLs. Нажмите Ctrl+R для сборки и запуска! Итоговый одиночный .exe файл в папке release-сборки запустится плавно без необходимости наличия каких-либо внешних DLL.

4. Build and Run on Ubuntu & Ubuntu WSL (Terminal) 4. Сборка и запуск на Ubuntu и Ubuntu WSL (Терминал)

On Ubuntu or Ubuntu WSL, configure and compile the project using CMake and Ninja from the terminal: В Ubuntu или Ubuntu WSL сконфигурируйте и скомпилируйте проект с помощью CMake и Ninja через терминал:

wsl -d Ubuntu

mkdir dist && cd dist

# Configure pointing to your static Qt
cmake -DCMAKE_PREFIX_PATH=$HOME/libs/qt-6.12.0-static-gcc \
      -DCMAKE_BUILD_TYPE=Release \
      -GNinja ..

# Build
ninja

# Run! Window appears seamlessly on Windows desktop via WSLg
./app

5. Expected Output 5. Ожидаемый результат

When launched, the desktop application displays a 500x500 window showing a 3D textured wooden crate cube rotating smoothly at exactly 90 degrees per second. Depth testing ensures rear faces are properly occluded, and perspective projection creates realistic depth with no lighting applied. При запуске откроется нативное десктопное окно (500x500), отображающее 3D-текстурированный деревянный ящик (куб), плавно вращающийся со скоростью ровно 90 градусов в секунду. Буфер глубины корректно отсекает скрытые задние грани, а перспективная проекция создаёт реалистичный объём без использования освещения.