名称
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