WAV to C Header Converter

将WAV音频文件转换为C语言头文件的Python脚本,支持将音频数据嵌入到C/C++项目中。

功能特性

音频格式支持

  • PCM格式:支持8位、16位、24位、32位PCM音频
  • IEEE Float格式:支持32位浮点音频
  • 多声道:支持单声道、立体声及多声道音频
  • 自动格式检测:自动识别WAV文件的编码格式

智能数组类型选择

  • 16位及以下WAV → 生成 int16_t 数组(紧凑存储)
  • 32位WAV → 生成 int32_t 数组(保持完整精度)

生成的头文件包含

  • 包含防护宏定义
  • 音频参数宏定义(采样率、声道数、采样点数)
  • 格式化的音频数据数组
  • 符合C语言标准的变量命名

使用方法

基本用法

  1. 将WAV文件放在脚本同一目录下
  2. 运行脚本:
python convert_wav_to_int16_h.py

脚本会自动扫描当前目录下的所有 .wav 文件并转换。

输出示例

对于16位WAV文件 audio.wav,会生成 audio.h

#ifndef AUDIO_H_
#define AUDIO_H_#include <stdint.h>#define AUDIO_SAMPLE_RATE 44100
#define AUDIO_NUM_CHANNELS 2
#define AUDIO_NUM_SAMPLES 88200const int16_t audio_samples[AUDIO_NUM_SAMPLES] = {1234, -5678, 2345, -6789, 3456, -7890, 4567, -8901,5678, -9012, 6789, -1023, 7890, -2134, 8901, -3245,// ... 更多数据
};#endif

对于32位WAV文件,会生成 int32_t 数组:

const int32_t audio_samples[AUDIO_NUM_SAMPLES] = {123456789, -987654321, 234567890, -876543210,// ... 更多数据
};

支持的音频格式

位深度格式类型输出数组类型说明
8位PCMint16_t无符号转有符号,缩放到16位
16位PCMint16_t直接使用原始值
24位PCMint16_t缩放到16位(截断低8位)
32位PCMint32_t保持完整32位精度
32位IEEE Floatint32_t浮点转整数,缩放到32位范围

文件命名规则

  • 输出文件名:原文件名.h
  • 变量名:基于文件名生成合法的C标识符
  • 宏定义:变量名转大写

命名示例

  • my-audio.wav → 变量名:my_audio_samples,宏前缀:MY_AUDIO_
  • 123sound.wav → 变量名:wav_123sound_samples,宏前缀:WAV_123SOUND_

应用场景

  • 嵌入式系统:将音效直接编译到固件中
  • 游戏开发:嵌入音效资源,避免文件IO
  • 音频处理:将测试音频数据编译到程序中
  • 实时系统:避免运行时文件加载延迟

技术细节

数据转换

  • 所有音频数据按小端序处理
  • 浮点数据范围限制在 [-1.0, 1.0]
  • 超出范围的整数数据会被裁剪
  • NaN浮点值会被转换为0

内存效率

  • 使用生成器避免大文件内存占用
  • 分块读取音频数据(4096帧/块)
  • 16位数组每行16个数据,32位数组每行8个数据

错误处理

  • 跳过不支持的音频格式
  • 显示详细的转换状态信息
  • 继续处理其他文件即使某个文件出错

输出信息

脚本运行时会显示每个文件的处理状态:

[ok] audio.wav -> audio.h | fmt=PCM, ch=2, sr=44100, width=2 bytes, samples=88200, array_type=int16_t
[skip] unsupported.wav: unsupported sample width 5 bytes
[error] corrupted.wav: Invalid WAV file format

依赖要求

  • Python 3.6+
  • 标准库模块:os, struct, wave

无需安装额外的第三方库。

python代码

