IDS Software Suite 4.96.1
 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_Gamma(HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Description
is_Gamma() enables digital gamma correction which applies a gamma characteristic to the image. When hardware color conversion is used on USB 3 uEye CP/LE/ML cameras the gamma correction is performed in the camera hardware as well. When the color conversion is performed in the PC (software conversion) the gamma correction is performed in software.
|
When the color format is set to Raw Bayer the gamma correction can not be used. |
|
Typical values for gamma range between 1.6 and 2.2. |
The nCommand input parameter is used to select the function mode. The pParam input parameter depends on the selected function mode. If you select functions for setting or returning a value, pParam contains a pointer to a variable of the UINT type. The size of the memory area to which pParam refers is specified in the cbSizeOfParam input parameter.
Input parameters
hCam |
Camera handle |
pParam |
Pointer to a function parameter, whose function depends on nCommand. |
cbSizeOfParam |
Size (in bytes) of the memory area to which pParam refers. |
Return values
IS_INVALID_PARAMETER |
One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode. |
IS_NO_SUCCESS |
General error message |
IS_NOT_SUPPORTED |
The camera model used here does not support this function or setting. |
IS_SUCCESS |
Function executed successfully |
Related functions
/* set gamma value to 1.6 */
INT nGamma = 160;
INT nRet = is_Gamma(hCam, IS_GAMMA_CMD_SET, (void*) &nGamma, sizeof(nGamma));
/* set gamma to default value */
INT nGamma;
INT nRet = is_Gamma(hCam, IS_GAMMA_CMD_GET_DEFAULT, (void*)&nGamma, sizeof(nGamma));
if (nRet == IS_SUCCESS)
{
is_Gamma(hCam, IS_GAMMA_CMD_SET, (void*)&nGamma, sizeof(nGamma));
}
/* read gamma value to nGamma */
INT nGamma;
INT nRet = is_Gamma(hCam, IS_GAMMA_CMD_GET, (void*) &nGamma, sizeof(nGamma));
See also: •Basics: Characteristics and LUT •Basics: Color filter (Bayer filter) •Programming: is_SetColorConverter() |
