Auto gain digital

Functions
PEAK_API_STATUS	peak_IPL_AutoBrightness_GainDigital_Mode_Set (peak_camera_handle hCam, peak_auto_feature_mode autoGainMode)
	Set the host auto gain control mode.
PEAK_API_STATUS	peak_IPL_AutoBrightness_GainDigital_Mode_Get (peak_camera_handle hCam, peak_auto_feature_mode *autoGainMode)
	Get the host auto gain control mode.
PEAK_API_STATUS	peak_IPL_AutoBrightness_GainDigitalLimit_Set (peak_camera_handle hCam, peak_double_limit gainLimit)
	Set the host auto gain digital limit.
PEAK_API_STATUS	peak_IPL_AutoBrightness_GainDigitalLimit_Get (peak_camera_handle hCam, peak_double_limit *gainLimit)
	Get the host auto gain digital limit.
PEAK_API_STATUS	peak_IPL_AutoBrightness_GainDigitalLimit_GetRange (peak_camera_handle hCam, peak_double_limit *gainLimit)
	Get the host auto gain digital limit range.

Detailed Description

Auto brightness gain digital control related functions and types.

This feature is applied in the host.
There is also a camera implementation. See Auto brightness control.

Function Documentation

peak_IPL_AutoBrightness_GainDigital_Mode_Get()

PEAK_API_STATUS peak_IPL_AutoBrightness_GainDigital_Mode_Get	(	peak_camera_handle	hCam,
		peak_auto_feature_mode *	autoGainMode
	)

Get the host auto gain control mode.

Reads the current host auto gain control mode.

Parameters

[in]	hCam	The camera handle.
[out]	autoGainMode	The current auto gain control mode.

Returns

PEAK_STATUS_SUCCESS Operation was successful; no error occurred.

PEAK_STATUS_INVALID_PARAMETER autoGainMode is an invalid pointer.

PEAK_STATUS_INVALID_HANDLE hCam is an invalid camera handle.

PEAK_STATUS_NOT_INITIALIZED The library is not initialized.

PEAK_STATUS_ERROR An unexpected internal error occurred.

peak_IPL_AutoBrightness_GainDigital_Mode_Set()

PEAK_API_STATUS peak_IPL_AutoBrightness_GainDigital_Mode_Set	(	peak_camera_handle	hCam,
		peak_auto_feature_mode	autoGainMode
	)

Set the host auto gain control mode.

Writes the desired host auto gain control mode.

Note

If auto gain has been enabled previously with peak_IPL_AutoBrightness_Gain_Mode_Set auto gain mode will be disabled.

Parameters

[in]	hCam	The camera handle.
[in]	autoGainMode	The auto gain control mode to set.

Returns

PEAK_STATUS_SUCCESS Operation was successful; no error occurred.

PEAK_STATUS_INVALID_PARAMETER autoGainMode is an invalid auto feature mode. Check peak_auto_feature_mode.

PEAK_STATUS_INVALID_HANDLE hCam is an invalid camera handle.

PEAK_STATUS_NOT_INITIALIZED The library is not initialized.

PEAK_STATUS_ERROR An unexpected internal error occurred.

peak_IPL_AutoBrightness_GainDigitalLimit_Get()

PEAK_API_STATUS peak_IPL_AutoBrightness_GainDigitalLimit_Get	(	peak_camera_handle	hCam,
		peak_double_limit *	gainLimit
	)

Get the host auto gain digital limit.

Parameters

[in]	hCam	The camera handle.
[out]	gainLimit	The current gain digital limit.

Returns

PEAK_STATUS_SUCCESS Operation was successful; no error occurred.

PEAK_STATUS_INVALID_PARAMETER gainLimit is an invalid pointer.

PEAK_STATUS_INVALID_HANDLE hCam is an invalid camera handle.

PEAK_STATUS_NOT_INITIALIZED The library is not initialized.

PEAK_STATUS_ERROR An unexpected internal error occurred.

peak_IPL_AutoBrightness_GainDigitalLimit_GetRange()

PEAK_API_STATUS peak_IPL_AutoBrightness_GainDigitalLimit_GetRange	(	peak_camera_handle	hCam,
		peak_double_limit *	gainLimit
	)

Get the host auto gain digital limit range.

Default is the complete range.

Parameters

[in]	hCam	The camera handle.
[out]	gainLimit	The valid range for the gain digital limit.

Returns

PEAK_STATUS_SUCCESS Operation was successful; no error occurred.

PEAK_STATUS_INVALID_PARAMETER gainLimit is an invalid pointer.

PEAK_STATUS_INVALID_HANDLE hCam is an invalid camera handle.

PEAK_STATUS_NOT_INITIALIZED The library is not initialized.

PEAK_STATUS_ERROR An unexpected internal error occurred.

peak_IPL_AutoBrightness_GainDigitalLimit_Set()

PEAK_API_STATUS peak_IPL_AutoBrightness_GainDigitalLimit_Set	(	peak_camera_handle	hCam,
		peak_double_limit	gainLimit
	)

Set the host auto gain digital limit.

The valid values can be read out by calling peak_IPL_AutoBrightness_GainDigitalLimit_GetRange. Default is the complete range.

If any value of the limit is out of range, the value is clamped to be valid. In this case the functions returns with PEAK_STATUS_VALUE_ADJUSTED. It is recommended to check the current values by calling peak_IPL_AutoBrightness_GainDigitalLimit_Get after this call.

Parameters

[in]	hCam	The camera handle.
[in]	gainLimit	The gain limit to set.

Returns

PEAK_STATUS_SUCCESS Operation was successful; no error occurred.

PEAK_STATUS_INVALID_PARAMETER gainLimit is an invalid pointer.

PEAK_STATUS_INVALID_HANDLE hCam is an invalid camera handle.

PEAK_STATUS_NOT_INITIALIZED The library is not initialized.

PEAK_STATUS_VALUE_ADJUSTED At least one value of the limit is out of range. The limit was adjusted accordingly.

PEAK_STATUS_ERROR An unexpected internal error occurred.