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

open_framegrabberT_open_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber (Operator)

Name

open_framegrabberT_open_framegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber — Ö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 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)

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::HFramegrabber(const wchar_t* Name, Hlong HorizontalResolution, Hlong VerticalResolution, Hlong ImageWidth, Hlong ImageHeight, Hlong StartRow, Hlong StartColumn, const wchar_t* Field, Hlong BitsPerChannel, const wchar_t* ColorSpace, double Generic, const wchar_t* ExternalTrigger, const wchar_t* CameraType, const wchar_t* Device, Hlong Port, Hlong LineIn)   (Nur Windows)

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 HFramegrabber::OpenFramegrabber(const wchar_t* Name, Hlong HorizontalResolution, Hlong VerticalResolution, Hlong ImageWidth, Hlong ImageHeight, Hlong StartRow, Hlong StartColumn, const wchar_t* Field, Hlong BitsPerChannel, const wchar_t* ColorSpace, double Generic, const wchar_t* ExternalTrigger, const wchar_t* CameraType, const wchar_t* Device, Hlong Port, Hlong LineIn)   (Nur Windows)

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)

def open_framegrabber(name: str, horizontal_resolution: int, vertical_resolution: int, image_width: int, image_height: int, start_row: int, start_column: int, field: str, bits_per_channel: MaybeSequence[int], color_space: MaybeSequence[str], generic: MaybeSequence[Union[str, float, int]], external_trigger: str, camera_type: MaybeSequence[str], device: MaybeSequence[str], port: MaybeSequence[int], line_in: MaybeSequence[int]) -> HHandle

Beschreibung

open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber ö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_imageGrabImageGrabImageGrabImagegrab_image, grab_datagrab_dataGrabDataGrabDataGrabDatagrab_data, grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsyncgrab_image_async oder grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsyncgrab_data_async. Wird das Bildeinzugsgerät nicht mehr benötigt, sollte er mittels close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber 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_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber. 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_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber ist im einzelnen:

HorizontalResolutionHorizontalResolutionHorizontalResolutionHorizontalResolutionhorizontalResolutionhorizontal_resolution, VerticalResolutionVerticalResolutionVerticalResolutionVerticalResolutionverticalResolutionvertical_resolution

Gewünschte Auflösung des Bildeinzugsgeräts.

ImageWidthImageWidthImageWidthImageWidthimageWidthimage_width, ImageHeightImageHeightImageHeightImageHeightimageHeightimage_height

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

StartRowStartRowStartRowStartRowstartRowstart_row, StartColumnStartColumnStartColumnStartColumnstartColumnstart_column

Linke obere Ecke des gewünschten Bildausschnittes.

FieldFieldFieldFieldfieldfield

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

BitsPerChannelBitsPerChannelBitsPerChannelBitsPerChannelbitsPerChannelbits_per_channel

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

ColorSpaceColorSpaceColorSpaceColorSpacecolorSpacecolor_space

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

GenericGenericGenericGenericgenericgeneric

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

ExternalTriggerExternalTriggerExternalTriggerExternalTriggerexternalTriggerexternal_trigger

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

CameraTypeCameraTypeCameraTypeCameraTypecameraTypecamera_type

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_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber abgefragt werden.

DeviceDeviceDeviceDevicedevicedevice

Gerätename des zu verwendenden Bildeinzugsgeräts.

PortPortPortPortportport

Port, an den das Bildeinzugsgerät angeschlossen ist.

LineInLineInLineInLineInlineInline_in

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

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

Achtung

Bedingt durch die Vielzahl der unterstützten Bildeinzugsgeräte, umfasst open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber 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_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParamget_framegrabber_param, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param, get_framegrabber_callbackget_framegrabber_callbackGetFramegrabberCallbackGetFramegrabberCallbackGetFramegrabberCallbackget_framegrabber_callback, set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback, get_framegrabber_lutget_framegrabber_lutGetFramegrabberLutGetFramegrabberLutGetFramegrabberLutget_framegrabber_lut, set_framegrabber_lutset_framegrabber_lutSetFramegrabberLutSetFramegrabberLutSetFramegrabberLutset_framegrabber_lut, grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStartgrab_image_start, grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image, grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsyncgrab_image_async, grab_datagrab_dataGrabDataGrabDataGrabDatagrab_data, grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsyncgrab_data_async, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbersclose_all_framegrabbers eine eigene Gruppe innerhalb der info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbersclose_all_framegrabbers exklusiv ausgeführt werden.

