HALCON Website / HALCON Operator-Referenz / Bild / Bildeinzug
KlassenKlassenKlassenKlassen | | | | Operatoren

open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber (Operator)

Name

open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber — Öffnen und Konfigurieren eines Bildeinzugsgeräts.

Signatur

open_framegrabber( : : Name, HorizontalResolution, VerticalResolution, ImageWidth, ImageHeight, StartRow, StartColumn, Field, BitsPerChannel, ColorSpace, Generic, ExternalTrigger, CameraType, Device, Port, LineIn : AcqHandle)

Herror open_framegrabber(const char* Name, const Hlong HorizontalResolution, const Hlong VerticalResolution, const Hlong ImageWidth, const Hlong ImageHeight, const Hlong StartRow, const Hlong StartColumn, const char* Field, const Hlong BitsPerChannel, const char* ColorSpace, double Generic, const char* ExternalTrigger, const char* CameraType, const char* Device, const Hlong Port, const Hlong LineIn, Hlong* AcqHandle)

Herror T_open_framegrabber(const Htuple Name, const Htuple HorizontalResolution, const Htuple VerticalResolution, const Htuple ImageWidth, const Htuple ImageHeight, const Htuple StartRow, const Htuple StartColumn, const Htuple Field, const Htuple BitsPerChannel, const Htuple ColorSpace, const Htuple Generic, const Htuple ExternalTrigger, const Htuple CameraType, const Htuple Device, const Htuple Port, const Htuple LineIn, Htuple* AcqHandle)

Herror open_framegrabber(const HTuple& Name, const HTuple& HorizontalResolution, const HTuple& VerticalResolution, const HTuple& ImageWidth, const HTuple& ImageHeight, const HTuple& StartRow, const HTuple& StartColumn, const HTuple& Field, const HTuple& BitsPerChannel, const HTuple& ColorSpace, const HTuple& Generic, const HTuple& ExternalTrigger, const HTuple& CameraType, const HTuple& Device, const HTuple& Port, const HTuple& LineIn, Hlong* AcqHandle)

void HFramegrabber::OpenFramegrabber(const HTuple& Name, const HTuple& HorizontalResolution, const HTuple& VerticalResolution, const HTuple& ImageWidth, const HTuple& ImageHeight, const HTuple& StartRow, const HTuple& StartColumn, const HTuple& Field, const HTuple& BitsPerChannel, const HTuple& ColorSpace, const HTuple& Generic, const HTuple& ExternalTrigger, const HTuple& CameraType, const HTuple& Device, const HTuple& Port, const HTuple& LineIn)

void OpenFramegrabber(const HTuple& Name, const HTuple& HorizontalResolution, const HTuple& VerticalResolution, const HTuple& ImageWidth, const HTuple& ImageHeight, const HTuple& StartRow, const HTuple& StartColumn, const HTuple& Field, const HTuple& BitsPerChannel, const HTuple& ColorSpace, const HTuple& Generic, const HTuple& ExternalTrigger, const HTuple& CameraType, const HTuple& Device, const HTuple& Port, const HTuple& LineIn, HTuple* AcqHandle)

void HFramegrabber::HFramegrabber(const HString& Name, Hlong HorizontalResolution, Hlong VerticalResolution, Hlong ImageWidth, Hlong ImageHeight, Hlong StartRow, Hlong StartColumn, const HString& Field, const HTuple& BitsPerChannel, const HTuple& ColorSpace, const HTuple& Generic, const HString& ExternalTrigger, const HTuple& CameraType, const HTuple& Device, const HTuple& Port, const HTuple& LineIn)

void HFramegrabber::HFramegrabber(const HString& Name, Hlong HorizontalResolution, Hlong VerticalResolution, Hlong ImageWidth, Hlong ImageHeight, Hlong StartRow, Hlong StartColumn, const HString& Field, Hlong BitsPerChannel, const HString& ColorSpace, double Generic, const HString& ExternalTrigger, const HString& CameraType, const HString& Device, Hlong Port, Hlong LineIn)

