USB 2.0 USB 3.0 GigE	USB 2.0 USB 3.0 GigE

Syntax

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

Beschreibung

Mit is_Exposure() können Sie erlaubte Wertebereiche für die Belichtungszeit in feiner Schrittweite der Kamera abfragen und neue Belichtungszeiten setzen.

Hinweis zur Abhängigkeit von anderen Einstellungen Die Belichtungszeit wird von folgenden Funktionen beeinflusst: •is_PixelClock() •is_SetOptimalCameraTiming() •is_SetFrameRate() •is_AOI() (wenn die Bildgröße geändert wird) •is_SetSubSampling() •is_SetBinning() Durch Ändern der Bildgröße, der Bildrate oder des Pixeltakts wird die Belichtungszeit verändert, deshalb muss is_Exposure() danach neu aufgerufen werden.

Hinweis zu neuen Treiberversionen Neuere Treiberversionen ermöglichen teilweise erweiterte Wertebereiche für die Belichtungszeit. Es wird daher empfohlen, diese Bereiche jedes Mal abzufragen und Werte explizit zu setzen.

Ü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_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE_MIN Gibt bei manchen Sensoren die minimale Belichtungszeit in einer feineren Schrittweite zurück. •pParam: Zeiger auf Variable vom Typ double, in der der minimale Wert zurückgegeben wird. •nSizeOfParam: 8 Beispiel 1 IS_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE_MAX Gibt bei manchen Sensoren die maximale Belichtungszeit in einer feineren Schrittweite zurück. •pParam: Zeiger auf Variable vom Typ double, in der der maximale Wert zurückgegeben wird. •nSizeOfParam: 8 IS_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE_INC Gibt bei manchen Sensoren das Inkrement der Belichtungszeit in einer feineren Schrittweite zurück. •pParam: Zeiger auf Variable vom Typ double, in der das Inkrement zurückgegeben wird. •nSizeOfParam: 8 IS_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE Gibt bei manchen Sensoren den Wertebereich der Belichtungszeit in einer feineren Schrittweite zurück. •pParam: Zeiger auf ein Array vom Typ double, in dem der minimale und maximale Wert sowie das Inkrement zurückgegeben werden (in genau dieser Reihenfolge). •nSizeOfParam: 24 Beispiel 2
pParam	Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.
cbSizeOfParam	Größe des Speicherbereichs in Byte, auf den pParam verweist.

Beispiel 1

double dblMin, dblMax, dblInc;

INT nRet = is_Exposure(m_hCam, IS_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE_MIN,
                      (void*)&dblMin, sizeof(dblMin));

INT nRet = is_Exposure(m_hCam, IS_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE_MAX,
                      (void*)&dblMax, sizeof(dblMax));

INT nRet = is_Exposure(m_hCam, IS_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE_INC,
                      (void*)&dblInc, sizeof(dblInc));

Beispiel 2

double dblRange[3];

double dblMin, dblMax, dblInc;

INT nRet = is_Exposure(m_hCam, IS_EXPOSURE_CMD_GET_FINE_INCREMENT_RANGE,
                      (void*)dblRange, sizeof(dblRange));

if (nRet == IS_SUCCESS)

{

  dblMin = dblRange[0];

  dblMax = dblRange[1];

  dblInc = dblRange[2];

}