is_SetBinning

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

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-3013XC

•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:

•is_SetFrameRate()

•is_Exposure()

•Wenn die Blitzfunktion der uEye verwendet wird: is_IO()

hint_info

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

•is_SetSubSampling()

•is_AOI()

•is_ImageFormat()

•is_PixelClock()

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.