标准库操作系统语言运行时系统编程【免费下载链接】cosmopolitanbuild-once run-anywhere c library项目地址https://gitcode.com/GitHub_Trending/co/cosmopolitan点击查看免费下载本文围绕 dsp/mpeg/README.md 展开系统讲解 PL_MPEG —— 一个单文件 MIT 许可的 C/C 媒体解码库它集成了 MPEG1 Video 解码器、MP2 音频解码器与 MPEG-PS 解复用器。在 Cosmopolitanbuild-once run-anywhere C 库中该模块被封装为DSP_MPEG库见 dsp/mpeg/BUILD.mk用于为应用和游戏提供轻量级视频回放能力。读完本文你将掌握 PL_MPEG 的编译接入方式、四种数据源与两级 API 用法、YCrCb/RGB 转换与音频输出路径以及用 ffmpeg 生成适配.mpg文件的完整流程。PL_MPEG 是什么为什么在应用中内嵌一个 MPEG 解码器PL_MPEG 是单文件single-file的 MIT 许可库其全部实现集中在 dsp/mpeg/pl_mpeg.c 与 dsp/mpeg/pl_mpeg.h 两个文件中。它同时具备三种能力MPEG1 Videompeg1解码器将压缩视频流解出原始 YCrCb 帧MPEG1 Audio Layer IImp2解码器将压缩音频流解出归一化浮点采样MPEG-PS 解复用器将.mpg节目流拆分为视频、音频数据包。选择它的核心动机是简单与 ffmpeg 这类动辄依赖海量库和大量胶水代码的方案相比PL_MPEG 只需要两个文件即可让应用获得视频回放能力。MPEG1 虽然是古老且低效的编码格式但对许多应用场景依然够用——更重要的是MPEG1 与 MP2 相关的专利均已过期可以完全免费地使用。从性能上看PL_MPEG 不使用任何 SIMD 指令凭借编解码器本身的相对简单性在单个 CPU 核心上即可解码 4K60fps 视频原 README 作者在 i7-6700k 上验证。这一点在 Cosmopolitan 的便携二进制场景下尤其有价值无需依赖外部动态库解码能力随可执行文件整体打包。在 Cosmopolitan 中接入 PL_MPEG编译与构建集成传统 Linux 编译方式原 README 给出了通用的 GCC 编译示例用于构建官方示例播放器pl_mpeg_playergcc -o pl_mpeg_player pl_mpeg_player.c $(pkg-config --cflags --libs sdl2 glew)该示例依赖 SDL2 与 GLEWSDL2 负责窗口与音频输出GLEW 负责 OpenGL 渲染。需要注意的是这个命令中的pl_mpeg_player.c是官方仓库中的独立示例文件Cosmopolitan 仓库内的 dsp/mpeg 目录只保留了核心库文件pl_mpeg.c、pl_mpeg.h示例源码可参照官方 pl_mpeg 项目。Cosmopolitan 的构建集成方式在 Cosmopolitan 中PL_MPEG 被封装为DSP_MPEG包。从 dsp/mpeg/BUILD.mk 可以看到其构建细节PKGS DSP_MPEG DSP_MPEG_ARTIFACTS DSP_MPEG_A DSP_MPEG_A o/$(MODE)/dsp/mpeg/mpeg.a DSP_MPEG_A_FILES : $(wildcard dsp/mpeg/*) DSP_MPEG_A_SRCS_C $(filter %.c,$(DSP_MPEG_A_FILES))产物为静态库mpeg.a源码自动扫描dsp/mpeg/*下的.c与.S文件直接依赖LIBC_CALLS、LIBC_INTRIN、LIBC_MEM、LIBC_STDIO、LIBC_STR、LIBC_TINYMATH以及THIRD_PARTY_COMPILER_RT说明解码器在 Cosmopolitan 中仅依赖基础 libc 组件没有引入外部媒体依赖pl_mpeg.o单独追加了-ffunction-sections -fdata-sections编译选项配合链接器的 GC section 机制可以在最终可执行文件中裁剪掉未用到的解码函数实现按需瘦身。此外仓库内的 dsp/mpeg/README.cosmo 记录了该模块的引入信息上游来源为 phoboslab/pl_mpeg提交9e40dd6536269d788728e32c39bfacf2ab7a0866MIT 许可本地唯一改动是新增了提取像素宽高比pixel aspect ratio的 API对应上游 PR #42即 dsp/mpeg/pl_mpeg.h 中的plm_get_pixel_aspect_ratio()与plm_video_get_pixel_aspect_ratio()接口。十分钟上手最小可用解码流程单文件头文件的使用约定PL_MPEG 采用经典的 single-file 头文件库模式在一个C/C 源文件中定义PL_MPEG_IMPLEMENTATION宏后再包含头文件即可生成实现其余源文件只需普通包含头文件。// 在且仅在一个源文件中 #define PL_MPEG_IMPLEMENTATION #include pl_mpeg.h最小播放循环官方头文件 dsp/mpeg/pl_mpeg.h 的 Synopsis 给出了完整的入门代码骨架// 视频帧回调每解出一帧调用一次 void my_video_callback(plm_t *plm, plm_frame_t *frame, void *user) { // 处理 frame-y.data、frame-cr.data、frame-cb.dataYCrCb 三平面 } // 音频采样回调每解出一帧音频调用一次 void my_audio_callback(plm_t *plm, plm_samples_t *frame, void *user) { // 处理 samples-interleaved左右声道交错浮点采样 } // 加载 .mpgMPEG Program Stream文件 plm_t *plm plm_create_with_filename(some-file.mpg); // 注册视频与音频解码回调 plm_set_video_decode_callback(plm, my_video_callback, my_data); plm_set_audio_decode_callback(plm, my_audio_callback, my_data); // 解码主循环传入自上次调用以来的时间增量秒 do { plm_decode(plm, time_since_last_call); } while (!plm_has_ended(plm)); // 全部完成释放资源 plm_destroy(plm);这个流程体现了高层接口的两种解码模式见 dsp/mpeg/pl_mpeg.h时间驱动模式调用plm_decode(plm, seconds)传入自上次调用以来的增量时间内部会自动解码到当前时间点并任意次调用回调帧驱动模式分别调用plm_decode_video()与plm_decode_audio()每次精确解出一帧音视频同步由调用方自行处理。若只解码视频或音频应通过plm_set_video_enabled(FALSE)/plm_set_audio_enabled(FALSE)禁用另一条流避免无谓的解码开销。解码输出格式视频平面与音频采样视频帧YCrCb 三平面结构视频解码结果为plm_frame_t包含时间戳time、显示尺寸width/height以及三个平面y、cr、cbdsp/mpeg/pl_mpeg.h。每个平面是plm_plane_t结构宽度、高度与原始字节数据。需要注意两点平面尺寸规则亮度平面Y的字节长度为每个色度平面Cr/Cb的两倍即 Y 是 Cr/Cb 的 4 倍且所有平面的尺寸会向上取整到宏块边界16px因此平面内部尺寸 ≠ 显示尺寸显示尺寸由frame-width/height给出帧有效期返回的plm_frame_t仅在下次plm_decode_video()或plm_destroy()之前有效。YCrCb → RGB 的两种路径得到 YCrCb 数据后需要转换为 RGB 才能显示有两种方式方式一CPU 转换较慢。使用库提供的转换函数目标缓冲区必须按stride目标缓冲区的行字节数预留空间// stride 至少为 frame-width * bytes_per_pixel缓冲区大小至少为 stride * frame-height plm_frame_to_rgb(frame, dest, stride); plm_frame_to_bgr(frame, dest, stride); plm_frame_to_rgba(frame, dest, stride); plm_frame_to_bgra(frame, dest, stride); plm_frame_to_argb(frame, dest, stride); plm_frame_to_abgr(frame, dest, stride);完整签名见 dsp/mpeg/pl_mpeg.h。其中 RGBA/ARGB 系列转换不会触碰 alpha 分量。方式二GPU 转换推荐。把三个平面作为纹理上传在着色器中用 BT.601 颜色矩阵一次完成转换官方头文件给出了可直接使用的矩阵mat4 bt601 mat4( 1.16438, 0.00000, 1.59603, -0.87079, 1.16438, -0.39176, -0.81297, 0.52959, 1.16438, 2.01723, 0.00000, -1.08139, 0, 0, 0, 1 ); gl_FragColor vec4(y, cb, cr, 1.0) * bt601;注意 shader 中分量顺序是(y, cb, cr)与平面结构命名顺序不同需按矩阵定义对应。音频采样交错或分离双通道音频解码结果为plm_samples_tdsp/mpeg/pl_mpeg.h采样以归一化浮点范围 -11存储。默认情况下左右声道交错存放在单个数组interleaved中如果在包含头文件之前定义PLM_AUDIO_SEPARATE_CHANNELS则改为两个独立数组left[]与right[]#define PLM_AUDIO_SEPARATE_CHANNELS // 在 #include pl_mpeg.h 之前定义 #include pl_mpeg.h每帧音频样本数固定为PLM_AUDIO_SAMPLES_PER_FRAME即 1152对应 MP2 一帧的 1152 个采样count字段仅为方便而提供。音频解码器的内部时间步进为1152 / samplerate秒。上层可通过plm_set_audio_lead_time()设置音频提前量——建议设为所用音频 API 的缓冲时长例如 SDL2 下为SDL_AudioSpec.samples / samplerate。数据源四种喂数据的方式与流式缓冲机制高层接口、解复用器与解码器共用的数据源是plm_buffer_t。有三种向高层接口提供数据的途径dsp/mpeg/pl_mpeg.h文件路径plm_create_with_filename(some-file.mpg)文件打不开时返回 NULL文件句柄plm_create_with_file(FILE *fh, int close_when_done)传入 TRUE 让库在plm_destroy()时替你fclose()整块内存plm_create_with_memory(uint8_t *bytes, size_t length, int free_when_done)不拷贝内存TRUE 表示销毁时由库free()自建缓冲区plm_create_with_buffer(plm_buffer_t *buffer, int destroy_when_done)适合流式场景。其中第 4 种是网络流式加载的关键你可以用plm_buffer_write()持续写入数据通过plm_buffer_get_remaining()监控剩余空间以便节流推送或通过plm_buffer_set_load_callback()安装缓冲区需要更多数据时的回调高层接口内部正是用这一机制为视频/音频解码器拉取对应类型的数据包见plm_read_video_packet/plm_read_audio_packet的实现。缓冲区有两种创建方式语义差异重要plm_buffer_create_with_capacity(size)环形缓冲区语义已读过的数据会被丢弃内存占用有上限plm_buffer_create_for_appending(initial_capacity)追加缓冲区保留全部写入数据从而允许在已加载部分内seek适用于网络加载无需限速的场景。默认缓冲区大小为PLM_BUFFER_DEFAULT_SIZE128KB若输入需要更大空间库会通过realloc()自动扩容。你还可以在包含头文件前定义PLM_MALLOC、PLM_REALLOC、PLM_FREE替换默认的内存管理函数默认映射到malloc/realloc/free方便对接自定义内存池。高层接口能力全集探测、信息查询、循环、seek 与时长plm_*高层接口将解复用器与两个解码器组合在一起除前述解码流程外还提供以下能力均见 dsp/mpeg/pl_mpeg.hAPI说明plm_has_headers()是否已读到全部流头可报告视频/音频流数量、分辨率、帧率与采样率文件非 MPEG-PS 或数据不足时返回 FALSEplm_probe(plm, probesize)探测数据以发现实际视频/音频流数量对 VideoCD 等文件比读头更准确仅对可 seek 的数据源有意义通常几百 KB 即够plm_get_num_video_streams()/plm_get_num_audio_streams()系统头中报告的流数量视频 0~1音频 0~4plm_get_width()/plm_get_height()/plm_get_framerate()视频显示尺寸与帧率fpsplm_get_pixel_aspect_ratio()像素宽高比Cosmopolitan 本地新增接口plm_get_samplerate()音频采样率samples/splm_set_audio_stream(idx)选择要解码的音频流0~3默认 0plm_get_time()/plm_get_duration()当前内部时间 / 源视频时长秒plm_set_loop(loop)/plm_has_ended()循环播放开关默认关闭开启循环后has_ended恒为 FALSEplm_seek(time, seek_exact)跳转。seek_exactTRUE精确到目标时刻需从最近 I 帧逐帧解码较慢FALSE 则跳到目标时刻前最近的 I 帧。成功后回调一次视频帧并补足音频 lead timeplm_seek_frame(time, seek_exact)同plm_seek()但不触发任何回调、不做音频同步直接返回目标帧注意seek 类操作仅当底层缓冲区可 seek文件、固定内存或_for_appending缓冲区时可用。编码适配用 ffmpeg 生成 PL_MPEG 可解码的 .mpg 文件PL_MPEG 的输入格式要求是包含MPEG1 Videompeg1与MPEG1 Audio Layer IImp2流的MPEG-PS.mpg文件。绝大多数符合此组合的.mpg文件可直接播放。特别提醒.mpg文件也可能包含MPEG2 Video而 PL_MPEG不支持MPEG2 视频流。用 ffmpeg 将任意输入编码为适配格式的命令原 README 给出ffmpeg -i input.mp4 -c:v mpeg1video -q:v 0 -c:a mp2 -format mpeg output.mpg参数要点-c:v mpeg1video视频编码器选 MPEG1-q:v 0固定视频质量可变比特率0 为最高质量也可改用-b:v 2000k设置固定比特率2000 kbit/s 示例。两种模式二选一-c:a mp2音频编码器选 MPEG1 Layer II-format mpeg容器格式为 MPEG Program Stream。更完整的编码选项可查阅 ffmpeg 官方文档ffmpeg.html#Options。如果只想快速验证库是否工作原 README 提供了一个可直接下载的测试文件https://phoboslab.org/files/bjork-all-is-full-of-love.mpgphoboslab 官方示例素材。深入底层解复用器与解码器的低级 API绝大多数使用场景无需接触低级 API——高层接口已经组合了解复用器与两个解码器。但遇到以下情况时低级接口直接可用dsp/mpeg/pl_mpeg.h拿到了裸的 mpeg1video 或 mp2 数据流来自其他来源可直接用plm_video_create_with_buffer()/plm_audio_create_with_buffer()解码原始流只想分析 MPEG-PS 文件或抽取原始包使用plm_demux_create()与plm_demux_decode()。解复用器plm_demuxMPEG-PS 被拆分为带类型的包类型直接对应 MPEG-PES 起始码dsp/mpeg/pl_mpeg.h包类型常量值含义PLM_DEMUX_PACKET_PRIVATE0xBD私有数据PLM_DEMUX_PACKET_AUDIO_1~AUDIO_40xC0~0xC34 路音频流PLM_DEMUX_PACKET_VIDEO_10xE0视频流plm_packet_t包含类型、PTS秒无 PTS 时取PLM_PACKET_INVALID_TS即 -1、长度与数据指针。解复用器支持plm_demux_probe()探测、plm_demux_seek(time, type, force_intra)按 PTS 与包类型跳转force_intraTRUE时只接受含 I 帧的视频包、plm_demux_get_start_time()与plm_demux_get_duration()查询首个 PTS 与时长跨度。视频解码器plm_video除帧率、尺寸、像素宽高比查询外一个值得关注的接口是plm_video_set_no_delay(no_delay)开启后解码器假定视频流不含 B 帧可显著降低流式播放时的延迟默认关闭。已知限制与注意事项原 README 明确列出的限制务必在选型与实现时考虑无错误上报PL_MPEG 会静默忽略任何无效数据不会报告解码错误。因此对损坏文件需自行处理无声失败的情况如回调长时间不被调用忽略容器级 PTSMPEG-PS 容器中数据包的 PTS 被忽略某些文件可能导致音视频同步问题可能存在其他 bug作者自嘲 bugs, probably生产使用前建议充分测试。结合源码补充两点工程建议帧/包返回对象的有效期都很短下次解码或销毁即失效如需长期持有必须自行拷贝数据高层接口的内存分配集中在创建阶段配合 Cosmopolitan 的-ffunction-sections裁剪嵌入游戏或应用的体积与运行时开销都相当可控。总结PL_MPEG 用两个文件为 Cosmopolitan 项目补齐了零外部依赖的 MPEG 回放能力高层plm_*API 让最小播放器只需一个解码循环加两个回调plm_buffer_*的环形/追加两种缓冲语义覆盖了本地文件、整块内存与网络流式三类数据来源低级plm_demux_*/plm_video_*/plm_audio_*接口则保留了分析、抽流与裸流解码的灵活性。配合 ffmpeg 的mpeg1video mp2 mpeg编码组合即可在应用与游戏中获得完全免费、免专利费的视频播放体验。进一步查阅 dsp/mpeg/pl_mpeg.h含完整 API 文档与实现源码与 dsp/mpeg/BUILD.mk构建集成可深入了解每个接口的细节约定。赞分享标准库操作系统语言运行时系统编程【免费下载链接】cosmopolitanbuild-once run-anywhere c library项目地址https://gitcode.com/GitHub_Trending/co/cosmopolitan点击查看免费下载相关推荐nlohmann-json 现代 C JSON 库实战指南从单头文件集成到 MongoDB 源码级应用nlohmann json 现代 C JSON 库实战指南从单头文件集成到 MongoDB 源码级应用 本文以 MongoDB 仓库中内置的第三方库 nl数据库文档数据库后端Zen C 可移植单文件可执行文件实战APE 与 Cosmopolitan Libc 构建完整指南Zen C 可移植单文件可执行文件实战APE 与 Cosmopolitan Libc 构建完整指南 Zen Czenc 是一门像高级语言一样写、像 C编程语言编译器RenderDoc 中的 TinyEXR单头文件 OpenEXR 读写库的集成与实战指南RenderDoc 中的 TinyEXR单头文件 OpenEXR 读写库的集成与实战指南 导读 本文聚焦 RenderDoc 仓库内嵌的第三方库 TinyEX开发工具调试器图形学GPU上一篇WinFsp文件系统校验5个关键步骤实现分布式任务高效调度下一篇gibMacOS源码解析downloader.py如何实现高效下载创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考