Create kinetic text
create_kinetic_textCreate animated kinetic typography overlays that flash, pulse, or slide over a background, driven by a rate-controlled LFO for live VJ lyric effects.
Instructions
Build a self-contained animated / kinetic typography layer — a word or line that flashes, pulses, or slides, the signature live-VJ lyric-flash effect. A Text TOP renders the text; an LFO CHOP at the given Rate (Hz) drives the animation: 'flash' gates a Level TOP's alpha/opacity hard on/off (a square wave — the text vanishes between flashes rather than turning black, so it pops cleanly in and out over a background), 'pulse' drives a Transform TOP's scale plus a Level TOP alpha fade (a sine, the text breathes), and 'slide' scrolls the Transform TOP's translate-X. With an input_path the text is composited OVER that source (pulled in by a Select TOP, so it can live in another container); without one it animates on a transparent frame. Output is a Null TOP. Rate is free-running for v1 — bind the LFO's frequency to a beat CHOP (or a Trigger to a detect_onsets channel) to lock the flashes to the tempo.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | The word or line to animate (the lyric flash). Rendered by a Text TOP. For multiple lines use \n. | DUQUESA |
| mode | No | Animation style: 'flash' = hard on/off blink (a square LFO gates the alpha/opacity — the classic lyric-flash, the text vanishes between flashes rather than going black); 'pulse' = breathing scale-up + alpha fade driven by a sine LFO; 'slide' = the text scrolls horizontally across the frame. | flash |
| size | No | Font size in pixels (drives the Text TOP's fontsizex / fontsizey). | |
| color | No | Text colour as a hex string ('#ffffff' = white). Sets the Text TOP's fontcolorr/g/b. | #ffffff |
| rate_hz | No | Animation rate in cycles per second (Hz) — the LFO frequency. Free-running for v1; bind it to a beat CHOP to fire on the actual beat. | |
| input_path | No | Optional absolute path of a source TOP to lay the text OVER. Pulled in via a Select TOP (TD wires don't cross containers) and composited under the text. If omitted, the text animates on a transparent frame. | |
| expose_controls | No | Expose live Text / Size / Color / Rate controls bound to the right node parameters. | |
| parent_path | No | /project1 |