open_framegrabberT_open_framegrabberOpenFramegrabberOpenFramegrabber (Operator)

Name

open_framegrabberT_open_framegrabberOpenFramegrabberOpenFramegrabber — Öffnen und Konfigurieren eines Bildeinzugsgeräts.

Signatur

Beschreibung

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber öffnet und konfiguriert das ausgewählte Bildeinzugsgerät. Dabei wird insbesondere auch die Verbindung zum Bildeinzugsgerät getestet, das Bildeinzugsgerät für andere Prozesse gesperrt und gegebenenfalls Speicher für die Datenpuffer reserviert. Der eigentliche Bildeinzug erfolgt dann mittels grab_imagegrab_imageGrabImageGrabImageGrabImage, grab_datagrab_dataGrabDataGrabDataGrabData, grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsync oder grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsync. Wird das Bildeinzugsgerät nicht mehr benötigt, sollte er mittels close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber wieder geschlossen und so für andere Prozesse freigegeben werden. Einige Bildeinzugsgeräte erlauben das gleichzeitige Öffnen mehrerer Instanzen.

Für alle Parameter kann explizit der gerätespezifische Default-Wert verwendet werden (vgl. Parameterbeschreibung unten). Nähere Informationen zu einem bestimmten Bildeinzugsgerät erhält man mit Hilfe von info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber. Die ausführliche Dokumentation zu allen gerätespezifischen Parametern findet sich in der Dokumentation für die verwendete Bildeinzugsschnittstelle im Verzeichnis 'doc/html/reference/acquisition'"doc/html/reference/acquisition""doc/html/reference/acquisition""doc/html/reference/acquisition""doc/html/reference/acquisition".

Die Bedeutung der Parameter von open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber ist im einzelnen:

HorizontalResolution, VerticalResolution

Gewünschte Auflösung des Bildeinzugsgeräts.

ImageWidth, ImageHeight

Größe des Bildausschnittes, der von grab_imagegrab_imageGrabImageGrabImageGrabImage etc. geliefert werden soll.

StartRow, StartColumn

Linke obere Ecke des gewünschten Bildausschnittes.

Field

Gewünschtes Halbbild ('first', 'second' oder 'next') bzw. Einstellung eines Vollbildes.

BitsPerChannel

Die Anzahl an Bits, die das Bildeinzugsgerät pro Pixel und Bildkanal überträgt (typischerweise 5, 8, 10, 12 oder 16).

ColorSpace

Festlegung des Ausgabe-Farbformats der eingezogenen Bilder (typischerweise 'gray' oder 'raw' für einkanalige bzw. 'rgb' oder 'yuv' für dreikanalige Bilder).

Generic

Generischer Parameter mit gerätespezifischer Bedeutung. Diese ist mittels info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber abfragbar.

ExternalTrigger

Aktivierung der externen Triggerung des Bildeinzugsgeräts (soweit unterstützt).

CameraType

Nähere Spezifikation des gewünschten Bildeinzugsgeräts (typischerweise die Angabe des analogen Videoformats oder der Name der zu verwendenden Kamerakonfigurationsdatei). Die Bedeutung dieses Parameters ist gerätespezifisch und kann mittels info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber abgefragt werden.

Device

Gerätename des zu verwendenden Bildeinzugsgeräts.

Port

Port, an den das Bildeinzugsgerät angeschlossen ist.

LineIn

Selektion des Kameraeingangs (falls ein Multiplexer für den Port verfügbar ist).

Der Operator open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber liefert mit AcqHandleAcqHandleAcqHandleAcqHandleacqHandle einen Handle auf das geöffneten Bildeinzugsgerät zurück.

Achtung

Bedingt durch die Vielzahl der unterstützten Bildeinzugsgeräte, umfasst open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber eine große Anzahl von Parametern. Für ein bestimmten Bildeinzugsgerät werden deshalb nicht immer alle Parameter benötigt.

Aus Sicht einer Anwendung mit mehreren Threads bilden alle Bildeinzugsoperatoren also info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParam, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam, get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackGetFramegrabberCallback, set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallback, get_framegrabber_lutget_framegrabber_lutGetFramegrabberLutGetFramegrabberLutGetFramegrabberLut, set_framegrabber_lutset_framegrabber_lutSetFramegrabberLutSetFramegrabberLutSetFramegrabberLut, grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStart, grab_imagegrab_imageGrabImageGrabImageGrabImage, grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsync, grab_datagrab_dataGrabDataGrabDataGrabData, grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsync, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbers eine eigene Gruppe innerhalb der info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbers exklusiv ausgeführt werden.

D.h., info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbers verhindern die gleichzeitige Ausführung anderer Operatoren innerhalb der Gruppe, laufen aber mit allen nicht exklusiven Operatoren außerhalb der Gruppe parallel.

Auf Windows Systemen können Fehler-Dialogboxen vom Betriebssystems erscheinen, wenn abhängende Module des Interfaces nicht gefunden werden können. Dies ist beispielsweise der Fall, wenn das entsprechende SDK nicht installiert wurde. Das Erscheinen der Dialogboxen kann über Windows Error Mode kontrolliert werden. Informationen dazu finden sich in der Beschreibung von SetErrorMode in der MSDN Dokumentation.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

Beispiel (HDevelop)

* Select a suitable image acquisition interface name AcqName
info_framegrabber(AcqName,'port',Information,Values)
* Open image acquisition device using the default settings, see
* documentation of the actually used interface for more details
open_framegrabber(AcqName,1,1,0,0,0,0,'default',-1,'default',-1.0, \
                  'default','default','default',-1,-1,AcqHandle)
grab_image(Image,AcqHandle)
close_framegrabber(AcqHandle)

Ergebnis

Sind die Parameterwerte korrekt und konnte das gewünschte Bildeinzugsgerät geöffnet werden, liefert open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabber den Wert 2 (H_MSG_TRUE). Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber

Nachfolger

grab_imagegrab_imageGrabImageGrabImageGrabImage, grab_datagrab_dataGrabDataGrabDataGrabData, grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStart, grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsync, grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsync, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParam, set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallback

Siehe auch

info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabber, grab_imagegrab_imageGrabImageGrabImageGrabImage

Modul

Foundation