VoxaTrace/com.musicmuni.voxatrace.calibra.model/PitchContour

PitchContour

data class PitchContour(val samples: List<PitchPoint>, val sampleRate: Int = 16000)

A sequence of pitch points representing a pitch contour over time.

Replaces parallel arrays (times[], pitches[]) with a structured representation.

Constructors

PitchContour

constructor(samples: List<PitchPoint>, sampleRate: Int = 16000)

Types

Companion

object Companion

Properties

duration

val duration: Float

Duration of the contour in seconds

isEmpty

val isEmpty: Boolean

True if contour has no samples

pitchesHz

@ShouldRefineInSwift

val pitchesHz: FloatArray

Pitches in Hz (fast path). Unvoiced frames use -1.

pitchesMidi

@ShouldRefineInSwift

val pitchesMidi: FloatArray

Pitches in MIDI for native evaluator (fast path). Unvoiced frames use -1.

sampleRate

val sampleRate: Int

Original audio sample rate (default 16kHz)

samples

val samples: List<PitchPoint>

List of pitch points in chronological order

size

val size: Int

Number of samples in the contour

times

@ShouldRefineInSwift

val times: FloatArray

Times array for native evaluator (fast path)

voicedRatio

val voicedRatio: Float

Ratio of voiced samples to total samples (0.0 - 1.0)

Functions

slice

fun slice(startTime: Float, endTime: Float, relativeTimes: Boolean = true): PitchContour

Extract a slice of the contour within a time range.

toPitchesArray

@ShouldRefineInSwift

fun toPitchesArray(): FloatArray

Get pitches as a FloatArray (for compatibility with internal APIs).

toTimesArray

@ShouldRefineInSwift

fun toTimesArray(): FloatArray

Get times as a FloatArray (for compatibility with internal APIs).