# IDMax Vision Data Access functions

本主题列出了从 IDMax Vision Data Access functions 结构中获取值的 Vision Data Access functions。

注意:所有返回值均来自引用的 IDMax 结构，该结构在创建 ReadIDMax 函数时插入到电子表格中。可选的索引可以引用 ReadIDMax 函数结果表中的索引字符串。

函数 | 说明
--- | ---
GetAngle(IDMax,[索引]) | 返回符号的角度。 注意:必须选中 ReadIDMax 中的“验证”复选框。
GetCodeName(IDMax,[索引]) | 返回代码类型的名称。这与 ReadIDMax 属性表中显示的代码名称相同。
GetCodeType(IDMax,[索引]) | 返回代码类型。
代码类型 | 对应代号名称
--- | ---
1 | Code 128
0 | Code 39
3/4 | UPC/EAN
11 | Code 93
12 | Codabar
128 | Data Matrix
129 | QR 码
132 | PDF 417
GetColor(IDMax,[索引]) | 返回 Data Matrix、QR 码或 PDF 417 符号的前景色的值（0 = 黑色，1 = 白色）。
GetDecoded(结构,索引) | 返回是否找到索引 ID 符号。如果未找到，则返回 0.0，如果找到，则返回 1.0。
GetErrorCode(IDMax,[索引]) | 如果函数失败，则返回每个信息字符串的错误代码。 注意:使用 GetErrorString 函数将错误字符串插入到电子表格中。
诊断代码 | 对应于信息字符串
--- | ---
00010000 | 视觉处理错误。
00010001 | 图像内存无效。
00010001 | 输入区域太小。
00010002 | 输入区域超出图像边界。
00019000 | IDMax 视觉处理错误。
04010000 | ReadCompositeCode 错误。
04010001 | 无法检测二维组件地址图案。
04010002 | 无效的 2D 组件图像数据过多。
04010003 | 无法检测二维组件符号版本。
04010004 | 无法填充缺失的二维组件地址图案。
04010005 | 扫描线检测到无效图像数据。
04010006 | 扫描线超出图像边界。
04010007 | 无法检测一维组件查找器图案。
04010008 | 无效的一维组件图像数据过多。
04010009 | 找不到有效的复合符号。 注意:对于所有其他符号，返回 04020001。
04010010 | 要更正的符号错误太多。
04010011 | 更正失败。
04010012 | 一维和二维可解码但不关联。
04010013 | 自动对比度阈值计算失败。
04010014 | 对比敏感度超出允许范围。
04010015 | 扫描参数超出允许范围。
04020000 | ReadIDMax 错误。
04020001 | 未找到有效符号。
04020002 | 无法解码符号。
GetErrorString(IDMax,[索引]) | 如果符号解码失败，则返回诊断信息。 注意:GetErrorString 视觉数据访问函数可用于从 ReadIDMax 函数返回的数据结构中提取以下错误列表。 系统错误。 堆内存不足。 视觉处理错误。 图像缓冲区无效。 区域大小无效。 区域超出图像边界。 ReadIDMax 错误。 ReadIDCode 错误。 无法检测行地址图案。 超出行地址图案 (RAP) 内存限制。 无法检测 CC-A 符号版本。 无法填写缺失的 RAP 分数。 检测到无效的扫描线。 扫描线超出图像边界。 无法检测半值图案。 超过半值内存限制。 未找到有效符号。 要更正的符号错误太多。 Reed Solomon 纠错失败。 自动对比度阈值计算失败。 对比敏感度超出允许范围。
GetFormat(IDMax,[索引]) | 返回 ReadIDMax 函数中表示二维符号格式的值。请参阅 GetFormat 值主题。
GetFound(IDMax, 索引) | 返回是否找到索引 ID 符号； 0.0 表示未找到，或 1.0 表示找到。
GetGridCols(IDMax,[索引]) | 返回二维符号中包含的列数。
GetGridRows(IDMax,[索引]) | 返回二维符号中包含的行数。
GetGrowth(IDMax,[指数]) | 返回二维符号的二维符号打印增长测试。水平和垂直打印增长是独立计算的，并返回较低的分数。 此测试指示符号中的单元格大小是否不同。例如，在一些标记方法中，单元格的大小从符号的左侧向右侧移动的情况并不少见。高质量的符号很少或没有印刷增长。印刷增长测试结果通常与不均匀性测试结果相关联，因为它会导致符号比例不正确。 A 级 (4.0) ≥ -0.50 且 ≤ 0.50 B 级 (3.0) ≥ -0.70 且 ≤ 0.70 C 级 (2.0) ≥ -.85 且 ≤ 0.85 D 级 (1.0) ≥ -1.00 且 ≤ 1.00 F 级 (0.0) < -1.00 或 > 1.00 注意:必须选中 ReadIDMax 中的“验证”复选框。
GetHeight(IDMax,[索引]) | 返回符号的高度。 注意:必须选中 ReadIDMax 中的“验证”复选框。
GetLearned(IDMax,[索引]) | 如果符号模型已成功训练，则返回“1”；如果模型未训练，则返回“0”。 对于 DataMatrix，索引 = 0，对于 QR 为 1，对于一维为 2。索引仅在与 ReadIDMax 一起使用时有效。
GetLearnedGridCol(IDMax,[索引]) | 返回训练 QR 码或 Data Matrix 符号中的列数。
GetLearnedGridRow(IDMax,[索引]) | 返回训练 QR 码或 Data Matrix 符号中的行数。
GetLearnedSymbology(IDMax) | 返回包含当前在 ReadIDMax 中学习的一维符号体系的字符串。
GetMirror(IDMax,[索引]) | 返回镜像状态（0 = 未镜像，1 = 镜像）Data Matrix 或 QR 码符号。
GetModuleSize(IDMax,[索引]) | 返回二维模块的大小。
GetNumResults(IDMax) | 返回找到和解码结果的数量。
GetRawStream(IDMax,[索引]) | 从 代码 128 符号的读取符号返回未解码的数据流。
GetResolution(IDMax,[索引]) | 对于二维符号，返回单元格的平均大小（以像素为单位）。虽然不是专门的质量验证测试，但分辨率测量符号中元素（或单元格）的平均大小（以像素为单位）。每种类型的符号都有一个最小分辨率规范： Data Matrix：每个元素 4 个像素 QR 码：每个元素 4 个像素 PDF 417：每个元素 3 个像素
GetString(IDMax,[索引]) | 返回索引结果中的字符串，如果未提供 [索引]，则返回结果 0。 注意:如果字符串包含 NULL (0x00)，函数将自动使用“<NUL>”交换该字符。
GetStringIDMax(IDMax,TranslationMode,[索引]) | 根据选定的转换模式，从索引结果中返回字符串（0、1 或 2；默认值 = 0），这指定函数将如何处理不可打印的 ASCII 字符。 当转换模式设置为 0，该函数会将 <NUL>与 ASCII 字符 0x00 交换 当转换模式设置为 1 时，该函数将使用下表转换所有不可打印的 ASCII 字符（0-31、127-255）：
0x00 | "<NUL>"
0x01 | "<SOH>"
0x02 | "<STX>"
0x03 | "<ETX>"
0x04 | "<EOT>"
0x05 | "<ENQ>"
0x06 | "<ACK>"
0x07 | "<BEL>"
0x08 | "<BS>"
0x09 | "<HT>"
0x0a | "<LF>"
0x0b | "<VT>"
0x0c | "<FF>"
0x0d | "<CR>"
0x0e | "<SO>"
0x0f | "<SI>"
0x10 | "<DLE>"
0x11 | "<DC1>"
0x12 | "<DC2>"
0x13 | "<DC3>"
0x14 | "<DC4>"
0x15 | "<NAK>"
0x16 | "<SYN>"
0x17 | "<ETB>"
0x18 | "<CAN>"
0x19 | "<EM>"
0x1a | "<SUB>"
0x1b | "<ESC>"
0x1c | "<FS>"
0x1d | "<GS>"
0x1e | "<RS>"
0x1f | "<US>"
0x7f | "<DEL>"
注意:表中未列出的不可打印的 ASCII 字符将被转换为“<X>”，其中 X 是十进制值。
当转换模式设置为 2 , 该函数将转换除 CR (0x0d) 和 LF (0x0a) 之外的所有不可打印的 ASCII 字符。
GetSymbologyIdentifier(IDMax,[索引]) | 根据 ISO 15424 规范返回符号类型作为三字符代码。
GetWidth(IDMax,[索引]) | 返回符号的宽度。 注意:必须选中 ReadIDMax 中的“验证”复选框。
GetX(IDMax, [Index1], [Index2]) | 返回 x 坐标。对于 ReadIDMax，Index2 指定符号角。
GetY(结构, [Index1], [Index2]) | 返回 y 坐标。对于 ReadIDMax，Index2 指定符号角。
SetSymbolMinStringLength(IDMax,符号,MinLength) | 为引用的 IDMax 结构设置指定符号的最小字符串长度。
IDMax | ReadIDMax(图像, 固定, 区域, ...) 读取并选择性地验证一维和二维条码和符号中包含的字母数字字符串。返回包含解码字符串的 IDCode 结构。
符号体系 | 指定的符号[仅支持 Interleaved 2/5(73)]
MinLength | 最小字符串长度整数，最大值 = 80。