threeagent
ClojureScript library for building Three.js apps in a reagent-like fashion
Installation
threeagent depends on THREE.js, so it will need to be added as a dependency to your project as well.
For shadow-cljs, install THREE.js using npm:
npm install --save three
For lein-cljsbuild, add an npm-deps entry on THREE.js:
:cljsbuild {:builds [{...
:compiler {...
:install-deps true
:npm-deps {:three "0.100.0"}}}]}
Example
(ns my-app.core
(:require [threeagent.core :as th]))
;; Use reactive atom for storing state
(defonce state (th/atom {:ticks 0}))
;; Tick every second
(.setInterval js/window #(swap! state update :ticks inc) 1000)
;; Form-1 component example
(defn color-box [color size]
[:box {:dims [size size size]
:material {:color color}}])
;; Form-2 component example
(defn growing-sphere []
(let [s (atom 0)]
(.setInterval js/window #(swap! s inc) 5000)
(fn []
[:sphere {:radius @s}])))
;; Root component render function
(defn root []
[:object {:position [1.0 0 -4.0]
:rotation [0 (.sin js/Math (:ticks @state)) 0]} ; Rotate on Y axis based on :ticks
[:ambient-light {:intensity 0.8}]
[color-box "red" 1.0] ; Don't forget to use square brackets!
[growing-sphere]])
;; Initialize and begin rendering threeagent scene
(defonce scene (th/render root (.-body js/document)))
Documentation
The latest documentation is available here
Development
Running Tests
Use shadow-cljs to watch unit tests
npx shadow-cljs watch test
Navigate to the HTTP server that shadow-cljs creates to view the test results