HALCON中文中文注解

Halcon查询图像参数1、get_grayval ( Image : : Row, Column : Grayval )计算Image图像中坐标为（Row，Column）的点的灰度值Grayval。

2、get_image_pointer1 ( Image : : : Pointer, Type, Width, Height )计算Image图像的数据指针Pointer，图像类型Type，图像宽度Width和高度Height。

Pointer指向了Image data的起点位置。

3、get_image_pointer3 ( ImageRGB : : : PointerRed, PointerGreen,PointerBlue, Type, Width, Height )计算彩色图像ImageRGB的参数。

4、get_image_pointer1_rect ( Image : : : PixelPointer, Width, Height, VerticalPitch, HorizontalBitPitch, BitsPerPixel )计算Image图像中定义区域的最小的长方形的区域的指针Pointer，宽度Width，高度Height，VerticalPitch代表Image的Width*(HorizontalBitPitch/8)。

两个相邻象素的水平距离（以比特计算）HorizontalBitPitch，每像素的比特数BitsPerPixel。

5、get_image_time ( Image : : : MSecond, Second, Minute, Hour, Day, YDay, Month, Year )获取图像生成的时间。

摄像头获取图像和相关参数1、close_all_framegrabbers ( : : : )关闭所有图像采集设备。

2、close_framegrabber ( : : AcqHandle : )关闭Handle为AcqHandle的图像采集设备。

3、open_framegrabber ( : : Name, HorizontalResolution,VerticalResolution, ImageWidth, ImageHeight, StartRow, StartColumn,Field, BitsPerChannel, ColorSpace, Generic, ExternalTrigger,CameraType, Device, Port, LineIn : AcqHandle )打开图像采集设备参数信息：Name：图像采集设备的名称HorizontalResolution和VerticalResolution：分别指预期的图像采集接口的水平分辨率和垂直分辨率ImageWidth和ImageHeight：指预期图像的宽度部分和高度部分。

StartRow和StartColumn：指显示预期图像的开始坐标Field：预期图像是一半的图像或者是完整图像BitsPerChannel：每像素比特数和图像通道ColorSpace：输出的色彩格式的抓住图像{gray、raw、rgb、yuv、default} Generic：通用参数与设备细节部分的具体意义。

ExternalTrigger：是否有外部触发CameraType：使用相机的类型Device：图像获取设别连接到的设备Port：图像获取设别连接到的端口LineIn :相机输入的多路转接器AcqHandle:图像获取设备的Handle4、grab_image ( : Image : AcqHandle : )获取AcqHandle的图像采集设备的Image。

5、get_framegrabber_param ( : : AcqHandle, Param : Value )查询AcqHandle的图像采集设备的特殊参数Param∈{name、port、revision、bits_per_channel, camera_type、color_space、device、field、generic、external_trigger、grab_timeout、horizontal_resolution、image_available、image_height、image_width、line_in、start_column、start_row、volatile、vertical_resolution、continuous_grabbing、}6、info_framegrabber ( : : Name, Query : Information, ValueList )查询指定的图像采集接口的信息。

Name为图像采集设备的名称Query为需要查询的参数名称Information是指输出的文本信息ValueList为该图像采集接口的参数值。

Name∈{1394IIDC、ABS、BaumerFCAM、BitFlow、Crevis、uEye、DahengCAM、DahengFG、DFG-LC、DirectFile、DirectShow、dPict、DT315x、DT3162、eneo、eXcite、FALCON、FlashBusMV、FlashBusMX、GigEVision、Ginga++、GingaDG、INSPECTA、TAG、INSPECTA5、iPORT、Leutron、LinX、LuCam、MatrixVisionAcquire、MILLite、File、mEnableIII、mEnableIV、mEnableVisualApplets、MultiCam、Opteon、p3i2、p3i4、PixeLINK、PX、PXC、PXD、PXR、pylon、RangerC、RangerE、SaperaLT、Sentech、SonyXCI、SonyXCI-2、SVCam-GigE、TWAIN、VRmUsbCam}Query∈{defaults、general、info_boards、parameters、field、generic、parameters_readonly、parameters_writeonly、vertical_resolution、port、bits_per_channel、camera_type、color_space、device、external_trigger、field、generic、horizontal_resolution、image_height、image_width、start_row、start_column、revision} 7、grab_image_async ( : Image : AcqHandle, MaxDelay : )获取AcqHandle的图像采集设备的Image当调用grab_image_async 或者grab_data_async时，抓拍下一个图像就结束1.// Select a suitable image acquisition interface name AcqName2.open_framegrabber(AcqName,1,1,0,0,0,0,’default’,-1,’default’,-1.0,’default’,’default’,’default’,-1,-1,AcqHandle)3.// Grab image + start next grab4.grab_image_async(Image1,AcqHandle,-1.0)5.// Process Image1 ...6.// Finish asynchronous grab + start next grab7.grab_image_async(Image2,AcqHandle,-1.0)8.// Process Image2 ...9.close_framegrabber(AcqHandle)8、grab_image_start ( : : AcqHandle, MaxDelay : )开始抓拍只有当和grab_image_async or grab_data_async一起使用时，grab_image_start 才会起作用。

1.// Select a suitable image acquisition interface name AcqName2.open_framegrabber(AcqName,1,1,0,0,0,0,’default’,-1,’default’,-1.0,3.’default’,’default’,’default’,-1,-1,AcqHandle)4.grab_image(Image1,AcqHandle)5.// Start next grab6.grab_image_start(AcqHandle,-1.0)7.// Process Image1 ...8.// Finish asynchronous grab + start next grab9.grab_image_async(Image2,AcqHandle,-1.0)10.// Process Image2 ...11.close_framegrabber(AcqHandle）9、get_framegrabber_lut ( : : AcqHandle : ImageRed, ImageGreen,ImageBlue )查询AcqHandle的图像采集设备的look-up table注意：该运算子不能支持所有的图像采集设备10、grab_data ( : Image, Region, Contours : AcqHandle : Data )获取AcqHandle的图像采集设备获得的Image、预处理Region和预处理XLD轮廓Contours和预处理控制数据Data。

注意：该运算子不能支持所有的图像采集设备11、grab_data_async ( : Image, Region, Contours : AcqHandle,MaxDelay: Data )获取AcqHandle的图像采集设备的Image、预处理Region和预处理XLD轮廓Contours和预处理控制数据Data。

（需要特殊图像采集数据）12、set_framegrabber_lut ( : : AcqHandle, ImageRed, ImageGreen,ImageBlue : )设置AcqHandle的图像采集设备的look-up table13、set_framegrabber_param ( : : AcqHandle, Param, Value : )设置AcqHandle的图像采集设备的特殊参数1.close_all_framegrabbers ()2.open_framegrabber ('DahengCAM', 1, 1, -1, -1, 0, 0, 'default', -1, 'rgb', -1, 'false', 'default', 'default', -1, -1, AcqHandle)3.grab_image (Image, AcqHandle)4.grab_image_async (Image2, AcqHandle, -1)5.get_framegrabber_param (AcqHandle, 'image_width', Value)_framegrabber ('DirectFile', 'info_boards', Information,ValueList)有关图像通道的函数黑白摄像机会返回每个像素所对应的能量采用结果，这些结果组成了一幅单通道灰度值图像，而对于RGB彩色摄像机，它将返回每个像素所对应的三个采样结果，也就是一幅三通道图像。