Class PitchColorPolicy

Maps stabilized pitch to HSL color.

This class is stateful:

It stores a “last good” color used during brief silence.
It can (optionally) randomize a new idle color after sustained silence.

Index

Constructors

Accessors

Methods

Constructors

constructor

new PitchColorPolicy(deps: PitchColorPolicyDeps): PitchColorPolicy
Parameters
- deps: PitchColorPolicyDeps
  Policy dependencies and tuning. The provided pitch hysteresis tracker instance
  
  is treated as owned-by-caller and is not disposed by this class.
Returns PitchColorPolicy
- Defined in frontend/ts/animations/helpers/audio/PitchColorPolicy.ts:110

Accessors

lastGoodColor

get lastGoodColor(): HslColor
Most recent non-silence (or idle) color chosen by the policy.

Returns HslColor
- Defined in frontend/ts/animations/helpers/audio/PitchColorPolicy.ts:169

Methods

decide

decide(__namedParameters: DecideInput): ColorDecision
Computes the current pitch-driven color decision.
Parameters
- __namedParameters: DecideInput
Returns ColorDecision
Remarks
Heuristics (high level):
- Silence holds the last color; after sustained silence, picks a new idle color from silenceRanges.
- Pitch hue is anchored to the committed pitch class (pitchClassToHue).
- Micro drift offsets hue by a bounded amount based on fractional semitone distance.
- If noteStep is enabled, color updates only on commit events (result.changed).
Determinism: given the same internal state and inputs, results are deterministic except when sustained silence triggers a random idle color.
- Defined in frontend/ts/animations/helpers/audio/PitchColorPolicy.ts:127