glm-kmp

Kotlin Multiplatform bindings for GLM (OpenGL Mathematics) — the header-only C++ math library for graphics and simulation, wrapped from the glm git submodule. GLM is pure computation, so the bindings cover every platform with the full core function set: vectors, matrices, quaternions, transforms and scalar math, exposed with idiomatic Kotlin operator overloads and member extensions.

Kotlin Multiplatform / Android / JS / Wasm:

implementation("cn.enaium.glm:glm-kmp:1.0.0")

JVM: the right native binary is resolved automatically — the glm-kmp artifact pulls in the matching :jni-jvm-* sibling on the classpath:

• glm-kmp-jni-jvm-linux-x86_64
• glm-kmp-jni-jvm-linux-aarch64
• glm-kmp-jni-jvm-darwin-x86_64
• glm-kmp-jni-jvm-darwin-aarch64
• glm-kmp-jni-jvm-windows-x86_64

NativeLoader detects os.name/os.arch at runtime, extracts the matching binary from the classpath to a temp directory, and System.loads it. No java.library.path setup is required for downstream JVM consumers.

import cn.enaium.glm.*
import kotlin.math.PI

// Vectors
val a = vec3(1.0f, 2.0f, 3.0f)
val b = vec3(4.0f, 5.0f, 6.0f)
val sum = a + b
val dot = a dot b
val cross = a cross b
val normalized = a.normalized()

// Matrices
val model = mat4()
    .translated(1.0f, 2.0f, 3.0f)
    .rotated(PI.toFloat() / 4.0f, 0.0f, 1.0f, 0.0f)
    .scaled(2.0f, 2.0f, 2.0f)

val view = lookAt(
    eye = vec3(0.0f, 0.0f, 5.0f),
    center = vec3(0.0f, 0.0f, 0.0f),
    up = vec3(0.0f, 1.0f, 0.0f),
)
val projection = perspective(
    fovyRadians = PI.toFloat() / 2.0f,
    aspect = 16.0f / 9.0f,
    near = 0.1f,
    far = 100.0f,
)
val clip = projection * view * model * vec4(0.0f, 0.0f, 0.0f, 1.0f)

// Quaternions
val q = quat(axis = vec3(0.0f, 0.0f, 1.0f), angle = PI.toFloat() / 2.0f)
val rotated = q * vec3(1.0f, 0.0f, 0.0f)
val slerped = q.slerped(quat().rotated(1.0f, vec3(1.0f, 0.0f, 0.0f)), 0.5f)

// Scalars
val x = clamp(mix(1.0f, 4.0f, 0.5f), 0.0f, 2.0f)  // 2.0

All types are value types (vec3(1f, 2f, 3f) == vec3(1f, 2f, 3f)) with operator overloads for +, -, *, /, unaryMinus and get.

sin, cos, tan, asin, acos, atan, atan2, sinh, cosh, tanh, asinh, acosh, atanh, radians, degrees, abs, sign, floor, ceil, fract, trunc, round, roundEven, sqrt, inversesqrt, exp, log, exp2, log2, pow, mod, min, max, clamp, mix, step, smoothstep, fma, isnan, isinf

The example/ module exercises the published artifact on every desktop platform with a shared demo (GlmExamples.runAll()) plus tests:

• JVM — ./gradlew :example:runJvm
• Kotlin/Native — ./gradlew :example:runDebugExecutableMacosArm64 (and the equivalent linux/mingw/windows executables)
• JavaScript — ./gradlew :example:jsNodeDevelopmentRun
• Wasm — ./gradlew :example:wasmJsNodeDevelopmentRun

• JDK 17+
• CMake 3.16+
• Android SDK + NDK (for Android targets)
• Xcode command-line tools (for iOS/macOS/tvOS/watchOS targets)
• Emscripten (emcc on PATH, for JS/Wasm targets)
• aarch64-linux-gnu-gcc / x86_64-w64-mingw32-gcc (Linux hosts, for the linuxArm64/mingwX64 cross-compiled targets)

git clone --recursive https://github.com/Enaium/glm-kmp.git
cd glm-kmp

./gradlew :glm-kmp:publishToMavenLocal

./gradlew :glm-kmp:jvmTest        # JVM (JNI)
./gradlew :glm-kmp:macosArm64Test # macOS native
./gradlew :glm-kmp:jsTest         # JavaScript (Node)
./gradlew :glm-kmp:wasmJsNodeTest # WebAssembly (Node)
./gradlew :glm-kmp:testAndroidHostTest # Android host tests

glm-kmp/
├── glm/                     # Git submodule (GLM C++ headers)
├── jni/
│   ├── CMakeLists.txt       # JNI shared library + static library build
│   ├── jni_bridge.cpp       # JNI bridge (C++ → JVM/Android)
│   ├── c_api/               # C ABI dispatcher (glm_wrapper.h/.cpp, generated)
│   └── jvm/                 # Per-OS/arch JNI publication subprojects
│       ├── darwin-aarch64, darwin-x86_64
│       ├── linux-x86_64, linux-aarch64
│       └── windows-x86_64
├── glm-kmp/                 # Kotlin Multiplatform module
│   ├── build.gradle.kts
│   └── src/
│       ├── commonMain/      # API: Vec2/3/4, Mat2/3/4, Quat, transforms
│       ├── commonTest/      # Shared test suite (runs on every platform)
│       ├── jvmMain/         # JVM actual (JNI) + NativeLoader
│       ├── androidMain/     # Android actual (JNI)
│       ├── nativeMain/      # Native actual (cinterop)
│       ├── jsMain/          # JavaScript actual (Emscripten wasm)
│       ├── wasmJsMain/      # WebAssembly actual
│       └── nativeInterop/cinterop/
├── example/                 # Multiplatform usage examples + tests
├── tools/
│   └── gen_ops.py           # Single source of truth for the 337-op table
└── .github/workflows/       # publish + test

MIT — see the LICENSE file.