DriveWorks SDK Reference
3.5.78 Release
For Test and Development only

LightSourceDetector

Detailed Description

Defines LightSourceDetector module for light source detection.

Note
SW Release Applicability: These APIs are available in NVIDIA DRIVE Software releases.

Enumerations

enum  dwLightSourceDetectorStage {
  DW_LSP_DETECTOR_STAGE_GPU_PREPROCESS = 0,
  DW_LSP_DETECTOR_STAGE_GPU_INFERENCE = 1,
  DW_LSP_DETECTOR_STAGE_GPU_POSTPROCESS = 2,
  DW_LSP_DETECTOR_STAGE_CPU_POSTPROCESS = 3
}
 

Functions

DW_API_PUBLIC dwStatus dwLightSourceDetector_bindInput (const dwImageCUDA *imageRGB, const dwImageCUDA *imageBayer, dwLightSourceDetectorHandle_t obj)
 Binds the input images to the detector. More...
 
DW_API_PUBLIC dwStatus dwLightSourceDetector_bindInputRawImage (const dwImageCUDA *imageBayer, dwLightSourceDetectorHandle_t obj)
 Binds the input raw image to the detector. More...
 
DW_API_PUBLIC dwStatus dwLightSourceDetector_bindInputTensor (dwAutoNetOutputHandle_t netTensor, dwLightSourceDetectorHandle_t obj)
 Binds the network inference output tensor. More...
 
DW_API_PUBLIC dwStatus dwLightSourceDetector_bindOutputAutoBeamStatus (dwLightSourceDetectorAutoBeamStatus *output, dwLightSourceDetectorHandle_t obj)
 Bind the ouput 0 (auto beam status) of the detector to object. More...
 
DW_API_PUBLIC dwStatus dwLightSourceDetector_bindOutputDetectorMask (dwLightSourceDetectorMask *output, dwLightSourceDetectorHandle_t obj)
 Bind the output 1 (matrix beam detection mask) of the detector to object. More...
 
DW_API_PUBLIC dwStatus dwLightSourceDetector_bindOutputDetectorMaskImage (dwImageHandle_t output, dwLightSourceDetectorHandle_t obj)
 Bind the output 2 (matrix beam detection mask image) of the detector to object. More...
 
DW_API_PUBLIC dwStatus dwLightSourceDetector_bindOutputRawDetectorMaskImage (dwImageHandle_t output, dwLightSourceDetectorHandle_t obj)
 Bind the output 3 (matrix beam raw detection mask image) of the detector to object. More...
 
DW_API_PUBLIC dwStatus dwLightSourceDetector_process (dwLightSourceDetectorStage stage, dwLightSourceDetectorHandle_t obj)
 Perform object detection stages. More...
 

Enumeration Type Documentation

◆ dwLightSourceDetectorStage

Enumerator
DW_LSP_DETECTOR_STAGE_GPU_PREPROCESS 

Input image is preprocessed on GPU side with certain predefined transformations in order to have the right properties required by DNN inference.

DW_LSP_DETECTOR_STAGE_GPU_INFERENCE 

DNN inference is run on prepared image.

DW_LSP_DETECTOR_STAGE_GPU_POSTPROCESS 

Async GPU post-processing is run after inference.

DW_LSP_DETECTOR_STAGE_CPU_POSTPROCESS 

After inference CPU runs post processing.

Definition at line 63 of file LspDetector_processPipeline.h.

Function Documentation

◆ dwLightSourceDetector_bindInput()

DW_API_PUBLIC dwStatus dwLightSourceDetector_bindInput ( const dwImageCUDA imageRGB,
const dwImageCUDA imageBayer,
dwLightSourceDetectorHandle_t  obj 
)

Binds the input images to the detector.

Parameters
[in]imageRGBPointer to RGB image where the detector is to be applied.
[in]imageBayerPointer to Bayer image where we apply linear HDR threshold.
[in]objSpecifies the LspDetector handle.
Returns
DW_SUCCESS, DW_INVALID_HANDLE, DW_BAD_CAST, DW_INVALID_ARGUMENT

