VoxaTrace/com.musicmuni.voxatrace.calibra.model/LessonMaterial/Companion

Companion

Functions

fun fromAudio(samples: FloatArray, sampleRate: Int, segments: List<Segment>, keyHz: Float, pitchContour: PitchContour? = null, hpcpFrames: List<FloatArray>? = null, lessonType: LessonType = LessonType.SINGALONG): LessonMaterial

Create a LessonMaterial from raw audio samples.

fromFile

fun fromFile(audioPath: String, segments: List<Segment>, keyHz: Float): LessonMaterial

Create a LessonMaterial from file paths.

reconcileSegments

fun reconcileSegments(segments: List<Segment>, lessonType: LessonType, audioDurationSec: Float): Pair<List<Segment>, List<String>>

Reconcile already-built Segments against the declared lessonType (see segmentsFromTrans for the rules). Authoring tools (the lesson-extractor) call this directly on segments built from other inputs and surface the returned warnings in their run summaries; runtime loading goes through segmentsFromTrans.

segmentsFromTrans

fun segmentsFromTrans(trans: TransData, lessonType: LessonType, audioDurationSec: Float, onWarning: (String) -> Unit = { Logger.w(WARN_TAG, it) }): List<Segment>

Build this lesson's Segments from a parsed .trans (TransData), with lessonType as the authority for the mapping: