README
T
AudioAnalysis
T
AudioData
T
ValidationResult
T
WavError
T
WavInfo
V
adjust_volume
V
analyze
V
calculate_dc_offset
V
combine_stereo
V
concat
V
convert_bit_depth
V
convert_channels
V
count_clipped_samples
V
count_silent_samples
V
count_zero_crossings
V
cross_correlation_zero_lag
V
decode
V
delay
V
echo
V
encode
V
encode_with_format
V
extract_channel
V
fade_in
V
fade_out
V
format_analysis
V
format_wav_info
V
generate_chirp
V
generate_noise
V
generate_sawtooth
V
generate_silence
V
generate_sine
V
generate_sine_wav
V
generate_square
V
generate_triangle
V
get_duration
V
get_frame_count
V
get_info
V
get_peak_amplitude
V
get_rms_level
V
high_pass_filter
V
low_pass_filter
V
make_audio_data
V
make_wav_info
V
mix
V
mix_multiple
V
normalize
V
pad_to_length
V
remove_dc_offset
V
repeat
V
resample
V
reverse
V
reverse_reverb
V
soft_clip
V
split_stereo
V
trim
V
validate

moon-wav

MoonBit 原生 WAV 音频解码库 | A native MoonBit WAV audio decoding library

wav

audio

pcm

decode

encode

RIFF

float

Download zip

Author

bw448

Version

0.3.0

License

Apache-2.0

Repository

github.com/bw448/moon-wav

Last updated

2 months ago

Downloads

No dependencies

#🎵 moon-wav

MoonBit 原生 WAV 音频库

A native MoonBit WAV audio library.

一个纯 MoonBit 实现的 WAV 音频库，支持解码、编码、格式转换、音频操作、波形生成和音频分析。

#✨ Features / 功能特性

WAV 解码 - 支持 8/16/24/32 位 PCM 和 IEEE 754 浮点格式
WAV 编码 - 将音频数据编码为标准 WAV 文件
格式验证 - 详细的 WAV 文件格式检查和警告
格式转换 - 位深转换、声道转换、采样率重采样
音频操作 - 裁剪、拼接、音量调整、混音、淡入淡出、反转
音频效果 - 回声、延迟、归一化、软限幅、低通/高通滤波
波形生成 - 正弦波、方波、锯齿波、三角波、噪声、啁啾
音频分析 - 峰值、RMS、直流偏移、过零率、削波检测、静音检测
工具函数 - 声道分离/合并、重复、填充、交叉相关

#📦 Installation

moon add bw448/moon-wav

#🚀 Quick Start

fn main {
  // Generate a 440Hz sine wave
  let audio = generate_sine_wav(440.0, 16000.0, 44100, 1.0, 16)

  // Encode to WAV format
  let wav_bytes = encode(audio)
  println("Generated " + wav_bytes.length().to_string() + " bytes")

  // Decode and analyze
  match decode(wav_bytes) {
    Ok(decoded) => {
      let analysis = analyze(decoded, 100)
      println("Peak: " + analysis.peak.to_string())
      println("RMS: " + analysis.rms.to_string())
    }
    Err(_) => println("Decode failed")
  }
}

#📚 API Reference

#Core Types

#WavInfo

pub struct WavInfo {
  audio_format : Int    // 1 = PCM, 3 = IEEE float
  num_channels : Int    // 1 = mono, 2 = stereo
  sample_rate : Int     // Sample rate in Hz (e.g., 44100)
  byte_rate : Int       // Byte rate
  block_align : Int     // Block align
  bits_per_sample : Int // 8, 16, 24, or 32
  data_size : Int       // Data size in bytes
}

#AudioData

pub struct AudioData {
  samples : Array[Int]  // Decoded samples (32-bit signed integers)
  info : WavInfo        // Format information
}

#WavError

pub enum WavError {
  InvalidHeader
  UnsupportedFormat
  CorruptedData
  InvalidChunk
}

#ValidationResult

pub struct ValidationResult {
  is_valid : Bool
  warnings : Array[String]
  error : String?
}

#AudioAnalysis

pub struct AudioAnalysis {
  duration_sec : Double
  samples_per_channel : Int
  peak : Int
  rms : Double
  dc_offset : Double
  zero_crossings : Int
  has_clipping : Bool
  clipped_samples : Int
  is_silent : Bool
  silence_ratio : Double
}

