awtk/docs/how_to_use_stb_hyuv_to_rgb.md

如何使用 stb 外部硬件 YUV 转 RGB

​ AWTK 解码图片是使用 stb 类库来解码的，但是 stb 的内部是软解码的，而且 jpg 一般都是使用 yuv 的颜色空间的，所以在 stb 解码 jpg 的时候，往往需要把 yuv 的颜色空间转化为 rgb 的颜色空间，但是传统的软转换效率会比较低（就算是查表也是比较慢的），所以 awtk 的 stb 提供了一个可以外部接入硬件转换的功能。

一，开启 stb 外部硬件 YUV 转 RGB

​ 开启该功能，需要定义 HAS_STB_YUV_TO_RGB_G2D 宏，然后需要实现 stbi__YCbCr_to_RGB_g2d 函数，该函数是给用户在外部写硬件转换的代码，可选定义的宏是 STB_YUV_DATA_PIXEL_BTYE，该宏是用于定义 yuv 的数据流的字节数，默认为 4 字节（32 位对齐）。

/**
 * @method stbi__YCbCr_to_RGB_g2d
 * stb 外部的硬件 YUV 转换 RGB
 *
 * @annotation ["static"]
 * @param {unsigned char*} out_data 输出的 RGB 数据流。
 * @param {int} out_data_size 输出的 RGB 数据流的长度。
 * @param {unsigned char*} yuv_data 输入的 YUV 的数据流（YUV 的格式为 packed 模式的 YUV444，默认是 4 字节对齐）。
 * @param {int} yuv_data_size 输入的 YUV 的数据流长度。
 * @param {int} w 输入图片的宽
 * @param {int} h 输入图片的高
 * @param {int*} out_channel_order 返回 RGB 数据流的类型（0 代表 R 在低位，1 代表 R 在高位）
 *
 * @return {ret_t} 返回RET_OK表示成功，否则表示失败。
 */
int stbi__YCbCr_to_RGB_g2d(unsigned char* out_data, int out_data_size, unsigned char* yuv_data, int yuv_data_size, int w, int h, int* out_channel_order);