void HFramegrabber::HFramegrabber(const char* Name, Hlong HorizontalResolution, Hlong VerticalResolution, Hlong ImageWidth, Hlong ImageHeight, Hlong StartRow, Hlong StartColumn, const char* Field, Hlong BitsPerChannel, const char* ColorSpace, double Generic, const char* ExternalTrigger, const char* CameraType, const char* Device, Hlong Port, Hlong LineIn)

void HFramegrabber::OpenFramegrabber(const HString& Name, Hlong HorizontalResolution, Hlong VerticalResolution, Hlong ImageWidth, Hlong ImageHeight, Hlong StartRow, Hlong StartColumn, const HString& Field, const HTuple& BitsPerChannel, const HTuple& ColorSpace, const HTuple& Generic, const HString& ExternalTrigger, const HTuple& CameraType, const HTuple& Device, const HTuple& Port, const HTuple& LineIn)

void HFramegrabber::OpenFramegrabber(const HString& Name, Hlong HorizontalResolution, Hlong VerticalResolution, Hlong ImageWidth, Hlong ImageHeight, Hlong StartRow, Hlong StartColumn, const HString& Field, Hlong BitsPerChannel, const HString& ColorSpace, double Generic, const HString& ExternalTrigger, const HString& CameraType, const HString& Device, Hlong Port, Hlong LineIn)

void HFramegrabber::OpenFramegrabber(const char* Name, Hlong HorizontalResolution, Hlong VerticalResolution, Hlong ImageWidth, Hlong ImageHeight, Hlong StartRow, Hlong StartColumn, const char* Field, Hlong BitsPerChannel, const char* ColorSpace, double Generic, const char* ExternalTrigger, const char* CameraType, const char* Device, Hlong Port, Hlong LineIn)

void HOperatorSetX.OpenFramegrabber(
[in] VARIANT Name, [in] VARIANT HorizontalResolution, [in] VARIANT VerticalResolution, [in] VARIANT ImageWidth, [in] VARIANT ImageHeight, [in] VARIANT StartRow, [in] VARIANT StartColumn, [in] VARIANT Field, [in] VARIANT BitsPerChannel, [in] VARIANT ColorSpace, [in] VARIANT Generic, [in] VARIANT ExternalTrigger, [in] VARIANT CameraType, [in] VARIANT Device, [in] VARIANT Port, [in] VARIANT LineIn, [out] VARIANT* AcqHandle)

void HFramegrabberX.OpenFramegrabber(
[in] BSTR Name, [in] Hlong HorizontalResolution, [in] Hlong VerticalResolution, [in] Hlong ImageWidth, [in] Hlong ImageHeight, [in] Hlong StartRow, [in] Hlong StartColumn, [in] BSTR Field, [in] VARIANT BitsPerChannel, [in] VARIANT ColorSpace, [in] VARIANT Generic, [in] BSTR ExternalTrigger, [in] VARIANT CameraType, [in] VARIANT Device, [in] VARIANT Port, [in] VARIANT LineIn)

static void HOperatorSet.OpenFramegrabber(HTuple name, HTuple horizontalResolution, HTuple verticalResolution, HTuple imageWidth, HTuple imageHeight, HTuple startRow, HTuple startColumn, HTuple field, HTuple bitsPerChannel, HTuple colorSpace, HTuple generic, HTuple externalTrigger, HTuple cameraType, HTuple device, HTuple port, HTuple lineIn, out HTuple acqHandle)

public HFramegrabber(string name, int horizontalResolution, int verticalResolution, int imageWidth, int imageHeight, int startRow, int startColumn, string field, HTuple bitsPerChannel, HTuple colorSpace, HTuple generic, string externalTrigger, HTuple cameraType, HTuple device, HTuple port, HTuple lineIn)

