Fokuseinstellungen für USB uEye XS


UI-1007XS	UI-1007XS

Syntax

INT is_Focus (HIDS hCam, UINT nCommand, void *pParam, UINT nSizeOfParam)

Beschreibung

Für die USB uEye XS kann über das Fokus-Messfenster zusätzlich definiert werden, auf welchen Bereich fokussiert werden soll. Das Messfenster kann frei positioniert werden.

•UI-1007XS: Das Messfenster hat eine feste Größe, die über FOC_CMD_GET_AUTOFOCUS_ZONE_SIZE_MIN und FOC_CMD_GET_AUTOFOCUS_ZONE_SIZE_MAX abgefragt werden kann.

Ü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 nSizeOfParam angegeben.

Laut Sensorhersteller kann nicht gewährleistet werden, dass ein manuell eingestellter Fokuswert zu einer reproduzierbaren Fokusdistanz führt. Ein mit einem Modell ermittelter Fokuswert muss bei einem anderen Modell nicht zum gleichen Fokuspunkt führen.

Übergabeparameter

hCam

Handle auf Kamera

Fokus-Messfenster setzen
FOC_CMD_GET_AUTOFOCUS_ZONE_AOI	Gibt das aktuell eingestellte Messfensters für den automatischen Fokus zurück. •pParam: Zeiger auf Variable vom Typ IS_RECT, in der die linke obere Ecke (s32X, s32Y) sowie die Breite (s23Width) und Höhe (s32Height) des Messfenstern zurückgegeben wird. Beispiel 2
FOC_CMD_SET_AUTOFOCUS_ZONE_AOI	Setzt das Messfenster für den automatischen Fokus. •pParam: Zeiger auf Variable vom Typ IS_RECT, in der die zu setzenden Werte übergeben werden. Beispiel 1
FOC_CMD_GET_AUTOFOCUS_ZONE_AOI_DEFAULT	Gibt das Standard-Messfenster zurück. •pParam: Zeiger auf Variable vom Typ IS_RECT, in der die linke obere Ecke (s32X, s32Y) sowie die Breite (s23Width) und Höhe (s32Height) des Messfenstern zurückgegeben wird.
FOC_CMD_GET_AUTOFOCUS_ZONE_POS_MIN	Gibt die minimal mögliche Position für das Messfenster zurück. •pParam: Zeiger auf Variable vom Typ IS_POINT_2D, in der die linke obere Ecke (s32X, s32Y) zurückgegeben wird. Beispiel 3
FOC_CMD_GET_AUTOFOCUS_ZONE_POS_MAX	Gibt die maximal mögliche Position für das Messfenster zurück. •pParam: Zeiger auf Variable vom Typ IS_POINT_2D, in der die linke obere Ecke (s32X, s32Y) zurückgegeben wird. Beispiel 3
FOC_CMD_GET_AUTOFOCUS_ZONE_POS_INC	Gibt das Inkrement für die Position des Messfensters zurück. •pParam: Zeiger auf Variable vom Typ IS_POINT_2D, in der das Inkrement zurückgegeben wird.
FOC_CMD_GET_AUTOFOCUS_ZONE_SIZE_MIN	Gibt die minimale Größe für das Messfenster zurück. •pParam: Zeiger auf Variable vom Typ IS_SIZE_2D, in der die Breite (s32Width) und Höhe (s32Height) zurückgegeben wird. Beispiel 3
FOC_CMD_GET_AUTOFOCUS_ZONE_SIZE_MAX	Gibt die maximale Größe für das Messfenster zurück. •pParam: Zeiger auf Variable vom Typ IS_SIZE_2D, in der die Breite (s32Width) und Höhe (s32Height) zurückgegeben wird. Beispiel 3
FOC_CMD_GET_AUTOFOCUS_ZONE_SIZE_INC	Gibt das Inkrement für die Größe des Messfensters zurück. •pParam: Zeiger auf Variable vom Typ IS_SIZE_2D, in der das Inkrement zurückgegeben wird.
FOC_CMD_GET_AUTOFOCUS_ZONE_WEIGHT_COUNT	Gibt die Anzahl der Zonen im Messfenster zurück. •pParam: Zeiger auf Variable vom Typ INT, in der die Anzahl der Zonen zurückgegeben wird. Beispiel 3

