# OCRMax Vision Data Access functions

En este tema se presentan las funciones Vision Data Access functions que obtienen valores de una estructura OCRMaxde reconocimiento óptico de caracteres.

Nota: A menos que se indique lo contrario, las siguientes funciones hacen referencia a una estructura de datos OCRMax a través de su primer parámetro. Char_Index (de base cero) indica qué carácter de la estructura se está indizando.

Función | Descripción
--- | ---
GetAngle(OCRMax, [Índice]) | Devuelve un valor de ángulo.
GetChar(OCRMax, [Índice1], [Índice2]) | Devuelve el carácter que se encuentra en la posición indicada por el índice. Cuando un parámetro opcional Char_Index1 es 1, devuelve el carácter con la segunda puntuación más alta.
GetCharConfused(OCRMax, Char_Index *) * Opcional | Si se especifica el parámetro opcional Char_Index, devuelve el estado de confundibilidad del carácter indexado; 1.0 si se confunde, de lo contrario 0.0. Si no se especifica un parámetro opcional Char_Index, la función devuelve 1.0 si hay algún carácter en la cadena que está en estado de confundibilidad, de lo contrario devuelve 0.0.
GetCharFailedValidation(OCRMax, Char_Index *) * Opcional | Si se especifica el parámetro opcional Char_Index, devuelve el estado de validación del carácter indexado; 1.0 si ha fallado la validación, de lo contrario 0.0. Si no se especifica un parámetro opcional Char_Index, la función devuelve 1.0 si hay algún carácter en la cadena con validación fallida, de lo contrario devuelve 0.0.
GetCharMisMatch(OCRMax, Char_Index *) * Opcional | Si se especifica el parámetro opcional Char_Index, devuelve el estado de discrepancia del carácter indexado; 1.0 si hay discrepancia, de lo contrario 0.0. Si no se especifica un parámetro opcional Char_Index, la función devuelve 1.0 si hay algún carácter en la cadena que no concuerda, de lo contrario devuelve 0.0.
GetCharacterRegion(OCRMax, Char_Index, Mostrar) | Devuelve una estructura de datos Region correspondiente al carácter indexado. La región devuelta corresponde a la región rectangular más pequeña posible que abarca completamente el carácter, como se muestra en el gráfico siguiente. Si los caracteres a los que se hace referencia no han sufrido una inclinación (como los caracteres en el gráfico siguiente), la región de visibilidad del carácter coincide con el rectángulo del carácter.
GetCharsTrained(OCRMax) | Devuelve los caracteres entrenados en forma de cadena de texto.
GetFontName(OCRMax) | Devuelve el nombre de la fuente definida en la función OCRMax referenciada.
GetHeight(CharacterRegion) | Devuelve la altura del rectángulo del carácter. Nota: La altura del rectángulo de un carácter es la misma que la de la región de un carácter.
GetHeight(OCRMax, Char_Index) | Devuelve la altura de la región del carácter. Nota: La altura del rectángulo de un carácter es la misma que la de la región de un carácter.
GetIgnoredCharacters(OCRMax) | Devuelve el número de caracteres segmentados que se han ignorado durante el fielding.
GetInternalSettings(OCRMax) | Devuelve los parámetros de segmentación de la función OCRMax referenciada en forma de una estructura de datos Settings que puede ser objeto de referencia de otra función OCRMax por medio del parámetro «Ajustes externos». Sin embargo, el Cuadro de diálogo Auto-Tune estará deshabilitado a menos que se haga lo siguiente: Para que el cuadro de diálogo de Auto-Tune permanezca habilitado mientras se utiliza la función GetInternalSettings, hay que utilizar por lo menos dos funciones OCRMax (OCRMax#1 y OCRMax#2). La primera función OCRMax (OCRMax#1) debe tener el parámetro Ajustes externos puesto a 0 para que la funcionalidad Auto-Tune permanezca habilitada. Se utilizará luego una función GetInternalSettings que hace referencia a OCRMax#1. La segunda función OCRMax (OCRMax#2) debe tener el parámetro Ajustes externos ajustado para hacer referencia a la función GetInternalSettings. Esto permite que OCRMax#1 se ajuste automáticamente y que los resultados sean utilizados por OCRMax#2. Por ejemplo: Celda A1: OCRMax#1 con «Ajustes externos» = 0 Celda B1: GetInternalSettings(referencia a A1) Celda C1: OCRMax#2 con «Ajustes externos» = B1
GetNumCharTrainedInstances(OCRMax, Carácter) | Devuelve el número de ejemplares entrenados para el carácter, por ejemplo, "a" o "B" o "1".
GetPassed(OCRMax, Char_Index) | Devuelve el estado de pase/fallo del carácter indexado. Si no especifica el parámetro Índice, devuelve el estado de pase/fallo de toda la cadena. El estado de toda la cadena es de pase únicamente si el de todos los caracteres lo es también.
GetScore(OCRMax, Char_Index0, [Char_Index1]) | Devuelve la puntuación de coincidencia (0 a 100) del carácter indexado. Si el valor de ajuste del parámetro opcional Índice1 es 1, la función devuelve la puntuación del carácter que tiene la segunda puntuación más alta.
GetSize(OCRMax, Char_Index) | Devuelve el tamaño del carácter indexado, en píxeles.
GetString(OCRMax) | Devuelve la cadena de texto leída por la función OCRMax referenciada.
GetWidth(CharacterRegion) | Devuelve la anchura del rectángulo del carácter. Nota: Si presenta inclinación, el ancho será la región del carácter más el ancho adicional necesario para tener en cuenta la inclinación.
GetWidth(OCRMax, Char_Index) | Devuelve la anchura de la región del carácter.
GetX(CharacterRegion) | Devuelve la coordenada X del rectángulo del carácter.
GetX(OCRMax, Char_Index, Corner_Index) | Devuelve la coordenada X de la esquina especificada mediante Corner_Index de una región de carácter.
GetY(CharacterRegion) | Devuelve la coordenada Y del rectángulo del carácter.
GetY(OCRMax, Char_Index, Corner_Index) | Devuelve la coordenada Y de la esquina especificada mediante Corner_Index de la región de visibilidad del carácter. Nota: Si los caracteres no presentan una inclinación, la región de visibilidad del carácter coincide con el rectángulo del carácter.