康耐视智能相机Insight全部函数介绍

一、视觉工具(提取并处理图像特征的函数)。

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, Number to Find, ...) 用一组加权的标准值对斑点结构内的斑点评分。 返回斑点结构。

3) SortBlobs(Blobs, Number to Sort, ...) 按指定标准排序斑点结构。返回斑点结构。

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, First Edge, Second Edge) 返回边对内各边之间的距离。

8）PairEdges(Edges, Number of Pairs, ...) 将多个边结果组合成对。 返回边结构。

9）PairMaxDistance(Edges) 返回多个边对的最大边对距离。

10）PairMeanDistance(Edges) 返回多个边对的平均边对距离。

11）PairMinDistance(Edges) 返回多个边对的最小边对距离。

12）PairSDevDistance(Edges) 返回多个边对的边对距离标准偏差。

13）PairsToEdges(Edges, Number of Pairs, Show) 通过对线段取平均数将边对组合为单一边。 返回边结构。

14）SortEdges(Edges, Number to Sort, Sort By, Show) 按照指定标准对边结构进行排序。 返回经排序的边结构。

5. 图案匹配（训练、查找和排序图案的函数，包括 PatMax(R) 图案（如果可用）。

1）FindPatMaxPatterns(Image, Fixture, Region, ...) 搜索图像内的图案。 返回图案结构。

2）FindPatterns(Image, Fixture, Region, ...) 从图像提取区域或边模型；可选择搜索此类模型。 返回图案结构。

3）SortPatterns(Patterns, Number to Sort, Sort By, 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]) 返回表示直方图百分比的灰度级值索引。

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(Circle 0, Circle 1, Show) 测量两个圆之间的最短距离。返回 Dist 结构。注意：如果两个圆彼此分离，距离为正值；相交时距离为 0.0； 若包含，则为负值。 2）LineToCircle(Line, Circle, Show) 测量直线到圆的最短距离。返回 Dist 结构。 注意：如果它们相交，则距离为 0.0，并且点就是交点。 3）LineToLine(Line 0, Line 1, Show) 测量两条直线之间夹角（逆时针度数）。 返回 Dist 结构。注意：如果它们相交，则距离为 0.0。如果平 行，则距离为正值且角度为 0、+180 或 ?180。 4）MidLineToMidLine(Line 0, Line 1, Show) 测量两条线段中点之间的最短距离。返回 Dist 结构。 5）PointToCircle(Point, Circle, Show) 测量点到圆的最短距离。 返回 Dist 结构。注意：如果点落在圆外，则距离为正；如果落在圆上，则距离 为 0.0；如果在圆内，则距离为负。 6）PointToLine(Point, Line, Show) 测量点到直线的最短距离。返回 Dist 结构。 注意：如果点落在直线上，则角度为 0.0。 7）PointToPoint(Point 0, Point 1, Show) 测量两点之间的最短距离。返回 Dist 结构。 注意：如果 Point 0 = Point 1，则角度为 0.0。 8）PointToPointAngle(Point 0, Point 1) 返回线段与图像行轴之间的角度。 注意：如果 Point 0 = Point 1，则角度为 0.0。 9）PointToPointDistance(Point 0, Point 1) 返回两个点之间的距离。

2. 拟合（构造几何形状的函数）。

1）BoundingRectangle 基于所选的对齐方式，创建围绕斑点的界限矩形。 2) CircleFromNPoints(Point Row 0, Point Col 0, Point Row 1, Point Col 1, Point Row 2, Point Col 2, [Point Row 3, Point Col 3, ..., Show]) 通过系列点构造一个圆。返回 CircleFit 结构。 3) LineFromNPoints(Point Row 0, Point Col 0, Point Row 1, Point Col 1, [Point Row 2, Point Col 2, ..., Show]) 通过系列点构造一条直线。 返回 LineFit 结构。 4) SegmentFromLines(Line 0, Line 1, Show) 通过对两条线段取平均数构造一条线段。 返回直线结构。

三、图形（在电子表格内放置和显示控件或显示图像内的图形的函数）

1. 控件（在电子表格上放置控件的函数。锁定电子表格时仍可对控件进行调整）。

1）Button(Name, Trigger) 在单元格中插入带标签的按钮控件。单击它会返回 1.0；否则返回 0.0。 2）CheckBox(Name) 在单元格中插入带标签的复选框控件。选中时返回 1.0；否则返回 0.0。 3）Dialog(Label, Title, High, Wide) 创建通过带标签的按钮进行访问的对话。 4）EditAnnulus(Fixture, Move, Size, Name, Show) 在单元格中插入交互式圆环控件。 5）EditCircle(Fixture, Move, Size, Name, Show) 在单元格中插入交互式圆控件。 6）EditFloat(Min, Max) 在单元格中插入数字编辑框控件。返回一个约束在 Min 到 Max 范围中的浮点值。 7）EditInt(Min, Max) 在单元格中插入数字编辑框控件。返回一个约束在 Min 到 Max 范围中的整数。 8）EditLine(Fixture, Move Point 0, Move Point 1, Name, Show) 在单元格中插入交互式直线控件。 9）EditPoint(Fixture, Move, Name, Show) 在单元格中插入交互式点控件。 10）EditRegion(Fixture, Move, Size, Rotate, Bend, Name, Show) 在单元格中插入交互式区域控件。

11）EditString(Max String Length) 在单元格中插入字符串编辑框控件。返回约束在 0 到最大字符长度范围中的字符串。 12）Link(标签, 主机名, 对话标签/左上方单元格, 光标位置) 创建到本地机或远程传感器上的对话或单元格的链接。标签/位置可以是主电子表格中的对话、向导或单元 格位置的标签。 13）ListBox(String0, [String1, ...]) 在单元格中插入列表框。返回选定列表项从零开始的索引。 14）MessageBox(Title, Text, Status, Timeout, Style) 弹出显示输入文本的消息框。 15）Select(Title, Index, Auto, Control0, [Control1, ...]) 使用变量列表中的 Index 参数打开对话、向导、链接或选择控件的函数。 16）Wizard(Name, Mode, Dialog0, Dialog1, [Dialog2, ...]) 通过对话框集合创建向导。将 Mode 设为 0 可在“菜单”模式下运行，或设置为 1 可在“序列”模式下运行。

2. 图像（在图像上画图的函数）。

1）PlotArc(Arc, Name, Color, Show) 绘制弧。 2）PlotCircle(Circle, Name, Color, Show) 绘制圆。返回绘图结构。 3）PlotCross(Cross, Name, Color, Show) 绘制交叉标记。返回绘图结构。 4）PlotLine(Line, Name, Color, Show) 绘制直线。 5）PlotPoint(Point, Name, Color, Show) 绘制点符号。 返回绘图结构。 6）PlotRegion(Region, Name, Color, Show) 绘制区域。 7）PlotString(String, Point, Color, Show) 绘制字符串。返回绘图结构。

