IDS Software Suite 4.97

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.

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
nCommand IS_GAMMA_CMD_SET Gamma value to be set, multiplied by 100 (Range: 1…1000) Example 1 IS_GAMMA_CMD_GET_DEFAULT Returns the standard gamma value (Default = 100, corresponds to a gamma value of 1.0) Example 2 IS_GAMMA_CMD_GET Returns the current set gamma value Example 3
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

Related functions

•is_SetHardwareGamma()

Example 1

/* set gamma value to 1.6 */
INT nGamma = 160;
INT nRet = is_Gamma(hCam, IS_GAMMA_CMD_SET, (void*) &nGamma, sizeof(nGamma));

Example 2

/* 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));
}

Beispiel 3

/* read gamma value to nGamma */
INT nGamma;
INT nRet = is_Gamma(hCam, IS_GAMMA_CMD_GET, (void*) &nGamma, sizeof(nGamma));