IDS Software Suite 4.96.1

Syntax

INT is_SetHWGainFactor (HIDS hCam, INT nMode, INT nFactor)

Beschreibung

is_SetHWGainFactor() regelt Verstärkerkanäle des Sensors anhand von Verstärkungsfaktoren. Diese können unabhängig voneinander eingestellt werden. Die Funktion is_SetHardwareGain() verwendet zum Setzen der Verstärkerkanäle keine Faktoren, sondern normierte Werte zwischen 0 und 100. Der tatsächliche erreichte Verstärkungsfaktor 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.

Je nach Zeitpunkt der Änderung der Verstärkung wirkt sich diese erst bei der Aufnahme des nächsten Bildes aus.

Übergabeparameter

Für die Umrechnung eines Verstärkungswertes aus der Funktion is_SetHardwareGain() kann der Parameter nMode auf einen der IS_INQUIRE_x_FACTOR Werte gesetzt werden. Der Wertebereich für nFactor liegt in diesem Fall von 0 bis 100.

Der Parameter nFactor muss für das Setzen der Verstärkung mit IS_SET_..._GAIN_FACTOR als Integer-Wert mit einem Bereich von 100 bis Maximum festgelegt sein. Das Maximum kann mit IS_INQUIRE_x_FACTOR und einem Wert von 100 für nFactor abgefragt werden. Ein Verstärkungsfaktor mit dem Wert 100 entspricht keiner Verstärkung, ein Wert von 200 einem Verstärkungsfaktor von zwei, usw.

Rückgabewert

Verwandte Funktionen

•is_SetHardwareGain()

•is_SetHardwareGamma()

•is_SetGainBoost()

•is_SetAutoParameter()

•is_GetSensorInfo()

Beispiel

// Gesamtverstärkungsfaktor auf 3,57 setzen:
INT ret = is_SetHWGainFactor (hCam, IS_SET_MASTER_GAIN_FACTOR, 357);
// ret hat für die UI-1460-C den Wert 363
 
// Abfragen des maximalen Verstärkungsfaktors im Rotkanal:
ret = is_SetHWGainFactor (hCam, IS_INQUIRE_RED_GAIN_FACTOR, 100);
// ret hat für die UI-1460-C den Wert 725