#Decoding Functions

Function	Description
decode(data : Bytes) -> Result[AudioData, WavError]	Decode a WAV file (PCM & IEEE float)
get_info(data : Bytes) -> Result[WavInfo, WavError]	Get WAV info without decoding

#Encoding Functions

Function	Description
encode(audio : AudioData) -> Bytes	Encode audio data to WAV format
encode_with_format(samples, num_channels, sample_rate, bits_per_sample) -> Bytes	Encode with specified format

#Validation Functions

Function	Description
validate(data : Bytes) -> ValidationResult	Validate WAV file structure

#Conversion Functions

Function	Description
convert_bit_depth(samples, from_bits, to_bits) -> Result[Array[Int], WavError]	Convert bit depth
convert_channels(samples, from_channels, to_channels) -> Result[Array[Int], WavError]	Convert channels
resample(samples, from_rate, to_rate, num_channels) -> Array[Int]	Resample audio

#Audio Operations

Function	Description
trim(samples, start, end) -> Array[Int]	Trim audio
concat(a, b) -> Array[Int]	Concatenate audio
adjust_volume(samples, factor) -> Array[Int]	Adjust volume
mix(a, b) -> Array[Int]	Mix two streams
fade_in(samples, fade_samples) -> Array[Int]	Fade in
fade_out(samples, fade_samples) -> Array[Int]	Fade out
reverse(samples) -> Array[Int]	Reverse audio
get_peak_amplitude(samples) -> Int	Get peak amplitude
get_rms_level(samples) -> Double	Get RMS level

#Audio Effects

Function	Description
echo(samples, delay_samples, decay) -> Array[Int]	Echo effect
delay(samples, delay_samples, mix) -> Array[Int]	Delay effect
normalize(samples, target_peak) -> Array[Int]	Normalize to target peak
soft_clip(samples, threshold) -> Array[Int]	Soft clipping
remove_dc_offset(samples) -> Array[Int]	Remove DC offset
low_pass_filter(samples, window_size) -> Array[Int]	Low-pass filter
high_pass_filter(samples, window_size) -> Array[Int]	High-pass filter
reverse_reverb(samples, fade_samples) -> Array[Int]	Reverse reverb

#Waveform Generators

Function	Description
generate_sine(freq, amp, rate, duration) -> Array[Int]	Sine wave
generate_square(freq, amp, rate, duration) -> Array[Int]	Square wave
generate_sawtooth(freq, amp, rate, duration) -> Array[Int]	Sawtooth wave
generate_triangle(freq, amp, rate, duration) -> Array[Int]	Triangle wave
generate_noise(amp, rate, duration, seed) -> Array[Int]	White noise
generate_chirp(start_freq, end_freq, amp, rate, duration) -> Array[Int]	Frequency sweep
generate_silence(rate, duration) -> Array[Int]	Silence
generate_sine_wav(freq, amp, rate, duration, bits) -> AudioData	Sine as AudioData

#Audio Analysis

Function	Description
analyze(audio, silence_threshold) -> AudioAnalysis	Full analysis
calculate_dc_offset(samples) -> Double	DC offset
count_zero_crossings(samples) -> Int	Zero crossings
count_clipped_samples(samples, min, max) -> Int	Clipped samples
count_silent_samples(samples, threshold) -> Int	Silent samples
format_analysis(analysis) -> String	Format analysis as string

#Utility Functions

Function	Description
format_wav_info(info) -> String	Format WAV info as string
split_stereo(samples) -> (Array[Int], Array[Int])	Split stereo to L/R
combine_stereo(left, right) -> Array[Int]	Combine L/R to stereo
get_duration(audio) -> Double	Get duration in seconds
get_frame_count(audio) -> Int	Get frame count
extract_channel(samples, num_channels, channel) -> Array[Int]	Extract one channel
mix_multiple(streams) -> Array[Int]	Mix multiple streams
repeat(samples, times) -> Array[Int]	Repeat audio
pad_to_length(samples, target_length) -> Array[Int]	Pad with silence
cross_correlation_zero_lag(a, b) -> Double	Cross-correlation

