halcon算子翻译——info_framegrabber

名称

info_framegrabber - 查询有关指定图像采集接口的信息。

用法

info_framegrabber( : : Name, Query : Information, ValueList)

描述

　　算子info_framegrabber返回关于图像采集设备Name的信息。 所需信息通过Query指定。 根据所选主题的文字说明在Information中返回。 如果适用，ValueList包含支持值的列表。 到目前为止，以下查询是可能的：

'bits_per_channel':

　　参数“BitsPerChannel”的所有支持值列表，请参阅open_framegrabber。

'camera_type':

　　参数“CameraType”的所有支持值的描述和列表，请参阅open_framegrabber。

'color_space':

　　参数'ColorSpace'的所有支持值列表，请参阅open_framegrabber。

'defaults':

　　ValueList表示特定的接口的默认值，请参阅open_framegrabber。

'device':

 　　参数“Device”的所有支持值列表，请参阅open_framegrabber。

'external_trigger':

　　参数“ExternalTrigger”的所有支持值列表，请参阅open_framegrabber。

'field':

　　参数“Field”的所有支持值列表，请参阅open_framegrabber。

'general':

　　一般信息（在Information中）

'generic':

　　具有设备特定含义的通用值，请参见open_framegrabber。

'horizontal_resolution':

　　参数'HorizontalResolution'的所有支持值列表，请参阅open_framegrabber。

'image_height':

　　参数“ImageHeight”的所有支持值的列表，请参阅open_framegrabber。

'image_width':

　　参数“ImageWidth”的所有支持值列表，请参阅open_framegrabber。

'info_boards':

　　有关实际安装的（采集卡）主板或相机的信息。 此数据对于ActivVisionTools的自动检测机制和HDevelop中的图像采集助手特别有用。

'line_in':

　　参数“LineIn”的所有支持值列表，请参阅open_framegrabber。

'parameters':

　　所有可通过set_framegrabber_param或get_framegrabber_param访问的接口特定参数列表。

'parameters_readonly':

　　所有只能通过get_framegrabber_param访问的特定接口参数的列表。

'parameters_writeonly':

　　所有只能通过set_framegrabber_param访问的特定接口参数的列表。

'port':

　　参数“Port”的所有支持值列表，请参阅open_framegrabber。

'revision':

　　图像采集接口的版本号。

'start_column':

　　参数“StartColumn”的所有支持值列表，请参阅open_framegrabber。

'start_row':

　　参数“StartColumn”的所有支持值列表，请参阅open_framegrabber。

'vertical_resolution':

　　参数'VerticalResolution'的所有支持值列表，请参阅open_framegrabber。

请查看目录“doc / html / reference / acquisition”以获取有关特定图像采集接口的文档。

注意

　　对于多线程应用程序，所有图像采集算子（如open_framegrabber中列出的）都是自己的组，其中info_framegrabber，open_framegrabber，close_framegrabber和close_all_framegrabbers是独占执行的。

　　info_framegrabber阻止该组中所有其他算子的并发执行，但与该组以外的所有非独占算子并行运行。

　　在Windows系统上，如果未找到接口的依赖项模块（例如未安装相应的SDK），则可能会出现操作系统的错误对话框。 错误框的发生可以通过设置Windows的错误模式来控制。 请参阅Windows MSDN文档中SetErrorMode的描述。

并行

●　　多线程类型：可重入（与非独占算子并行运行）。
●　　多线程范围：全局（可以从任何线程调用）。
●　　不并行化处理。

参数

Name (input_control) 　　string → (string)
　　HALCON图像采集接口名称，即对应的DLL（Windows）或共享库（Linux / OS X）的名称。
　　Default value: 'File'

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

Query (input_control) 　　 string → (string)
　　所选查询的名称。
　　Default value: 'info_boards'

List of values: 'bits_per_channel', 'camera_type', 'color_space', 'defaults', 'device', 'external_trigger', 'field', 'general', 'generic', 'horizontal_resolution', 'image_height', 'image_width', 'info_boards', 'parameters', 'parameters_readonly', 'parameters_writeonly', 'port', 'revision', 'start_column', 'start_row', 'vertical_resolution'

Information 　　(output_control) string → (string)
　　文本信息（根据Query）。

ValueList (output_control) 　　 string-array → (string / integer / real)
　　值列表（根据Query）。

Example (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)

结果

如果参数值正确并且指定的图像采集接口可用，则info_framegrabber返回值2（H_MSG_TRUE）。 否则会引发异常。

Possible Predecessors

open_framegrabber

Possible Successors

open_framegrabber

See also

open_framegrabber

模块

Foundation