USB 2.0 USB 3.0 GigE	USB 2.0 USB 3.0 GigE

Syntax

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

Beschreibung

Die Funktion ermöglicht das Messen der Schärfe in einem definierten Bildausschnitt des aktuellen Bilds. Um einen Wert für die Schärfe zu erhalten, werden die Kanten des Bilds ausgewertet. Die Schärfe kann nur als relativer Wert angegeben werden, da diese von den Kanten im Bild abhängig ist. Ein Bild mit wenig Kanten kann daher nie den Schärfewert erreichen wie ein Bild mit vielen Kanten.

Je höher der Wert ist, desto besser die Schärfe. Der Wert kann in Vergleichsmessungen verwendet werden, um Veränderungen in der Aufnahmesituation desselben Motivs zu entdecken, z.B. durch verstellte Objektive.

Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter cbSizeOfParam angegeben.

Übergabeparameter

hCam	Handle auf Kamera
nCommand IS_MEASURE_CMD_SHARPNESS_AOI_SET Setzt einen Bildausschnitt (AOI), in dem die Schärfe gemessen wird. Es sind bis zu 5 AOIs in einem Bild möglich. Diese können sich auch überschneiden. (Beispiel 1) IS_MEASURE_CMD_SHARPNESS_AOI_INQUIRE Gibt Informationen (z.B. die Schärfe) über eine AOI zurück (Beispiel 2) IS_MEASURE_CMD_SHARPNESS_AOI_SET_PRESET Setzt über eine Voreinstellung verschiedene AOIs im Bild (Beispiel 3)
pParam	Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.
cbSizeOfParam	Größe des Speicherbereichs in Byte, auf den pParam verweist.

Inhalte der Struktur MEASURE_SHARPNESS_AOI_INFO

Inhalte der Enumeration MEASURE_SHARPNESS_AOI_PRESETS

Rückgabewert

Beispiel 1

INT nRet = IS_SUCCESS;
 
/* Create info object */
MEASURE_SHARPNESS_AOI_INFO measureSharpnessInfo;
 
/* Set values of AOI_0: The position and size of the AOI equals the whole image */
measureSharpnessInfo.u32NumberAOI   = 0;
measureSharpnessInfo.rcAOI.s32X     = 0;
measureSharpnessInfo.rcAOI.s32Y     = 0;
measureSharpnessInfo.rcAOI.s32Width = m_s32MaxImageWidth;
measureSharpnessInfo.rcAOI.s32Height = m_s32MaxImageHeight;
 
/* Set AOI_0 */
nRet = is_Measure(m_hCam, IS_MEASURE_CMD_SHARPNESS_AOI_SET, (void*)&measureSharpnessInfo,
                 sizeof(measureSharpnessInfo));
 
/* Set values of AOI_1 */
measureSharpnessInfo.u32NumberAOI   = 1;
measureSharpnessInfo.rcAOI.s32X     = 50;
measureSharpnessInfo.rcAOI.s32Y     = 50;
measureSharpnessInfo.rcAOI.s32Width = 200;
measureSharpnessInfo.rcAOI.s32Height = 200;
 
/* Set AOI_1 */
nRet = is_Measure(m_hCam, IS_MEASURE_CMD_SHARPNESS_AOI_SET, (void*)&measureSharpnessInfo,
                 sizeof(measureSharpnessInfo));

Beispiel 2

INT nRet = IS_SUCCESS;
 
/* Create info object */
MEASURE_SHARPNESS_AOI_INFO measureSharpnessInfo;
 
/* Get values of AOI_0 */
measureSharpnessInfo.u32NumberAOI = 0;
 
nRet = is_Measure(m_hCam, IS_MEASURE_CMD_SHARPNESS_AOI_INQUIRE, (void*)&measureSharpnessInfo,
                sizeof(measureSharpnessInfo));
if (nRet == IS_SUCCESS)
{
  UINT s32Sharpness = measureSharpnessInfo.u32SharpnessValue;
}

Beispiel 3

INT nRet = IS_SUCCESS;
 
/* Set preset */
UINT nPreset = IS_MEASURE_SHARPNESS_AOI_PRESET_1;
 
nRet = is_Measure(m_hCam, IS_MEASURE_CMD_SHARPNESS_AOI_SET_PRESET, (void*)&nPreset, sizeof(nPreset));