#⚠️ Limitations / 功能边界

#Supported Formats / 支持的格式

Format	Decode	Encode
PCM 8-bit unsigned	✅	✅
PCM 16-bit signed LE	✅	✅
PCM 24-bit signed LE	✅	✅
PCM 32-bit signed LE	✅	✅
IEEE 754 32-bit float	✅	❌
ADPCM, A-law, μ-law	❌	❌
Compressed formats	❌	❌

#Channel Support / 声道支持

Channels	Support
Mono (1ch)	✅ Full
Stereo (2ch)	✅ Full
Multi-channel (3+)	⚠️ Partial (decode only)

#Sample Rate / 采样率

Any sample rate from 1 Hz to 192,000 Hz
Resampling uses linear interpolation (not band-limited)

#Known Limitations / 已知限制

Only standard WAV files - RIFF/WAVE format only, no RF64 or BWF
No compressed formats - ADPCM, A-law, μ-law not supported
IEEE float encode not supported - Can decode but not encode float WAV
Linear interpolation resampling - May introduce aliasing at extreme ratios
No metadata chunks - LIST, INFO chunks are ignored
32-bit integer samples - All samples stored as 32-bit signed integers internally

#📝 Examples

#Generate and Encode WAV

let audio = generate_sine_wav(440.0, 16000.0, 44100, 1.0, 16)
let wav_bytes = encode(audio)
println("WAV file: " + wav_bytes.length().to_string() + " bytes")

#Validate WAV File

let result = validate(wav_data)
if result.is_valid {
  println("Valid WAV file")
} else {
  println("Invalid: " + result.error.to_string())
}

#Audio Analysis

match decode(wav_data) {
  Ok(audio) => {
    let analysis = analyze(audio, 100)
    println("Duration: " + analysis.duration_sec.to_string() + "s")
    println("Peak: " + analysis.peak.to_string())
    println("Clipping: " + analysis.has_clipping.to_string())
  }
  Err(_) => ()
}

#Processing Pipeline

let audio = generate_sine_wav(440.0, 16000.0, 44100, 1.0, 16)
let processed = fade_in(audio.samples, 4410) // 100ms fade in
let processed = fade_out(processed, 4410) // 100ms fade out
let processed = normalize(processed, 32000) // Normalize
let encoded = encode({ samples: processed, info: audio.info })

#🔨 Building

# Build the library
moon build

# Run tests
moon test

# Run the example
moon run cmd/main

#📄 License

Apache-2.0

#🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

AudioAnalysis

source

pub struct AudioAnalysis {
  duration_sec : Double
  samples_per_channel : Int
  peak : Int
  rms : Double
  dc_offset : Double
  zero_crossings : Int
  has_clipping : Bool
  clipped_samples : Int
  is_silent : Bool
  silence_ratio : Double
} derive(@moonbitlang/core/debug.Debug
Debug)

Result of audio analysis.

AudioData

source

pub struct AudioData {
  samples : Array[Int]
  info : WavInfo
} derive(@moonbitlang/core/debug.Debug
Debug)

Represents decoded audio data with format information.

ValidationResult

source

pub struct ValidationResult {
  is_valid : Bool
  warnings : Array[String]
  error : String?
} derive(@moonbitlang/core/debug.Debug
Debug)

Validation result with detailed error information.

WavError

source

pub enum WavError {
  InvalidHeader
  UnsupportedFormat
  CorruptedData
  InvalidChunk
} derive(Eq, @moonbitlang/core/debug.Debug
Debug)

Errors that can occur during WAV decoding.

WavInfo

source

pub struct WavInfo {
  audio_format : Int
  num_channels : Int
  sample_rate : Int
  byte_rate : Int
  block_align : Int
  bits_per_sample : Int
  data_size : Int
} derive(@moonbitlang/core/debug.Debug
Debug)

Represents the format information of a WAV file.

adjust_volume

source

fn adjust_volume(samples : Array[Int], factor : Double) -> Array[Int]

Adjust the volume of audio samples.

Arguments

samples - Input audio samples
factor - Volume multiplier (1.0 = no change, 0.5 = half volume, 2.0 = double)

Returns

Array[Int] - Volume-adjusted samples

analyze

source

