开源项目 yuv2rgb 使用教程

1. 项目的目录结构及介绍

yuv2rgb/
├── README.md
├── LICENSE
├── src/
│   ├── main.c
│   ├── yuv2rgb.c
│   └── yuv2rgb.h
├── include/
│   └── yuv2rgb.h
├── tests/
│   ├── test_main.c
│   └── test_yuv2rgb.c
└── Makefile

• README.md: 项目介绍和使用说明。
• LICENSE: 项目许可证文件。
• src/: 源代码目录，包含主要的转换逻辑和入口文件。
  • main.c: 项目的主入口文件。
  • yuv2rgb.c: YUV 到 RGB 转换的核心实现。
  • yuv2rgb.h: 转换函数的头文件。
• include/: 头文件目录，包含对外暴露的头文件。
  • yuv2rgb.h: 转换函数的头文件。
• tests/: 测试代码目录，包含项目的单元测试。
  • test_main.c: 测试入口文件。
  • test_yuv2rgb.c: YUV 到 RGB 转换的测试用例。
• Makefile: 编译和测试的自动化脚本。

2. 项目的启动文件介绍

项目的启动文件是 src/main.c，它包含了程序的入口点 main 函数。该文件主要负责解析命令行参数、调用 YUV 到 RGB 转换函数并输出结果。以下是 main.c 的简要介绍：

#include <stdio.h>
#include <stdlib.h>
#include "yuv2rgb.h"

int main(int argc, char *argv[]) {
    // 解析命令行参数
    if (argc < 4) {
        fprintf(stderr, "Usage: %s <input_yuv_file> <output_rgb_file> <width> <height>\n", argv[0]);
        return 1;
    }

    const char *input_file = argv[1];
    const char *output_file = argv[2];
    int width = atoi(argv[3]);
    int height = atoi(argv[4]);

    // 调用 YUV 到 RGB 转换函数
    if (convert_yuv_to_rgb(input_file, output_file, width, height) != 0) {
        fprintf(stderr, "Failed to convert YUV to RGB\n");
        return 1;
    }

    printf("Conversion successful!\n");
    return 0;
}

3. 项目的配置文件介绍

项目中没有显式的配置文件，所有的配置和参数都是通过命令行参数传递的。在 main.c 中，通过解析 argv 数组来获取输入文件、输出文件、图像宽度和高度等参数。

例如，运行项目时可以使用以下命令：

./yuv2rgb input.yuv output.rgb 640 480

这条命令将 input.yuv 文件中的 YUV 数据转换为 RGB 格式，并输出到 output.rgb 文件中，图像的宽度和高度分别为 640 和 480。