Triggers

Overview

Triggers are conditions you can set on certain effects to animate and synchronize them to the current audio.

Hyperchroma currently supports two types of triggers: Novelty and Transition triggers.

Novelty Triggers

Novelty triggers are triggers that specify conditions on the Novelty Detection from the Analysis View. Novelty values from the novelty curves are used to determine when to trigger animations and how much to animate.

Novelty triggers are used primarily for animating Filter effects and certain Camera effects.

Novelty

Determines the novelty curve to read novelty values from:

  • None: prevents the trigger from activating
  • Low: use values from the Low novelty curve
  • Mid: use values from the Mid novelty curve
  • High: use values from the High novelty curve

Sensitivity

Affects the scaling of the animation based on the novelty value. Increasing this value causes the animation to scale to its maximum amount faster based on the current novely value.

Note that this effectively acts as a multiplier against the novelty value. This value also does not affect the threshold of the trigger.

Threshold

The minimum novelty value required to trigger the animation. Only values from the configured novelty curve greater than or equal to the threshold will activate the trigger.

Smoothing

The amount of smoothing to apply for the triggered animation. Increasing this value results in smoother animations.

Transition Triggers

Transition triggers are triggers that specify conditions on the Transition Detection and Energy Detection from the Analysis View.

Transition triggers are used for animating Transition effects.

Transition

Determines the transition value that will trigger the transition:

  • None: prevents the trigger from activating
  • Minor: triggers on Minor transition values from the transition curve
  • Major: triggers on Major transition values from the transition curve

Weight

An arbitrary value that represents probability of the transition occurring. This value is divided by the sum of the weights across all transition triggers that meet their threshold requirements and trigger on the same transition type to determine the probability of the trigger activating.

Threshold

The minimum energy value required to trigger the transition. Only values from the energy curve greater than or equal to the threshold when the transition occurs will activate the trigger.