DriveWorks SDK Reference
3.0.4260 Release
For Test and Development only

Typedefs | Functions
HeadlightController Interface

Detailed Description

Provides vehicle headlight reactor functionality.

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

Headlight Controller is a module to automatically guide the car's headlight control status. Instead of using an extra sensor, this module is based camera input signals. The basic idea is to provide headlight control signals according to environment ambient intensity.

Typedefs

typedef struct dwHeadlightControllerObject * dwHeadlightControllerHandle_t
 

Functions

DW_API_PUBLIC dwStatus dwHeadlightController_computeControlLevel (float32_t *level, dwConstImageHandle_t img, dwHeadlightControllerHandle_t obj)
 Get control level from headlight controller. More...
 
DW_API_PUBLIC dwStatus dwHeadlightController_initialize (dwHeadlightControllerHandle_t *obj, dwCameraType camType, dwContextHandle_t ctx)
 Initializes the HeadlightController module. More...
 
DW_API_PUBLIC dwStatus dwHeadlightController_release (dwHeadlightControllerHandle_t obj)
 Release the headlight controller object. More...
 
DW_API_PUBLIC dwStatus dwHeadlightController_reset (dwHeadlightControllerHandle_t obj)
 reset the headlight controller, clear any related history and status More...
 

Typedef Documentation

◆ dwHeadlightControllerHandle_t

typedef struct dwHeadlightControllerObject* dwHeadlightControllerHandle_t

Definition at line 67 of file HeadlightController.h.

Function Documentation

◆ dwHeadlightController_computeControlLevel()

DW_API_PUBLIC dwStatus dwHeadlightController_computeControlLevel ( float32_t *  level,
dwConstImageHandle_t  img,
dwHeadlightControllerHandle_t  obj 
)

Get control level from headlight controller.

Control level is an indicator to guide whether to turn on/off the headlight of the car. For headlight without intensity control, threshold value 0.5 should be used for on/off signal. For headlight with intensity control, the value [0.5, 1.0] could guide the setting of intensity. For example, linearly mapping this range to your headlight electronic output.

Parameters
[out]levelA pointer to a float number.
Which will gain value between 0 and 1. Level value with 0.5 or bigger should be treated as the turn on signal.
For the light headware with intensity control, could use the linear range from 0.5 to 1 to mapping their output instensity
[in]imga general image handle from camera
[in]objctx Specify the handle to headlightController
Returns
DW_INVALID_ARGUMENT - if provided frame or handle is invalid.
DW_SUCCESS

◆ dwHeadlightController_initialize()

DW_API_PUBLIC dwStatus dwHeadlightController_initialize ( dwHeadlightControllerHandle_t *  obj,
dwCameraType  camType,
dwContextHandle_t  ctx 
)

Initializes the HeadlightController module.

Parameters
[out]objA pointer to the headlightController handle for the created module.
[in]camTypeSpecify the source camera type.
[in]ctxSpecify the handle to the runtime context under which the controller module will be created.
Returns
DW_NOT_SUPPORTED - if provided camera not supported
DW_INVALID_ARGUMENT - if provided arguments combination is invalid.
DW_SUCCESS
Note
At this moment only DW_CAMERA_GMSL_AR0231 camera is supported.

◆ dwHeadlightController_release()

DW_API_PUBLIC dwStatus dwHeadlightController_release ( dwHeadlightControllerHandle_t  obj)

Release the headlight controller object.

Parameters
[in]objThe headlight controller object handle.
Returns
DW_INVALID_ARGUMENT - if provided handle is invalid.
DW_SUCCESS

◆ dwHeadlightController_reset()

DW_API_PUBLIC dwStatus dwHeadlightController_reset ( dwHeadlightControllerHandle_t  obj)

reset the headlight controller, clear any related history and status

Parameters
[in]objThe headlight controller object you want to reset.
Returns
DW_INVALID_ARGUMENT - if provided handle is invalid.
DW_SUCCESS