3. 显示（在电子表格上放置图形显示的函数）。

1）Chart(Event, Value, Number, Name, Range:Min, Range:Max) 在单元格中插入发生每个事件时更新的图表显示。 2）ColorLabel(Name, Fore Color, Back Color) 将指定颜色的字符串插入指定颜色的单元格中。 3）MultiStatus(Value, Start Bit, Number of Bits, Reverse Order, Color 0, Color 1) 显示指示位值的一行 16 个状态灯。如果相应位等于 1，则显示 Color 1 的灯；否则显示 Color 0 的灯。 4）Status(Status, Label:Green, Label:Yellow, Label:Red) 插入带有用户指定标签的模拟 LED 状态灯。 5）StatusLight(Status, Label:Positive, Label:Zero, Label:Negative, ...) 插入带有标签的模拟 LED 状态灯；状态灯和标签的颜色均可由用户指定。

四、数学（数学函数和运算符）

1、 查找（查找函数）。

1）Choose(Index, Val0, [Val1, ...]) 返回可变长度列表中的被检索参数的值。 2）Column(Cell) 返回电子表格单元格的列号。 注意：列 A = 0.0，列 Z = 25.0。 3）CountError(Cell1, [Cell2, ...]) 返回一个或多个单元格或单元格范围中的错误数。 4）ErrFree(cell or cell-range) 将 #ERR 单元格转换为空单元格，以消除错误传播。 5）If(Cond, Val1, Val2) 如果 Cond 为 TRUE，则返回 Val1；否则返回 Val2。 6）MaxI(Val0, [Val1, ...]) 返回可变长度值列表的最大值的索引。 7）MinI(Val0, [Val1, ...]) 返回可变长度值列表的最大值的索引。 8）NthMaxI(N, Val0, [Val1, ...]) 返回可变长度列表中的第 N 大的值的索引。 9）NthMinI(N, Val0, [Val1, ...]) 返回可变长度列表中的第 N 小的值的索引。 10）Row(Cell) 返回电子表格单元格的行号。 11）Switch(FindCase, Default, [Case0, Val0, Case1, Val1, ...]) 返回索引匹配项的值，否则返回默认值。

2、 逻辑（逻辑函数。TRUE = 非 0.0；FALSE = 0.0）。

1）And(Val1, Val2, [Val3, ...]) 返回可变长度值列表的逻辑与运算结果。 2）BitAnd(Val1, Val2, [Val3, ...]) 返回可变长度值列表的按位与运算结果。 注意：只处理较低的 16 位。 3）BitNot(Val) 返回 Val 的逻辑取反运算结果。 注意：只处理较低的 16 位。 4）BitOr(Val1, Val2, [Val3, ...]) 返回可变长度值列表的按位或运算结果。 注意：只处理较低的 16 位。 5）BitXor(Val1, Val2, [Val3, ...]) 返回可变长度值列表的按位异或运算结果。 注意：只处理较低的 16 位。 6）If(Cond, Val1, Val2) 如果 Cond 为 TRUE，则返回 Val1；否则返回 Val2。 7）InRange(Val, Start, End) 如果 Min(Start,End) <= Val <= Max(Start,End)，则返回 TRUE。 8）Not(Val) 返回 Val的逻辑取反运算结果。 9）Or(Val1, Val2, [Val3, ...]) 返回可变长度值列表的逻辑或运算结果。

3、 三角学（三角函数）。

1）ACos(Val) 返回 Val 的反余弦值（度）。 2）ASin(Val) 返回 Val 的反正弦值（度）。 3）ATan(Val) 返回 Val 的反正切值（+/-90 度）。 4）ATan2(DY, DX) 返回向量 (DY, DX) 的反正切值（+/-180 度）。 5）Cos(Angle) 返回相应角（单位为度）的余弦值。 6）Degrees(Radians) 给出以弧度为单位的角度时返回以度为单位的角度。 7）Pi 返回圆周率的值。 8）Radians(Degrees) 给出以角度为单位的角时，返回以弧度为单位角。 9）Sin(Angle) 返回以度为单位的角的正弦值。 10）Tan(Angle) 返回以度为单位的 Angle 的正切值。

4、 数学（算术函数）。

1）Abs(Val) 返回 Val 的绝对值。 2）Exp(Val) 返回 e 的 Val 次幂的值。 3）Mod(Val1, Val2) 返回 Val1 除以 Val2 的余数。 4）Power(Base, Exp) 返回 Exp 次方的 Base。 5）Rand(Event) 返回随机数：0.0 <= num < 1.0。每个事件触发一个新的随机数字。 注意：Rand 必须是单元格中的唯一项。 6）Round(Val) 返回被圆整为最邻近整数值的 Val。 7）RoundDown(Val) 返回与 Val 邻近的较小下舍入整数值。 8）RoundUp(Val) 返回被截断成相邻更大整数的 Val。 9）Sqrt(Val) 返回 Val 的平方根。 10）Sum(Val1, [Val2, ...]) 返回可变长度列表的值的总和。 11）Trunc(Val) 返回被截成整数的 Val。所得结果是不含小数部分的 Val。

5、 统计（统计函数）。

1）ComputeStats(事件, 值, 脱机计数,...) 计算所引用值的统计信息。 2）Max(Val0, [Val1, ...]) 返回可变长度值列表的最大值。 3）Mean(Val0, [Val1, ...]) 返回可变长度值列表的平均值。 4）Min(Val0, [Val1, ...]) 返回可变长度值列表的最小值。 5）NthMax(N, Val0, [Val1, ...]) 返回可变长度列表中的第 N 大的值。 6）NthMin(N, Val0, [Val1, ...]) 返回可变长度列表中的第 N 小的值。 7）SDev(Val1, Val2, [Val3, ...]) 返回可变长度值列表的标准偏差。

6、 运算符

五、文本（打印和处理字符串或二进制数据的函数）

1、 二进制（处理二进制数据的函数）。

1）BGetFloat(Binary, Offset, [Endian]) 返回 Binary 结构中的浮点值。 Offset：以字节为单位的偏移。 Endian：0 = big ? endian（默认）、1 = little ? endian。 2）BGetInt(Binary, Offset, Bytes, [Sign], [Endian]) 返回 Binary 结构中的整数值。 Offset：以字节为单位的偏移。Bytes：1、2 或 4。 Sign：0 = 有符号（默认）、1 = 无符号。 Endian：0 = big ? endian（默认）、1 = little ? endian。 3）BGetString(Binary, Offset, Bytes) 返回 Binary 结构中的字符串。 Offset：以字节为单位的偏移。 Bytes：要提取的长度。 4）BLen(Binary) 返回 Binary 结构中的长度。 5）BStringf(Endian, Format-String, Value, ...) 根据指定的格式构造一个二进制结构。 Endian：0=big-endian、1=little-endian。格式字符串: %c=1 字节；%h=2 字节；%d=4 字节；%f=4 字节 浮点值；%b=二进制结构；%s=字符串；