fn analyze(audio : AudioData, silence_threshold : Int) -> AudioAnalysis

Analyze audio samples and return comprehensive statistics.

Arguments

audio - The audio data to analyze
silence_threshold - Amplitude threshold below which is considered silent (default: 100)

Returns

AudioAnalysis - Comprehensive analysis result

calculate_dc_offset

source

fn calculate_dc_offset(samples : Array[Int]) -> Double

Calculate the DC offset (mean value) of audio samples.

combine_stereo

source

fn combine_stereo(left : Array[Int], right : Array[Int]) -> Array[Int]

Combine left and right channels into interleaved stereo samples.

Arguments

left - Left channel samples
right - Right channel samples

Returns

Array[Int] - Interleaved stereo samples [L0, R0, L1, R1, ...]

concat

source

fn concat(a : Array[Int], b : Array[Int]) -> Array[Int]

Concatenate two audio sample arrays.

Arguments

a - First audio samples
b - Second audio samples

Returns

Array[Int] - Concatenated samples

convert_bit_depth

source

fn convert_bit_depth(samples : Array[Int], from_bits : Int, to_bits : Int) -> Result[Array[Int], WavError]

Convert audio samples from one bit depth to another.

Arguments

samples - Input audio samples
from_bits - Source bit depth (8, 16, or 24)
to_bits - Target bit depth (8, 16, or 24)

Returns

Ok(Array[Int]) - Converted samples
Err(WavError) - Error during conversion

convert_channels

source

fn convert_channels(samples : Array[Int], from_channels : Int, to_channels : Int) -> Result[Array[Int], WavError]

Convert audio samples between mono and stereo.

Arguments

samples - Input audio samples
from_channels - Source channel count (1 or 2)
to_channels - Target channel count (1 or 2)

Returns

Ok(Array[Int]) - Converted samples
Err(WavError) - Error during conversion

count_clipped_samples

source

fn count_clipped_samples(samples : Array[Int], min_val : Int, max_val : Int) -> Int

Count the number of clipped samples (at min or max value).

count_silent_samples

source

fn count_silent_samples(samples : Array[Int], threshold : Int) -> Int

Count the number of silent samples (absolute value below threshold).

count_zero_crossings

source

fn count_zero_crossings(samples : Array[Int]) -> Int

Count the number of zero crossings in the audio signal. A zero crossing occurs when consecutive samples have different signs.

cross_correlation_zero_lag

source

fn cross_correlation_zero_lag(a : Array[Int], b : Array[Int]) -> Double

Calculate the cross-correlation between two signals at zero lag. Useful for comparing similarity of two audio signals.

decode

source

fn decode(data : Bytes) -> Result[AudioData, WavError]

Parse a WAV file from bytes and return the decoded audio data.

Arguments

data - The raw bytes of the WAV file

Returns

Ok(AudioData) - Successfully decoded audio data
Err(WavError) - Error during decoding

delay

source

fn delay(samples : Array[Int], delay_samples : Int, mix : Double) -> Array[Int]

Apply delay effect to audio samples.

Arguments

samples - Input audio samples
delay_samples - Delay in samples
mix - Mix ratio (0.0 = dry only, 1.0 = wet only, 0.5 = equal mix)

Returns

Array[Int] - Samples with delay applied

echo

source

fn echo(samples : Array[Int], delay_samples : Int, decay : Double) -> Array[Int]

Apply echo effect to audio samples.

Arguments

samples - Input audio samples
delay_samples - Delay in samples (e.g., 4410 for 100ms at 44100Hz)
decay - Decay factor for echo (0.0 to 1.0, e.g., 0.5)

Returns

Array[Int] - Samples with echo applied

encode

source

fn encode(audio : AudioData) -> Bytes

Encode audio samples and format info into a WAV file.

Arguments

audio - The audio data to encode

Returns

Bytes - The encoded WAV file bytes

encode_with_format

source

fn encode_with_format(samples : Array[Int], num_channels : Int, sample_rate : Int, bits_per_sample : Int) -> Bytes

Encode audio samples into a WAV file with specified format.

Arguments

samples - The audio samples
num_channels - Number of channels (1 or 2)
sample_rate - Sample rate in Hz
bits_per_sample - Bit depth (8, 16, 24, or 32)

