You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
358 lines
14 KiB
358 lines
14 KiB
2 years ago
|
#ifndef __ZMF_UTILS_H__
|
||
|
|
#define __ZMF_UTILS_H__
|
||
|
|
#include <stdarg.h>
|
||
|
|
#ifdef __GNUC__
|
||
|
|
#pragma GCC visibility push(default)
|
||
|
|
#endif
|
||
|
|
/**
|
||
|
|
* @file zmf_utils.h
|
||
|
|
* @brief ZMF图像转换工具函数
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @defgroup ZmfLog 日志接口
|
||
|
|
* @brief 自定义ZMF模块的日志打印等级。
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 日志等级
|
||
|
|
*/
|
||
|
|
typedef enum {
|
||
|
|
ZmfLogDebug = 0,
|
||
|
|
ZmfLogInfo = 1,
|
||
|
|
ZmfLogWarn = 2,
|
||
|
|
ZmfLogError = 3,
|
||
|
|
} ZmfLogLevel;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 将格式化输出内容打印至zmf的日志系统
|
||
|
|
* @param iLogLevel 要打印的日志等级， @ref ZmfLogLevel
|
||
|
|
* @param format 要打印的格式化输出字符串
|
||
|
|
* @param argv 要打印的格式化输出字符串对应的参数列表
|
||
|
|
* @note 无返回值，不进行错误管理。
|
||
|
|
*/
|
||
|
|
void Zmf_LogV(int iLogLevel, const char *format, va_list argv);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @defgroup ZmfVideoType 视频数据类型
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief ZMF模块支持的图像类型
|
||
|
|
*/
|
||
|
|
typedef enum {
|
||
|
|
ZmfPixelFormatI420 = 1, /**< @brief YUVI420格式，通道顺序Y-U-V，4:1:1 */
|
||
|
|
ZmfPixelFormatIYUV = 2, /**< @brief IYUV格式 */
|
||
|
|
ZmfPixelFormatRGB24 = 3, /**< @brief RGB24格式 */
|
||
|
|
ZmfPixelFormatABGR = 4, /**< @brief ABGR格式 */
|
||
|
|
ZmfPixelFormatARGB = 5, /**< @brief ARGB格式 */
|
||
|
|
ZmfPixelFormatARGB4444 = 6, /**< @brief ARGB4444格式 */
|
||
|
|
ZmfPixelFormatRGB565 = 7, /**< @brief RGB565格式 */
|
||
|
|
ZmfPixelFormatARGB1555 = 8, /**< @brief ARGB1555格式 */
|
||
|
|
ZmfPixelFormatYUY2 = 9, /**< @brief YUY2格式 */
|
||
|
|
ZmfPixelFormatYV12 = 10, /**< @brief YV12格式 */
|
||
|
|
ZmfPixelFormatUYVY = 11, /**< @brief UYVY格式 */
|
||
|
|
ZmfPixelFormatMJPG = 12, /**< @brief Motion JPG格式 */
|
||
|
|
ZmfPixelFormatNV21 = 13, /**< @brief NV21格式 */
|
||
|
|
ZmfPixelFormatNV12 = 14, /**< @brief NV12格式 */
|
||
|
|
ZmfPixelFormatBGRA = 15, /**< @brief BGRA格式 */
|
||
|
|
ZmfPixelFormatRGBA = 16, /**< @brief RGBA格式 */
|
||
|
|
} ZmfPixelFormatType;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @defgroup ZmfVideoInterface 视频基础接口
|
||
|
|
*
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 将I420图像转换成别的类型
|
||
|
|
* @param dstFrame 用于保存转换后的图像数据
|
||
|
|
* @param dstStride 表示一行像素的字节数
|
||
|
|
* @param dstFormat 输出图像类型 @see ZmfPixelFormatType
|
||
|
|
* @param srcFrame 源图像数据
|
||
|
|
* @param srcWidth 源图像宽
|
||
|
|
* @param srcHeight 源图像高
|
||
|
|
* @return int，函数执行结果
|
||
|
|
|
||
|
|
* dstFormat 不等于 ZmfPixelFormatMJPG时,\n
|
||
|
|
* 0: 函数执行成功\n
|
||
|
|
* -ZMF_ERROR_ARGUMENT_INVALID: 接口输入参数错误\n
|
||
|
|
* -ZMF_ERROR_YUV_NOT_SUPPORTED:当前版本ZMF不支持使用libyuv\n
|
||
|
|
* -ZMF_ERROR_YUV_FMT_ANY: 指定的yuv fomat不支持\n
|
||
|
|
* -ZMF_ERROR_YUV_LIB_ERROR: libyuv报错，具体错误信息需查看日志获取。\n
|
||
|
|
* dstFormat 等于 ZmfPixelFormatMJPG时,\n
|
||
|
|
* 大于0: 返回 dstFrame的大小,函数执行成功\n
|
||
|
|
* -ZMF_ERROR_ARGUMENT_INVALID: 接口输入参数错误\n
|
||
|
|
* -ZMF_ERROR_YUV_NOT_SUPPORTED:当前版本ZMF不支持使用libyuv\n
|
||
|
|
* -ZMF_ERROR_YUV_FMT_ANY: 指定的yuv fomat不支持\n
|
||
|
|
* -ZMF_ERROR_YUV_LIB_ERROR: libyuv报错，具体错误信息需查看日志获取。\n
|
||
|
|
* @see Zmf_ImageFromYV12, Zmf_ConvertToI420, Zmf_ScaleI420, Zmf_MirrorI420UpDown
|
||
|
|
*/
|
||
|
|
int Zmf_ImageFromI420 (void* dstFrame, int dstFormat, int dstStride,
|
||
|
|
const void* srcFrame, int srcWidth, int srcHeight);
|
||
|
|
///@cond
|
||
|
|
/** deprecated, use Zmf_ImageFromI420 */
|
||
|
|
int Zmf_ConvertFromI420 (void* dstFrame, int dstFormat,
|
||
|
|
const void* srcFrame, int srcWidth, int srcHeight);
|
||
|
|
///@endcond
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 将YV12图像转换成别的类型
|
||
|
|
* @param dstFrame 用于保存转换后的图像数据
|
||
|
|
* @param dstFormat 输出图像类型 @ref ZmfPixelFormatType
|
||
|
|
* @param dstStride 表示一行像素的字节数
|
||
|
|
* @param srcFrame 源图像数据
|
||
|
|
* @param srcWidth 源图像宽
|
||
|
|
* @param srcHeight 源图像高
|
||
|
|
* @return int，函数执行结果\n
|
||
|
|
* 0: 函数执行成功\n
|
||
|
|
* -ZMF_ERROR_ARGUMENT_INVALID: 接口输入参数错误\n
|
||
|
|
* -ZMF_ERROR_YUV_NOT_SUPPORTED:当前版本ZMF不支持使用libyuv\n
|
||
|
|
* -ZMF_ERROR_YUV_FMT_ANY: 指定的yuv fomat不支持\n
|
||
|
|
* -ZMF_ERROR_YUV_LIB_ERROR: libyuv报错，具体错误信息需查看日志获取。\n
|
||
|
|
* @see Zmf_ImageFromI420
|
||
|
|
*/
|
||
|
|
int Zmf_ImageFromYV12 (void* dstFrame, int dstFormat, int dstStride,
|
||
|
|
const void* srcFrame, int srcWidth, int srcHeight);
|
||
|
|
///@cond
|
||
|
|
/** deprecated, use Zmf_ImageFromYV12 */
|
||
|
|
int Zmf_ConvertFromYV12 (void* dstFrame, int dstFormat,
|
||
|
|
const void* srcFrame, int srcWidth, int srcHeight);
|
||
|
|
///@endcond
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 将图像类型转换成I420
|
||
|
|
* @param dstFrame 用于保存转换后的图像数据
|
||
|
|
* @param srcFormat 源图像类型 @ref ZmfPixelFormatType
|
||
|
|
* @param srcFrame 源图像数据
|
||
|
|
* @param srcBufLen 源图像数据字节数
|
||
|
|
* @param srcWidth 源图像宽
|
||
|
|
* @param srcHeight 源图像高
|
||
|
|
* @param crop_x 相对于左上角的裁剪起始宽度偏移
|
||
|
|
* @param crop_y 相对于左上角的裁剪起始高度偏移
|
||
|
|
* @param dstWidth 输出图像宽度(4字节对齐)，同时作为输出值表示转换后图像的实际宽
|
||
|
|
* @param dstHeight 输出图像高度(4字节对齐)，同时作为输出值表示转换后图像的实际高
|
||
|
|
* @param rotateAngle 顺时针旋转角度
|
||
|
|
* @return int，函数执行结果\n
|
||
|
|
* 0: 函数执行成功\n
|
||
|
|
* -ZMF_ERROR_ARGUMENT_INVALID: 接口输入参数错误\n
|
||
|
|
* -ZMF_ERROR_YUV_NOT_SUPPORTED:当前版本ZMF不支持使用libyuv\n
|
||
|
|
* -ZMF_ERROR_YUV_FMT_ANY: 指定的yuv fomat不支持\n
|
||
|
|
* -ZMF_ERROR_YUV_LIB_ERROR: libyuv报错，具体错误信息需查看日志获取。\n
|
||
|
|
* @see Zmf_ImageFromI420, Zmf_ScaleI420, Zmf_MirrorI420UpDown
|
||
|
|
*/
|
||
|
|
int Zmf_ConvertToI420(void* dstFrame,
|
||
|
|
int srcFormat, const void* srcFrame, unsigned srcBufLen,
|
||
|
|
int srcWidth, int srcHeight, int crop_x, int crop_y,
|
||
|
|
int *dstWidth, int *dstHeight, int rotateAngle);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 内存连续的I420图像类型
|
||
|
|
*/
|
||
|
|
typedef struct {
|
||
|
|
unsigned char *data;
|
||
|
|
int width, height, angle;
|
||
|
|
} ZmfI420Image;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 图像上的锚点(相对点)
|
||
|
|
*/
|
||
|
|
typedef enum {
|
||
|
|
ZmfAnchorLeftTop = 0,
|
||
|
|
ZmfAnchorRightTop = 1,
|
||
|
|
ZmfAnchorLeftBottom = 2,
|
||
|
|
ZmfAnchorRightBottom = ZmfAnchorRightTop | ZmfAnchorLeftBottom,
|
||
|
|
ZmfAnchorLeftCenter = 4,
|
||
|
|
ZmfAnchorTopCenter = 8,
|
||
|
|
ZmfAnchorRightCenter = ZmfAnchorLeftCenter | ZmfAnchorRightTop,
|
||
|
|
ZmfAnchorBottomCenter = ZmfAnchorTopCenter | ZmfAnchorLeftBottom,
|
||
|
|
ZmfAnchorCenter = ZmfAnchorLeftCenter | ZmfAnchorTopCenter
|
||
|
|
} ZmfAnchorSite;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 从I420图像中扣出并转为ABGR图像
|
||
|
|
*/
|
||
|
|
int Zmf_BitmapFromI420(
|
||
|
|
void* bitmap, int stride, int width, int height, ZmfPixelFormatType format,
|
||
|
|
const ZmfI420Image* i420, int i420OffsetX, int i420OffsetY, ZmfAnchorSite anchor);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 将ABGR图像覆盖到 I420图像中
|
||
|
|
*/
|
||
|
|
int Zmf_BitmapToI420(
|
||
|
|
const void* bitmap, int stride, int width, int height, ZmfPixelFormatType format,
|
||
|
|
const ZmfI420Image* i420, int i420OffsetX, int i420OffsetY, ZmfAnchorSite anchor);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 缩放I420图像
|
||
|
|
* @param srcFrame 源图像数据
|
||
|
|
* @param srcWidth 源图像宽
|
||
|
|
* @param srcHeight 源图像高
|
||
|
|
* @param dstFrame 输出图像数据
|
||
|
|
* @param dstWidth 输出图像宽度
|
||
|
|
* @param dstHeight 输出图像高度
|
||
|
|
* @return int，函数执行结果\n
|
||
|
|
* 0: 函数执行成功\n
|
||
|
|
* -ZMF_ERROR_ARGUMENT_INVALID: 接口输入参数错误\n
|
||
|
|
* -ZMF_ERROR_YUV_NOT_SUPPORTED:当前版本ZMF不支持使用libyuv\n
|
||
|
|
* -ZMF_ERROR_YUV_LIB_ERROR: libyuv报错，具体错误信息需查看日志获取。\n
|
||
|
|
* @see Zmf_ConvertToI420, Zmf_ImageFromI420, Zmf_MirrorI420UpDown
|
||
|
|
*/
|
||
|
|
int Zmf_ScaleI420(void* srcFrame, int srcWidth, int srcHeight,
|
||
|
|
void* dstFrame, int dstWidth, int dstHeight);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 上下翻转I420图像
|
||
|
|
* @param srcFrame 源图像数据
|
||
|
|
* @param dstFrame 输出图像数据
|
||
|
|
* @param width 图像宽度
|
||
|
|
* @param height 图像高度
|
||
|
|
* @return int，函数执行结果\n
|
||
|
|
* 0: 函数执行成功\n
|
||
|
|
* -ZMF_ERROR_ARGUMENT_INVALID: 接口输入参数错误\n
|
||
|
|
* -ZMF_ERROR_YUV_NOT_SUPPORTED:当前版本ZMF不支持使用libyuv\n
|
||
|
|
* -ZMF_ERROR_YUV_LIB_ERROR: libyuv报错，具体错误信息需查看日志获取。\n
|
||
|
|
* @see Zmf_ConvertToI420, Zmf_ImageFromI420, Zmf_ScaleI420
|
||
|
|
*/
|
||
|
|
int Zmf_MirrorI420UpDown(void* srcFrame, void* dstFrame,
|
||
|
|
int width, int height);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief THEA收集信息的等级枚举
|
||
|
|
*/
|
||
|
|
enum ZmfTessarCollectLevel {
|
||
|
|
ZmfTessarError, /**< @brief 等级为错误的THEA信息 */
|
||
|
|
ZmfTessarWarn, /**< @brief 等级为警告的THEA信息 */
|
||
|
|
ZmfTessarImportant, /**< @brief 等级为重要的THEA信息 */
|
||
|
|
ZmfTessarDebug, /**< @brief 等级为调试的THEA信息 */
|
||
|
|
};
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief THEA收集信息的类型枚举
|
||
|
|
*/
|
||
|
|
enum ZmfTessarCollectType {
|
||
|
|
ZmfTessarData = 0x01,
|
||
|
|
ZmfTessarEvent = 0x02,
|
||
|
|
ZmfTessarAll = 0x03,
|
||
|
|
};
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 注册THEA ID
|
||
|
|
* @return int，注册THEA ID的结果。\n
|
||
|
|
* >0: 注册分配到的THEA ID\n
|
||
|
|
* -ZMF_ERROR_TESSAR_ID_FULL: 当前zmf中的THEA ID已满\n
|
||
|
|
*/
|
||
|
|
int Zmf_TessarRegister();
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 注销THEA ID
|
||
|
|
* @param id 用户id, 通过 @ref Zmf_TessarRegister 获取。
|
||
|
|
* @note 此接口无返回值，也不会产生错误信息。
|
||
|
|
*/
|
||
|
|
void Zmf_TessarDeregister(int id);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 获取THEA字符串(json)
|
||
|
|
* @param level THEA等级, @ref ZmfTessarCollectLevel
|
||
|
|
* @param type 数据类型, @ref ZmfTessarCollectType
|
||
|
|
* @param id 用户id, 通过 @ref Zmf_TessarRegister 获取。
|
||
|
|
* @return const char*, 如果获取失败返回NULL，通过 @ref Zmf_GetLastError 获取错误码和详细错误信息。\n
|
||
|
|
* 错误码由错误编号和领域码组成，其中错误编号的取值为如下之一:\n
|
||
|
|
* -ZMF_ERROR_TESSAR_ID_INVALID: 指定的id无效。\n
|
||
|
|
* -ZMF_ERROR_TESSAR_UNREGISTERED: 指定的id对应的THEA未注册。\n
|
||
|
|
*/
|
||
|
|
const char* Zmf_GetTessarData(int level, int type, int id);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 写入THEA数据
|
||
|
|
* @param keys 关键字, @ref TessarKey
|
||
|
|
* @param values 值, 顺序要和keys对应。
|
||
|
|
* @param size keys数组大小。
|
||
|
|
* @param flag 是否去重，仅针对event。=0不去重，否则表示5s内若有相同事件，则本次不写入。
|
||
|
|
* @return int
|
||
|
|
* @retval >=0 实际写入参数数量
|
||
|
|
* @warning 函数不检查values数组，使用时务必确保values数组内容和大小与key对应。
|
||
|
|
*/
|
||
|
|
int Zmf_TessarRecord(int keys[], int values[], const int size, int flag);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 设置THEA消息通知回调函数
|
||
|
|
*
|
||
|
|
* @param[in] cookie cookie, 用于区分回调对象, 不能为NULL
|
||
|
|
* @param[in] callback 回调函数, NULL表示取消回调
|
||
|
|
* @param[in] bError 是否订阅所有 @ref ZmfTessarError 等级事件
|
||
|
|
* @param[in] bWarn 是否订阅所有 @ref ZmfTessarWarn 等级事件
|
||
|
|
*
|
||
|
|
* @return 调用结果
|
||
|
|
* - 0 : 成功
|
||
|
|
* - -ZMF_ERROR_PARAM_INVALID : cookie为NULL
|
||
|
|
*/
|
||
|
|
int Zmf_TessarSetCallback(void* cookie,
|
||
|
|
void (*callback)(void* cookie, const int event_code, const char* extend_info, int len),
|
||
|
|
int bError, int bWarn);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 订阅THEA事件
|
||
|
|
*
|
||
|
|
* @param[in] cookie cookie, 用于区分回调对象, 不能为NULL
|
||
|
|
* @param[in] eventCode 事件码
|
||
|
|
*
|
||
|
|
* @return 调用结果
|
||
|
|
* - 0 : 成功
|
||
|
|
* - -ZMF_ERROR_PARAM_INVALID : cookie为NULL或eventCode<=0
|
||
|
|
* - -ZMF_ERROR_TESSAR_SUBEVENT_INVALID_COOKIE : 未调用 @ref Zmf_TessarSetCallback 添加cookie
|
||
|
|
*/
|
||
|
|
int Zmf_TessarSubscribeEvent(void* cookie, int eventCode);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 取消订阅THEA事件
|
||
|
|
*
|
||
|
|
* @param[in] cookie cookie, 用于区分回调对象, 不能为NULL
|
||
|
|
* @param[in] eventCode 事件码, -1表示取消所有订阅的特定事件
|
||
|
|
*
|
||
|
|
* @return 调用结果
|
||
|
|
* - 0 : 成功
|
||
|
|
* - -ZMF_ERROR_PARAM_INVALID : cookie为NULL
|
||
|
|
* - -ZMF_ERROR_TESSAR_SUBEVENT_INVALID_COOKIE : 未调用 @ref Zmf_TessarSetCallback 添加cookie
|
||
|
|
*
|
||
|
|
* @remark
|
||
|
|
* 取消订阅与 @ref Zmf_TessarSetCallback 设置的订阅类型相互独立。即：
|
||
|
|
* 如果订阅了Error等级事件，即使没有订阅任何事件码，Error事件依然会上报。
|
||
|
|
*/
|
||
|
|
int Zmf_TessarUnsubscribeEvent(void* cookie, int eventCode);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief 获得last error。
|
||
|
|
* @param code 错误码。格式 "[ErrorNumber][DomainCode]."
|
||
|
|
* @param msg 描述信息。
|
||
|
|
* @return 返回错误值
|
||
|
|
*/
|
||
|
|
int Zmf_GetLastError(char code[16], char msg[2048]);
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif /* __cplusplus */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifdef __GNUC__
|
||
|
|
#pragma GCC visibility pop
|
||
|
|
#endif
|
||
|
|
#endif
|