D.h., info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber und close_all_framegrabbersclose_all_framegrabbersCloseAllFramegrabbersCloseAllFramegrabbersCloseAllFramegrabbersclose_all_framegrabbers 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

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 → HTuplestrHTupleHtuple (string) (string) (HString) (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: 'ABS'"ABS""ABS""ABS""ABS""ABS", 'ADLINK'"ADLINK""ADLINK""ADLINK""ADLINK""ADLINK", 'AlkUSB3'"AlkUSB3""AlkUSB3""AlkUSB3""AlkUSB3""AlkUSB3", 'Andor'"Andor""Andor""Andor""Andor""Andor", '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", 'FocalSpecLCI'"FocalSpecLCI""FocalSpecLCI""FocalSpecLCI""FocalSpecLCI""FocalSpecLCI", 'GenICamTL'"GenICamTL""GenICamTL""GenICamTL""GenICamTL""GenICamTL", 'GigEVision2'"GigEVision2""GigEVision2""GigEVision2""GigEVision2""GigEVision2", 'GingaDG'"GingaDG""GingaDG""GingaDG""GingaDG""GingaDG", 'Ginga++'"Ginga++""Ginga++""Ginga++""Ginga++""Ginga++", 'GStreamer'"GStreamer""GStreamer""GStreamer""GStreamer""GStreamer", 'heliCamC3'"heliCamC3""heliCamC3""heliCamC3""heliCamC3""heliCamC3", 'KeyenceVJ'"KeyenceVJ""KeyenceVJ""KeyenceVJ""KeyenceVJ""KeyenceVJ", '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", 'PhoXi'"PhoXi""PhoXi""PhoXi""PhoXi""PhoXi", 'PixeLINK'"PixeLINK""PixeLINK""PixeLINK""PixeLINK""PixeLINK", 'pylon'"pylon""pylon""pylon""pylon""pylon", 'SaperaLT'"SaperaLT""SaperaLT""SaperaLT""SaperaLT""SaperaLT", 'Sentech'"Sentech""Sentech""Sentech""Sentech""Sentech", '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", '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"

HorizontalResolutionHorizontalResolutionHorizontalResolutionHorizontalResolutionhorizontalResolutionhorizontal_resolution (input_control)  extent.x → HTupleintHTupleHtuple (integer) (int / long) (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

VerticalResolutionVerticalResolutionVerticalResolutionVerticalResolutionverticalResolutionvertical_resolution (input_control)  extent.y → HTupleintHTupleHtuple (integer) (int / long) (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

ImageWidthImageWidthImageWidthImageWidthimageWidthimage_width (input_control)  rectangle.extent.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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

Defaultwert: 0

Wertevorschläge: 0, -1

ImageHeightImageHeightImageHeightImageHeightimageHeightimage_height (input_control)  rectangle.extent.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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

Defaultwert: 0

Wertevorschläge: 0, -1

StartRowStartRowStartRowStartRowstartRowstart_row (input_control)  rectangle.origin.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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

Defaultwert: 0

Wertevorschläge: 0, -1

StartColumnStartColumnStartColumnStartColumnstartColumnstart_column (input_control)  rectangle.origin.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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

Defaultwert: 0

Wertevorschläge: 0, -1

FieldFieldFieldFieldfieldfield (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (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"

BitsPerChannelBitsPerChannelBitsPerChannelBitsPerChannelbitsPerChannelbits_per_channel (input_control)  integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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

Defaultwert: -1

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

ColorSpaceColorSpaceColorSpaceColorSpacecolorSpacecolor_space (input_control)  string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Festlegung des Ausgabe-Farbformats der eingezogenen Bilder, typischerweise 'gray'"gray""gray""gray""gray""gray" oder 'raw'"raw""raw""raw""raw""raw" für einkanalige bzw. 'rgb'"rgb""rgb""rgb""rgb""rgb" oder 'yuv'"yuv""yuv""yuv""yuv""yuv" für dreikanalige Bilder ('default'"default""default""default""default""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) → HTupleMaybeSequence[Union[str, float, int]]HTupleHtuple (real / string / integer) (double / string / int / long) (double / HString / Hlong) (double / char* / Hlong)

Generischer Parameter mit gerätespezifischer Bedeutung.

Defaultwert: -1

ExternalTriggerExternalTriggerExternalTriggerExternalTriggerexternalTriggerexternal_trigger (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Trigger 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"

CameraTypeCameraTypeCameraTypeCameraTypecameraTypecamera_type (input_control)  string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Verwendeter Kameratyp ('default'"default""default""default""default""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) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Device, an das das Bildeinzugsgerät angeschlossen ist ('default'"default""default""default""default""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) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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

Defaultwert: -1

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

LineInLineInLineInLineInlineInline_in (input_control)  integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Kameraeingang (-1: gerätespezifischer Defaultwert).

Defaultwert: -1

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

AcqHandleAcqHandleAcqHandleAcqHandleacqHandleacq_handle (output_control)  framegrabber → HFramegrabber, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

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)

Ergebnis

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

Vorgänger

info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber

Nachfolger

grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image, grab_datagrab_dataGrabDataGrabDataGrabDatagrab_data, grab_image_startgrab_image_startGrabImageStartGrabImageStartGrabImageStartgrab_image_start, grab_image_asyncgrab_image_asyncGrabImageAsyncGrabImageAsyncGrabImageAsyncgrab_image_async, grab_data_asyncgrab_data_asyncGrabDataAsyncGrabDataAsyncGrabDataAsyncgrab_data_async, set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param, set_framegrabber_callbackset_framegrabber_callbackSetFramegrabberCallbackSetFramegrabberCallbackSetFramegrabberCallbackset_framegrabber_callback

Siehe auch

info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber, close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber, grab_imagegrab_imageGrabImageGrabImageGrabImagegrab_image

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 20.11.4.0 Copyright © 1996-2023 MVTec Software GmbH