import os
import struct
import wavedef sanitize_name(name: str) -> str:base = ''.join(c if (c.isalnum() or c == '_') else '_' for c in name)if not base or base[0].isdigit():base = 'wav_' + basereturn basedef to_macro(name: str) -> str:return sanitize_name(name).upper()def detect_wav_format(path: str):# Returns ("PCM" or "FLOAT")try:with open(path, 'rb') as f:if f.read(4) != b'RIFF':return "PCM"f.read(4)  # sizeif f.read(4) != b'WAVE':return "PCM"# iterate chunkswhile True:hdr = f.read(8)if len(hdr) < 8:breakchunk_id, chunk_size = hdr[:4], struct.unpack('<I', hdr[4:8])[0]if chunk_id == b'fmt ':fmt_data = f.read(chunk_size)if len(fmt_data) < 16:return "PCM"audio_format = struct.unpack('<H', fmt_data[0:2])[0]if audio_format == 1:return "PCM"if audio_format == 3:return "FLOAT"if audio_format == 0xFFFE and len(fmt_data) >= 40:# WAVE_FORMAT_EXTENSIBLE: subformat at offset 24 (16 bytes)subformat = fmt_data[24:40]# First 4 bytes little-endian correspond to PCM(1) or IEEE_FLOAT(3)code = struct.unpack('<I', subformat[0:4])[0]if code == 1:return "PCM"if code == 3:return "FLOAT"return "PCM"else:# skip chunk (with padding byte if size is odd)skip = chunk_size + (chunk_size & 1)f.seek(skip, 1)except Exception:return "PCM"return "PCM"def clip_int16(v: int) -> int:if v > 32767:return 32767if v < -32768:return -32768return vdef convert_sample(sample_bytes: bytes, fmt: str, sampwidth: int, target_width: int) -> int:# Returns int16 or int32 value based on target_widthif sampwidth == 1:# 8-bit unsigned PCM: 0..255 -> -128..127, then scaleu = sample_bytes[0]s = u - 128if target_width == 2:return s << 8  # scale to int16else:return s << 24  # scale to int32elif sampwidth == 2:# 16-bit signed little-endianval = struct.unpack('<h', sample_bytes)[0]if target_width == 2:return valelse:return val << 16  # scale to int32elif sampwidth == 3:# 24-bit signed little-endianb0, b1, b2 = sample_bytes[0], sample_bytes[1], sample_bytes[2]val = b0 | (b1 << 8) | (b2 << 16)if b2 & 0x80:val -= 1 << 24if target_width == 2:# Scale down to 16-bitreturn clip_int16(val >> 8)else:return val << 8  # scale to int32elif sampwidth == 4:if fmt == "PCM":# 32-bit signed little-endianval = struct.unpack('<i', sample_bytes)[0]if target_width == 2:return clip_int16(val >> 16)else:return valelse:# 32-bit IEEE floatf = struct.unpack('<f', sample_bytes)[0]if f != f:  # NaNf = 0.0if f > 1.0:f = 1.0elif f < -1.0:f = -1.0if target_width == 2:return clip_int16(int(round(f * 32767.0)))else:return int(round(f * 2147483647.0))  # scale to int32else:# Unsupported width: fallback zeroreturn 0def write_header_start(fp, guard: str, var_base: str, num_samples: int, sample_rate: int, num_channels: int):fp.write(f"#ifndef {guard}\n")fp.write(f"#define {guard}\n\n")fp.write("#include <stdint.h>\n\n")macro_base = to_macro(var_base)fp.write(f"#define {macro_base}_SAMPLE_RATE {sample_rate}\n")fp.write(f"#define {macro_base}_NUM_CHANNELS {num_channels}\n")fp.write(f"#define {macro_base}_NUM_SAMPLES {num_samples}\n\n")fp.write(f"extern const int16_t {var_base}_samples[{macro_base}_NUM_SAMPLES];\n\n")fp.write("#endif\n")def write_header_with_array(path_h: str, var_base: str, sample_iter, total_samples: int, sample_rate: int, num_channels: int, sampwidth: int):guard = to_macro(var_base) + "_H_"# Determine array type based on sample widthif sampwidth == 4:array_type = "int32_t"per_line = 8  # fewer numbers per line for int32else:array_type = "int16_t"per_line = 16with open(path_h, "w", encoding="utf-8") as fp:fp.write(f"#ifndef {guard}\n")fp.write(f"#define {guard}\n\n")fp.write("#include <stdint.h>\n\n")macro_base = to_macro(var_base)fp.write(f"#define {macro_base}_SAMPLE_RATE {sample_rate}\n")fp.write(f"#define {macro_base}_NUM_CHANNELS {num_channels}\n")fp.write(f"#define {macro_base}_NUM_SAMPLES {total_samples}\n\n")fp.write(f"const {array_type} {var_base}_samples[{macro_base}_NUM_SAMPLES] = {{\n  ")count = 0first = Truefor s in sample_iter:if not first:fp.write(", ")else:first = Falsefp.write(str(s))count += 1if (count % per_line) == 0:fp.write("\n  ")fp.write("\n};\n\n")fp.write("#endif\n")def convert_wav_to_h(path_wav: str):base_name = os.path.splitext(os.path.basename(path_wav))[0]var_base = sanitize_name(base_name)out_h = f"{base_name}.h"fmt = detect_wav_format(path_wav)with wave.open(path_wav, 'rb') as wf:nch = wf.getnchannels()sampwidth = wf.getsampwidth()  # bytes per samplefr = wf.getframerate()nframes = wf.getnframes()if sampwidth not in (1, 2, 3, 4):print(f"[skip] {path_wav}: unsupported sample width {sampwidth} bytes")return# Determine target width: 32-bit WAV -> int32, others -> int16target_width = 4 if sampwidth == 4 else 2array_type = "int32_t" if target_width == 4 else "int16_t"total_samples = nframes * nchdef sample_generator():chunk_frames = 4096while True:frames = wf.readframes(chunk_frames)if not frames:breakmv = memoryview(frames)step = sampwidthfor off in range(0, len(mv), step):# mv[off:off+step] is a memoryview, convert to bytes for struct/unpacksb = mv[off:off + step].tobytes()yield convert_sample(sb, fmt, sampwidth, target_width)write_header_with_array(out_h, var_base, sample_generator(), total_samples, fr, nch, sampwidth)print(f"[ok] {path_wav} -> {out_h} | fmt={fmt}, ch={nch}, sr={fr}, width={sampwidth} bytes, samples={total_samples}, array_type={array_type}")def main():wavs = [f for f in os.listdir('.') if f.lower().endswith('.wav')]if not wavs:print("No .wav files found in current directory.")returnwavs.sort()for w in wavs:try:convert_wav_to_h(w)except Exception as e:print(f"[error] {w}: {e}")if __name__ == "__main__":main()

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若转载,请注明出处:http://www.pswp.cn/web/94930.shtml
繁体地址,请注明出处:http://hk.pswp.cn/web/94930.shtml
英文地址,请注明出处:http://en.pswp.cn/web/94930.shtml

