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

PitchProcessingConfig

data class PitchProcessingConfig(val fixOctaveErrors: Boolean = true, val removeSpuriousJumps: Boolean = true, val octaveThresholdCents: Float = 150.0f, val referencePitchHz: Float = 0.0f, val fixBoundaryOctaves: Boolean = true, val boundaryWindowMs: Float = 50.0f, val smoothPitch: Boolean = true, val smoothingWindowSize: Int = 7, val removeBlips: Boolean = true, val minimumNoteDurationMs: Float = 80.0f, val hopMs: Int = 10)

Configuration for batch pitch processing pipeline (ADR-001).

Replaces ContourCleanup with expanded config covering octave correction, smoothing, and blip removal. Supports 3-tier API: presets, builder, .copy().

Usage

// Tier 1: Preset
PitchProcessing.process(contour, PitchProcessingConfig.SCORING)

// Tier 2: Builder
val config = PitchProcessingConfig.Builder()
    .fixOctaveErrors(true)
    .removeSpuriousJumps(false)
    .smoothingWindowSize(9)
    .build()

// Tier 3: .copy()
PitchProcessing.process(contour, PitchProcessingConfig.DISPLAY.copy(hopMs = 20))

iOS (Swift)

// Tier 1: Preset (lowercase Swift accessors: .raw / .scoring / .display)
PitchProcessing.process(contour: contour, config: .scoring)

// Tier 2: Builder (native Int, not Int32)
let config = PitchProcessingConfig.Builder()
    .fixOctaveErrors(true)
    .removeSpuriousJumps(false)
    .smoothingWindowSize(9)
    .build()

// Tier 3: .doCopy()  (SKIE bridge for Kotlin's .copy)
let config = PitchProcessingConfig.display.doCopy(hopMs: 20)

Constructors

PitchProcessingConfig

constructor(fixOctaveErrors: Boolean = true, removeSpuriousJumps: Boolean = true, octaveThresholdCents: Float = 150.0f, referencePitchHz: Float = 0.0f, fixBoundaryOctaves: Boolean = true, boundaryWindowMs: Float = 50.0f, smoothPitch: Boolean = true, smoothingWindowSize: Int = 7, removeBlips: Boolean = true, minimumNoteDurationMs: Float = 80.0f, hopMs: Int = 10)