pParam

Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.

nSizeOfParam

Größe des Speicherbereichs in Byte, auf den pParam verweist.

Rückgabewert

IS_CANT_COMMUNICATE_WITH_DRIVER	Kommunikation mit dem Kameratreiber schlug fehl, weil kein Treiber geladen ist.
IS_CANT_OPEN_DEVICE	Ein Versuch die Kamera zu öffnen schlug fehl (Kamera nicht vorhanden oder Fehler beim Initialisieren).
IS_INVALID_CAPTURE_MODE	Die Funktion kann im aktuellen Betriebsmodus der Kamera (Freilaufend, Trigger oder Standby) nicht ausgeführt werden.
IS_INVALID_CAMERA_HANDLE	Ungültiges Kamera-Handle
IS_INVALID_PARAMETER	Einer der übergebenen Parameter ist außerhalb des gültigen Bereichs, oder für diesen Sensor nicht unterstützt, bzw. in diesem Modus nicht zugänglich.
IS_IO_REQUEST_FAILED	Eine IO Anforderung des uEye Treibers schlug fehl. Eventuell passen die Versionen der Dateien ueye_api.dll (API) und ueye_usb.sys bzw. ueye_eth.sys (Treiber) nicht zusammen.
IS_NO_SUCCESS	Allgemeine Fehlermeldung
IS_NOT_SUPPORTED	Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht.
IS_SUCCESS	Funktion erfolgreich

Beispiel 1

/* set auto focus zone */
IS_RECT focusZoneRect;
focusZoneRect.s32X = 16;
focusZoneRect.s32Y = 16;
focusZoneRect.s32Width = 64;
focusZoneRect.s32Height = 64;

INT nRet = is_Focus(hCam, FOC_CMD_SET_AUTOFOCUS_ZONE_AOI, (void*)&focusZoneRect, sizeof(focusZoneRect));
if (nRet == IS_SUCCESS)
{
...

}

Beispiel 2

/* get auto focus zone */
IS_RECT focusZoneRect;

INT nRet = is_Focus(hCam, FOC_CMD_GET_AUTOFOCUS_ZONE_AOI, (void*)&focusZoneRect, sizeof(focusZoneRect));
if (nRet == IS_SUCCESS)
{
...

}

Beispiel 3

/* receive min position */
IS_POINT_2D pointMin;
nRet = is_Focus(hCam, FOC_CMD_GET_AUTOFOCUS_ZONE_POS_MIN, (void*)&pointMin, sizeof(pointMin));

/* receive max position */
IS_POINT_2D pointMax;
nRet = is_Focus(hCam, FOC_CMD_GET_AUTOFOCUS_ZONE_POS_MAX, (void*)&pointMax, sizeof(pointMax));

/* receive min size */
IS_SIZE_2D sizeMin;
is_Focus(hCam, FOC_CMD_GET_AUTOFOCUS_ZONE_SIZE_MIN, (void*)&sizeMin, sizeof(sizeMin));

/* receive max size */
IS_SIZE_2D sizeMax;
is_Focus(hCam, FOC_CMD_GET_AUTOFOCUS_ZONE_SIZE_MAX, (void*)&sizeMax, sizeof(sizeMax));

/* receive zone count */
INT nFocusZoneCount;
nRet = is_Focus(hCam, FOC_CMD_GET_AUTOFOCUS_ZONE_WEIGHT_COUNT, (void*)&nFocusZoneCount, sizeof(nFocusZoneCount));

Haben Sie Verbesserungshinweise? Senden Sie ein kurzes Feedback zu diesem Kapitel. Vielen Dank!
Bei technischen Fragen wenden Sie sich bitte an Ihren lokalen Händler oder nutzen Sie das Support-Formular auf unserer Internetseite.