Class AudioEffects

CodenameOne/src/com/codename1/media/AudioEffects.java:32–345

/// normalized float PCM samples in the `[-1, 1]` range.  They return new
/// `AudioBuffer` instances and leave the source buffer unchanged.
public final class AudioEffects {
    private static final float DEFAULT_LOW_CUTOFF_HZ = 250.0f;
    private static final float DEFAULT_HIGH_CUTOFF_HZ = 4000.0f;
    private static boolean simdOptimizationsEnabled = Simd.get().isSupported();

    private AudioEffects() {
    }

    /// Indicates whether `AudioEffects` should use SIMD-backed kernels when
    /// the current platform supports them. Scalar fallbacks are always used for
    /// effects whose stateful filters don't map to the current SIMD API.
    ///
    /// #### Returns
    ///
    /// true when SIMD optimizations are enabled.
    public static boolean isSimdOptimizationsEnabled() {
        return simdOptimizationsEnabled;
    }

    /// Enables or disables SIMD-backed `AudioEffects` optimizations.
    ///
    /// This only changes internal implementation choices. It doesn't change
    /// output format or API behavior.
    ///
    /// #### Parameters
    ///
    /// - `enabled`: true to use SIMD where supported, false to force scalar loops.
    public static void setSimdOptimizationsEnabled(boolean enabled) {
        simdOptimizationsEnabled = enabled;
    }

    /// Restores the default SIMD optimization setting for this platform.
    public static void resetSimdOptimizationsEnabled() {
        simdOptimizationsEnabled = Simd.get().isSupported();
    }

    /// Applies gain to a PCM buffer.
    ///
    /// #### Parameters
    ///
    /// - `source`: The source buffer.
    /// - `gain`: Gain multiplier.  `1.0f` preserves level.
    ///
    /// #### Returns
    ///
    /// a new buffer with gain applied and samples clipped to `[-1, 1]`.
    public static AudioBuffer gain(AudioBuffer source, float gain) {
        validateBuffer(source);
        validateFinite(gain, "gain");
        float[] pcm = copySamples(source);
        applyGainInPlace(pcm, gain);
        return buffer(source.getSampleRate(), source.getNumChannels(), pcm);
    }

    /// Normalizes a PCM buffer so its largest absolute sample reaches `targetPeak`.
    ///
    /// #### Parameters
    ///