2、 字符串（处理字符串的函数）。

1）Code(Text) 返回文本字符串中第一个字符的代码。 2）Concatenate(Arg1, [Arg2, ...]) 连接可变数量的参数。返回一个字符串。 注意：将数字参数转换成文本。 3）Exact(Text1, Text2) 将 Text1 与 Text2 进行比较。如果相等，则返回 1.0；否则返回 0.0。 注意：Exact 区分大小写。 4）Find(FindText, SrcText, [StartChar]) 在 SrcText 内从 StartChar 开始查找 FindText。返回第一个匹配字符的索引。 注意：Find 函数区分大小写并从第一个字符开始查找。 5）FormatString(格式字符串, [文本或值, ...]) 返回一个格式为 %format-string 的字符串。格式字符串：%c=字符；%d=整数；%f=浮点；%o=八进制；%s= 字符串；%u=无符号；%x 或 %X=十六进制；%e=科学符号。 6）Left(Text, NumChars) 返回 Text 的最左侧的字符。 7）Len(Text) 返回 Text 中的字节数。 8）Lower(Text) 返回自 Text 转换的小写字符串。 9）Mid(Text, StartChar, NumChars) 返回 Text 中自指定位置开始的指定数目的字符。StartChar：指 Text 中从零开始的索引。NumChars 是要 返回的字符数。 10）Replace(SrcText, StartChar, NumChars, NewText) 用 NewText 替换 SrcText 中从 StartChar 开始的字符。返回经 NewText 修改后的 SrcText。 StartChar：一个索引。NumChars：要替换的数量。NewText：要插入的文本。 11）Right(Text, NumChars) 返回 Text 中最右侧的字符。NumChars 为返回的字符数。 12）Strcspn(SrcText, CharList) 在 SrcText 内搜索 CharList（字符集）中所包含的第一个字符。返回 SrcText 中第一个匹配字符的索引。 注意：Strcspn 区分大小写。 13）Stringf(Format-String, [Text or Value, ...]) 返回一个格式为 %format-string 的字符串。格式字符串为：%c=字符；%d=整数；%f=浮点；%o=八进制；%s= 字符串；%u=无符号；%x 或 %X=十六进制；%H=主机名；%I=IP 地址；%e=科学符号。 14）Strspn(SrcText, CharList) 在 SrcText 内搜索 CharList 字符集中不包含的第一个字符。返回 SrcText 中第一个非匹配字符的索引。 注意：Strspn 区分大小写。 15）Strtol(IntegerText) 将一个以整数开始的文本字符串转换成其对应的整数值。返回一个整数。 注意：忽略随后的非整数字符并截断浮点输入值。 16）Substitute(SrcText, OldText, NewText, [Instance]) 使用 NewText 替换 SrcText 内的 OldText。返回编辑后的字符串。 注意：除非指定一个 Instance 编号，否则替换所有实例。 17）Token(Text, Delimiter, Instance) 从具有指定分隔符的列表中返回 Text 的一个指定 Instance。 18）Trim(Text) 删除 Text 的开头、结尾和内部的多余空格。返回编辑后的字符串。 注意：Trim 会在各词之间保留一个空格。 19）Upper(Text) 返回自 Text 转换的大写字符串。 20）Value(NumericText) 将以数字值开始的文本字符串转换成其相应值。返回一个数字值。 注意：该值忽略随后的非数字字符。

六、坐标变换（在坐标系统之间映射点的函数）

1、 定位器（在固定坐标系和像素坐标系之间映射的函数）。

1）TransBlobsToFixture(Fixture, Blobs, Number to Convert) 对斑点结构进行固定坐标变换。返回转变为固定坐标的斑点结构。 2）TransEdgesToFixture(Fixture, Edges, Number to Convert) 对边结构进行固定坐标变换。返回转变为固定坐标的边结构。 3）TransFixtureToPixel(Fixture, Point, Show) 将某个点的固定坐标转换成像素坐标。返回点结构。 4）TransPatternsToFixture(Fixture, Patterns, Number to Convert) 对图案结构进行固定坐标变换。返回转变为固定坐标的图案结构。 5）TransPixelToFixture(Fixture, Point, Show) 将某个点的像素坐标转换成固定坐标。返回点结构。

2、 校准（建立或使用坐标变换的函数）。

1）Calibrate(Pixel Point 0, World Point 0, Pixel Point 1, ...) 从四个已知点构造坐标变换。返回 Calib 结构。 2）CalibrateAdvanced(Pixel Row 0, Pixel Col 0, World X 0, World Y 0, ...) 从一到九个已知点对构造坐标变换。 返回 Calib 结构。 3）CalibrateGrid(图像) 使用正方形网格来校准系统。 4）CalibrateImage(图像, 校准) 将某校准结果与图像关联。引用结果的工具根据模式，按像素或校准的单位显示其数据。 5）ExtractCalibration(图像) 从变换的图像中提取校准。返回 Calib 结构。 6）TransBlobsToWorld(Calib, Blobs, Number to Convert) 对斑点结构进行坐标变换。返回转变为全局坐标的斑点结构。 7）TransEdgesToWorld(Calib, Edges, Number to Convert) 对边结构进行坐标变换。 返回转变为全局坐标的边结构。 8）TransFixtureToWorld(Calib, Fixture, Show) 将在像素坐标系中的固定坐标转换成场景坐标系中的固定坐标。返回固定坐标结构 9）TransformImage(图像, 校准, 区域, 显示) 基于 CalibrateGrid 变换纠正图像失真。返回存储已处理图像的 Image 结构。 10）TransPatternsToWorld(Calib, Patterns, Number to Convert) 对图案结构进行坐标变换。返回转变为全局坐标的图案结构。 11）TransPixelToWorld(Calib, Point, Show) 将某个点的像素坐标转换成全局坐标。返回点结构。 12）TransWorldToPixel(Calib, Point, Show) 将某个点的全局坐标转换成像素坐标。返回点结构。

七、输入/输出（与外部设备通信及定义更新电子表格的事件的函数）

1、 MachineStatus（存储 In-Sight 传感器的运行状态信息的函数）。

1）PushMSStack(Event) 将每个缓冲器的内容转移到机器状态堆栈的下一个缓冲器中。 2）WriteMSStack(事件, 字符串) 将字符串添加到机器状态堆栈的第一个缓冲器中的运行状态信息上。（字符串的最大长度为 255）。

2、 离散（读取和写入离散 I/O 的函数）。

1）ReadCameraTrigger(Event) Reads the state of the camera trigger. Returns the state as a value (0 = OFF, 1 = ON). 2）ReadDiscrete(Event, Start Bit, Number of Bits) 读取一系列输入位。 3）WriteDiscrete(事件, 开始位, 位数, 值) 将电子表格中的值写入一系列离散输出位。

3、 时间/定时器（报告执行单元格时间、从内部时钟读取日期和时间并在指定间隔后或于指定时间 触发事件的函数）。

