NVIDIA DriveOS Linux NSR SDK API Reference

7.0.3.0 Release
Rectifier.h
Go to the documentation of this file.
1 /*
2  * SPDX-FileCopyrightText: Copyright (c) 2015-2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
3  * SPDX-License-Identifier: LicenseRef-NvidiaProprietary
4  *
5  * NVIDIA CORPORATION, its affiliates and licensors retain all intellectual
6  * property and proprietary rights in and to this material, related
7  * documentation and any modifications thereto. Any use, reproduction,
8  * disclosure or distribution of this material and related documentation
9  * without an express license agreement from NVIDIA CORPORATION or
10  * its affiliates is strictly prohibited.
11  */
12 
29 #ifndef DW_IMAGEPROCESSING_GEOMETRY_RECTIFIER_H_
30 #define DW_IMAGEPROCESSING_GEOMETRY_RECTIFIER_H_
31 
32 #include <dw/core/context/Context.h>
33 #include <dw/core/base/Types.h>
34 #include <dw/image/Image.h>
35 #include <dw/calibration/cameramodel/CameraModel.h>
36 
37 #ifdef __cplusplus
38 extern "C" {
39 #endif
40 
46 typedef struct dwRectifierObject* dwRectifierHandle_t;
47 
69  dwCameraModelHandle_t cameraIn,
70  dwCameraModelHandle_t cameraOut,
72 
88 
106 
137 
156 
178 dwStatus dwRectifier_apply(dwImageHandle_t outputImage, const dwConstImageHandle_t inputImage,
180 
198 
217 
235 dwStatus dwRectifier_warpPointsCPU(dwVector2f* outputPoints, const dwVector2f* inputPoints,
236  uint32_t pointCount, dwRectifierHandle_t obj);
237 
256 dwStatus dwRectifier_warpPointsGPU(dwVector2f* outputPoints, const dwVector2f* inputPoints,
257  uint32_t pointCount, dwRectifierHandle_t obj);
258 
275 
292 
309 
326 
327 #ifdef __cplusplus
328 }
329 #endif
330 
331 #endif // DW_RECTIFIER_H_
dwCameraModelHandle_t
struct dwCameraModelObject * dwCameraModelHandle_t
A pointer to the handle representing a calibrated camera model.
Definition: CameraModel.h:50
dwRectifier_warpPointsCPU
DW_API_PUBLIC dwStatus dwRectifier_warpPointsCPU(dwVector2f *outputPoints, const dwVector2f *inputPoints, uint32_t pointCount, dwRectifierHandle_t obj)
Warps an array of CPU dwVector2f on a preallocated output CPU buffer.
dwRectifier_getHomography
DW_API_PUBLIC dwStatus dwRectifier_getHomography(dwMatrix3f *homography, dwRectifierHandle_t obj)
Gets the homography matrix used.
dwRectifier_setHomographyFromRotation
DW_API_PUBLIC dwStatus dwRectifier_setHomographyFromRotation(float32_t roll, float32_t pitch, float32_t yaw, dwRectifierHandle_t obj)
Calculates and sets the homography matrix used based on a value for roll, pitch and yaw.
dwRectifierHandle_t
struct dwRectifierObject * dwRectifierHandle_t
A pointer to the handle representing a rectifier.
Definition: Rectifier.h:46
ctx
DW_API_PUBLIC dwPointCloudRangeImageCreatorParams const *const const dwContextHandle_t ctx
Definition: PointCloudRangeImageCreator.h:293
dwRectifier_getDistortionMap
DW_API_PUBLIC dwStatus dwRectifier_getDistortionMap(dwImageCUDA *distortionMap, dwRectifierHandle_t obj)
Gets the distortion map as a 2-channel single plane image.
handle
const WFDCommitType const WFDHandle handle
Definition: wfdext.h:124
dwConstImageHandle_t
struct dwImageObject const * dwConstImageHandle_t
Definition: Image.h:89
dwImageCUDA
Defines a CUDA image.
Definition: Image.h:508
float32_t
float float32_t
Specifies POD types.
Definition: BasicTypes.h:41
dwRectifier_setHomography
DW_API_PUBLIC dwStatus dwRectifier_setHomography(const dwMatrix3f *homography, dwRectifierHandle_t obj)
Sets the homography matrix used.
dwRect
Defines a rectangle.
Definition: GeometricTypes.h:47
dwRectifier_getCUDAStream
DW_API_PUBLIC dwStatus dwRectifier_getCUDAStream(cudaStream_t *stream, dwRectifierHandle_t obj)
Gets the CUDA stream used.
dwRectifier_registerImages
DW_API_PUBLIC dwStatus dwRectifier_registerImages(dwImagePool imagePool, dwRectifierHandle_t handle)
All (both input and output) images that the rectifier engine has to work with (NvMedia2D VIC mode onl...
dwRectifier_warpPointsGPU
DW_API_PUBLIC dwStatus dwRectifier_warpPointsGPU(dwVector2f *outputPoints, const dwVector2f *inputPoints, uint32_t pointCount, dwRectifierHandle_t obj)
Warps an array of dwVector2f on GPU.
dwRectifier_release
DW_API_PUBLIC dwStatus dwRectifier_release(dwRectifierHandle_t obj)
Releases the rectifier module.
dwImageProperties
Defines the properties of the image.
Definition: Image.h:477
dwRectifier_reset
DW_API_PUBLIC dwStatus dwRectifier_reset(dwRectifierHandle_t obj)
Resets the rectifier module.
dwContextHandle_t
struct dwContextObject * dwContextHandle_t
Context handle.
Definition: Context.h:74
dwRectifier_initialize
DW_API_PUBLIC dwStatus dwRectifier_initialize(dwRectifierHandle_t *obj, dwCameraModelHandle_t cameraIn, dwCameraModelHandle_t cameraOut, dwContextHandle_t ctx)
Initializes a rectifier based on an input and output camera model and a homography.
dwImageHandle_t
struct dwImageObject * dwImageHandle_t
Definition: Image.h:88
dwMatrix3f
Defines a 3x3 matrix of floating point numbers by using only one array.
Definition: MatrixTypes.h:158
dwStatus
dwStatus
Status definition.
Definition: ErrorDefs.h:27
dwImagePool
Specifies a pool of images.
Definition: Image.h:95
dwRectifier_setCUDAStream
DW_API_PUBLIC dwStatus dwRectifier_setCUDAStream(cudaStream_t stream, dwRectifierHandle_t obj)
Sets the CUDA stream used.
DW_API_PUBLIC
#define DW_API_PUBLIC
Definition: Exports.h:38
dwRectifier_appendAllocationAttributes
DW_API_PUBLIC dwStatus dwRectifier_appendAllocationAttributes(dwImageProperties *const imgProps, dwRectifierHandle_t obj)
Append the allocation attribute such that the images created of type DW_IMAGE_NVMEDIA can be fed to d...
dwRectifier_apply
DW_API_PUBLIC dwStatus dwRectifier_apply(dwImageHandle_t outputImage, const dwConstImageHandle_t inputImage, dwRect *roi, dwRectifierHandle_t obj)
Warps the image from the input camera model to the model of the output camera using either CUDA on th...
obj
const NvSciSyncObj *const obj
Definition: wfdext.h:120
dwVector2f
Defines a two-element single-precision floating-point vector.
Definition: MatrixTypes.h:30