Returns

Bytes - The encoded WAV file bytes

extract_channel

source

fn extract_channel(samples : Array[Int], num_channels : Int, channel : Int) -> Array[Int]

Extract a single channel from multi-channel audio.

Arguments

samples - Interleaved multi-channel samples
num_channels - Total number of channels
channel - Channel index to extract (0-based)

Returns

Array[Int] - Extracted channel samples

fade_in

source

fn fade_in(samples : Array[Int], fade_samples : Int) -> Array[Int]

Fade in audio samples.

Arguments

samples - Input audio samples
fade_samples - Number of samples to fade in

Returns

Array[Int] - Samples with fade in applied

fade_out

source

fn fade_out(samples : Array[Int], fade_samples : Int) -> Array[Int]

Fade out audio samples.

Arguments

samples - Input audio samples
fade_samples - Number of samples to fade out

Returns

Array[Int] - Samples with fade out applied

format_analysis

source

fn format_analysis(analysis : AudioAnalysis) -> String

Format audio analysis as a human-readable string.

format_wav_info

source

fn format_wav_info(info : WavInfo) -> String

Format WAV info as a human-readable string.

generate_chirp

source

fn generate_chirp(start_freq : Double, end_freq : Double, amplitude : Double, sample_rate : Int, duration_sec : Double) -> Array[Int]

Generate a chirp (frequency sweep) from start_freq to end_freq.

Arguments

start_freq - Starting frequency in Hz
end_freq - Ending frequency in Hz
amplitude - Peak amplitude
sample_rate - Sample rate in Hz
duration_sec - Duration in seconds

Returns

Array[Int] - Generated samples

generate_noise

source

fn generate_noise(amplitude : Double, sample_rate : Int, duration_sec : Double, seed : Int) -> Array[Int]

Generate white noise.

Arguments

amplitude - Peak amplitude
sample_rate - Sample rate in Hz
duration_sec - Duration in seconds
seed - Random seed for reproducibility

Returns

Array[Int] - Generated samples

generate_sawtooth

source

fn generate_sawtooth(frequency : Double, amplitude : Double, sample_rate : Int, duration_sec : Double) -> Array[Int]

Generate a sawtooth wave.

Arguments

frequency - Frequency in Hz
amplitude - Peak amplitude
sample_rate - Sample rate in Hz
duration_sec - Duration in seconds

Returns

Array[Int] - Generated samples

generate_silence

source

fn generate_silence(sample_rate : Int, duration_sec : Double) -> Array[Int]

Generate silence (all zeros).

Arguments

sample_rate - Sample rate in Hz
duration_sec - Duration in seconds

Returns

Array[Int] - Generated samples (all zeros)

generate_sine

source

fn generate_sine(frequency : Double, amplitude : Double, sample_rate : Int, duration_sec : Double) -> Array[Int]

Generate a sine wave.

Arguments

frequency - Frequency in Hz
amplitude - Peak amplitude (e.g., 16000 for 16-bit)
sample_rate - Sample rate in Hz
duration_sec - Duration in seconds

Returns

Array[Int] - Generated samples

generate_sine_wav

source

fn generate_sine_wav(frequency : Double, amplitude : Double, sample_rate : Int, duration_sec : Double, bits_per_sample : Int) -> AudioData

Generate a sine wave and return as AudioData ready for encoding.

Arguments

frequency - Frequency in Hz
amplitude - Peak amplitude
sample_rate - Sample rate in Hz
duration_sec - Duration in seconds
bits_per_sample - Bit depth (8, 16, 24, 32)

Returns

AudioData - Audio data ready for encoding

generate_square

source

fn generate_square(frequency : Double, amplitude : Double, sample_rate : Int, duration_sec : Double) -> Array[Int]

Generate a square wave.

Arguments

frequency - Frequency in Hz
amplitude - Peak amplitude
sample_rate - Sample rate in Hz
duration_sec - Duration in seconds

Returns

Array[Int] - Generated samples

generate_triangle

source

fn generate_triangle(frequency : Double, amplitude : Double, sample_rate : Int, duration_sec : Double) -> Array[Int]

Generate a triangle wave.

Arguments

