 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_SetHardwareGain (HIDS hCam, INT nMaster, INT nRed, INT nGreen, INT nBlue)
Beschreibung
is_SetHardwareGain() regelt Verstärkerkanäle des Sensors. Diese können unabhängig voneinander zwischen 0 % und 100 % eingestellt werden. Der tatsächliche erreichte Verstärkungsfaktor bei 100 % ist sensorabhängig und ist im Kapitel Kamera- und Sensordaten aufgeführt.
Über die Funktion is_GetSensorInfo() kann abgefragt werden, welche Verstärker vorhanden sind.
|
Hinweis zur Verwendung der Sensorverstärkung Mit der Verstärkung der Signale erfolgt auch eine Verstärkung des Bildrauschens. Aus diesem Grund sind hohe Verstärkungseinstellungen nicht zu empfehlen. Folgende Reihenfolge der Verstärkungseinstellung wird empfohlen: 1.Aktivieren der Funktion is_SetGainBoost() (Analoge Extraverstärkung) 2.Bei Bedarf mit is_SetHardwareGain() nachregeln Je nach Zeitpunkt der Verstärkungsänderung wirkt sich diese erst bei der nächsten Bildaufnahme aus. |
|
Hinweis zur Linearität der Sensorverstärkung Die Verstärkung kann bei uEye Kameras in Schritten von 0 bis 100 eingestellt werden. Sensorbedingt ist die Unterteilung der Schritte nicht über den ganzen Bereich linear. In der Regel ist die Schrittweite im oberen Bereich größer als im unteren Bereich. Die maximal einstellbaren Faktoren sind ebenfalls je nach Sensor unterschiedlich. |
|
Hinweis zur Standardeinstellung der RGB-Verstärkung Die Werte für die Default-Einstellungen der Rot-, Grün- und Blau-Verstärkung hängen von der eingestellten Farbkorrekturmatrix ab. Bei Auswahl einer anderen Farbkorrekturmatrix ändern sich unter Umständen die zurückgegebenen Default-Werte (siehe auch is_SetColorCorrection()). |
Übergabeparameter
hCam |
Handle auf Kamera |
nMaster |
Gesamtverstärkung (master gain) einstellen (0...100) |
IS_IGNORE_PARAMETER |
Gesamtverstärkung nicht verändern. |
IS_GET_MASTER_GAIN |
Rückgabe der Gesamtverstärkung |
IS_GET_RED_GAIN |
Rückgabe der Rot-Verstärkung |
IS_GET_GREEN_GAIN |
Rückgabe der Grün-Verstärkung |
IS_GET_BLUE_GAIN |
Rückgabe der Blau-Verstärkung |
IS_GET_DEFAULT_MASTER |
Rückgabe der Standard-Gesamtverstärkung |
IS_GET_DEFAULT_RED |
Rückgabe der Standard-Rot-Verstärkung |
IS_GET_DEFAULT_GREEN |
Rückgabe der Standard-Grün-Verstärkung |
IS_GET_DEFAULT_BLUE |
Rückgabe der Standard-Blau-Verstärkung |
IS_SET_ENABLE_AUTO_GAIN |
Aktivieren der Auto-Verstärkungs-Funktionalität (siehe auch is_SetAutoParameter()). Die Auto-Verstärkungs-Funktionalität wird durch Setzen eines Parameters für nMaster deaktiviert. |
nRed |
Rotkanal-Verstärkung einstellen (0...100) |
IS_IGNORE_PARAMETER |
Rot nicht verändern. |
nGreen |
Grünkanal-Verstärkung einstellen (0...100) |
IS_IGNORE_PARAMETER |
Grün nicht verändern. |
nBlue |
Blaukanal-Verstärkung einstellen (0...100) |
IS_IGNORE_PARAMETER |
Blau nicht verändern. |
Rückgabewert
In Verbindung mit |
Aktuelle Einstellung |
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_TYPE |
Kameratyp der .ini-Datei stimmt nicht mit dem aktuellen Kameramodell überein. |
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
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_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_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_SUCCESS |
Funktion erfolgreich |
IS_TIMED_OUT |
Ein Timeout trat auf. Eine Bildaufnahme konnte nicht in der vorgeschriebenen Zeit beendet werden. |
Verwandte Funktionen
