YUV2RGB 库使用教程

YUV2RGB 库使用教程

1. 项目介绍

YUV2RGB 是一个用 C99 编写的轻量级库，专注于快速地在 YUV420p 和 RGB24 图像格式间进行转换。该库由 descampsa 开发，旨在提供高效且易于集成到其他项目的解决方案，适用于实时视频处理或图像处理场景。

2. 项目快速启动

安装依赖

确保你的开发环境已安装必要的编译工具，例如 GCC 或 Clang。

sudo apt-get update && sudo apt-get install build-essential

下载库

克隆项目仓库：

git clone https://github.com/descampsa/yuv2rgb.git
cd yuv2rgb

编译示例

使用 Makefile 编译提供的示例代码：

make

运行示例

运行转换示例：

./example <input.yuv> <output.rgb>

其中 <input.yuv> 是输入的 YUV 文件，<output.rgb> 是转换后的 RGB 输出文件。

3. 应用案例和最佳实践

融入现有项目

要将 YUV2RGB 库整合进你的项目，只需将 src 目录下的 yuv2rgb.c 和 yuv2rgb.h 文件复制到你的工程中，然后包含头文件并调用相应的函数，如 yuv420p_to_rgb24()。

实时视频处理

可以结合 OpenCV 或其他多媒体框架，实时捕获 YUV 流并利用本库进行转换，再展示在屏幕上。

#include "yuv2rgb.h"

// ... 获取 YUV 数据 ...

int width = 640;
int height = 480;
unsigned char* yuv_data = malloc(width * height * 3 / 2);
// 填充 yuv_data...

// 转换为 RGB
unsigned char* rgb_data = malloc(width * height * 3);
yuv420p_to_rgb24(rgb_data, yuv_data, width, height);

// 使用 OpenCV 显示 RGB 图像
cv::Mat frame(height, width, CV_8UC3, rgb_data);
cv::imshow("Converted Image", frame);
cv::waitKey(1); // 更新每秒30帧

4. 典型生态项目

• OpenCV: 开源计算机视觉库，提供多种图像和视频处理功能。
• FFmpeg: 强大的多媒体处理框架，支持多种编码解码器及格式转换。
• GStreamer: 分布式流媒体框架，可扩展性强，适合实时音视频处理。

通过这些生态项目，开发者可以更方便地结合 YUV2RGB 进行复杂的视频处理任务，比如视频会议、监控系统或直播平台。

以上就是 YUV2RGB 的基本使用教程，更多详细信息和自定义选项，建议查看项目 README 文件和源代码。