frequency - Frequency in Hz
amplitude - Peak amplitude
sample_rate - Sample rate in Hz
duration_sec - Duration in seconds

Returns

Array[Int] - Generated samples

get_duration

source

fn get_duration(audio : AudioData) -> Double

Get the duration of audio in seconds.

get_frame_count

source

fn get_frame_count(audio : AudioData) -> Int

Get the number of frames (samples per channel).

get_info

source

fn get_info(data : Bytes) -> Result[WavInfo, WavError]

Get WAV file information without decoding the audio data.

Arguments

data - The raw bytes of the WAV file

Returns

Ok(WavInfo) - WAV file format information
Err(WavError) - Error during parsing

get_peak_amplitude

source

fn get_peak_amplitude(samples : Array[Int]) -> Int

Get the peak amplitude of audio samples.

Arguments

samples - Input audio samples

Returns

Int - Peak amplitude (absolute value)

get_rms_level

source

fn get_rms_level(samples : Array[Int]) -> Double

Get the RMS (Root Mean Square) level of audio samples.

Arguments

samples - Input audio samples

Returns

Double - RMS level

high_pass_filter

source

fn high_pass_filter(samples : Array[Int], window_size : Int) -> Array[Int]

Apply a simple high-pass filter (difference from moving average).

Arguments

samples - Input audio samples
window_size - Size of the moving average window

Returns

Array[Int] - Filtered samples

low_pass_filter

source

fn low_pass_filter(samples : Array[Int], window_size : Int) -> Array[Int]

Apply a simple low-pass filter (moving average).

Arguments

samples - Input audio samples
window_size - Size of the moving average window (must be odd)

Returns

Array[Int] - Filtered samples

make_audio_data

source

fn make_audio_data(samples : Array[Int], info : WavInfo) -> AudioData

Create a new AudioData with the given samples and info.

make_wav_info

source

fn make_wav_info(audio_format : Int, num_channels : Int, sample_rate : Int, byte_rate : Int, block_align : Int, bits_per_sample : Int, data_size : Int) -> WavInfo

Create a new WavInfo with the given parameters.

mix

source

fn mix(a : Array[Int], b : Array[Int]) -> Array[Int]

Mix two audio streams together by averaging.

Arguments

a - First audio samples
b - Second audio samples

Returns

Array[Int] - Mixed samples (length = max(a.length, b.length))

mix_multiple

source

fn mix_multiple(streams : Array[Array[Int]]) -> Array[Int]

Mix multiple audio streams with equal weight.

Arguments

streams - Array of audio sample arrays

Returns

Array[Int] - Mixed samples

normalize

source

fn normalize(samples : Array[Int], target_peak : Int) -> Array[Int]

Normalize audio to a target peak amplitude.

Arguments

samples - Input audio samples
target_peak - Target peak amplitude (e.g., 32000 for 16-bit)

Returns

Array[Int] - Normalized samples

pad_to_length

source

fn pad_to_length(samples : Array[Int], target_length : Int) -> Array[Int]

Pad audio with silence to reach a target length.

Arguments

samples - Input audio samples
target_length - Target number of samples

Returns

Array[Int] - Padded samples

remove_dc_offset

source

fn remove_dc_offset(samples : Array[Int]) -> Array[Int]

Remove DC offset from audio samples.

Arguments

samples - Input audio samples

Returns

Array[Int] - Samples with DC offset removed

repeat

source

fn repeat(samples : Array[Int], times : Int) -> Array[Int]

Repeat audio samples a specified number of times.

Arguments

samples - Input audio samples
times - Number of times to repeat

Returns

Array[Int] - Repeated samples

resample

source

fn resample(samples : Array[Int], from_rate : Int, to_rate : Int, num_channels : Int) -> Array[Int]

Resample audio data to a different sample rate using linear interpolation.

Arguments

samples - Input audio samples
from_rate - Source sample rate in Hz
to_rate - Target sample rate in Hz
num_channels - Number of channels

Returns

Array[Int] - Resampled samples

reverse

source

fn reverse(samples : Array[Int]) -> Array[Int]

Reverse audio samples.

Arguments

samples - Input audio samples

Returns

Array[Int] - Reversed samples

reverse_reverb

source

