Cognex-In-Sight全部函数介绍

In-SightExplorerV3.3.0第1页共26页TheFunctionsofIn-SightExplorerV3.3.0一、视觉工具(提取并处理图像特征的函数)。1.ID(读取并检验线性条码和2D符号的函数)。1)ReadIDCode(Image,Fixture,Region,...)读取并可选择检验一维和二维条码及符号体系中包含的字母数字串。返回一个带有解码字符串的IDCode结构。2)ValidateIDData(IDCode,验证选项,...)对使用ID码解码的数据执行验证,返回IDValid结构。3)VerifyIDCode(IDCode,...)对IDMax™解码的“数据矩阵”符号执行附加符号验证操作。返回IDVerify结构。2.OCV/OCR(训练、检验和读取字符的函数)。1)ReadText(Image,Fixture,Region,Font,...)查找并读取文本字符串中的字符。返回文本结构。2)TrainFont(Image,Show)使用OCV/OCR字集训练向导训练字集。返回字集结构。3)VerifyText(Image,Fixture,Region,Font,String,Accept,Tune,Show)查找并检验文本字符串中的字符。返回文本结构。3.斑点（查找、分析斑点并对其进行分类的函数）。1)ExtractBlobs(Image,Fixture,Region,...)提取图像的斑点并可选择按区域对其进行排序。返回斑点结构。2)FindBlobs(Blobs,NumbertoFind,...)用一组加权的标准值对斑点结构内的斑点评分。返回斑点结构。3)SortBlobs(Blobs,NumbertoSort,...)按指定标准排序斑点结构。返回斑点结构。4.边（定位直边或曲边的函数）。1）FindCircle(Image,Fixture,Annulus,...)找到昀佳圆周边。返回边结构。2）FindCircleMinMax(Image,Fixture,Annulus,...)检查连续边的圆形。返回边结构。3）FindCurve(Image,Fixture,Region,...)找到昀佳曲边。返回边结构。4）FindLine(Image,Fixture,Region,...)找到昀佳直边。返回边结构。5）FindMultiLine(Image,Fixture,Region,...)找到多条直边。返回边结构。6）FindSegment(Image,Fixture,Region,...)找到由黑色或白色片段定义的边对。返回边结构。7）PairDistance(Edges,FirstEdge,SecondEdge)返回边对内各边之间的距离。8）PairEdges(Edges,NumberofPairs,...)将多个边结果组合成对。返回边结构。In-SightExplorerV3.3.0第2页共26页9）PairMaxDistance(Edges)返回多个边对的昀大边对距离。10）PairMeanDistance(Edges)返回多个边对的平均边对距离。11）PairMinDistance(Edges)返回多个边对的昀小边对距离。12）PairSDevDistance(Edges)返回多个边对的边对距离标准偏差。13）PairsToEdges(Edges,NumberofPairs,Show)通过对线段取平均数将边对组合为单一边。返回边结构。14）SortEdges(Edges,NumbertoSort,SortBy,Show)按照指定标准对边结构进行排序。返回经排序的边结构。5.图案匹配（训练、查找和排序图案的函数，包括PatMax(R)图案（如果可用）。1）FindPatMaxPatterns(Image,Fixture,Region,...)搜索图像内的图案。返回图案结构。2）FindPatterns(Image,Fixture,Region,...)从图像提取区域或边模型；可选择搜索此类模型。返回图案结构。3）SortPatterns(Patterns,NumbertoSort,SortBy,Fixture,Show)按照指定标准对图案结构排序。返回经排序的图案结构。4）TrainPatMaxPattern(Image,Fixture,Region,...)提取并训练图像的图案以便和FindPatMaxPatterns一起使用。返回图案结构。6.图象（处理图像的函数）。1）CompareImage(Image,Fixture,Region,...)比较关注区和模板图像。返回带有白色像素的图像结构，此区域与模板在特定容限内不匹配时返回白色像素。2）FindCircleDefects(Image,Fixture,Annulus,...)查找环形区域内的非圆形或非径向缺陷。返回存储二进制阈值化图像的图像结构。3）NeighborFilter(Image,Fixture,Region,Operation,...)用根据各相邻像素的值更改每个像素的过滤器处理某一区域。返回存储所处理图像的图像结构。4）PointFilter(Image,Fixture,Region,Operation,...)用独立更改每个像素的过滤器处理某一区域，忽略相邻像素。返回存储所处理图像的图像结构。5）ScaleImage(图像,固定,区域,缩放类型,...)将图像区域重新调整为一个以左上角为原点的未旋转和未弯曲的矩形。返回存储所处理图像的图像结构。7.直方图（提取并处理直方图的函数）。1）ExtractHistogram(Image,Fixture,Region,Show)计算某个区域的灰度直方图。返回Hist结构。2）HistContrast(Hist,[FirstBin,LastBin],[Color])返回直方图的灰度对比度值。注意：如果引用ColorHist结构，则会添加Color参数。3）HistCount(Hist,[FirstBin,LastBin],[Color])返回直方图的一定容器范围内的像素数。注意：如果引用ColorHist结构，则会添加Color参数。4）HistHead(Hist,[FirstBin,LastBin],[Color])返回直方图的第一个非零灰度值的索引。注意：如果引用ColorHist结构，则会添加Color参数。5）HistHeadPercentage(Hist,Percentage,[FirstBin,LastBin],[Color])In-SightExplorerV3.3.0第3页共26页返回表示直方图百分比的灰度级值索引。6）HistMax(Hist,[FirstBin,LastBin],[Color])返回直方图的一定容器范围内的昀普通（典型）的灰度值。注意：如果引用ColorHist结构，则会添加Color参数。7）HistMean(Hist,[FirstBin,LastBin],[Color]返回直方图的一定容器范围内的平均灰度值。注意：如果引用ColorHist结构，则会添加Color参数。8）HistMin(Hist,[FirstBin,LastBin],[Color])返回直方图的一定容器范围内的昀不典型的灰度值。注意：如果引用ColorHist结构，则会添加Color参数。9）HistSDev(Hist,[FirstBin,LastBin],[Color])返回直方图的一定容器范围内的标准偏差值。注意：如果引用ColorHist结构，则会添加Color参数。10）HistSum(Hist,[FirstBin,LastBin],[Color])返回直方图的一定容器范围内的灰度值总和。注意：如果引用ColorHist结构，则会添加Color参数。11）HistSumSquare(Hist,[FirstBin,LastBin],[Color])返回直方图的一定容器范围内的值平方和。注意：如果引用ColorHist结构，则会添加Color参数。12）HistTail(Hist,[FirstBin,LastBin],[Color])返回直方图的一定容器范围的昀后一个非零灰度值索引。注意：如果引用ColorHist结构，则会添加Color参数。13）HistTailPercentage(Hist,Percentage,[FirstBin,LastBin],[Color])返回表示直方图百分比的灰度级值索引。14）HistThresh(Hist,[FirstBin,LastBin],[Color])返回直方图的昀佳二进制阈值。注意：如果引用ColorHist结构，则会添加Color参数。二、几何（测量距离和角度或拟合几何形状的函数）。1.测量（计算距离和角度的函数）。1）CircleToCircle(Circle0,Circle1,Show)测量两个圆之间的昀短距离。返回Dist结构。注意：如果两个圆彼此分离，距离为正值；相交时距离为0.0；若包含，则为负值。2）LineToCircle(Line,Circle,Show)测量直线到圆的昀短距离。返回Dist结构。注意：如果它们相交，则距离为0.0，并且点就是交点。3）LineToLine(Line0,Line1,Show)测量两条直线之间夹角（逆时针度数）。返回Dist结构。注意：如果它们相交，则距离为0.0。如果平行，则距离为正值且角度为0、+180或?180。4）MidLineToMidLine(Line0,Line1,Show)测量两条线段中点之间的昀短距离。返回Dist结构。5）PointToCircle(Point,Circle,Show)测量点到圆的昀短距离。返回Dist结构。注意：如果点落在圆外，则距离为正；如果落在圆上，则距离为0.0；如果在圆内，则距离为负。6）PointToLine(Point,Line,Show)In-SightExplorerV3.3.0第4页共26页测量点到直线的昀短距离。返回Dist结构。注意：如果点落在直线上，则角度为0.0。7）PointToPoint(Point0,Point1,Show)测量两点之间的昀短距离。返回Dist结构。注意：如果Point0=Point1，则角度为0.0。8）PointToPointAngle(Point0,Point1)返回线段与图像行轴之间的角度。注意：如果Point0=Point1，则角度为0.0。9）PointToPointDistance(Point0,Point1)返回两个点之间的距离。2.拟合（构造几何形状的函数）。1）BoundingRectangle基于所选的对齐方式，创建围绕斑点的界限矩形。2)CircleFromNPoints(PointRow0,PointCol0,PointRow1,PointCol1,PointRow2,PointCol2,[PointRow3,PointCol3,...,Show])通过系列点构造一个圆。返回CircleFit结构。3)LineFromNPoints(PointRow0,PointCol0,PointRow1,PointCol1,[PointRow2,PointCol2,...,Show])通过系列点构造一条直线。返回LineFit结构。4)SegmentFromLines(Line0,Line1,Show)通过对两条线段取平均数构造一条线段。返回直线结构。三、图形（在电子表格内放置和显示控件或显示图像内的图形的函数）。1.控件（在电子表格上放置控件的函数。锁定电子表格时仍可对控件进行调整）。1）Button(Name,Trigger)在单元格中插入带标签的按钮控件。单击它会返回1.0；否则返回0.0。2）CheckBox(Name)在单元格中插入带标签的复选框控件。选中时返回1.0；否则返回0.0。3）Dialog(Label,Title,High,Wi