VoxaTrace/com.musicmuni.voxatrace.tona.model/PitchPoint

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 (from PitchDetector.detect) and as elements in PitchContour. Provides computed properties for MIDI note, note label, cents deviation, and tuning status.

Constructors

PitchPoint

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

Types

Companion

object Companion

Tuning

enum Tuning : Enum<PitchPoint.Tuning>

Tuning status relative to nearest musical note

Properties

centsOff

val centsOff: Int

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

confidence

val confidence: Float

Detection confidence (0.0–1.0), derived from YIN aperiodicity.

isSinging

val isSinging: Boolean

True if singing/voiced audio was detected

midiNote

val midiNote: Int

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

note

val note: String?

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

pitch

val pitch: Float

Detected pitch in Hz, or -1f if no pitch detected (unvoiced).

reliability

val reliability: Float

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

timeSeconds

val timeSeconds: Float

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

tuning

val tuning: PitchPoint.Tuning

Tuning status relative to nearest note

PitchPoint

See also

Constructors

Types

Properties