# IDMax Vision Data Access functions

En este tema se presentan las Vision Data Access functions que devuelven valores de una estructura IDMax Vision Data Access functions.

Nota: Todos los valores devueltos son de una estructura IDMax de referencia que se inserta en la hoja de cálculo cuando se crea la función ReadIDMax. El índice opcional puede hacer referencia a una cadena indexada de la tabla de resultados de la función ReadIDMax.

Función | Descripción
--- | ---
GetAngle(IDMax,[Índice]) | Devuelve el ángulo de un símbolo. Nota: Debe marcarse la casilla de Verify en ReadIDMax.
GetCodeName(IDMax,[Índice]) | Devuelve el nombre del tipo de código. Este es el mismo nombre que el que muestra la Hoja de propiedades de ReadIDMax.
GetCodeType(IDMax,[Índice]) | Devuelve el tipo de código.
Tipo de código | Nombre del código correspondiente
--- | ---
1 | Código 128
0 | Código 39
3/4 | UPC/EAN
11 | Code 93
12 | Codabar
128 | Data Matrix
129 | QR Code
132 | PDF 417
GetColor(IDMax,[Índice]) | Devuelve el valor cromático (0 = negro, 1 = blanco) del primer plano de un símbolo Data Matrix, código QR o PDF 417.
GetDecoded(Structure,Índice) | Devuelve información sobre si se ha encontrado el símbolo de identificación indexado. Da 0.0 si no se ha encontrado o 1.0 si se ha encontrado.
GetErrorCode(IDMax,[Índice]) | Devuelve un código de error para cada cadena de información presentada si la función falla. Nota: Las cadenas de error se insertan en la hoja de cálculo por medio de la función GetErrorString.
Código de diagnóstico | Cadena de información correspondiente
--- | ---
00010000 | Error de procesamiento de visión artificial.
00010001 | Memoria de imagen no válida.
00010001 | La región de entrada es demasiado pequeña.
00010002 | La región de entrada sobrepasa los límites de la imagen.
00019000 | Error de procesamiento de visión IDMax.
04010000 | Error de ReadCompositeCode.
04010001 | No se pueden detectar patrones de dirección de componentes 2D.
04010002 | Demasiados datos no válidos en imagen de componente 2D.
04010003 | No se puede detectar la versión del símbolo de componente 2D.
04010004 | Imposible completar los patrones de dirección de componentes 2D faltantes.
04010005 | La línea de barrido ha detectado datos de imagen no válidos.
04010006 | La línea de barrido sobrepasa los límites de la imagen.
04010007 | No se puede detectar ningún patrón localizador en componente 1D.
04010008 | Demasiados datos no válidos en imagen de componente 1D.
04010009 | No se ha encontrado níngún símbolo combinado válido. Nota: Para todos los demás símbolos, se devuelve 04020001.
04010010 | Demasiados errores a corregir en el símbolo.
04010011 | La corrección de errores ha fallado.
04010012 | 1D y 2D son decodificables pero no están vinculados.
04010013 | Ha fallado el cálculo automático de umbral de contraste.
04010014 | La sensibilidad al contraste supera el margen permitido.
04010015 | El parámetro de barrido supera el margen permitido.
04020000 | Error de ReadIDMax.
04020001 | No se han encontrado símbolos válidos.
04020002 | No se ha podido decodificar el símbolo.
GetErrorString(IDMax,[Índice]) | Da información de diagnóstico si falla la decodificación del símbolo. Nota: La función GetErrorString de Vision Data Access puede utilizarse para extraer la siguiente lista de errores de la estructura de datos devuelta por una función ReadIDMax. Error del sistema. No hay suficiente memoria cúmulo. Error de procesamiento de visión artificial. Búfer de imagen no válido. Tamaño de región no válido. La región sobrepasa los límites de la imagen. Error de ReadIDMax. Error de ReadIDCode. No se pueden detectar patrones de dirección de fila. Se ha superado el límite de memoria para patrones de dirección de fila (RAP). No se puede detectar la versión del símbolo CC-A. No se puede llenar los puntos RAP que faltan. Se ha detectado una línea de barrido no válida. La línea de barrido sobrepasa los límites de la imagen. No se pueden detectar patrones de valor medio. Se ha superado el límite de la memoria de valor medio. No se han encontrado símbolos válidos. Demasiados errores a corregir en el símbolo. No se ha podido corregir el error de Reed Solomon. Ha fallado el cálculo automático de umbral de contraste. La sensibilidad al contraste supera el margen permitido.
GetFormat(IDMax,[Índice]) | Devuelve el valor que representa el formato de un símbolo 2D en la función ReadIDMax. Consulte el tema GetFormat Values.
GetFound(IDMax,Índice) | Devuelve información sobre si se ha encontrado el símbolo de ID indexado; 0.0 significa no encontrado y 1.0, encontrado.
GetGridCols(IDMax,[Índice]) | Devuelve la cantidad de columnas que contiene un símbolo 2D.
GetGridRows(IDMax,[Índice]) | Devuelve la cantidad de filas que contiene un símbolo 2D.
GetGrowth(IDMax,[Índice]) | Devuelve el resultado de la prueba de crecimiento de impresión 2D para el símbolo 2D considerado. Los crecimientos de impresión horizontal y vertical se calculan de forma independiente y la función devuelve la puntuación más baja. Esta prueba indica si las celdas del símbolo presentan variaciones en tamaño. Por ejemplo, no es infrecuente con algunos métodos de marcado que las celdas aumenten de tamaño, desde el lado izquierdo del símbolo hacia el de la derecha. Un símbolo de alta calidad no debe a penas presentar un aumento de impresión, si no ninguno. El resultado de la prueba de crecimiento de impresión está a menudo vinculado al resultado de la prueba de no uniformidad, ya que puede encontrarse en símbolos con proporciones incorrectas. Calificación A (4,0) ≥ -0,50 y ≤ 0,50 Calificación B (3,0) ≥ -0,70 y ≤ 0,70 Calificación C (2,0) ≥ -0,85 y ≤ 0,85 Calificación D (1,0) ≥ -1,00 y ≤ 1,00 Calificación F (0,0) < -1,00 o > 1,00 Nota: Debe marcarse la casilla de Verify en ReadIDMax.
GetHeight(IDMax,[Índice]) | Devuelve la altura del símbolo. Nota: Debe marcarse la casilla de Verify en ReadIDMax.
GetLearned(IDMax,[Índice]) | Devuelve '1' si se ha entrenado correctamente el modelo del símbolo y '0' si no se ha entrenado el modelo. Índice = 0 para DataMatrix, 1 para QR, 2 para 1D. Estos índices solo son válidos cuando se utilizan con la función ReadIDMax.
GetLearnedGridCol(IDMax,[Índice]) | Devuelve la cantidad de columnas que hay en un código QR o símbolo Data Matrix aprendidos.
GetLearnedGridRow(IDMax,[Índice]) | Devuelve la cantidad de filas que hay en un código QR o símbolo Data Matrix aprendidos.
GetLearnedSymbology(IDMax) | Devuelve una cadena que contiene la simbología 1D que se está aprendiendo actualmente con ReadIDMax.
GetMirror(IDMax,[Índice]) | Devuelve el estado de réplica (0 = no es una réplica, 1 = réplica) de un símbolo Data Matrix o código QR.
GetModuleSize(IDMax,[Índice]) | Devuelve el tamaño del módulo 2D.
GetNumResults(IDMax) | Devuelve el número de resultados encontrados y decodificados.
GetRawStream(IDMax,[Índice]) | Devuelve la secuencia de datos indecodificada de un símbolo leído de código 128.
GetResolution(IDMax,[Índice]) | En el caso de símbolos 2D, devuelve el tamaño medio, en píxeles, de las celdas. Aunque no se utiliza específicamente para una prueba de verificación de la calidad, «resolución» proporciona el tamaño medio, en píxeles, de un elemento (o celda) en un símbolo. Cada tipo de símbolo debe tener una resolución mínima según las especificaciones correspondientes: Data Matrix: 4 píxeles por elemento Código QR: 4 píxeles por elemento PDF 417: 3 píxeles por elemento
GetString(IDMax,[Índice]) | Devuelve la cadena del resultado indexado o 0, si no se especifica ningún [Índice]. Nota: Si la cadena contiene NULL (0x00), la función intercambia automáticamente el carácter por <NUL>.
GetStringIDMax(IDMax,TranslationMode,[Índice]) | Devuelve la cadena del resultado indexado, según el modo de traducción seleccionado (0, 1 o 2; por defecto = 0) que especifica cómo ha de procesar la función los caracteres ASCII no imprimibles. Cuando el modo de traducción se establece en 0, la función intercambia el carácter ASCII 0x00 por < NUL> Cuando el modo de traducción se establece en 1, la función traduce todos los caracteres ASCII no imprimibles (0-31, 127-255) conforme a la siguiente tabla:
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>"
Nota: Los caracteres ASCII no imprimibles que no figuran en la tabla se traducen como "<X>", donde X es el valor decimal.
Cuando el modo de traducción se establece en 2, la función traduce todos los caracteres ASCII no imprimibles excepto CR (0x0d) y LF (0x0a).
GetSymbologyIdentifier(IDMax,[Índice]) | Devuelve el tipo de símbolo, especificándolo como un código de tres caracteres conforme a la especificación ISO 15424.
GetWidth(IDMax,[Índice]) | Devuelve la anchura del símbolo. Nota: Debe marcarse la casilla de Verify en ReadIDMax.
GetX(IDMax, [Índice1], [Índice2]) | Devuelve una coordenada X. Para ReadIDMax, Índice2 especifica la esquina del símbolo.
GetY(Estructura, [Índice1], [Índice2]) | Devuelve una coordenada Y. Para ReadIDMax, Índice2 especifica la esquina del símbolo.
SetSymbolMinStringLength(IDMax,Simbología,MinLength) | Establece la longitud mínima de la cadena según la simbología especificada para la estructura IDMax referenciada.
IDMax | ReadIDMax(Image, Fixture, Region, ...) Lee y verifica opcionalmente las cadenas alfanuméricas contenidas en simbologías y códigos de barras 1D y 2D. Devuelve una estructura IDCode con la cadena decodificada.
Symbology | La simbología especificada [solo admite Intercalado 2 de 5(73)]
MinLength | Entero para longitud mínima de cadena, máx. = 80.