1）Now(Event) 从内部时钟读取日期和时间，并将相应日期和时间作为格式化文本字符串插入。返回时间结构。 2）Sleep(持续时间, Cell1, [Cell2, ...]) 在指定的毫秒数内暂停执行作业。暂停发生在最后一个引用的单元格执行完毕后。 3）Timer(Time-String, Trigger) 在指定的间隔后或每天在指定的时间触发电子表格事件。

4、 网络（读取和写入网络的函数）。

1）Packet(Length Location, Length Size, Endian, Length Adjustment, Buffer Size, Format String) 定义将由 TCPDevice 函数读取或发送的二进制信息包格式。返回信息包结构。 2）QueryDevice(Event, Device, Data) 将数据写入指定的设备，然后从同一设备读取数据。设备必须为客户端类型。返回查询结构。 3）ReadDevice(Device) 接收来自指定设备的数据。返回读取结构。 4）ReadEIP(Event, MapSpec) 使用以太网/IP 协议将来自以太网的数据读入（消费）到电子表格。使用“映射”分析数据。返回 ReadEIP 结 构。 5）ReadEIPBuffer(事件, 缓冲区) 使用Ethernet/IP 协议将来自以太网的数据读入（取出）到电子表格。使用 FormatInputBuffer 分析数据。 返回 ReadEIP 结构。 6）ReadResult(AcquireCell, HostName, Timeout) 读取来自网络发送者的结果。返回结果结构。 7）TCPDevice(HostName, Port, Protocol, Packet, Timeout) 定义 TCP/IP 插槽设备。返回设备结构。 8）WriteDevice(Event, Device, Data1, [Data2, ...]) 将数据写入指定的设备。返回写入结构。 9）WriteEIP(事件, MapSpec, Value1, [Value2, ...]) 通过Ethenet /IP 协议从电子表格中写入一个或多个值，格式由 MapSpec 确定。 10）WriteEIPBuffer(事件, 缓冲区) 通过Ethernet/IP 协议从电子表格中写入一个或多个值，格式由 FormatOutputBuffer 单元格确定。 11）WriteFTP(事件, 主机名, 用户名, 密码, 文件名, 存储数据格式, 字符串, 添加) 将字符串写入或添加到 FTP 服务器上的指定文件中。返回 FTP 结构。 12）WriteImageFTP(事件, 主机名, 用户名, 密码, 图像, 文件名, 最大存储数量, 重置, 存储数据格式, 屏 幕捕捉) 将当前图像发送到指定 FTP 服务器。返回 FTP 结构。 13）WriteResult(事件, Cell1, [Cell2, ...]) 将指定单元格的数据传输给网络接收者。返回结果结构。 14）WriteSMTP(事件, SMTPServer, 收件人, 抄送, 发件人, 主题, 重要性, 图像附件, 图像格式, 屏幕捕捉, 消息文本) 发送电子邮件消息。该消息可包含图像附件。返回 SMTP 结构。

5、 消息（通过本机模式连接读写文本字符串的函数）。

1）ReadMessage(Event) 从本机模式连接将输入字符串读入电子表格。 返回字符串。 2）WriteMessage(事件, 字符串) 通过Native模式连接写出字符串。返回字符串。

6、 序列（读取和写入串行 I/O 的函数）。

1）ReadDeviceNet(Event, Port, Mapping, Compatibility) 通过 Port 将 DeviceNet 中的数据读入电子表格。使用 Mapping 分析该数据。返回 ReadDeviceNet 数据 结构。 2）ReadDeviceNetBuffer(事件, 端口, 缓冲区) 通过端口将 DeviceNet 中的数据读入电子表格。使用 FormatInputBuffer 分析该数据。返回 ReadDeviceNet 数据结构。 3）ReadSerial(Event, Port) 从串行端口将输入字符串读入电子表格。返回字符串。 4）WriteDeviceNet(事件, 端口, MapSpec, 兼容性, Value1, [Value2, ...]) 通过端口将电子表格中的一个或多个值写入 DeviceNet，格式由 MapSpec 确定。 5）WriteDeviceNetBuffer(事件, 端口, 缓冲区) 通过端口将电子表格中的一个或多个值写入 DeviceNet，格式由 FormatOutputBuffer 单元格确定。 6）WriteSerial(事件, 端口, 字符串) 将字符串写入指定的串行端口。

八、定时数据存储（保留运行合计的函数）

1、Accumulate(事件, 值, 重设, 预设) 保存某个指定值的运行合计。返回当前累计总数。与 ClockedSum 不同，该函数使用上一作业执行的值。 2、ClockedMax(事件, 值, 重设, 预设) 返回一个运行最大值。3、ClockedMin(事件, 值, 重设, 预设) 返回一个运行最小值。 4、ClockedSum(事件, 值, 重设, 预设) 保存某个指定值的运行合计。返回当前累计总数。 5、Count(Event, Max Value, Reset, Preset) 以指定整数开始，每发生一个事件加一。 返回当前运行合计。 6、CountPassFail(事件, 值, 脱机计数,...) 计数并返回给定引用值的通过、失败、错误和总事件数。通过：值 > 0；失败：值 = 0；#ERR：值 < 0。 7、DelayLine(事件, 数据, 步数, 重设) 缓存某个值的历史。返回存储相应缓冲器的延时结构。与 ShiftRegister 不同，该函数使用上一作业执行的 值。 8、Latch(Event, Value) 根据每个事件返回值。 9、LatchString(Event, String) 根据每个事件返回字符串。 10、Maximum(事件, 值, 重设, 预设) 返回一个运行最大值。与 ClockedMax 不同，该函数使用上一作业执行的值。 11、Minimum(事件, 值, 重设, 预设) 返回一个运行最小值。与 ClockedMin 不同，该函数使用上一作业执行的值。 12、ShiftRegister(事件, 数据, 步数, 重置) 缓存某个值的历史。返回存储缓冲区的 ShiftRegister 结构。

九、视觉数据访问（从数据结构获取值的函数）

