is_Zoom


USB 3 uEye XC	USB 3 uEye XC

Syntax

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

Beschreibung

is_Zoom() steuert bei manchen uEye Kameras die Zoom-Funktion des Objektivs oder des Sensors (Digitalzoom).

Diese Funktion wird derzeit von folgenden Kameramodellen unterstützt:

•UI-3013XC

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

Übergabeparameter

hCam

Handle auf Kamera

pParam

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

nSizeOfParam

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

Statusflags aus ZOOM_CAPABILITY_FLAGS

ZOOM_CAP_INVALID	Kamera unterstützt keine Zoom-Funktion
ZOOM_CAP_DIGITAL_ZOOM	Kamera unterstützt Digitalzoom

Rückgabewerte

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_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_NULL_POINTER	Ungültiges Array
IS_SUCCESS	Funktion erfolgreich

Beispiel 1

double dZoomValue = 0;
nRet = is_Zoom(hCam, ZOOM_CMD_DIGITAL_GET_VALUE_DEFAULT, (void*)&dZoomValue, sizeof(dZoomValue));
if (nRet == IS_SUCCESS)
{
nRet = is_Zoom(hCam, ZOOM_CMD_DIGITAL_SET_VALUE, (void*)&dZoomValue, sizeof(dZoomValue));
UpdateZoomControls();
}

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.