VPI - 视觉编程接口

3.2 版本

ORB.h
前往此文件的文档。
1 /*
2  * Copyright 2022-2024 NVIDIA Corporation. All rights reserved.
3  *
4  * NOTICE TO LICENSEE:
5  *
6  * This source code and/or documentation ("Licensed Deliverables") are
7  * subject to NVIDIA intellectual property rights under U.S. and
8  * international Copyright laws.
9  *
10  * These Licensed Deliverables contained herein is PROPRIETARY and
11  * CONFIDENTIAL to NVIDIA and is being provided under the terms and
12  * conditions of a form of NVIDIA software license agreement by and
13  * between NVIDIA and Licensee ("License Agreement") or electronically
14  * accepted by Licensee. Notwithstanding any terms or conditions to
15  * the contrary in the License Agreement, reproduction or disclosure
16  * of the Licensed Deliverables to any third party without the express
17  * written consent of NVIDIA is prohibited.
18  *
19  * NOTWITHSTANDING ANY TERMS OR CONDITIONS TO THE CONTRARY IN THE
20  * LICENSE AGREEMENT, NVIDIA MAKES NO REPRESENTATION ABOUT THE
21  * SUITABILITY OF THESE LICENSED DELIVERABLES FOR ANY PURPOSE. IT IS
22  * PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY OF ANY KIND.
23  * NVIDIA DISCLAIMS ALL WARRANTIES WITH REGARD TO THESE LICENSED
24  * DELIVERABLES, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY,
25  * NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.
26  * NOTWITHSTANDING ANY TERMS OR CONDITIONS TO THE CONTRARY IN THE
27  * LICENSE AGREEMENT, IN NO EVENT SHALL NVIDIA BE LIABLE FOR ANY
28  * SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, OR ANY
29  * DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
30  * WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
31  * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
32  * OF THESE LICENSED DELIVERABLES.
33  *
34  * U.S. Government End Users. These Licensed Deliverables are a
35  * "commercial item" as that term is defined at 48 C.F.R. 2.101 (OCT
36  * 1995), consisting of "commercial computer software" and "commercial
37  * computer software documentation" as such terms are used in 48
38  * C.F.R. 12.212 (SEPT 1995) and is provided to the U.S. Government
39  * only as a commercial end item. Consistent with 48 C.F.R.12.212 and
40  * 48 C.F.R. 227.7202-1 through 227.7202-4 (JUNE 1995), all
41  * U.S. Government End Users acquire the Licensed Deliverables with
42  * only those rights set forth herein.
43  *
44  * Any use of the Licensed Deliverables in individual and commercial
45  * software must include, in the user documentation and internal
46  * comments to the code, the above Disclaimer and U.S. Government End
47  * Users Notice.
48  */
49 
56 #ifndef NV_VPI_ALGORITHMS_ORB_H
57 #define NV_VPI_ALGORITHMS_ORB_H
58 
59 #include "../Export.h"
60 #include "../Status.h"
61 #include "../Types.h"
62 #include "FASTCorners.h"
63 
64 #include <stddef.h>
65 #include <stdint.h>
66 
67 #ifdef __cplusplus
68 extern "C" {
69 #endif
70 
83 #define VPI_DISABLE_RBRIEF (0x01)
84 
88 typedef struct
89 {
95 
107 
112 
123 
130  uint32_t flags;
131 } VPIORBParams;
132 
146 
174 VPI_PUBLIC VPIStatus vpiCreateORBFeatureDetector(uint64_t backends, int32_t capacity, VPIPayload *payload);
175 
256 VPI_PUBLIC VPIStatus vpiSubmitORBFeatureDetector(VPIStream stream, uint64_t backend, VPIPayload payload,
257  VPIPyramid input, VPIArray outCorners, VPIArray outDescriptors,
258  const VPIORBParams *params, VPIBorderExtension border);
259 
282 VPI_PUBLIC VPIStatus vpiCreateORBDescriptorExtractor(uint64_t backends, VPIPayload *payload);
283 
363 #if NV_VPI_VERSION_API_AT_LEAST(3, 1)
364 VPI_PUBLIC VPIStatus vpiSubmitORBDescriptorExtractor(VPIStream stream, uint64_t backend, VPIPayload payload,
365  VPIPyramid input, VPIArray inCorners, VPIArray outDescriptors,
366  uint32_t flags);
367 #else
368 __asm__(".symver vpiSubmitORBDescriptorExtractor,vpiSubmitORBDescriptorExtractor@VPI_3.0");
369 VPI_PUBLIC VPIStatus vpiSubmitORBDescriptorExtractor(VPIStream stream, uint64_t backend, VPIPayload payload,
370  VPIImage input, VPIArray inCorners, VPIArray outDescriptors,
371  uint32_t flags);
372 #endif
373 
374 #ifdef __cplusplus
375 }
376 #endif
377  // end of VPI_OrbFeatureDetector
379 
380 #endif /* NV_VPI_ALGORITHMS_ORB_H */
声明实现 FAST 角点支持的函数。
VPICornerScore
定义不同类型的角点得分。
Definition: Types.h:355
struct VPIArrayImpl * VPIArray
数组的句柄。
Definition: Types.h:232
定义 vpiSubmitFASTCornerDetector 参数的结构体。
Definition: FASTCorners.h:82
struct VPIImageImpl * VPIImage
图像的句柄。
Definition: Types.h:256
int32_t maxFeaturesPerLevel
ORB 使用的每个输入金字塔级别的最大特征数量 N。
Definition: ORB.h:106
VPICornerScore scoreType
分数类型允许定义如何为角点分配分数。
Definition: ORB.h:122
uint32_t flags
控制标志。
Definition: ORB.h:130
VPIFASTCornerDetectorParams fastParams
FAST 角点检测器的参数,详见 FAST 角点检测器。
Definition: ORB.h:94
int32_t maxPyramidLevels
要利用的输入金字塔中的最大级别数。
Definition: ORB.h:111
VPIStatus vpiInitORBParams(VPIORBParams *params)
使用默认值初始化 VPIORBParams。
VPIStatus vpiCreateORBDescriptorExtractor(uint64_t backends, VPIPayload *payload)
创建 ORB 描述符提取器有效载荷。
VPIStatus vpiSubmitORBFeatureDetector(VPIStream stream, uint64_t backend, VPIPayload payload, VPIPyramid input, VPIArray outCorners, VPIArray outDescriptors, const VPIORBParams *params, VPIBorderExtension border)
向流提交 ORB 特征检测器操作。
VPIStatus vpiSubmitORBDescriptorExtractor(VPIStream stream, uint64_t backend, VPIPayload payload, VPIPyramid input, VPIArray inCorners, VPIArray outDescriptors, uint32_t flags)
向流提交 ORB 描述符提取器操作。
VPIStatus vpiCreateORBFeatureDetector(uint64_t backends, int32_t capacity, VPIPayload *payload)
创建 ORB 特征检测器有效载荷。
定义 vpiSubmitORBFeatureDetector 参数的结构体。
Definition: ORB.h:89
struct VPIPayloadImpl * VPIPayload
算法有效载荷的句柄。
Definition: Types.h:268
struct VPIPyramidImpl * VPIPyramid
图像金字塔的句柄。
Definition: Types.h:262
VPIStatus
状态代码。
Definition: Status.h:81
struct VPIStreamImpl * VPIStream
流的句柄。
Definition: Types.h:250
VPIBorderExtension
图像边界扩展指定应如何构建图像域外部的像素值。
Definition: Types.h:277