◆ dwLightSourceDetector_bindInputRawImage()

DW_API_PUBLIC dwStatus dwLightSourceDetector_bindInputRawImage ( const dwImageCUDA imageBayer,
dwLightSourceDetectorHandle_t  obj 
)

Binds the input raw image to the detector.

Parameters
[in]imageBayerPointer to Bayer image where we apply linear HDR threshold.
[in]objSpecifies the LspDetector handle.
Returns
DW_SUCCESS, DW_INVALID_HANDLE, DW_BAD_CAST, DW_INVALID_ARGUMENT

◆ dwLightSourceDetector_bindInputTensor()

DW_API_PUBLIC dwStatus dwLightSourceDetector_bindInputTensor ( dwAutoNetOutputHandle_t  netTensor,
dwLightSourceDetectorHandle_t  obj 
)

Binds the network inference output tensor.

Parameters
[in]netTensornetwork detection tensor
[in]objSpecifies the ObjectDetector handle.
Returns
DW_SUCCESS, DW_INVALID_HANDLE, DW_BAD_CAST, DW_INVALID_ARGUMENT

◆ dwLightSourceDetector_bindOutputAutoBeamStatus()

DW_API_PUBLIC dwStatus dwLightSourceDetector_bindOutputAutoBeamStatus ( dwLightSourceDetectorAutoBeamStatus output,
dwLightSourceDetectorHandle_t  obj 
)

Bind the ouput 0 (auto beam status) of the detector to object.

Parameters
[in,out]outputPointer to an object output structure.
[in]objSpecifies the LightSourceDetector handle.
Returns
DW_SUCCESS, DW_INVALID_HANDLE, DW_BAD_CAST, DW_INVALID_ARGUMENT

◆ dwLightSourceDetector_bindOutputDetectorMask()

DW_API_PUBLIC dwStatus dwLightSourceDetector_bindOutputDetectorMask ( dwLightSourceDetectorMask output,
dwLightSourceDetectorHandle_t  obj 
)

Bind the output 1 (matrix beam detection mask) of the detector to object.

Parameters
[in,out]outputPointer to an object output structure.
[in]objSpecifies the LightSourceDetector handle.
Returns
DW_SUCCESS, DW_INVALID_HANDLE, DW_BAD_CAST, DW_INVALID_ARGUMENT

◆ dwLightSourceDetector_bindOutputDetectorMaskImage()

DW_API_PUBLIC dwStatus dwLightSourceDetector_bindOutputDetectorMaskImage ( dwImageHandle_t  output,
dwLightSourceDetectorHandle_t  obj 
)

Bind the output 2 (matrix beam detection mask image) of the detector to object.

Parameters
[in,out]outputpointer of the structure that receives the mask.
[in]objSpecifies the LightSourceDetector handle.
Returns
DW_SUCCESS, DW_INVALID_HANDLE, DW_BAD_CAST, DW_INVALID_ARGUMENT

◆ dwLightSourceDetector_bindOutputRawDetectorMaskImage()

DW_API_PUBLIC dwStatus dwLightSourceDetector_bindOutputRawDetectorMaskImage ( dwImageHandle_t  output,
dwLightSourceDetectorHandle_t  obj 
)

Bind the output 3 (matrix beam raw detection mask image) of the detector to object.

Parameters
[in,out]outputHandle of the image that receives the raw mask.
[in]objSpecifies the LightSourceDetector handle.
Returns
DW_SUCCESS, DW_INVALID_HANDLE, DW_BAD_CAST, DW_INVALID_ARGUMENT

◆ dwLightSourceDetector_process()

DW_API_PUBLIC dwStatus dwLightSourceDetector_process ( dwLightSourceDetectorStage  stage,
dwLightSourceDetectorHandle_t  obj 
)

Perform object detection stages.

Inputs and outputs must be bound before this call.

Parameters
[in]stageProcessing stage to run.
[in]objSpecifies the LightSourceDetector handle.
Returns
DW_SUCCESS operation completed successfully DW_INVALID_ARGUMENT one of the parameters are invalid (nullptr or null handle)