svara 1.1.1

svara — Formant and vocal synthesis: glottal source, vocal tract modeling, phonemes, prosody
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

//! Shared DSP utilities for svara synthesis modules.

use alloc::format;

/// Validates that a sample rate is positive and finite.
#[inline]
#[allow(dead_code)]
pub(crate) fn validate_sample_rate(sample_rate: f32) -> crate::error::Result<()> {
    if sample_rate <= 0.0 || !sample_rate.is_finite() {
        return Err(crate::error::SvaraError::InvalidFormant(format!(
            "sample_rate must be positive and finite, got {sample_rate}"
        )));
    }
    Ok(())
}

/// Validates that a duration is positive and finite.
#[inline]
#[allow(dead_code)]
pub(crate) fn validate_duration(duration: f32) -> crate::error::Result<()> {
    if duration <= 0.0 || !duration.is_finite() {
        return Err(crate::error::SvaraError::InvalidDuration(format!(
            "duration must be positive and finite, got {duration}"
        )));
    }
    Ok(())
}

/// Maps a naad backend error to a `SvaraError` with context.
#[cfg(feature = "naad-backend")]
#[allow(dead_code)]
pub(crate) fn map_naad_error(component: &str, err: naad::NaadError) -> crate::error::SvaraError {
    let msg = format!("{component} init failed: {err}");
    #[cfg(feature = "logging")]
    tracing::error!(component, %err, "naad backend error");
    crate::error::SvaraError::ComputationError(msg)
}