PitchPoint

data class PitchPoint(val pitch: Float, val confidence: Float, val timeSeconds: Float = 0.0f)

A pitch detection result or timestamped pitch sample.

Used for both single-frame detection output and as elements in pitch contours.

Constructors

constructor(pitch: Float, confidence: Float, timeSeconds: Float = 0.0f)

Tuning status relative to nearest musical note

Cents deviation from nearest note (-50 to +50). Returns 0 if not singing.

Detection confidence (0.0-1.0), derived from YIN aperiodicity

True if singing/voiced audio was detected

MIDI note number (e.g., 69 for A4). Returns -1 if not singing.

Musical note name (e.g., "A4", "C#5"). Returns null if not singing.

Detected pitch in Hz, or -1.0 if no pitch detected

Detection reliability (0.0-1.0). Higher = more confident.

Timestamp in seconds (0 when not relevant, e.g., single-frame detection)

Tuning status relative to nearest note