全局函数 - ABBYY Vantage Documentation

区域运算
距离运算
数值数据类型的运算
与 Rectangle 和区域相关的操作
字符串操作
访问 XML 文件
类型转换与检查
坐标运算
访问数据目录（data catalog）
访问类型为 Text 的 Skill 参数
其他

区域运算

Function	Description
`Area Max( Area a1, Area a2 )`	返回 a1 与 a2 中的较大者。
`Area Min( Area a1, Area a2 )`	返回 a1 与 a2 中的较小者。
`Area ObjectsArea( Rect, ImageObjectType )`	返回指定 Rectangle 内指定类型对象的面积。基于全局坐标。
`Area ObjectsIntersectionArea( Rect, ImageObjectType )`	返回指定 Rectangle 内指定类型对象的面积。若对象的面积超出该 Rectangle，返回对象面积与该 Rectangle 的交集面积。基于全局坐标。

距离运算

Function	Description
`Distance Abs( Distance )`	返回距离的绝对值。
`Distance AverageInterLineInterval()`	返回页面上文本行的平均高度。仅当文档的最小和最大页数均为 1 时可使用该函数。对于多页文档，请使用 Page 类型的对应方法：`Page( N ).AverageLineHeight`。
`Distance AverageLineHeight()`	返回页面上文本行之间的平均间距。仅当文档的最小和最大页数均为 1 时可使用该函数。对于多页文档，请使用 Page 类型的对应方法：`Page( N ).AverageInterLineInterval`。
`Distance Min( Distance d1, Distance d2 )`	返回 d1 与 d2 中的最小值。
`Distance Max( Distance d1, Distance d2 )`	返回 d1 与 d2 中的最大值。

数值数据类型的运算

Function	Description
`Int abs( Int )`	返回数值的绝对值。
`Int Ceil( Real )`	返回不小于该参数的最小整数。
`Int Floor( Real )`	返回不大于该参数的最大整数。
`Int Max( Int n1, Int n2 )`	返回 n1 与 n2 中的最大值。
`Int Min( Int n1, Int n2 )`	返回 n1 与 n2 中的最小值。
`Int Round( Real )`	返回最接近该参数的整数。
`Real Min( Real d1, Real d2 )`	返回 d1 与 d2 中的最小值。
`Real Max( Real d1, Real d2 )`	返回 d1 与 d2 中的最大值。

与 Rectangle 和区域相关的操作

Function	Description
`Rect DocumentRect()`	返回整个文档的矩形（使用全局坐标）。
`Rect PageRect()`	返回整个图像的矩形。仅当文档的页数上下限均设置为 1 时才能使用该函数。
`Region FormRegion( RectArray included, RectArray excluded )`	创建一个区域，包含“包含”矩形数组，并排除“排除”矩形数组。

字符串操作

函数	描述
`String Chr( Int )`	返回使用指定字符 Unicode 码点（必须为十进制）构造的字符串。
`String LCase( String )`	返回将指定字符串的所有字符转换为小写后的结果。
`String RealToStrVariants( Real value, String fractionalPartSeparators, Int maxDigitsCountInFractionalPart = 2 )`	根据指定的实数 value、小数分隔符 fractionalPartSeparators 和小数部分的最大位数，生成多个字符串表示，并以竖线分隔。
`String Str( ... )`	数据类型的字符串表示。适用于 Int、Logic、Real、XInterval、YInterval、DistInterval、FuzzyRect、Hypothesis、RectArray、Region、Area、Quality、Distance、PageInterval。
`String RemoveSpaces( String )`	返回移除了指定字符串中所有空格后的结果。
`String UCase( String )`	返回将指定字符串的所有字符转换为大写后的结果。

访问 XML 文件

Function	Description
`StringArray ReadFromXML( String filename, String xPathQuery )`	从“filename”XML 文件中读取字符串数组。字符串通过计算传入的 xPath 查询“xPathQuery”获得。有关使用 XML 文件的更多信息，请参见 User Dictionaries。注意：为使代码更清晰，您可以为常用的 xPath 查询定义带可替换参数的常量，并在函数调用中使用这些常量。
`String ReadSingleStringFromXML( String filename, String xPathQuery )`	从“filename”XML 文件中读取单个字符串。该字符串通过计算传入的 xPath 查询“xPathQuery”获得。有关使用 XML 文件的更多信息，请参见 User Dictionaries。

类型转换与检查

Function	Description
`Logic IsReal( String numberString, String separators = ".,", Logic isStrictMode = false )`	检查字符串 `inputString` 是否可安全转换为实数。允许的小数分隔符列表由参数 “separators” 指定。
`Logic IsRealFuzzy( String, String separators = defaultDecimalSeparators, Logic isStrictMode = false )`	在考虑字符串中可能存在的识别错误的情况下，检查字符串 `inputString` 是否可安全转换为实数。
`Logic IsInt( String inputString, Logic isStrictMode = false )`	检查字符串 `inputString` 是否可安全转换为整数。
`Logic IsIntFuzzy( String inputString, Logic isStrictMode = false )`	在考虑字符串中可能存在的识别错误的情况下，检查字符串 `inputString` 是否可安全转换为整数。
`Real StrToRealFuzzy( String, String separators = defaultDecimalSeparators, Logic isStrictMode = false )`	在考虑可能的识别错误的情况下，返回将字符串 `inputString` 的值转换为实数的结果。
`Real StrToReal( String numberString, String separators = ".,", Logic isStrictMode = false )`	返回将字符串 `inputString` 转换为实数的结果。会忽略空格。
`Int StrToInt( String inputString, Logic isStrictMode = false )`	返回将字符串 `inputString` 的值转换为整数的结果。会忽略空格。
`Int StrToIntFuzzy( String, Logic isStrictMode = false )`	在考虑可能的识别错误的情况下，返回将字符串 `inputString` 的值转换为整数的结果。
`Int LogicToInt( Logic value )`	若值为 `true` 则返回 “1”，若值为 `false` 则返回 “0”。

