Syntax

INT is_AOI (HIDS hCam, UINT nCommand, void* pParam, UINT nSizeOfParam)

Beschreibung

Mit is_AOI() kann die Größe und Position eines Bildausschnitts (area of interest - AOI) gesetzt werden. Die AOI ist immer bezogen auf den Sensor. Mögliche AOI sind:

•Image AOI – Darstellung eines Teilbildes

•Auto Brightness AOI – Referenz-Bildausschnitt für die automatische Helligkeitssteuerung

•Auto Whitebalance AOI – Referenz-Bildausschnitt für den automatischen Weißabgleich

Bei Image AOIs gelten sensorabhängige Einschränkungen für die Schrittweiten von Position und Größe. Die Werte für Position und Größe der AOI müssen ganzzahlige Vielfache der erlaubten Schrittweiten sein. Genauere Informationen zum AOI-Raster einzelner Kameramodelle finden Sie im zugehörigen Kapitel des Abschnitts Kamera- und Sensordaten.

Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter nSizeOfParam angegeben.

AOI für die automatische Bildregelung

Die AOI für die automatische Helligkeitsregelung (AES/AGC) und den automatischen Weißabgleich (AWB) ist standardmäßig so groß wie die aktuelle Bildgröße (d. h. die Image AOI).

Nach Änderungen der Bildgeometrie (durch Neusetzen einer Image AOI, Binning oder Subsampling) werden die AOI für die automatische Bildregelung immer auf den Wert der eingestellten Image AOI zurückgesetzt. Das bedeutet, dass die Auto Brightness/Auto White Balance AOI eventuell neu gesetzt werden müssen.

Schnelles Verschieben von AOIs

Über das Kommando IS_AOI_IMAGE_SET_POS_FAST kann die Position von Bildausschnitten sehr schnell verändert werden. Der Zeitbedarf für die Ausführung dieses Kommandos liegt im Bereich weniger Millisekunden. Bei der Verwendung dieses Kommandos sind folgende Besonderheiten zu beachten:

•Das Kommando wird nicht von allen Kameramodellen unterstützt. Über das Kommando IS_AOI_IMAGE_GET_POS_FAST_SUPPORTED kann abgefragt werden, ob ein Sensor das schnelle Verschieben unterstützt.

•Die Hotpixelkorrektur muss abgeschaltet werden (siehe is_HotPixel()).

•Der Bildeinzug wird beim schnellen Verschieben der AOI nicht angehalten. Dadurch können nach dem Aufruf des Kommandos noch weitere Bilder mit der alten AOI-Position übertragen werden, wenn diese sich noch im Treiberpuffer befinden.

Ändern der Bildgröße

Wenn Sie die Größe der AOI ändern, achten Sie darauf, dass der aktuelle Bildspeicher ausreichend groß ist. Andernfalls müssen Sie den Bildspeicher neu anlegen (siehe is_AllocImageMem()).

Eine Änderung der Bildgröße beeinflusst die Wertebereiche von Bildwiederholrate und Belichtungszeit. Es wird empfohlen, nach dem Ausführen von is_AOI() folgende Funktionen aufzurufen, um definierte Kameraeinstellungen zu erhalten:

•is_SetFrameRate()

•is_Exposure()

•Wenn die Blitzfunktion verwendet wird: is_IO()

Weitere AOI-Funktionen

Bei einigen uEye Kameramodellen können weitere spezielle Formen der AOI-Funktion gesetzt werden:

•Multi-AOI-Funktion verwenden

•Sequenz-AOI-Modus verwenden

•IDS Linescan ("AOI-Merge-Modus") konfigurieren

Übergabeparameter

Inhalt der Struktur IS_RECT

Inhalt der Struktur IS_POINT_2D

Inhalt der Struktur IS_SIZE_2D

Rückgabewerte

Verwandte Funktionen

•is_ImageFormat()

•is_SetBinning()

•is_SetSubSampling()

Beispiel 1 für AOI

// Setzt die Position und Größe des Bildes über ein Objekt vom Typ IS_RECT.

IS_RECT rectAOI;

 

rectAOI.s32X     = 100;

rectAOI.s32Y     = 100;

rectAOI.s32Width = 200;

rectAOI.s32Height = 100;

 

INT nRet = is_AOI( hCam, IS_AOI_IMAGE_SET_AOI, (void*)&rectAOI, sizeof(rectAOI));

Beispiel 2 für AOI

// Gibt die Position und Größe der AOI über ein Objekt vom Typ IS_RECT zurück.

IS_RECT rectAOI;

 

INT nRet = is_AOI(hCam, IS_AOI_IMAGE_GET_AOI, (void*)&rectAOI, sizeof(rectAOI));

if (nRet == IS_SUCCESS)

{

  INT x     = rectAOI.s32X;

  INT y     = rectAOI.s32Y;

  INT width = rectAOI.s32Width;

  INT height = rectAOI.s32Height;

}

Beispiel 3 für AOI

// Gibt über ein UINT Objekt zurück, ob bei der X-Position IS_AOI_IMAGE_POS_ABSOLUTE gesetzt ist.

UINT nAbsPos = 0;

 

INT nRet = is_AOI(hCam, IS_AOI_IMAGE_GET_POS_X_ABS, (void*)&nAbsPos , sizeof(nAbsPos ));

if (nRet == IS_SUCCESS)

{

  if (nAbsPos == IS_AOI_IMAGE_POS_ABSOLUTE)

  {

  // gesetzt

  }

  else if (nAbsPos == 0)

  {

  // nicht gesetzt

  }

}

Beispiel 4 für AOI

// Abfragen, ob das schnelle Verschieben der AOI unterstützt wird
unsigned int fastAOIsupport = 0;
int nRet = is_AOI(m_hCam, IS_AOI_IMAGE_GET_POS_FAST_SUPPORTED, (void*)&fastAOIsupport, sizeof(fastAOIsupport));

Beispiele für das Setzen der AOI-Position im Speicher

x = 100

y = 100

x = 100 | IS_AOI_IMAGE_POS_ABSOLUTE

y = 100

x = 100 | IS_AOI_IMAGE_POS_ABSOLUTE

y = 100 | IS_AOI_IMAGE_POS_ABSOLUTE