如若内容造成侵权/违法违规/事实不符,请联系英文站点网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

01.《基础入门:了解网络的基本概念》

网络基础 文章目录网络基础网络通信核心原理网络通信定义信息传递过程关键术语解释网络的分类网络参考模型OSI 参考模型各层核心工作分层核心原则TCP/IP 参考模型&#xff08;4 层 / 5 层&#xff0c;实际应用模型&#xff09;TCP/IP 与 OSI 模型的对应关系传输层核心协议&…

基于vue驾校管理系统的设计与实现5hl93(程序+源码+数据库+调试部署+开发环境)带论文文档1万字以上,文末可获取,系统界面在最后面。

系统程序文件列表&#xff1a;项目功能&#xff1a;学员,教练,教练信息,预约信息,场地信息,时间安排,车辆信息,预约练车,时间段,驾校场地信息,驾校车辆信息,预约报名开题报告内容&#xff1a;一、选题背景与意义背景随着汽车保有量持续增长&#xff0c;驾校行业规模不断扩大&am…

灰度思维:解锁世界原有本色的密码

摘要本文深入探讨灰度思维的概念内涵及其在处理他人评价中的应用价值。研究指出&#xff0c;灰度思维作为一种超越非黑即白的思维方式&#xff0c;能够帮助个体以更客观、全面的态度接受他人评价的片面性&#xff0c;从而促进个人成长和人际关系和谐。文章分析了他人评价片面性…

动态规划--Day03--打家劫舍--198. 打家劫舍,213. 打家劫舍 II,2320. 统计放置房子的方式数

动态规划–Day03–打家劫舍–198. 打家劫舍&#xff0c;213. 打家劫舍 II&#xff0c;2320. 统计放置房子的方式数 今天要训练的题目类型是&#xff1a;【打家劫舍】&#xff0c;题单来自灵艾山茶府。 掌握动态规划&#xff08;DP&#xff09;是没有捷径的&#xff0c;咱们唯一…

Nuxt.js@4 中管理 HTML <head> 标签

可以在 nuxt.config.ts 中配置全局的 HTML 标签&#xff0c;也可以在指定 index.vue 页面中配置指定的 HTML 标签。 在 nuxt.config.ts 中配置 HTML 标签 export default defineNuxtConfig({compatibilityDate: 2025-07-15,devtools: { enabled: true },app: {head: {charse…

UCIE Specification详解(十)

文章目录4.5.3.7 PHYRETRAIN&#xff08;物理层重训练&#xff09;4.5.3.7.1 Adapter initiated PHY retrain4.5.3.7.2 PHY initiated PHY retrain4.5.3.7.3 Remote Die requested PHY retrain4.5.3.8 TRAIN ERROR4.5.3.9 L1/L24.6 Runtime Recalibration4.7 Multi-module Link…

电商数据的获取方式:API、爬虫、第三方服务及更多

在竞争激烈的电商领域&#xff0c;数据是驱动业务增长的关键。准确、及时地获取电商数据&#xff0c;并进行深入分析&#xff0c;能够帮助企业洞察市场趋势、优化运营策略、提升用户体验。本文将全面介绍电商数据的获取方式&#xff0c;涵盖API接口、网络爬虫技术、第三方数据服…

《WINDOWS 环境下32位汇编语言程序设计》第8章 通用对话框

