Step 1: Download Source Code Шаг 1: Скачивание исходного кода

Download the latest release zip archive directly from GitHub Releases: Скачайте zip-архив последнего релиза напрямую из GitHub Releases:

Download cglm Releases Скачать релизы cglm

For Ubuntu, you can download it via wget in terminal: В Ubuntu вы можете скачать архив с помощью wget через терминал:

sudo apt update && sudo apt install -y wget unzip

cd ~
wget https://github.com/recp/cglm/archive/refs/tags/v0.9.6.zip -O cglm-0.9.6.zip

Step 2: Extract the Library Шаг 2: Распаковка библиотеки

Option A: Windows Вариант A: Windows

Unzip the downloaded archive so that the header files are located in C:\libs\cglm-0.9.6\include. Распакуйте скачанный архив так, чтобы заголовочные файлы находились в папке C:\libs\cglm-0.9.6\include.

Option B: Ubuntu Вариант B: Ubuntu

Unzip the archive into the ~/libs directory: Распакуйте архив в директорию ~/libs:

mkdir -p ~/libs
unzip -o cglm-0.9.6.zip -d ~/libs/
rm -f cglm-0.9.6.zip

This will extract the headers into ~/libs/cglm-0.9.6/include. Заголовочные файлы будут распакованы по пути ~/libs/cglm-0.9.6/include.

Step 3: Create Project Directory Шаг 3: Создание директории проекта

Create a workspace folder and a new directory for your cglm test project: Создайте рабочую папку для проектов и новую директорию для вашего тестового проекта cglm:

Windows (Command Prompt / PowerShell)

mkdir C:\projects\cglm-test
cd C:\projects\cglm-test

Ubuntu (Terminal)

mkdir -p ~/projects/cglm-test
cd ~/projects/cglm-test

Step 4: Create Source Files (main.c & CMakeLists.txt) Шаг 4: Создание исходных файлов (main.c и CMakeLists.txt)

You can create these files using Notepad / Sublime Text on Windows, or nano in Ubuntu terminal: Вы можете создать эти файлы через Блокнот / Sublime Text в Windows или с помощью nano в терминале Ubuntu:

Windows (Terminal / Notepad)

notepad main.c
notepad CMakeLists.txt

Ubuntu (Terminal / Nano)

nano main.c
nano CMakeLists.txt

1. File Contents for main.c 1. Содержимое файла main.c

#include <stdio.h>
#include <cglm/cglm.h>

int main(int argc, char *argv[]) {
    vec3 v1 = {1.0f, 2.0f, 3.0f};
    vec3 v2 = {4.0f, 5.0f, 6.0f};
    vec3 result;

    glm_vec3_add(v1, v2, result);

    printf("Result vector: [%.1f, %.1f, %.1f]\n", result[0], result[1], result[2]);
    return 0;
}

2. File Contents for CMakeLists.txt 2. Содержимое файла CMakeLists.txt

cmake_minimum_required(VERSION 3.21)
project(cglm_test C)

add_executable(app main.c)

if(WIN32)
    target_include_directories(app PRIVATE C:/libs/cglm-0.9.6/include)
else()
    target_include_directories(app PRIVATE $ENV{HOME}/libs/cglm-0.9.6/include)
endif()

Step 5: Create Build & Execution Scripts Шаг 5: Создание скриптов сборки и запуска

Windows (MinGW / Batch Scripts)

config-exe.bat

cmake -G Ninja -S . -B dist/win

build-exe.bat

cmake --build dist/win

run-exe.bat

@echo off
.\dist\win\app.exe

Run the scripts sequentially in Command Prompt or PowerShell: Последовательно запустите скрипты в командной строке или PowerShell:

config-exe.bat
build-exe.bat
run-exe.bat

Ubuntu (Bash Scripts)

config-bin.sh

#!/usr/bin/env bash
set -e
cmake -G Ninja -S . -B dist/linux

build-bin.sh

#!/usr/bin/env bash
set -e
cmake --build dist/linux

run-bin.sh

#!/usr/bin/env bash
set -e
./dist/linux/app

Grant execute permissions on Ubuntu before running: Предоставьте права на выполнение в Ubuntu перед запуском:

chmod +x config-bin.sh build-bin.sh run-bin.sh
./config-bin.sh
./build-bin.sh
./run-bin.sh