kStatus kCamera_EnableLeadOut	(	kCamera	camera,
		kBool	enable
	)

Determines whether estimated imager post-exposure is incorporated into nominal exposure.

When enabled, the underlying imager post-exposure (the duration for which an imager is sensitive to light after its physical exposure signal is deasserted, determined via characterization) will be included in its nominal exposure duration. In this case, a lead-out (offset between end of physical imager exposure and end of nominal camera exposure) is used. In turn, this lead-out typically determines the minimum exposure time constraint. Use of this option, which is enabled by default, provides some automatic protection against light multiplexing hazards by ensuring that the camera's nominal exposure time reflects all of the time in which the camera is actually sensitive to light. When this option is enabled, the kCameraState_LeadOutNs property will typically report a positive value, and the kCameraState_PostExposureNs property will report a zero value.

However, some cameras can produce exposure artifacts if significant illumination is present during camera post-exposure (e.g., "black sun" effects on LC2000/5000). In these cases, reliance on camera lead-outs can result in artifacts when light exposure is coupled to (or manually aligned with) camera exposure. Additionally, if lights are coupled to cameras and very low exposures are required, disabling the camera lead-out allows the nominal camera exposure to be reduced down to zero, which in turn allows the coupled light exposure to be reduced down to zero. This can be used to simulate exposure times that are lower than what the camera itself can support, an advantage in some contexts.

Due to the problems and limitations associated with camera lead-out, it is recommended that lead-out should be disabled in new applications. However, please note that doing so will change the effective exposure time for the same nominal exposure setting; as such, this choice must be carefully weighed if backwards compability with older platform versions is important. When this option is disabled, the kCameraState_LeadOutNs property will report zero, and the kCameraState_PostExposureNs property will likely report a positive value. The post-exposure time should be considered when determining multiplexed camera/light time slots.

This option is enabled by default. This option is not configurable for DM647 (M2, M50) controllers.

Parameters

camera	Camera object.
enable	kTRUE to include camera lead-out.

Returns

Operation status.

See also

kCameraState_LeadOutNs, kCameraState_PostExposureNs