How sunset-sejong-university/tolqyn works
Tolkyn is a Processing-based generative-art sketch: audio and motion inputs influence a 3D particle-and-edge scene, with procedural melody and optional gyroscope support. Its principal workflow is sensing, analyzing input, updating the scene, and rendering it with sound. The README describes most sketch internals, but the only sampled source is the BLE-to-UDP bridge; therefore sketch-stage relationships are documented in the README, and the bridge-to-sketch connection is left unverified.
Main entry points: Tolqyn.pde 3D Node Universe · ble_to_processing.py BLE UDP Bridge · Tolqyn.ino Arduino Gyroscope Firmware
Components 17
Input and Motion
- Camera Motion Tracking
Tolqyn.pde - Gyro Camera Fusion
Tolqyn.pde
Generative Artwork
- 3D Node Universe
Tolqyn.pde - Node Respawn and Reveal
Tolqyn.pde - Focus Node Selection
Tolqyn.pde - Farthest Node Sorting
Tolqyn.pde - Edge Burst Rendering
Tolqyn.pde - Scene Rotation
Tolqyn.pde - P3D Scene Output
Tolqyn.pde
Audio and Melody
- FFT and Beat Analysis
Tolqyn.pde - Procedural Melody
Tolqyn.pde - Tone Synthesis
Tolqyn.pde
Gyroscope Transport
- BLE UDP Bridge
ble_to_processing.py - Arduino Gyroscope Firmware
Tolqyn/Tolqyn.ino
Other components
- Microphone
- Webcam
- Gyroscope Device
Connections 18
- Webcam → Camera Motion Tracking: provides frames
README.md - Camera Motion Tracking → Gyro Camera Fusion: supplies motion
README.md - Gyroscope Device → Arduino Gyroscope Firmware: sends gyro data
README.md - Arduino Gyroscope Firmware → BLE UDP Bridge: BLE notifications
ble_to_processing.py - BLE UDP Bridge → Gyro Camera Fusion: forwards gyro data
- Gyro Camera Fusion → Scene Rotation: sets orientation
README.md - Microphone → FFT and Beat Analysis: provides audio
README.md - FFT and Beat Analysis → Edge Burst Rendering: drives burst density
README.md - FFT and Beat Analysis → 3D Node Universe: triggers beat response
README.md - Node Respawn and Reveal → 3D Node Universe: regenerates nodes
README.md - 3D Node Universe → Focus Node Selection: supplies nodes
README.md - Focus Node Selection → Farthest Node Sorting: selects focus nodes
README.md - Farthest Node Sorting → Edge Burst Rendering: identifies distant nodes
README.md - Focus Node Selection → Procedural Melody: advances phrase
README.md - Procedural Melody → Tone Synthesis: plays notes
README.md - Edge Burst Rendering → P3D Scene Output: draws connections
README.md - 3D Node Universe → P3D Scene Output: renders nodes
README.md - Scene Rotation → P3D Scene Output: rotates scene
README.md