 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_SetSubSampling (HIDS hCam, INT mode)
Beschreibung
Mit is_SetSubSampling() kann der Subsampling-Modus sowohl in horizontaler als auch in vertikaler Richtung aktiviert werden. Dadurch kann die Bildgröße in Subsampling-Richtung verkleinert werden, ohne dass der Bildausschnitt kleiner wird. Zur gleichzeitigen Aktivierung von horizontalem und vertikalem Subsampling können die horizontalen und vertikalen Subsampling-Parameter 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. |
Manche Monochromsensoren führen bauartbedingt nur ein Farb-Subsampling durch. Dies kann bei feinen Bildstrukturen zu leichten Artefakten führen.
Die einstellbaren Subsampling-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_SetSubSampling() folgende Funktionen aufzurufen, um definierte Kameraeinstellungen zu erhalten:
•Wenn die Blitzfunktion der uEye Kamera verwendet wird: is_IO()
Übergabeparameter
hCam |
Handle auf Kamera |
Rückgabewert
In Verbindung mit IS_GET_SUBSAMPLING |
Aktuelle Einstellung: Gibt eine VerODERung aus den definierten Konstanten aus ueye.h zurück, z.B. IS_SUBSAMPLING_2X_HORIZONTAL |
In Verbindung mit IS_GET_SUBSAMPLING_FACTOR_VERTICAL IS_GET_SUBSAMPLING_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_SUBSAMPLING_TYPE |
Aktuelle Einstellung: Gibt IS_SUBSAMPLING_COLOR zurück, wenn die Kamera farberhaltendes Subsampling verwendet, andernfalls IS_SUBSAMPLING_MONO |
In Verbindung mit IS_GET_SUPPORTED_SUBSAMPLING |
Gibt die unterstützten Subsampling 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