1、CircleFit（从 CircleFit 结构获取值的函数）。 1）GetCol(Structure, [Index1], [Index2]) 返回一个列坐标。 注意：注意：Index2（仅限边）指定一个端点（0 或 1）。 2）GetDistance(Structure, [Index]) 返回距离值。 3）GetMaxDist(Structure) 返回各输入点到对象的最大距离。 4）GetMaxDistIndex(Structure) 返回距离对象最远的输入点的索引。 5）GetNPointsUsed(Structure) 返回使用的点数。 6）GetRadius(Structure, [Index]) 返回指定圆或弧的半径。 7）GetRow(Structure, [Index1], [Index2]) 返回一个行坐标。 注意：Index2（仅限边）指定一个端点（0 或 1）。 8）GetSigma(CircleFit) 返回 sigma 值。 2、Clocked Data Storage(从 Count 结构获取值的函数)。 1）GetCount(Structure)返回计数值。 2）GetErrorCount(结构) 返回二维符号中发现的错误数。必须选中 ID 工具中的“检验”复选框。 注意：引用 Count 或 Stats 结构时将会返回错误数。 3）GetFailCount(Structure) Returns number of failed results. 4）GetMax(Structure) 返回最大值。 5）GetMean(Structure) 返回平均值。 6）GetMin(Structure) 返回最小值。 7）GetPassCount(Structure) Returns number of pass results. 8）GetSDev(Structure) 返回标准偏差值。 9）GetSum(Structure) 返回和数值。 10）GetTotalCount(Structure) Returns total number of results. 11）GetValue(Structure, Index) Hist：返回指定容器内的值数目。 延时：在指定的时间增量后返回值。 3、Dist（从 Dist 结构获取值的函数）。 1）GetAngle(Structure, [Index]) 返回角度值。 2）GetCol(Structure, [Index1], [Index2]) 返回一个列坐标。 注意：注意：Index2（仅限边）指定一个端点（0 或 1）。 3）GetDistance(Structure, [Index]) 返回距离值。 4）GetRow(Structure, [Index1], [Index2]) 返回一个行坐标。 注意：Index2（仅限边）指定一个端点（0 或 1）。 4、Hist（从 Hist 结构获取值的函数）。 1）GetValue(Structure, Index) Hist：返回指定容器内的值数目。 延时：在指定的时间增量后返回值。 5、IDCode（从 IDCode 结构获取值的函数）。 1）GetAngle(Structure, [Index]) 返回角度值。 2）GetBarSkew(Structure) 返回各条的平均倾斜值。 3）GetBarSpace(Structure) 返回条间的平均间距。 4）GetBarWidth(Structure) 返回各条的平均宽度。 5）GetCodeName(Structure) 返回 ReadIDCode 函数中代码类型的名称。 6）GetCodeType(Structure) 返回 ReadIDCode 函数中代码类型的值。 7）GetCol(Structure, [Index1], [Index2]) 返回一个列坐标。 注意：注意：Index2（仅限边）指定一个端点（0 或 1）。 8）GetColor(Structure, [Index]) 返回颜色值，0.0 代表黑色，1.0 代表白色。 9）GetContrast(Structure, [Index]) 以灰度级别方式返回前景和背景之间的对比度。 注意：对于 PatMax 和 ID 工具，会返回对比度百分比；而对于 ID 工具，必须选中“检验”复选框。 10）GetDecodability(Structure) 返回符号（所有字符、所有扫描线）的最小可解码性。 11）GetDefect(Structure) 返回最大元素反射系数不一致性与平均符号对比度的比值。 12）GetECLevel(Structure) 返回二维符号的纠错级别。必须选中 ID 工具中的“检验”复选框。 13）GetECMin(Structure) 返回符号中连续元素间的最小边响应。 14）GetErrorCount(结构) 返回二维符号中发现的错误数。必须选中 ID 工具中的“检验”复选框。 注意：引用 Count 或 Stats 结构时将会返回错误数。 15）GetFormat(Structure) 返回二维符号函数中符号格式的值。 16）GetGrade(Structure, [Structure]) 返回一维或二维符号的总体质量等级。必须选中 ID 工具中的“检验”复选框。如果提供第二个 IDCode 结构，请测试 RSS/CS 等级和连接。 17）GetGridCols(Structure) 返回二维符号中的列数。 18）GetGridRows(Structure) 返回二维符号中的行数。 19）GetGrowth(Structure) 返回二维符号的打印增长的测试结果。必须选中 ID 工具中的“检验”复选框。 20）GetHigh(Structure, [Index]) 返回高度值。 21）GetLearned(Structure) 返回 ID 符号的学习状态，0.0 表示无效或未学习，而 1.0 表示有效。 22）GetLearnedGridCol(IDCode) 返回学习“QR 码”或“数据矩阵”符号中的列数。23）GetLearnedGridRow(IDCode) 返回学习“QR 码”或“数据矩阵”符号中的行数。 24）GetMaxBarSkew(Structure) 返回各条的最大倾斜值。 25）GetMaxBarSpace(Structure) 返回条间的最大间距。 26）GetMaxBarWidth(Structure) 返回最宽条的宽度。 27）GetMaxContrast(Structure) 返回最大对比度值。 28）GetMinBarSkew(Structure) 返回各条的最小倾斜值。 29）GetMinBarSpace(Structure) 返回条间的最小间距。 30）GetMinBarWidth(Structure) 返回最窄条的宽度。 31）GetMinContrast(Structure) 返回最小对比度值。 32）GetMirror(Structure) 返回符号是否被镜像，0.0 表示未被镜像，1.0 表示被镜像。 33）GetModulation(Structure) 返回最小边响应 (ECMin) 与符号平均对比度的比值。 34）GetNBars(Structure) 返回条码中发现的条数。 35）GetNonUniformity(Structure) 返回二维符号的轴向不一致性的测试结果。必须选中 ID 工具中的“检验”复选框。 36）GetNumEdges(Structure) 返回每条有效扫描线从被检验符号各组分找到的边的总数。 37）GetQuietZonesCheck(Structure) 返回在符号空白区发现的最大不均匀性与平均符号对比度的比值。 38）GetRawStream(Structure) 返回读取符号中的未解码数据流。 39）GetReflectanceDark(Structure) 返回符号的暗色（最小）反射系数。 40）GetReflectanceLight(Structure) 返回符号的亮色（最大）反射系数。 41）GetResolution(Structure) 返回 ID 符号主要特征的分辨率（以像素表示）。 对于二维符号，分辨率为平均单元大小。 对于一维符号，分辨率为最小条宽度。 42）GetRow(Structure, [Index1], [Index2]) 返回一个行坐标。 注意：Index2（仅限边）指定一个端点（0 或 1）。 43）GetSDevBarSkew(Structure) 返回各条的倾斜值标准偏差。 44）GetSDevBarSpace(Structure) 返回条间间距的标准偏差。 45）GetSDevBarWidth(Structure) 返回条宽的标准偏差。 46）GetSDevContrast(Structure) 返回对比度值的标准偏差。 47）GetString(Structure) 返回引用的 Structure 中的字符串。 注意：仅限 AcquireImage，返回由网络“主系统”发送的字符串。 48）GetUnusedEC(Structure) 返回二维符号中未使用纠错的百分比。必须选中 ID 工具中的“检验”复选框。 49）GetWide(Structure, [Index]) 返回宽度值。 6、IDValidate（从 IDVal 结构获取值的函数）。 1）GetCAGECode(结构) 返回 DoD UID 数据中的“箱代码”。 2）GetCAGECodeID(结构) 返回表示 DoD UID 数据中的“箱代码”的标识符。 3）GetDataFormat(结构, [索引]) 返回用于对数据解码的格式。 4）GetDiagnosticsCode(结构) 返回诊断代码。 5）GetDiagnosticsString(结构) 返回诊断信息。 6）GetFieldData(结构, 索引) 返回 Index'th 字段中编码的数据。 7）GetFieldIdentifier(结构, 索引) 返回 Index'th 字段中编码的标识符。 8）GetGTIN(结构) 返回 DoD UID 数据中的 GTIN（箱代码 + 箱代码内的原始部件号）。 9）GetGTINID(结构) 返回表示 DoD UID 数据中 GTIN（箱代码 + 箱代码内的原始部件号）的标识符。 10）GetInvalidDataLength(结构) 返回有错误的数据子字符串的长度。 11）GetInvalidDataPosition(结构) 返回有错误的数据子字符串的起始位置。 12）GetNumDataFormats(结构) 返回用于为数据编码的格式数。 13）GetNumFields(结构) 返回数据中编码的字段数。 14）GetPartNum(结构) 返回 DoD UID 数据中的“部件号”。 15）GetPartNumID(结构) 返回表示 DoD UID 数据中“部件号”的标识符。16）GetSerialNum(结构) 返回 DoD UID 数据中的“序列号”。 17）GetSerialNumID(结构) 返回表示 DoD UID 数据中“序列号”的标识符。 18）GetUID(结构) 返回 DoD UID 数据中的 UID。 19）GetUIDID(结构) 返回表示 DoD UID 数据中 UID 的标识符。 20）GetValid(结构) 返回引用的数据流是否有效。 7、IDVerify（从 IDVerify 结构获取值的函数）。 1）Get2DModulation(IDVerify) Returns ISO 15415 Modulation of the 2D symbol. The ISO 15415 metrics must be enabled. 2）GetBkgdUniformity(IDVerify) 测量符号背景亮度的变化。 3）GetCellSeparability(IDVerify) 测量符号内前景和背景单元的差异程度。 4）GetContrast(Structure, [Index]) 以灰度级别方式返回前景和背景之间的对比度。 注意：对于 PatMax 和 ID 工具，会返回对比度百分比；而对于 ID 工具，必须选中“检验”复选框。 5）GetDistortionAngle(IDVerify) 返回符号的 X 与 Y 轴之间角度减去 90 度（垂直）所得的角度误差度数。 6）GetDistortionAngleGrade(Structure) 返回畸变角的 AS9132 等级。 7）GetDotCenter(IDVerify) 表示符号内单元的中心与其期望位置的拟合程度百分比。 8）GetDotDiameter(IDVerify) 返回各单元直径的平均值，表示成期望单元直径的百分比。 9）GetDotOvality(IDVerify) 返回各单元宽度和高度的平均差值，表示为期望单元大小的百分数。 10）GetExtremeReflectance(IDVerify) Returns ISO 15415 Extreme Reflectance for the 2D symbol. The ISO 15415 metrics must be enabled. 11）GetFinderConfCon(IDVerify) 测量符号的定位图形的连贯性（依据 AIM 规范）。 12）GetFinderConfDot(IDVerify) 测量点喷符号的定位图形符合 AIM 规范的程度。 13）GetFixedPatternDamage(IDVerify) Returns ISO 15415 Fixed Pattern Damage metric of the 2D symbol. The ISO 15415 metrics must be enabled. 14）GetGrade(Structure, [Structure]) 返回一维或二维符号的总体质量等级。必须选中 ID 工具中的“检验”复选框。如果提供第二个 IDCode 结构，请测试 RSS/CS 等级和连接。 15）GetGridNonUniformity(IDVerify) Returns ISO 15415 Grid Non-unifromity of the 2D symbol. The ISO 15415 metrics must be enabled. 16）GetGrowth(Structure) 返回二维符号的打印增长的测试结果。必须选中 ID 工具中的“检验”复选框。 17）GetGrowthHorizontal(Structure) 返回沿二维符号水平方向的打印增长。 18）GetGrowthVertical(Structure) 返回沿二维符号垂直方向的打印增长。 19）GetIAQGOverallGrade(Structure) 返回依据 IAQG 9132 规格的总体符号等级。 20）GetImageSharpness(IDVerify) 测量图像中各边的清晰度。 21）GetNonUniformity(Structure) 返回二维符号的轴向不一致性的测试结果。必须选中 ID 工具中的“检验”复选框。 22）GetNoReadStatus(Structure) 返回诊断码以提供有关 ReadIDCode 失败的信息。 23）GetNoReadString(Structure) 返回诊断字符串以提供有关 ReadIDCode 失败的信息。 24）GetPercDotOSFail(Structure) 返回符号中超出点大小或椭圆度范围的 ON 单元格的百分比。 25）GetPercDotOSFailGrade(Structure) 返回超出点大小或椭圆度范围的 ON 单元格百分比的 AS9132 等级。 26）GetPercDotPositionFail(Structure) 返回符号中超出位置公差范围的 ON 单元格的百分比。 27）GetPercDotPositionFailGrade(Structure) 返回超出位置公差范围的 ON 单元格百分比的 AS9132 等级。 28）GetRefDecode(IDVerify) 指示符号是否被成功解码。 29）GetSDevDotCenter(IDVerify) 测量点位置偏移错误的标准偏差。 30）GetSDevDotDiameter(IDVerify) 返回所有单元直径的标准偏差。 31）GetSDevDotOvality(IDVerify) 返回各单元宽度和高度间的标准偏差百分数。 32）GetSymSeparability(IDVerify) 测量符号与其环境的差异度。 33）GetUnusedEC(Structure) 返回二维符号中未使用纠错的百分比。必须选中 ID 工具中的“检验”复选框。 8、LineFit（从 LineFit 结构获取值的函数）。 1）GetChi2(LineFit) 返回 chi 平方的值。 2）GetCol(Structure, [Index1], [Index2]) 返回一个列坐标。注意：注意：Index2（仅限边）指定一个端点（0 或 1）。 3）GetDistance(Structure, [Index]) 返回距离值。 4）GetMaxDist(Structure) 返回各输入点到对象的最大距离。 5）GetMaxDistIndex(Structure) 返回距离对象最远的输入点的索引。 6）GetNPointsUsed(Structure) 返回使用的点数。 7）GetRow(Structure, [Index1], [Index2]) 返回一个行坐标。 注意：Index2（仅限边）指定一个端点（0 或 1）。 9、斑点（从斑点结构获取值的函数）。 1）GetAngle(Structure, [Index]) 返回角度值。 2）GetArea(Structure, [Index]) 返回面积值。 3）GetCol(Structure, [Index1], [Index2]) 返回一个列坐标。 注意：注意：Index2（仅限边）指定一个端点（0 或 1）。 4）GetColor(Structure, [Index]) 返回颜色值，0.0 代表黑色，1.0 代表白色。 5）GetElongation(Blobs, [Index]) 返回延长值。 6）GetHoles(Blobs, [Index]) 返回孔个数。 7）GetMaxCol(Structure, [Index]) 返回最大（最右侧）列坐标。 8）GetMaxColRow(Structure, [Index]) 返回最大（最右侧）列坐标处的行坐标。 9）GetMaxRow(Structure, [Index]) 返回最大（最底部）行坐标。 10）GetMaxRowCol(Structure, [Index]) 返回最大（最底部）行坐标处的列坐标。 11）GetMinCol(Structure, [Index]) 返回最小（最左侧）列坐标。 12）GetMinColRow(Structure, [Index]) 返回最小（最左侧）列坐标处的行坐标。 13）GetMinRow(Structure, [Index]) 返回最小（最顶端）行坐标。 14）GetMinRowCol(Structure, [Index]) 返回最小（最顶端）行坐标处的列坐标。 15）GetNFound(Structure) 返回所找到数量的值。16）GetPerimeter(Structure, [Index]) 返回周长值。 17）GetRow(Structure, [Index1], [Index2]) 返回一个行坐标。 注意：Index2（仅限边）指定一个端点（0 或 1）。 18）GetScore(Structure, [Index1], [Index2]) 返回分数值（0-100）。 19）GetSpread(Blobs, [Index]) 返回扩展值。 20）GetThresh(Structure) 返回手工或最佳的二进制阀值。 10、边（从边结构获取值的函数）。 1）GetAngle(Structure, [Index]) 返回角度值。 2）GetCol(Structure, [Index1], [Index2]) 返回一个列坐标。 注意：注意：Index2（仅限边）指定一个端点（0 或 1）。 3）GetContrast(Structure, [Index]) 以灰度级别方式返回前景和背景之间的对比度。 注意：对于 PatMax 和 ID 工具，会返回对比度百分比；而对于 ID 工具，必须选中“检验”复选框。 4）GetMax(Structure) 返回最大值。 5）GetMin(Structure) 返回最小值。 6）GetNFound(Structure) 返回所找到数量的值。 7）GetRadius(Structure, [Index]) 返回指定圆或弧的半径。 8）GetRow(Structure, [Index1], [Index2]) 返回一个行坐标。 注意：Index2（仅限边）指定一个端点（0 或 1）。 9）GetScore(Structure, [Index1], [Index2]) 返回分数值（0-100）。 10）GetSDev(Structure) 返回标准偏差值。 11、结构（从圆环、圆、交叉、固定位置、线、点或区域结构获取值的函数）。 1）GetAngle(Structure, [Index]) 返回角度值。 2）GetCol(Structure, [Index1], [Index2]) 返回一个列坐标。 注意：注意：Index2（仅限边）指定一个端点（0 或 1）。 3）GetCurve(Structure) 返回弯曲角度值（逆时针度数）。4）GetHigh(Structure, [Index]) 返回高度值。 5）GetRadius(Structure, [Index]) 返回指定圆或弧的半径。 6）GetRow(Structure, [Index1], [Index2]) 返回一个行坐标。 注意：Index2（仅限边）指定一个端点（0 或 1）。 7）GetWide(Structure, [Index]) 返回宽度值。 12、控件（从"图形"函数获取值的函数）。 1）GetString(Structure) 返回引用的 Structure 中的字符串。 注意：仅限 AcquireImage，返回由网络“主系统”发送的字符串。 13、时间/定时器（报告执行单元格时间、从内部时钟读取日期和时间并在指定间隔后或于指定时间触发事件的函 数）。 1）GetAllTime(图像) 返回作业的执行时间（毫秒）。 注意：必须在单元格 A0 中引用 AcquireImage 函数。 2）GetElapsedTime(图像) 返回两次连续图像采集之间的时间（毫秒）。 注意：必须在单元格 A0 中引用 AcquireImage 函数。 3）GetTime(Cell1, [Cell2, ...]) 返回单元格的执行时间（毫秒） 14、输入/输出（从输入/输出结构获取值的函数）。 1）GetClock(Time, Format-String) 返回包含日期和时间的格式化字符串。 2）GetDeviceNetData(DNData, Index) 从 DNData 结构返回被检索的数据项。 3）GetEIPData(ReadEIPData, Index) 返回 ReadEIPData 结构的被检索数据项。 4）GetFilename(FTP) 返回 FTP 结构的文件名。 5）GetResult(Result, Index) 返回由网络发送者发送的结果。 15、统计（统计函数）。 1）GetErrorCount(结构) 返回二维符号中发现的错误数。必须选中 ID 工具中的“检验”复选框。 注意：引用 Count 或 Stats 结构时将会返回错误数。 2）GetLatest(结构) 返回 ComputeStats 引用的最新有效值。 3）GetMax(Structure) 返回最大值。 4）GetMean(Structure) 返回平均值。 5）GetMin(Structure) 返回最小值。 6）GetNumSamples(结构) 返回用于计算的样品总数。 7）GetRange(结构) 返回最小和最大值之间的范围。 8）GetSDev(Structure) 返回标准偏差值。 9）GetSum(Structure) 返回和数值。 10）GetVariance(Structure) Returns the variance in the calculated value across the current image. For ComputeStats returns the variance for the referenced value. 16、图案（从图案结构获取值的函数）。 1）GetAngle(Structure, [Index]) 返回角度值。 2）GetClutter(Structure, [Index]) 返回 PatMax 训练的图案匹配的混乱程度得分。 3）GetCol(Structure, [Index1], [Index2]) 返回一个列坐标。 注意：注意：Index2（仅限边）指定一个端点（0 或 1）。 4）GetContrast(Structure, [Index]) 以灰度级别方式返回前景和背景之间的对比度。 注意：对于 PatMax 和 ID 工具，会返回对比度百分比；而对于 ID 工具，必须选中“检验”复选框。 5）GetCoverage(Structure, [Index]) 返回 PatMax 训练的图案匹配的覆盖百分比。 6）GetErrorCode(Structure) Returns diagnostic code if function fails. 7）GetFitError(Structure, [Index]) 返回 PatMax 训练的图案匹配的拟合错误得分。 8）GetGrainCoarse(Structure) 返回由 TrainPatMaxPattern 自动计算的粗糙粒度或手动输入的相应值。 9）GetGrainFine(Structure) 返回由 TrainPatMaxPattern 自动计算的精细粒度或手动输入的相应值。 10）GetInfoString(Patterns, [Index]) 返回图案的信息字符串。 11）GetNFound(Structure) 返回所找到数量的值。 12）GetOutsideArea(Patterns, [Index]) 返回在搜索区外找到的匹配区域的百分比。 13）GetOutsideFeatures(Patterns, [Index]) 返回在搜索区外找到的匹配特性百分比。 14）GetRow(Structure, [Index1], [Index2]) 返回一个行坐标。 注意：Index2（仅限边）指定一个端点（0 或 1）。 15）GetScale(Structure, [Index]) 返回缩放值。 16）GetScaleX(Structure, [Index]) 返回 X 方向的缩放比例。 17）GetScaleY(Structure, [Index]) 返回 Y 方向的缩放比例。 18）GetScore(Structure, [Index1], [Index2]) 返回分数值（0-100）。 19）GetTrained(Patterns) 如果 TrainPatMaxPattern 成功训练了图案，则返回 1，否则返回 0。 17、图像（从图像结构获取值的函数）。 1）GetArea(Structure, [Index]) 返回面积值。 2）GetBrightPixelCount(Image) 返回大于阈值的像素数。 3）GetCol(Structure, [Index1], [Index2]) 返回一个列坐标。 注意：注意：Index2（仅限边）指定一个端点（0 或 1）。 4）GetDarkPixelCount(Image) 返回小于阈值的像素数。 5）GetExposure(Image) 返回最近采集的曝光时间（以毫秒为单位）。 注意：必须在单元格 A0 中引用 AcquireImage 函数。 6）GetHigh(Structure, [Index]) 返回高度值。 7）GetPixelValue(Image, Fixture, Point) 返回图像中指定点的灰度值（0-255）。 8）GetRow(Structure, [Index1], [Index2]) 返回一个行坐标。 注意：Index2（仅限边）指定一个端点（0 或 1）。 9）GetString(Structure) 返回引用的 Structure 中的字符串。 注意：仅限 AcquireImage，返回由网络“主系统”发送的字符串。 10）GetThresh(Structure) 返回手工或最佳的二进制阀值。 11）GetWide(Structure, [Index]) 返回宽度值。 18、文本（通过光学字符验证和文本结构读取来获取值的函数）。 1）GetAngle(Structure, [Index]) 返回角度值。 2）GetChar(Structure, [Index1], [Index2]) 返回索引处的字符。 3）GetCol(Structure, [Index1], [Index2]) 返回一个列坐标。 注意：注意：Index2（仅限边）指定一个端点（0 或 1）。 4）GetContrast(Structure, [Index]) 以灰度级别方式返回前景和背景之间的对比度。 注意：对于 PatMax 和 ID 工具，会返回对比度百分比；而对于 ID 工具，必须选中“检验”复选框。 5）GetHigh(Structure, [Index]) 返回高度值。 6）GetPassed(Structure, [Index]) 返回通过/失败状态。如果成功，则为 1.0；而失败为 0.0。 7）GetRow(Structure, [Index1], [Index2]) 返回一个行坐标。 注意：Index2（仅限边）指定一个端点（0 或 1）。 8）GetScore(Structure, [Index1], [Index2]) 返回分数值（0-100）。 9）GetString(Structure) 返回引用的 Structure 中的字符串。 注意：仅限 AcquireImage，返回由网络“主系统”发送的字符串。 10）GetWide(Structure, [Index]) 返回宽度值。 19、 字集（通过光学字符验证和文本结构读取来获取值的函数）。 1）GetFontLabel(Font, Index) 返回被检索字集数据库字符的字符标记。 2）GetFontName(Font) 获取指定字集的名称。 3）GetFontNumCharacter(Font) 返回字集数据库中的字符数。

