/Kaleidocycles

Kaleidocycle simulator and editor built using Three.js

Primary LanguageJavaScriptGNU General Public License v2.0GPL-2.0

Kaleidocycles

This is a project to simulate and design Kaleidocycles through various boolean solid operations (subtraction, union, intersection). Basic Kaleidocycles can "sculpted" using various tools such as cones, cylinders, and prisms.
Made possible by Three.js (see below), the simulation follows the equations explained in this paper to model Kaleidocyclic behavior both before and after the sculpting process.

Demos

Interact with the live-hosted project at our website here.

Project Resources

Dependencies

  1. Three.js
    Three.js Docs
    Three.js Fundamentals
    Three.js r115 Source

  2. CSG.js
    CSG.js Homepage
    CSG.js port for Three

  3. FileSaver.js
    FileSaver Home
    FileSaver pure JS implementation

Math Tools & Theory

3D Reflection Matrix. The kaleidocycle itself is an illusion – a single base unit is simply rotated around the z axis and reflected across the approriate planes successively to mimic the appearance of a physical kaleidocycle.
Transformation Debugging. A simple tool to step through the governing equations.