USB 2.0 USB 3.0 GigE	USB 2.0 USB 3.0 GigE

Syntax

INT is_EdgeEnhancement(HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)

Description

This function enables/disables a software edge filter.

Due to Bayer format color conversion, the original edges of a color image may easily become blurred. By enabling the digital edge filter, you can optimize edge representation. This function causes a higher CPU load.

The is_EdgeEnhancement() function cannot be used if you have set raw Bayer as color format.

For UI-3013XC, UI-1007XS please use the is_Sharpness() function instead.

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_EDGE_ENHANCEMENT_CMD_GET_RANGE Returns the range of the edge enhancement (Example 1) IS_EDGE_ENHANCEMENT_CMD_GET_DEFAULT Returns the standard value of the edge enhancement (Example 2) IS_EDGE_ENHANCEMENT_CMD_GET Returns the current set edge enhancement (Example 3) IS_EDGE_ENHANCEMENT_CMD_SET Sets the edge enhancement (Example 4) 0: no edge enhancement
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_SetColorMode()

•is_SetColorConverter()

Example 1

UINT nRange[3];

ZeroMemory(nRange, sizeof(nRange));

INT nRet = is_EdgeEnhancement(m_hCam, IS_EDGE_ENHANCEMENT_CMD_GET_RANGE, (void*)nRange, sizeof(nRange));

if (nRet == IS_SUCCESS)

{

  UINT nEdgeEnhancementMin = nRange[0];

  UINT nEdgeEnhancementMax = nRange[1];

  UINT nEdgeEnhancementInc = nRange[2];

}

Example 2

UINT nDefault;

INT nRet = is_EdgeEnhancement(m_hCam, IS_EDGE_ENHANCEMENT_CMD_GET_DEFAULT, (void*)&nDefault, sizeof(nDefault));

Example 3

UINT nEdgeEnhancement;

INT nRet = is_EdgeEnhancement(m_hCam, IS_EDGE_ENHANCEMENT_CMD_GET, (void*)&nEdgeEnhancement, sizeof(nEdgeEnhancement));

Example 4

UINT nEdgeEnhancement = 4;

INT nRet = is_EdgeEnhancement(m_hCam, IS_EDGE_ENHANCEMENT_CMD_SET, (void*)&nEdgeEnhancement, sizeof(nEdgeEnhancement));