info_framegrabberT_info_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber (算子名称)
名称
info_framegrabberT_info_framegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber
— Query information about the specified image acquisition interface.
参数签名
def info_framegrabber(name: str, query: str) -> Tuple[str, Sequence[Union[str, int, float]]]
描述
The operator info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber
returns information about the image
acquisition device NameNameNameNamenamename
. The desired information is specified via
QueryQueryQueryQueryqueryquery
. A textual description according to the selected
topic is returned in InformationInformationInformationInformationinformationinformation
. If applicable,
ValueListValueListValueListValueListvalueListvalue_list
contains a list of supported values. Up to now,
the following queries are possible:
- 'bits_per_channel':
List of all supported values for the parameter
BitsPerChannelBitsPerChannelBitsPerChannelBitsPerChannelbitsPerChannelbits_per_channel
, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'camera_type':
Description and list of all supported values for the
parameter CameraTypeCameraTypeCameraTypeCameraTypecameraTypecamera_type
,
see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'color_space':
List of all supported values for the parameter
ColorSpaceColorSpaceColorSpaceColorSpacecolorSpacecolor_space
,
see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'defaults':
Interface-specific default values
in ValueListValueListValueListValueListvalueListvalue_list
, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'device':
List of all supported values for the parameter
DeviceDeviceDeviceDevicedevicedevice
, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'external_trigger':
List of all supported values for the parameter
ExternalTriggerExternalTriggerExternalTriggerExternalTriggerexternalTriggerexternal_trigger
, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'field':
List of all supported values for the parameter
FieldFieldFieldFieldfieldfield
, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'general':
General information (in InformationInformationInformationInformationinformationinformation
).
- 'generic':
Generic value with device-specific meaning,
see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'horizontal_resolution':
List of all supported values for the
parameter HorizontalResolutionHorizontalResolutionHorizontalResolutionHorizontalResolutionhorizontalResolutionhorizontal_resolution
, see
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'image_height':
List of all supported values for the parameter
ImageHeightImageHeightImageHeightImageHeightimageHeightimage_height
, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'image_width':
List of all supported values for the parameter
ImageWidthImageWidthImageWidthImageWidthimageWidthimage_width
, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'info_boards':
Information about actually installed boards
or cameras. This data is especially useful for
the auto-detect mechanism of the Image
Acquisition Assistant in HDevelop.
- 'line_in':
List of all supported values for the parameter
LineInLineInLineInLineInlineInline_in
, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'parameters':
List of all interface-specific parameters which
are accessible via set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param
or get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParamget_framegrabber_param
.
- 'parameters_readonly':
List of all interface-specific parameters
which are only accessible via
get_framegrabber_paramget_framegrabber_paramGetFramegrabberParamGetFramegrabberParamGetFramegrabberParamget_framegrabber_param
.
- 'parameters_writeonly':
List of all interface-specific parameters
which are only accessible via
set_framegrabber_paramset_framegrabber_paramSetFramegrabberParamSetFramegrabberParamSetFramegrabberParamset_framegrabber_param
.
- 'port':
List of all supported values for the parameter
PortPortPortPortportport
, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'revision':
Version number of the image acquisition interface.
- 'start_column':
List of all supported values for the parameter
StartColumnStartColumnStartColumnStartColumnstartColumnstart_column
, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'start_row':
List of all supported values for the parameter
StartRowStartRowStartRowStartRowstartRowstart_row
, see open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
- 'vertical_resolution':
List of all supported values for the
parameter VerticalResolutionVerticalResolutionVerticalResolutionVerticalResolutionverticalResolutionvertical_resolution
, see
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
.
Please check also the directory doc/html/reference/acquisition
for documentation about specific image grabber interfaces.
注意
For a multithreaded application,
info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber
, open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
, and
close_framegrabberclose_framegrabberCloseFramegrabberCloseFramegrabberCloseFramegrabberclose_framegrabber
are executed exclusively. Thus,
they block the concurrent execution of each other, but run in
parallel with all non-exclusive operators outside of this group.
On Windows Systems, error dialog boxes from the operating system can occur
when dependency modules of the interface are not found, e.g., the according
SDK was not installed. The occurrence of the error boxes can be controlled
by setting Windows' Error Mode. Please refer to the description of
SetErrorMode within the Windows MSDN documentation.
运行信息
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
参数表
NameNameNameNamenamename
(input_control) string →
HTuplestrHTupleHtuple (string) (string) (HString) (char*)
HALCON image acquisition interface name, i.e.,
name of the corresponding DLL (Windows) or
shared library (Linux).
Default:
'File'
"File"
"File"
"File"
"File"
"File"
Suggested values:
'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", 'MediaFoundation'"MediaFoundation""MediaFoundation""MediaFoundation""MediaFoundation""MediaFoundation", '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", 'RealSense'"RealSense""RealSense""RealSense""RealSense""RealSense", '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"
QueryQueryQueryQueryqueryquery
(input_control) string →
HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of the chosen query.
Default:
'info_boards'
"info_boards"
"info_boards"
"info_boards"
"info_boards"
"info_boards"
List of values:
'bits_per_channel'"bits_per_channel""bits_per_channel""bits_per_channel""bits_per_channel""bits_per_channel", 'camera_type'"camera_type""camera_type""camera_type""camera_type""camera_type", 'color_space'"color_space""color_space""color_space""color_space""color_space", 'defaults'"defaults""defaults""defaults""defaults""defaults", 'device'"device""device""device""device""device", 'external_trigger'"external_trigger""external_trigger""external_trigger""external_trigger""external_trigger", 'field'"field""field""field""field""field", 'general'"general""general""general""general""general", 'generic'"generic""generic""generic""generic""generic", 'horizontal_resolution'"horizontal_resolution""horizontal_resolution""horizontal_resolution""horizontal_resolution""horizontal_resolution", 'image_height'"image_height""image_height""image_height""image_height""image_height", 'image_width'"image_width""image_width""image_width""image_width""image_width", 'info_boards'"info_boards""info_boards""info_boards""info_boards""info_boards", 'parameters'"parameters""parameters""parameters""parameters""parameters", 'parameters_readonly'"parameters_readonly""parameters_readonly""parameters_readonly""parameters_readonly""parameters_readonly", 'parameters_writeonly'"parameters_writeonly""parameters_writeonly""parameters_writeonly""parameters_writeonly""parameters_writeonly", 'port'"port""port""port""port""port", 'revision'"revision""revision""revision""revision""revision", 'start_column'"start_column""start_column""start_column""start_column""start_column", 'start_row'"start_row""start_row""start_row""start_row""start_row", 'vertical_resolution'"vertical_resolution""vertical_resolution""vertical_resolution""vertical_resolution""vertical_resolution"
InformationInformationInformationInformationinformationinformation
(output_control) string →
HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Textual information (according to QueryQueryQueryQueryqueryquery
).
ValueListValueListValueListValueListvalueListvalue_list
(output_control) string-array →
HTupleSequence[Union[str, int, float]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
List of values (according to QueryQueryQueryQueryqueryquery
).
例程 (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)
结果
If the parameter values are correct and the specified image acquisition
interface is available, info_framegrabberinfo_framegrabberInfoFramegrabberInfoFramegrabberInfoFramegrabberinfo_framegrabber
returns the value
2 (
H_MSG_TRUE)
. Otherwise an exception is raised.
可能的前置算子
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
可能的后置算子
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
参考其它
open_framegrabberopen_framegrabberOpenFramegrabberOpenFramegrabberOpenFramegrabberopen_framegrabber
模块
Foundation