坐标运算

Function	Description
`XCoordinate Min( XCoordinate x1, XCoordinate x2 )`	返回 x1 和 x2 中的较小值。
`XCoordinate Max( XCoordinate x1, XCoordinate x2 )`	返回 x1 和 x2 中的较大值。
`XCoordinate MiddleBetween( XCoordinate x1, XCoordinate x2 )`	返回按 ( x1 + x2 ) / 2 计算的 X 坐标。
`XCoordinate Between( XCoordinate x1, XCoordinate x2, Real ratio )`	返回按 x1 + ( x2 – x1 ) * ratio 计算的 X 坐标。
`YCoordinate Min( YCoordinate y1, YCoordinate y2 )`	返回 y1 和 y2 中的较小值。
`YCoordinate Max( YCoordinate y1, YCoordinate y2 )`	返回 y1 和 y2 中的较大值。
`YCoordinate MiddleBetween( YCoordinate y1, YCoordinate y2 )`	返回按 ( y1 + y2 ) / 2 计算的 Y 坐标。
`YCoordinate Between( YCoordinate y1, YCoordinate y2, Real ratio )`	返回按 y1 + ( y2 – y1 ) * ratio 计算的 Y 坐标。
`XInterval MiddleBetween( Xinterval x1, XInterval x2 )`	返回按 ( x1 + x2 ) / 2 计算的 XInterval。
`XInterval Between( Xinterval x2, Xinterval x2, Real ratio )`	返回按 x1 + ( x2 – x1 ) * ratio 计算的 XInterval。
`YInterval MiddleBetween( Yinterval y1, Yinterval y2 )`	返回按 ( y1 + y2 ) / 2 计算的 YInterval。
`YInterval Between( Yinterval y1, Yinterval y2, Real ratio )`	返回按 y1 + ( y2 – y1 ) * ratio 计算的 YInterval。

访问数据目录（data catalog）

注意： 要访问数据目录（data catalog），应先创建一个引用该目录的 Skill Parameter，然后在方法调用中使用该 Parameter 的名称。

Function	Description
`Logic TestAccessToCatalog( String catalogParameterName )`	测试是否能够访问由参数 catalogParameterName 引用的数据目录（data catalog）。
`Logic TestCatalogSearchCriteria( String catalogParameterName, StringArray searchColumns, NamedValueArray searchCriteria )`	检查为数据目录（data catalog）设置的搜索条件是否有效。搜索条件通过命名值数组设置，其中每个命名值表示一个列名及其期望值。searchColumns 数组指定响应中应包含数据目录记录的哪些列。
`StringArray FieldNamesOfCatalog( String catalogParameterName )`	返回由参数 catalogParameterName 引用的数据目录（data catalog）中所有列名的列表。列按索引号升序排列。
`StringArray FieldNamesOfCatalog( String catalogParameterName, StringArray searchColumnNames )`	返回出现在 searchColumnNames 数组中的数据目录（data catalog）列名列表（不区分大小写）。列按索引号升序排列。可使用此方法确定列索引。
`Int RecordCountOfCatalog( String catalogParameterName, StringArray searchColumns, NamedValueArray searchCriteria = EmptyNamedValueArray )`	返回数据目录（data catalog）中满足指定搜索条件的记录数量。
`Void PrepareRecordsetOfCatalog( String catalogParameterName, StringArray searchColumns, NamedValueArray searchCriteria = EmptyNamedValueArray, Int maxRecordsCount = 1000 )`	获取满足搜索条件的数据目录（data catalog）记录集。
`StringArray RecordOfCatalog( String catalogParameterName, StringArray searchColumns, NamedValueArray searchCriteria = EmptyNamedValueArray, Int rowIndex )`	返回数据目录（data catalog）中符合搜索条件的一条记录。
`Quality ValidateByCatalog( String word, String catalogParameterName, Int columnIndex, NamedValueArray searchCriteria = EmptyNamedValueArray, Int maxErrors, Rational maxErrorsPart, Logic ignoreSpaces = true, Int maxRecordsCount = 1000 )`	通过将指定的 word 字符串与数据目录（data catalog）中索引为 columnIndex 的列的值进行比对来校验该字符串。返回该字符串与数据目录列中最佳匹配项之间的匹配质量。
`Int GetCatalogColumnIndex( String catalogParameterName, String columnName )`	返回由参数 catalogParameterName 引用的数据目录（data catalog）中首个匹配给定名称的列的索引。列名不区分大小写。
`IntArray GetCatalogColumnIndices( String catalogParameterName, String columnName )`	返回由参数 catalogParameterName 引用的数据目录（data catalog）中所有匹配给定名称的列的索引。列名不区分大小写。

访问类型为 Text 的 Skill 参数

Function	Description
`Logic NamedParameterStringExists( String parameterName )`	检查 Skill 中是否存在具有指定名称的文本参数。参数名称区分大小写。
`String GetNamedParameterString( String parameterName )`	返回具有指定名称的文本参数的值。参数名称区分大小写。

其他

Function	Description
`InputFieldArray InputFields()`	返回一个对象集合——在前序处理阶段于文档中识别到的 field。
`Int PagesCount()`	返回文档的页数。
`Page Page( Int PageNumber )`	返回表示指定页码的 Page 对象。
`Logic IsOnSameLine( Hypothesis, Hypothesis )`	检查这些假设在垂直方向上是否相交。

预定义字段区域描述变量用户词典

⌘I