kiteplayer-audioviz/io.github.yuroyami.kiteplayer.audioviz.viz.motion/Gestures

Gestures

Confident transients and supported structural edges, with separate continuous visual cycles.

A hit is a transient the detector supports, whatever its level: see AudioDetection.isHit. The strength of a hit says how much the picture should answer. The names below are the bands the detectors watch. They do not identify instruments.

Constructors

Gestures

constructor()

Properties

bar

val ~~bar~~: Boolean

barPhase

val ~~barPhase~~: Float

bars

val ~~bars~~: Int

barSeconds

val ~~barSeconds~~: Float

beatSeconds

val beatSeconds: Float

breakdown

var breakdown: Boolean

cyclePhase

var cyclePhase: Float

Artistic four-pulse cycle, with level-driven free motion when rhythm is unavailable.

cycles

var cycles: Int

cycleSeconds

var cycleSeconds: Float

Nominal duration used for continuous parameter responses, not a measured bar length.

drop

var drop: Boolean

hat

var hat: Float

Strength of the strongest high-transient hit in this frame.

hats

var hats: Int

How many high-transient hits this frame carried.

kick

var kick: Float

Strength of the strongest low-transient hit in this frame, 0 when there is none.

kicks

var kicks: Int

How many low-transient hits this frame carried. Several land in one frame at a low frame rate.

phrase

val ~~phrase~~: Boolean

phrasePhase

val ~~phrasePhase~~: Float

phrases

val ~~phrases~~: Int

pulseUsable

var pulseUsable: Boolean

Whether the cycles follow a supported pulse rather than running free.

section

var section: Boolean

An accepted structural boundary. Neither elapsed time nor pulse counting produces this.

sections

var sections: Int

silence

var silence: Boolean

True while the overall driver has remained below 0.02 for two seconds.

slowCyclePhase

var slowCyclePhase: Float

Artistic sixteen-pulse cycle. This does not describe a musical phrase.

slowCycles

var slowCycles: Int

snare

var snare: Float

Strength of the strongest body-transient hit in this frame.

snares

var snares: Int

How many body-transient hits this frame carried.

surge

var surge: Boolean

A moment for a drawing's biggest gesture: an accepted drop, or the first strong rise in energy after six quiet seconds, at most once a minute.

surges

var surges: Int

turn

var turn: Boolean

A moment to change the picture: an accepted boundary, or the eighth cycle since the last turn while something plays.

turns

var turns: Int

Functions

reset

fun reset()

update

fun update(state: VizRenderState)

Reads one frame. Repeating the same state does not repeat an edge. A new frame at an instant already read delivers its edges without advancing the cycles again.