ray
/
huaxun
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
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.
12 Commits
1 Branch
0 Tags
655 MiB
 
 
 
Tree: 9b2b76d843
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '9b2b76d843'
${ noResults }
huaxun/Pods/JuphoonCloudSDK_iOS/include/grape/zmf_utils.h

357 lines
14 KiB
Raw Blame History

#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