public HFramegrabber(string name, int horizontalResolution, int verticalResolution, int imageWidth, int imageHeight, int startRow, int startColumn, string field, int bitsPerChannel, string colorSpace, double generic, string externalTrigger, string cameraType, string device, int port, int lineIn)

void HFramegrabber.OpenFramegrabber(string name, int horizontalResolution, int verticalResolution, int imageWidth, int imageHeight, int startRow, int startColumn, string field, HTuple bitsPerChannel, HTuple colorSpace, HTuple generic, string externalTrigger, HTuple cameraType, HTuple device, HTuple port, HTuple lineIn)

void HFramegrabber.OpenFramegrabber(string name, int horizontalResolution, int verticalResolution, int imageWidth, int imageHeight, int startRow, int startColumn, string field, int bitsPerChannel, string colorSpace, double generic, string externalTrigger, string cameraType, string device, int port, int lineIn)

Beschreibung

open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber ö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_imageGrabImagegrab_imageGrabImageGrabImage, grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData, grab_image_asyncgrab_image_asyncGrabImageAsyncgrab_image_asyncGrabImageAsyncGrabImageAsync oder grab_data_asyncgrab_data_asyncGrabDataAsyncgrab_data_asyncGrabDataAsyncGrabDataAsync. Wird das Bildeinzugsgerät nicht mehr benötigt, sollte er mittels close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber 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_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber. 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""doc/html/reference/acquisition".

Die Bedeutung der Parameter von open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber ist im einzelnen:

HorizontalResolution, VerticalResolution

Gewünschte Auflösung des Bildeinzugsgeräts.

ImageWidth, ImageHeight

Größe des Bildausschnittes, der von grab_imagegrab_imageGrabImagegrab_imageGrabImageGrabImage 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_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber 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_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber 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_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber liefert mit AcqHandleAcqHandleAcqHandleAcqHandleAcqHandleacqHandle einen Handle auf das geöffneten Bildeinzugsgerät zurück.

Achtung

Bedingt durch die Vielzahl der unterstützten Bildeinzugsgeräte, umfasst open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber 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_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamget_framegrabber_paramGetFramegrabberParamGetFramegrabberParam, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam, get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallback, set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallback, get_framegrabber_lutget_framegrabber_lutGetFramegrabberLutget_framegrabber_lutGetFramegrabberLutGetFramegrabberLut, set_framegrabber_lutset_framegrabber_lutSetFramegrabberLutset_framegrabber_lutSetFramegrabberLutSetFramegrabberLut, grab_image_startgrab_image_startGrabImageStartgrab_image_startGrabImageStartGrabImageStart, grab_imagegrab_imageGrabImagegrab_imageGrabImageGrabImage, grab_image_asyncgrab_image_asyncGrabImageAsyncgrab_image_asyncGrabImageAsyncGrabImageAsync, grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData, grab_data_asyncgrab_data_asyncGrabDataAsyncgrab_data_asyncGrabDataAsyncGrabDataAsync, close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbers eine eigene Gruppe innerhalb der info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbers exklusiv ausgeführt werden.

D.h., info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, open_framegrabberopen_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbers 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.

Parallelisierung

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

