跳到主要内容

Init

Init​

函数功能​

实现尺度空间构造的模型处理资源初始化。

函数原型​

APP_ERROR Init(int32_t deviceId = 0);

参数说明​

参数名输入/输出说明
deviceId输入模型部署的芯片ID，默认为0。（目前仅支持0号芯片。）

返回参数说明​

数据结构说明
APP_ERROR程序执行返回的错误码，请参考APP_ERROR说明。

父主题： Sift

DetectAndCompute​

函数功能​

实现图像特征点的提取及计算。

函数原型​

APP_ERROR DetectAndCompute(Tensor _image, Rect _mask, std::vector<cv::KeyPoint> &keyPoints, cv::OutputArray descriptors, bool useProvidedKeyPoints);

参数说明​

参数名输入/输出说明
_image输入Tensor类，特征提取的输入图片。
- Tensor维度支持HWC（三维）。
- 不可为空，第三维C（通道数）为1，仅支持单通道。
- 支持1280 * 720输入图片尺寸。
_mask输入Rect类，输入图片掩码，用于限制需要计算特征的区域，针对该区域内的图像进行特征提取。 “_mask”所表示的掩码矩形框需放置在图片内，Rect类对应的左上角坐标及右下角坐标需在图片有效范围内。
keyPoints输入/输出提取的特征点列表。
descriptors输出生成的描述子列表。
useProvidedKeyPoints输入是否提供特征点列表，即该函数仅进行描述子生成。
- 参数为“true”时，接口将会根据keyPoints传入的特征点列表生成描述子列表。
- 参数为“false”时，接口将会根据Sift算法提取特征点列表并根据列表生成描述子列表。

返回参数说明​

数据结构说明
APP_ERROR程序执行返回的错误码，请参考APP_ERROR说明。

父主题： Sift

类说明​

VideoEncoder类，作为视频编码类，主要开放视频编码接口。

:::note 说明 VideoEncoder类涉及申请Device侧资源，与MxDeInit的作用域冲突，因此，其作用域不能大于或等于MxDeInit的作用域。 :::

父主题： VideoEncoder

VideoEncoder​

函数功能​

VideoEncoder类的构造函数。若因内存不足，或无法识别芯片等构造失败的场景会抛出 std::runtime_error 异常。

函数原型​

VideoEncoder(const VideoEncodeConfig& vEncodeConfig, const int32_t deviceId = 0,
             const uint32_t channelId = 0);

参数说明​

参数名输入/输出说明
vEncodeConfig输入视频编码的参数（以结构体的形式传入）。 视频编码的最大分辨率（宽 * 高）不能超过 4096 * 2304。
deviceId输入视频编码器部署的芯片，默认为 0 号芯片。 取值范围：[0, 识别到的芯片个数 - 1]。
channelId输入视频编码器的视频流索引。
- Atlas 200I/500 A2 推理产品：只能构造一个VideoEncoder，因此用户无需设置 channelId，重复构造会导致失败。

父主题： VideoEncoder

~VideoEncoder​

函数功能​

VideoEncoder类的默认析构函数。

函数原型​

~VideoEncoder()

父主题： VideoEncoder

Encode​

函数功能​

VideoEncoder的视频编码接口。

函数原型​

APP_ERROR Encode(const Image &inputImage, const uint32_t frameId, void* userData);

参数说明​

参数名输入/输出说明
inputImage输入输入编码前的FrameImage结构体。
frameId输入输入视频帧索引。
userData输入/输出输入用户自定义数据（用于传入用户自定义回调函数内，主要用来获取编码结果）。

返回参数说明​

数据结构说明
APP_ERROR程序执行返回的错误码，请参考APP_ERROR说明。

父主题： VideoEncoder

在线提单