fn reverse_reverb(samples : Array[Int], fade_samples : Int) -> Array[Int]

Reverse audio and apply fade (creates a "reverse reverb" effect).

Arguments

samples - Input audio samples
fade_samples - Number of samples for fade

Returns

Array[Int] - Processed samples

soft_clip

source

fn soft_clip(samples : Array[Int], threshold : Int) -> Array[Int]

Apply soft clipping to prevent harsh distortion. Uses a tanh-like curve to smoothly limit amplitude.

Arguments

samples - Input audio samples
threshold - Clipping threshold (e.g., 30000 for 16-bit)

Returns

Array[Int] - Samples with soft clipping applied

split_stereo

source

fn split_stereo(samples : Array[Int]) -> (Array[Int], Array[Int])

Split stereo samples into left and right channels.

Arguments

samples - Interleaved stereo samples [L0, R0, L1, R1, ...]

Returns

(Array[Int], Array[Int]) - (left_channel, right_channel)

trim

source

fn trim(samples : Array[Int], start_sample : Int, end_sample : Int) -> Array[Int]

Trim audio samples to a specified range.

Arguments

samples - Input audio samples
start_sample - Start index (inclusive)
end_sample - End index (exclusive)

Returns

Array[Int] - Trimmed samples

validate

source

fn validate(data : Bytes) -> ValidationResult

Validate a WAV file and return detailed results.

Checks:

RIFF header correctness
WAVE marker presence
fmt chunk structure and values
data chunk presence
Chunk alignment
Data size consistency

Arguments

data - The raw bytes of the WAV file

Returns

ValidationResult - Detailed validation result

Source Files

Install

Download zip

MoonBit 原生 WAV 音频解码库 | A native MoonBit WAV audio decoding library

wavaudiopcmdecodeencodeRIFFfloat

bw448

Apache-2.0

github.com/bw448/moon-wav

Updated 2 months ago

33 downloads

Site source Report issue Modules Skills CLI Build queue Statistics

moon-wav

#🎵 moon-wav

#✨ Features / 功能特性

#📦 Installation

#🚀 Quick Start

#📚 API Reference

#Core Types

#WavInfo

#AudioData

#WavError

#ValidationResult

#AudioAnalysis

#Decoding Functions

#Encoding Functions

#Validation Functions

#Conversion Functions

#Audio Operations

#Audio Effects

#Waveform Generators

#Audio Analysis

#Utility Functions

#⚠️ Limitations / 功能边界

#Supported Formats / 支持的格式

#Channel Support / 声道支持

#Sample Rate / 采样率

#Known Limitations / 已知限制

#📝 Examples

#Generate and Encode WAV

#Validate WAV File

#Audio Analysis

#Processing Pipeline

#🔨 Building

#📄 License

#🤝 Contributing

#AudioAnalysis

#AudioData

#ValidationResult

#WavError

#WavInfo

#adjust_volume

Arguments

Returns

#analyze

Arguments

Returns

#calculate_dc_offset

#combine_stereo

Arguments

Returns

#concat

Arguments

Returns

#convert_bit_depth

Arguments

Returns

#convert_channels

Arguments

Returns

#count_clipped_samples

#count_silent_samples

#count_zero_crossings

#cross_correlation_zero_lag

#decode

Arguments

Returns

#delay

Arguments

Returns

#echo

Arguments

Returns

#encode

Arguments

Returns

#encode_with_format

Arguments

Returns

#extract_channel

Arguments

Returns

AudioAnalysis

AudioData

ValidationResult

WavError

WavInfo

adjust_volume

analyze

calculate_dc_offset

combine_stereo

concat

convert_bit_depth

convert_channels

count_clipped_samples

count_silent_samples

count_zero_crossings

cross_correlation_zero_lag

decode

delay

echo

encode

encode_with_format

extract_channel

fade_in

fade_out

format_analysis

format_wav_info

generate_chirp

generate_noise

generate_sawtooth

generate_silence

generate_sine

generate_sine_wav

generate_square

generate_triangle

get_duration

get_frame_count

get_info

get_peak_amplitude

get_rms_level

high_pass_filter

low_pass_filter

make_audio_data

make_wav_info

mix

mix_multiple

normalize

pad_to_length

remove_dc_offset

repeat

resample