Windows操作系统为一些常用功能提供了一些通用对话框&#xff08;Common Dialog Box&#xff09;&#xff0c;比如&#xff0c;在不同的应用程序中进行打开文件、选择字体、选择颜色等操作时&#xff0c;不同程序显示的对话框的模样都是一样的。另外&#xff0c;把同样的应用程…

SOME/IP-SD协议中组播IP地址和端口号应从何处获取、由谁设置?

<摘要> AUTOSAR SOME/IP-SD协议中组播通信参数的核心配置规则明确规定了在服务端传输&#xff08;Server-Transmits&#xff09;和客户端传输&#xff08;Client-Transmits&#xff09;两种模式下&#xff0c;组播IP地址和端口号应从何处获取、由谁设置&#xff0c;从而确…

DAY49打卡

追到第45天内容浙大疏锦行

十四、测试 (Testing)

Rust内置了强大的测试框架,使得编写和运行测试变得非常简单。Rust的测试系统主要包括单元测试、集成测试和文档测试。 1. 单元测试 单元测试通常放在与被测试代码相同的文件中,使用#[cfg(test)]模块和#[test]属性标记。 1.1 基本测试结构 // 在src/lib.rs或任何模块中pub…

LeetCode 刷题【56. 合并区间】

56. 合并区间 自己做 解&#xff1a;排序合并 class Solution { public:static bool compare(const vector<int> &p1, const vector<int> &p2){ //按第一个数排序return p1[0] < p2[0]; }vector<vector<int>> merge(ve…

DistributedLock 实现.Net分布式锁

在分布式系统中&#xff0c;经常会遇到多个实例同时访问同一份资源的情况&#xff0c;例如&#xff1a; • 多个服务节点同时写入数据库同一行数据• 定时任务在多个节点上同时运行&#xff0c;导致重复执行• 多实例写缓存时出现数据覆盖问题 为了解决 并发冲突 和 数据一致…

Flutter:ios打包ipa,证书申请,Xcode打包,完整流程

步骤1 - 5 为 申请ios的签名文件&#xff0c;App ID&#xff0c;证书&#xff0c;描述文件&#xff0c;并添加测试打包设备。 步骤1&#xff1a;生成证书签名文件&#xff08;打开钥匙串访问>证书助理>从证书颁发机构请求证书&#xff09; 存储后得到了一个签名文件&…

Shell 秘典(卷二)——号令延展秘术 与 流程掌控心法・if 天机判语篇精解

文章目录前言一、命令扩展详解1.1 逻辑运算符1.1.1 逻辑与运算符&#xff08;&&&#xff09;1.1.2 逻辑或运算符&#xff08;||&#xff09;1.1.3 组合使用注意事项1.2 echo 命令1.2.1 基本用法1.2.2 输出到标准错误&#xff08;stderr&#xff09;1.3 标准文件描述符&…

Agent实战教程:深度解析async异步编程在Langgraph中的性能优化

在现代Python开发中&#xff0c;异步编程已经成为提高程序性能的重要手段&#xff0c;特别是在处理网络请求、数据库操作或AI模型调用等耗时操作时。本文将通过实际的LangGraph 示例&#xff0c;深入解析async的真正作用&#xff0c;并揭示一个常见误区&#xff1a;为什么异步顺…

coalesce在sql中什么作用

COALESCE‌是SQL中的一个函数&#xff0c;用于返回参数列表中的第一个非空值&#xff0c;若所有参数均为NULL则返回NULL&#xff0c;常用于处理数据中的空值情况。 ‌核心功能与语法‌ COALESCE函数的基本语法为&#xff1a;COALESCE(expression1, expression2, ..., express…

【Rust】 6. 字符串学习笔记

一、Rust 字符串概述 Rust 字符串是 UTF-8 编码的文本序列&#xff0c;提供两种主要类型&#xff1a; &str - 字符串切片&#xff08;通常作为引用出现&#xff09;String - 动态可变的、拥有所有权的字符串 二、字符串字面量 (&str) 编译时已知大小&#xff0c;静态分…

达梦数据库-数据文件 (二)

达梦数据库-数据文件&#xff08;二&#xff09;-自动监控达梦数据库表空间使用率的 Shell 脚本 自动监控达梦数据库表空间使用率的 Shell 脚本&#xff0c;支持&#xff1a; ✅ 实时计算每个表空间的使用率✅ 设置阈值告警&#xff08;如 >80%&#xff09;✅ 支持邮件告警&…

如何用 Android 平台开发第一个 Kotlin 小程序

安装开发环境下载并安装最新版 Android Studio&#xff08;官方 IDE&#xff09;&#xff0c;安装时勾选 Kotlin 插件。确保 JDK 版本为 11 或更高。创建新项目打开 Android Studio 选择 File > New > New Project&#xff0c;选择 Empty Activity 模板。在配置界面中&am…