NameNameNameNameNamename (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name der HALCON-Bildeinzugsschnittstelle, d.h. Name der zugehörigen DLL (Windows) bzw. 'shared library' (Linux/macOS).

Defaultwert: 'File' "File" "File" "File" "File" "File"

Wertevorschläge: '1394IIDC'"1394IIDC""1394IIDC""1394IIDC""1394IIDC""1394IIDC", 'ABS'"ABS""ABS""ABS""ABS""ABS", 'ADLINK'"ADLINK""ADLINK""ADLINK""ADLINK""ADLINK", 'Andor'"Andor""Andor""Andor""Andor""Andor", 'Argos3D-P1xx'"Argos3D-P1xx""Argos3D-P1xx""Argos3D-P1xx""Argos3D-P1xx""Argos3D-P1xx", 'BitFlow'"BitFlow""BitFlow""BitFlow""BitFlow""BitFlow", 'Crevis'"Crevis""Crevis""Crevis""Crevis""Crevis", 'DahengCAM'"DahengCAM""DahengCAM""DahengCAM""DahengCAM""DahengCAM", 'DirectFile'"DirectFile""DirectFile""DirectFile""DirectFile""DirectFile", 'DirectShow'"DirectShow""DirectShow""DirectShow""DirectShow""DirectShow", 'Ensenso-NxLib'"Ensenso-NxLib""Ensenso-NxLib""Ensenso-NxLib""Ensenso-NxLib""Ensenso-NxLib", 'File'"File""File""File""File""File", 'GenICamTL'"GenICamTL""GenICamTL""GenICamTL""GenICamTL""GenICamTL", 'GigEVision2'"GigEVision2""GigEVision2""GigEVision2""GigEVision2""GigEVision2", 'Ginga++'"Ginga++""Ginga++""Ginga++""Ginga++""Ginga++", 'GingaDG'"GingaDG""GingaDG""GingaDG""GingaDG""GingaDG", 'heliCamC3'"heliCamC3""heliCamC3""heliCamC3""heliCamC3""heliCamC3", 'LinX'"LinX""LinX""LinX""LinX""LinX", 'LPS36'"LPS36""LPS36""LPS36""LPS36""LPS36", 'LuCam'"LuCam""LuCam""LuCam""LuCam""LuCam", 'MatrixVisionAcquire'"MatrixVisionAcquire""MatrixVisionAcquire""MatrixVisionAcquire""MatrixVisionAcquire""MatrixVisionAcquire", 'MILLite'"MILLite""MILLite""MILLite""MILLite""MILLite", 'MultiCam'"MultiCam""MultiCam""MultiCam""MultiCam""MultiCam", 'O3D3xx'"O3D3xx""O3D3xx""O3D3xx""O3D3xx""O3D3xx", 'Opteon'"Opteon""Opteon""Opteon""Opteon""Opteon", 'PixeLINK'"PixeLINK""PixeLINK""PixeLINK""PixeLINK""PixeLINK", 'pylon'"pylon""pylon""pylon""pylon""pylon", 'SaperaLT'"SaperaLT""SaperaLT""SaperaLT""SaperaLT""SaperaLT", 'Sentech'"Sentech""Sentech""Sentech""Sentech""Sentech", 'ShapeDrive'"ShapeDrive""ShapeDrive""ShapeDrive""ShapeDrive""ShapeDrive", 'SICK-3DCamera'"SICK-3DCamera""SICK-3DCamera""SICK-3DCamera""SICK-3DCamera""SICK-3DCamera", 'SICK-ScanningRuler'"SICK-ScanningRuler""SICK-ScanningRuler""SICK-ScanningRuler""SICK-ScanningRuler""SICK-ScanningRuler", 'SiliconSoftware'"SiliconSoftware""SiliconSoftware""SiliconSoftware""SiliconSoftware""SiliconSoftware", 'Slink'"Slink""Slink""Slink""Slink""Slink", 'SwissRanger'"SwissRanger""SwissRanger""SwissRanger""SwissRanger""SwissRanger", 'TWAIN'"TWAIN""TWAIN""TWAIN""TWAIN""TWAIN", 'uEye'"uEye""uEye""uEye""uEye""uEye", 'USB3Vision'"USB3Vision""USB3Vision""USB3Vision""USB3Vision""USB3Vision", 'Video4Linux2'"Video4Linux2""Video4Linux2""Video4Linux2""Video4Linux2""Video4Linux2", 'VRmUsbCam'"VRmUsbCam""VRmUsbCam""VRmUsbCam""VRmUsbCam""VRmUsbCam"

HorizontalResolutionHorizontalResolutionHorizontalResolutionHorizontalResolutionHorizontalResolutionhorizontalResolution (input_control)  extent.x → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Gewünschte horizontale Auflösung des Bildeinzugsgeräts (absoluter Wert oder 1 für Vollauflösung, 2 für halbe Auflösung bzw. 4 für viertel Auflösung).

Defaultwert: 1

Wertevorschläge: 1, 2, 4, 1600, 1280, 768, 640, 384, 320, 192, 160, -1

VerticalResolutionVerticalResolutionVerticalResolutionVerticalResolutionVerticalResolutionverticalResolution (input_control)  extent.y → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Gewünschte vertikale Auflösung des Bildeinzugsgeräts (absoluter Wert oder 1 für Vollauflösung, 2 für halbe Auflösung bzw. 4 für viertel Auflösung).

Defaultwert: 1

Wertevorschläge: 1, 2, 4, 1200, 1024, 576, 480, 288, 240, 144, 120, -1

ImageWidthImageWidthImageWidthImageWidthImageWidthimageWidth (input_control)  rectangle.extent.x → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Breite des gewünschten Bildausschnittes (absoluter Wert oder 0 für HorizontalResolutionHorizontalResolutionHorizontalResolutionHorizontalResolutionHorizontalResolutionhorizontalResolution - 2*StartColumnStartColumnStartColumnStartColumnStartColumnstartColumn).

Defaultwert: 0

Wertevorschläge: 0, -1

ImageHeightImageHeightImageHeightImageHeightImageHeightimageHeight (input_control)  rectangle.extent.y → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Höhe des gewünschten Bildausschnittes (absoluter Wert oder 0 für VerticalResolutionVerticalResolutionVerticalResolutionVerticalResolutionVerticalResolutionverticalResolution - 2*StartRowStartRowStartRowStartRowStartRowstartRow).

Defaultwert: 0

Wertevorschläge: 0, -1

StartRowStartRowStartRowStartRowStartRowstartRow (input_control)  rectangle.origin.y → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Zeilennummer der oberen linken Ecke des gewünschten Bildausschnittes (bzw. Höhe eines Rahmens, falls ImageHeightImageHeightImageHeightImageHeightImageHeightimageHeight = 0).

Defaultwert: 0

Wertevorschläge: 0, -1

StartColumnStartColumnStartColumnStartColumnStartColumnstartColumn (input_control)  rectangle.origin.x → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Spaltennummer der oberen linken Ecke des gewünschten Bildausschnittes (bzw. Breite eines Rahmens, falls ImageWidthImageWidthImageWidthImageWidthImageWidthimageWidth = 0).

Defaultwert: 0

Wertevorschläge: 0, -1

FieldFieldFieldFieldFieldfield (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Gewünschtes Halbbild bzw. Vollbild.

Defaultwert: 'default' "default" "default" "default" "default" "default"

Wertevorschläge: 'first'"first""first""first""first""first", 'second'"second""second""second""second""second", 'next'"next""next""next""next""next", 'interlaced'"interlaced""interlaced""interlaced""interlaced""interlaced", 'progressive'"progressive""progressive""progressive""progressive""progressive", 'default'"default""default""default""default""default"

BitsPerChannelBitsPerChannelBitsPerChannelBitsPerChannelBitsPerChannelbitsPerChannel (input_control)  integer(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Anzahl übertragener Bits pro Pixel und Bildkanal (-1: gerätespezifischer Defaultwert).

Defaultwert: -1

Wertevorschläge: 5, 8, 10, 12, 14, 16, -1

ColorSpaceColorSpaceColorSpaceColorSpaceColorSpacecolorSpace (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Festlegung des Ausgabe-Farbformats der eingezogenen Bilder, typischerweise 'gray' oder 'raw' für einkanalige bzw. 'rgb' oder 'yuv' für dreikanalige Bilder ('default': gerätespezifischer Defaultwert).

Defaultwert: 'default' "default" "default" "default" "default" "default"

Wertevorschläge: 'gray'"gray""gray""gray""gray""gray", 'raw'"raw""raw""raw""raw""raw", 'rgb'"rgb""rgb""rgb""rgb""rgb", 'yuv'"yuv""yuv""yuv""yuv""yuv", 'default'"default""default""default""default""default"

GenericGenericGenericGenericGenericgeneric (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (real / string / integer) (double / string / int / long) (double / HString / Hlong) (double / char* / Hlong) (double / BSTR / Hlong) (double / char* / Hlong)

Generischer Parameter mit gerätespezifischer Bedeutung.

Defaultwert: -1

ExternalTriggerExternalTriggerExternalTriggerExternalTriggerExternalTriggerexternalTrigger (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Triggerung durch externes Signal.

Defaultwert: 'default' "default" "default" "default" "default" "default"

Werteliste: 'default'"default""default""default""default""default", 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"

CameraTypeCameraTypeCameraTypeCameraTypeCameraTypecameraType (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Verwendeter Kameratyp ('default': gerätespezifischer Defaultwert).

Defaultwert: 'default' "default" "default" "default" "default" "default"

Wertevorschläge: 'ntsc'"ntsc""ntsc""ntsc""ntsc""ntsc", 'pal'"pal""pal""pal""pal""pal", 'auto'"auto""auto""auto""auto""auto", 'default'"default""default""default""default""default"

DeviceDeviceDeviceDeviceDevicedevice (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Device, an das das Bildeinzugsgerät angeschlossen ist ('default': gerätespezifischer Defaultwert).

Defaultwert: 'default' "default" "default" "default" "default" "default"

Wertevorschläge: '-1'"-1""-1""-1""-1""-1", '0'"0""0""0""0""0", '1'"1""1""1""1""1", '2'"2""2""2""2""2", '3'"3""3""3""3""3", 'default'"default""default""default""default""default"

PortPortPortPortPortport (input_control)  integer(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Port, an den das Bildeinzugsgerät angeschlossen ist (-1: gerätespezifischer Defaultwert).

Defaultwert: -1

Wertevorschläge: 0, 1, 2, 3, -1

LineInLineInLineInLineInLineInlineIn (input_control)  integer(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Kameraeingang (-1: gerätespezifischer Defaultwert).

Defaultwert: -1

Wertevorschläge: 1, 2, 3, 4, -1

AcqHandleAcqHandleAcqHandleAcqHandleAcqHandleacqHandle (output_control)  framegrabber → HFramegrabber, HTupleHTupleHFramegrabber, HTupleHFramegrabberX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle für das neu geöffnete Bildeinzugsgerät.

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)

Beispiel (C)

/* 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) ;

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)

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)

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)

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_framegrabberOpenFramegrabberopen_framegrabberOpenFramegrabberOpenFramegrabber den Wert 2 (H_MSG_TRUE). Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber

Nachfolger

grab_imagegrab_imageGrabImagegrab_imageGrabImageGrabImage, grab_datagrab_dataGrabDatagrab_dataGrabDataGrabData, grab_image_startgrab_image_startGrabImageStartgrab_image_startGrabImageStartGrabImageStart, grab_image_asyncgrab_image_asyncGrabImageAsyncgrab_image_asyncGrabImageAsyncGrabImageAsync, grab_data_asyncgrab_data_asyncGrabDataAsyncgrab_data_asyncGrabDataAsyncGrabDataAsync, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamset_framegrabber_paramSetFramegrabberParamSetFramegrabberParam, set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallback

Siehe auch

info_framegrabberinfo_framegrabberInfoFramegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabber, close_framegrabberclose_framegrabberCloseFramegrabberclose_framegrabberCloseFramegrabberCloseFramegrabber, grab_imagegrab_imageGrabImagegrab_imageGrabImageGrabImage

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH