 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_SetBinning (HIDS hCam, INT mode)
Beschreibung
Mit is_SetBinning() kann der Binningmodus sowohl in horizontaler als auch in vertikaler Richtung aktiviert werden. Dadurch kann die Bildgröße in Binningrichtung verkleinert werden, ohne dass der Bildausschnitt kleiner wird. Je nach Sensor kann bei aktiviertem Binning die Empfindlichkeit zunehmen oder die Bildrate erhöht werden. Zur gleichzeitigen Aktivierung von horizontalem und vertikalem Binning können die horizontalen und vertikalen Binningparameter durch ein logisches ODER verknüpft werden.
|
Beachten Sie, dass Binning oder Subsampling nicht aktiviert werden kann, wenn die AOI-Größe auf den Minimalwert eingestellt ist. |
Die einstellbaren Binning-Faktoren der einzelnen Sensoren sind im Kapitel Kamera- und Sensordaten aufgeführt.
Einige Sensoren erlauben einen höheren Pixeltakt, wenn zuvor Binning oder Subsampling aktiviert wurden. Wenn ein höherer Pixeltakt gesetzt wurde und danach die Binning-/Subsamplingfaktoren wieder reduziert werden, wählt der Treiber automatisch den höchstmöglichen Pixeltakt für die neuen Einstellungen.
|
Diese Funktion wird von folgenden Kameramodellen nicht unterstützt: •UI-1007XS |
Eine Änderung der Bildgeometrie oder des Pixeltakts beeinflusst die Wertebereiche von Bildwiederholrate und Belichtungszeit. Es wird empfohlen, nach dem Ausführen von is_SetBinning() folgende Funktionen aufzurufen, um definierte Kameraeinstellungen zu erhalten:
•Wenn die Blitzfunktion der uEye verwendet wird: is_IO()
|
Hinweise zu den Modellen UI-124x/UI-324x/UI-524x, UI-125x/UI-325x/UI-525x und UI-155x/UI-555x Bei diesen Modellen kann das Binning ausschließlich kombiniert für die horizontale und vertikale Richtung gesetzt werden. Bitte beachten Sie die Informationen im Kapitel UI-124x/UI-324x/UI-524x Anwendungshinweise, UI-125x/UI-325x/UI-525x Anwendungshinweise und UI-155x/UI-555x Anwendungshinweise. |
Übergabeparameter
hCam |
Handle auf Kamera |
Rückgabewert
In Verbindung mit IS_GET_BINNING |
Aktuelle Einstellung |
In Verbindung mit IS_GET_BINNING_FACTOR_VERTICAL IS_GET_BINNING_FACTOR_HORIZONTAL |
Aktuelle Einstellung: Gibt den derzeitigen Faktor als Integer-Wert zurück (2, 3, 4, 5, 6, 8, 16) |
In Verbindung mit IS_GET_BINNING_TYPE |
Gibt IS_BINNING_COLOR zurück, wenn die Kamera farberhaltendes Binning verwendet, andernfalls IS_BINNING_MONO |
In Verbindung mit IS_GET_SUPPORTED_BINNING |
Gibt die unterstützten Binning-Modi logisch verodert zurück. |
IS_BAD_STRUCTURE_SIZE |
Eine interne Struktur hat die falsche Größe. |
IS_CANT_ADD_TO_SEQUENCE |
Der Bildspeicher befindet sich bereits in der Sequenz und kann nicht doppelt hinzugefügt werden. |
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_CAPTURE_RUNNING |
Es läuft bereits eine Aufnahme, die zuerst beendet werden muss. |
IS_DR_CANNOT_CREATE_SURFACE |
Bild- oder Overlay-Surface konnten nicht angelegt werden. |
IS_DR_CANNOT_CREATE_TEXTURE |
Die Textur konnte nicht angelegt werden. |
IS_DR_CANNOT_CREATE_VERTEX_BUFFER |
Der Vertex-Puffer konnte nicht angelegt werden. |
IS_DR_DEVICE_OUT_OF_MEMORY |
Nicht genügend Grafikspeicher verfügbar. |
IS_DR_LIBRARY_NOT_FOUND |
Die DirectRenderer-Bibliothek konnte nicht gefunden werden. |
IS_INVALID_BUFFER_SIZE |
Der Bildspeicher hat die falsche Größe um das Bild im gewünschten Format aufzunehmen. |
IS_INVALID_CAMERA_TYPE |
Kameratyp der .ini-Datei stimmt nicht mit dem aktuellen Kameramodell überein. |
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_MEMORY_POINTER |
Ungültiger Zeiger oder ungültige Speicher-ID |
IS_INVALID_MODE |
Kamera im Standby, Funktion nicht erlaubt |
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_INVALID_PIXEL_CLOCK |
Diese Einstellung ist bei dem aktuell eingestellten Pixeltakt nicht möglich. |
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_ACTIVE_IMG_MEM |
Kein aktivierter Bildspeicher vorhanden. Der Speicher muss mit der Funktion is_SetImageMem() aktiviert werden, oder es muss mit der Funktion is_AddToSequence() eine Sequenz aufgebaut werden. |
IS_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_NOT_CALIBRATED |
Die Kamera enthält keine Kalibrierungsdaten. |
IS_NOT_SUPPORTED |
Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht. |
IS_NULL_POINTER |
Ungültiges Array |
IS_OUT_OF_MEMORY |
Es konnte kein Speicher alloziert werden. |
IS_SEQUENCE_BUF_ALREADY_LOCKED |
Der Speicher konnte nicht gelockt werden. Der Zeiger auf den Buffer ist ungültig. |
IS_SUCCESS |
Funktion erfolgreich |
IS_TIMED_OUT |
Ein Timeout trat auf. Eine Bildaufnahme konnte nicht in der vorgeschriebenen Zeit beendet werden. |
IS_TRIGGER_ACTIVATED |
Die Funktion ist nicht möglich, da die Kamera auf ein Triggersignal wartet. |
Verwandte Funktionen