十、结构（创建结构的函数）

1、Annulus(Fixture, Annulus, Show) 返回 Annulus 结构，它存储固定的圆环。 2、Circle(Fixture, Circle, Show) 返回 Circle 结构，其中存储固定的圆。 3、Cross(Fixture, Cross, Show) 返回交叉结构，它存储了固定的交叉标记。 4、Fixture(Fixture, Show) 返回 Fixture 结构，它存储固定坐标。 5、Line(Fixture, Line, Show) 返回 Line 结构，它存储固定的直线。 6、Point(Fixture, Point, Show) 返回 Point 结构，它存储固定的点。

7、Region(Fixture, Region, Show) 返回 Region 结构，它存储固定的区域。

十一、新函数

1、CalibrateGrid(图像)使用正方形网格来校准系统； 2、CalibrateImage（图像，校准）将某校准结果与图像关联。引用结果的工具根据模式，按像素或校准的单位显 示其数据； 3、ClockedMax（事件，值，重设，预设）返回一个运行最大值； 4、ClockedMin（事件，值，重设，预设）返回一个运行最小值； 5、ClockedSum（事件，值，重设，预设）保存某个指定值的运行合计，返回当前累计总数； 6、ComputeStats（事件，值，脱机计数——）计算所引用值的统计信息； 7、ExtractCalibration（图像）从变换的图像中提取校准，返回Calib结构； 8、FormatInputBuffer（格式）设置二进制输入数据格式； 9、FormatOutputBuffer（协议，格式，Value1,[Value2,--]）根据指定的格式构造二进制数据； 10、FormatString（格式字符串，[文本或值，――]）返回一个格式为%format-string的字符串。格式字符串： %c=字符；%d=整数；%f=浮点数；%o=八进制；%s=字符串；%u=无符号；%x或%X=十六进制；%e=科学符号； 11、GetAllTime（图像）返回作业的执行时间（毫秒）。注意：必须在单元格A0中引用AcquireImage函数； 12、GetElapsedTime（图像）返回两次连续图像采集之间的时间（毫秒）。注意：必须在单元格A0中引用AcquireImage 函数； 13、GetTime（Cell1,[Cell2--]）返回单元格的执行时间（毫秒）； 14、ReadDeviceNetBuffer（事件，端口，缓冲区）通过端口将DeviceNet中的数据读入电子表格。使用 FormatInputBuffer分析该数据。返回ReadDeviceNet数据结构 15、ReadEIPBuffer（事件，缓冲区）使用Ethernet/IP协议将来自以太网的数据读入（取出）到电子表格。使用 FormatInputBuffer分析该数据。返回ReadEIP结构。 16、ScaleImage（图像，固定，区域，缩放类型――）将图像区域重新调整为一个以左上角为圆点的未旋转和未 弯曲的矩形。返回存储所处理图像的图像结构。 17、ShiftRegister（事件，数据，步数，重置）缓存某个值的历史。返回存储缓冲区的ShiftRegister结构。 18、Sleep（持续时间，Cell1,[Cell2,--]）在指定的毫秒数内暂停执行作业。暂停发生在最后一个引用的单元格 执行完毕后。 19、TransFixtureToWorld（Calib,Fixture,Show）将在像素坐标系中的固定坐标转换成场景坐标系中的固定坐标。 返回固定坐标结构。 20、TransformImage（图像，校准，区域，显示）基于CalibrateGrid变换纠正图像失真。返回存储已处理图像的 Image结构。 21、ValidateIDData（IDCode,验证选项，――）对使用ID码解码的数据执行验证。返回IDValid结构。 22、WriteDeviceNetBuffer（事件，端口，缓冲区）通过端口将电子表格中的一个或多个值写入DeviceNet，格式 由FormatOutputBuffer单元格确定。 23、WriteEIPBuffer（事件，缓冲区）通过Ethernet/IP协议从电子表格中写入一个或多个值，格式由 FormatOutputBuffer单元格确定。