VoxaTrace/com.musicmuni.voxatrace.calibra/ContourExtractorConfig

ContourExtractorConfig

data class ContourExtractorConfig(val preset: PitchPreset = PitchPreset.BALANCED, val algorithm: PitchAlgorithm = PitchAlgorithm.SWIFT_F0, val sampleRate: Int = 16000, val hopMs: Int = 10, val cleanup: ContourCleanup = ContourCleanup.SCORING, val voiceType: VoiceType = VoiceType.Auto, val quietHandling: QuietHandling = QuietHandling.NORMAL, val strictness: DetectionStrictness = DetectionStrictness.BALANCED)

Configuration for CalibraPitch ContourExtractor.

Usage Tiers

Tier 1: Presets (80% of users)

Kotlin

val extractor = CalibraPitch.createContourExtractor(
    ContourExtractorConfig.SCORING,
    modelProvider = { ModelLoader.loadSwiftF0() }
)

Swift

let extractor = CalibraPitch.createContourExtractor(
    config: .scoring,
    modelProvider: { ModelLoader.shared.loadSwiftF0() }
)

Tier 2: Builder (15% of users)

Kotlin

val config = ContourExtractorConfig.Builder()
    .preset(ContourExtractorConfig.SCORING)
    .sampleRate(16000)
    .hopMs(10)
    .build()
val extractor = CalibraPitch.createContourExtractor(config, modelProvider = { ... })

Swift

let config = ContourExtractorConfig.Builder()
    .preset(.scoring)
    .sampleRate(16000)
    .hopMs(10)
    .build()
let extractor = CalibraPitch.createContourExtractor(config: config, modelProvider: { ... })

Tier 3: .copy() (5% of users)

Kotlin

val config = ContourExtractorConfig.SCORING.copy(hopMs = 5)

Constructors

ContourExtractorConfig

constructor(preset: PitchPreset = PitchPreset.BALANCED, algorithm: PitchAlgorithm = PitchAlgorithm.SWIFT_F0, sampleRate: Int = 16000, hopMs: Int = 10, cleanup: ContourCleanup = ContourCleanup.SCORING, voiceType: VoiceType = VoiceType.Auto, quietHandling: QuietHandling = QuietHandling.NORMAL, strictness: DetectionStrictness = DetectionStrictness.BALANCED)