Raylib 5.0 bindings for Clojure.
Thin wrapper around raylib.h and rlgl.h.
REQUIRES: java21 and --enable-preview jdk flag.
Add rayclj as a dependency. For Clojure CLI/deps.edn:
org.clojars.maksut/rayclj {:mvn/version "0.0.60"}
Add these two jvm options into your alias:
:jvm-opts [; for foreign function api
"--enable-preview"
"--enable-native-access=ALL-UNNAMED"]Hello world:
(ns basic-window
(:require [rayclj.raylib.functions :as rl]))
(defn -main []
(let [screen-width 800 screen-height 450]
(rl/init-window screen-width screen-height "raylib [core] example - basic window")
(rl/set-target-fps 60) ;; Set our game to run at 60 frames-per-second
;; Main game loop
(while (not (rl/window-should-close?)) ;; Detect window close button or ESC key
;; Update your game state here
;; Draw
(rl/with-drawing
(rl/clear-background :white)
(rl/draw-text "Hello, World!" 190 200 20 :lightgray)))
;; De-Initialization
(rl/close-window))) ;; Close window and OpenGL contextSee more raylib examples ported from raylib.
Note: Rayclj jar includes native libraries (eg. libraylib.so). By default it will export the raylib binary into your current working directory.
To provide your own raylib binary you can use rayclj.library property. For example:
:jvm-opts [; for foreign function api
"--enable-preview"
"--enable-native-access=ALL-UNNAMED"
; Optional raylib dynamic library.
"-Drayclj.library=/some/directory/libraylib.so"]
Raylib function/struct/enum names are converted into kebab-case:
ImageDrawCircleLines=>image-draw-circle-linesBoneInfo=>bone-info
For rlgl, rl prefix is dropped because it lives in a separate namespace:
rlPushMatrix=>push-matrix
Functions starting with "Is" has a question mark instead:
IsWindowReady=>window-ready?
Enumeration and pre-defined color arguments can be provided with regular keywords (see raylib enum types):
(clear-background :white)
(key-down? :right)Vectors and matrices can be represented with regular clojure vectors.
(draw-triangle [0 0] [0 10] [10 10] :darkblue)Other structs can be represented with clojure maps.
(clear-background {:r 255 :g 0 :b 255 :a 255})
(image-crop img {:x 100 :y 10 :width 280 :height 380})Not bad actually. Idiomatic clojure with immutable data structures is slow as expected. But it is cleaner and can be parallelized.
With mutable data structures, clojure can get really close to java's performance.
This wrapper uses Java's new Foreign Function and Memory (FFM) api. Which is designed to be performant (similar to JNI) and ergonomic (like JNA).
Bunnymark (silly example but gives an idea):
| implementation | explanation | bunnies | relative performance |
|---|---|---|---|
| textures_bunnymark.c | basic example in C, not optimised | 175000 | 1x |
| bunnymark.clj | rayclj, not optimised | 50000 | 0.29x |
| bunnymark_mutable.clj | rayclj, mutable data structures | 135000 | 0.77x |