Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt

Use this file to discover all available pages before exploring further.

Este objeto corresponde a una imagen abierta, o “documento de imagen”. Sus atributos reflejan los atributos de una imagen. El objeto ImageDocument es el objeto raíz de una colección de objetos Image, o “planos de imagen”. Cada documento de imagen incluye 4 “planos de imagen”: blanco y negro, gris, color y vista previa. Se puede acceder a ellos mediante las propiedades correspondientes. El objeto contiene varios métodos de preprocesamiento de imágenes. Algunos de estos métodos son adecuados solo para fotos; otros pueden utilizarse con todo tipo de documentos. Algunos métodos aumentan la calidad del reconocimiento; otros solo mejoran la representación visual de las imágenes, pero pueden reducir la calidad del reconocimiento. Estos últimos deben usarse solo después del reconocimiento. Lea atentamente la descripción de cada método para determinar si puede utilizarse en su caso de uso. A continuación puede ver el orden en el que recomendamos usar los métodos de preprocesamiento de imágenes (use solo los métodos de la lista que sean adecuados para su caso de uso):
  • Para mejorar la calidad del reconocimiento:
    1. Recortar la imagen
    2. Mejorar el contraste local
    3. Corregir la orientación (use el método Transform con los parámetros necesarios)
    4. Invertir o reflejar la imagen (use el método Transform con los parámetros necesarios)
    5. Corregir la inclinación
    6. Dividir una doble página (use el método SplitPages del objeto FRDocument)
    7. Eliminar distorsiones geométricas
    8. Eliminar manchas
    9. Eliminar ruido
    10. Eliminar desenfoque por movimiento
    11. Suprimir objetos de color
    12. Eliminar objetos de color
  • Para mejorar la apariencia de la imagen:
    1. Igualar el brillo y hacer que el fondo sea blanco
    2. Suavizar la textura de la imagen
    3. Aplicar tramado a la imagen
Tenga en cuenta que todos estos métodos de preprocesamiento deben aplicarse a una imagen abierta. Algunas modificaciones de la imagen pueden aplicarse antes, durante el proceso de apertura. Consulte la descripción de los objetos PrepareImageMode y PagePreprocessingParams para obtener más información sobre el preprocesamiento de imágenes al abrirla. El objeto ImageDocument es lo que se conoce como un “objeto conectable.” Para Visual Basic en FRE para Windows, puede declararse como WithEvents. Para C++ (en todos los sistemas operativos compatibles), esto significa que admite la interfaz IConnectionPointContainer. Para recibir eventos de notificación durante el procesamiento, los usuarios de C++ deben crear un objeto derivado de la interfaz IImageDocumentEvents y hacer lo siguiente:
  • En Linux y macOS: suscribir el objeto al objeto ImageDocument llamando a la función global AdviseFREngineObject.
  • En Windows: configurar la conexión entre el objeto y el origen de eventos implementado en el objeto ImageDocument mediante los mecanismos COM estándar.
En Windows: Los métodos del objeto ImageDocument informan sobre el progreso del procesamiento de páginas mediante interfaces salientes especiales. Estas interfaces son IImageDocumentEvents (para C++) y la dispinterface DIImageDocumentEvents (para Visual Basic). Debe tenerse en cuenta que los usuarios de Visual Basic no deben preocuparse por los detalles de la implementación de interfaces de eventos, ya que esta plataforma de desarrollo proporciona medios sencillos para manejarlas.

Propiedades

, de solo lectura

Devuelve el objeto.

, de solo lectura

Proporciona acceso al plano de imagen en blanco y negro del objeto ImageDocument actual.

, de solo lectura

Proporciona acceso al plano de imagen en color del objeto ImageDocument actual.

, de solo lectura

Proporciona acceso al plano de imagen gris del objeto ImageDocument actual.

, de solo lectura

Almacena el identificador del documento de imagen.

, de solo lectura

Cada plano de color del documento de imagen se caracteriza por su propio tipo de color. Esta propiedad especifica el tipo de color de todo el documento de imagen como el valor máximo de los valores correspondientes de sus planos de color (blanco y negro, gris, color).

, de solo lectura

Especifica si el documento de imagen se almacena solo en la memoria o si también está representado como una carpeta en el disco.

Después de llamar al método SaveTo, el valor de esta propiedad no cambia. Debe volver a cargar el documento de imagen llamando al método LoadImageDoc.

, de solo lectura

Almacena la ruta de acceso a la carpeta que contiene la representación interna del objeto en el disco. La propiedad contiene una cadena vacía si el valor de la propiedad IsInMemory es TRUE.

Después de llamar al método SaveTo, el valor de esta propiedad no cambia. Debe volver a cargar el documento de imagen llamando al método LoadImageDoc.

, de solo lectura

Devuelve elobjeto que contiene información sobre las coordenadas de los píxeles en el estado actual de modificación.

Esta propiedad resulta útil cuando necesita convertir coordenadas entre dos estados durante el procesamiento de imágenes.

, de solo lectura

Indica si se ha realizado alguna modificación en el objeto ImageDocument desde que se cargó en memoria o desde la última llamada al método.

, de solo lectura

Especifica la rotación aplicada a la imagen desde que se abrió.

, de solo lectura

Esta propiedad, establecida en TRUE, indica que los colores de la imagen se han invertido desde que se abrió.

, de solo lectura

Esta propiedad, cuando se establece en TRUE, especifica que la imagen se reflejó respecto al eje vertical desde que se abrió.

, de solo lectura

Esta propiedad indica si la inclinación de la imagen se corrigió por completo durante la apertura, el preprocesamiento o al llamar al método.

La tangente del ángulo de inclinación corregido se almacena en la propiedad SkewAngle.

, de solo lectura

Almacena la tangente del ángulo de inclinación detectado en la imagen y corregido durante la apertura, el preprocesamiento o al llamar almétodo. Si el ángulo de inclinación es negativo, la imagen se gira en el sentido de las agujas del reloj; si el ángulo es positivo, la imagen se gira en sentido contrario a las agujas del reloj. La imagen puede girarse alrededor de cualquier punto. El tamaño de la imagen corregida siempre es mayor que el tamaño de la imagen original.

Si realiza más modificaciones en la imagen, el valor de esta propiedad se restablece a 0. Guarde el valor del ángulo de inclinación corregido, si lo necesita, antes de llamar a cualquier otro método para editar la imagen.

, de solo lectura

Indica si el objeto ImageDocument se creó a partir de un archivo que contiene texto. Por ejemplo, los archivos PDF pueden incluir una capa de texto.

, de solo lectura

Indica si el objeto ImageDocument se creó a partir de un archivo que es una fotografía.

, de solo lectura

Proporciona información sobre el formato del archivo de imagen de origen del objeto ImageDocument actual. Si esta información no está disponible o la imagen se recibió desde un escáner, el valor de esta propiedad es IFF_UnknownFormat.

, de solo lectura

Proporciona información sobre el escáner utilizado para adquirir la imagen. Si no hay información disponible sobre los parámetros de la imagen de origen o la imagen se recibió de un archivo, el valor de esta propiedad es una cadena vacía.

, de solo lectura

Proporciona información sobre el umbral de intensidad de escaneado del objeto ImageDocument actual. Si la información sobre los parámetros de la imagen de origen no está disponible o la imagen se obtuvo de un archivo, el valor de esta propiedad es -1.

, de solo lectura

Proporciona información sobre la resolución horizontal de la imagen de origen del objeto ImageDocument actual. Si no se dispone de información sobre los parámetros de la imagen de origen, el valor de esta propiedad es 0.

, de solo lectura

Proporciona información sobre la resolución vertical de la imagen de origen del objeto ImageDocument actual. Si no hay información disponible sobre los parámetros de la imagen de origen, el valor de esta propiedad es 0.

Métodos

NombreDescripción
ApplySigmaFilterEste método aplica a la imagen un filtro para reducir el ruido. Resulta especialmente útil en fotografías.
ChangeResolutionCambia la resolución de la imagen.
CorrectShadowsAndHighlightsCorrige las sombras excesivas y las zonas sobreiluminadas de la imagen.
CorrectSkewCorrige la inclinación de la imagen.
CropImageDetecta los bordes del documento en la imagen y, a continuación, la recorta.
DitherImageAplica tramado a la imagen mediante el algoritmo Floyd–Steinberg o Bayer (ordenado).
EnhanceLocalContrastAumenta el contraste local de la imagen.
EqualizeBrightnessEcualiza el brillo de la imagen. Este método solo puede usarse con imágenes en escala de grises y en color.
FindBlackSquaresDetecta los cuadrados negros de la imagen.
GetPreviewImageProporciona acceso a la capa de imagen de vista previa de 94 * 60 del objeto ImageDocument actual. Si la vista previa de este tamaño aún no se ha creado, se creará en esta llamada, lo que llevará cierto tiempo.
GetPreviewImageSpecificSizeProporciona acceso al plano de imagen de vista previa del objeto ImageDocument actual y permite especificar su tamaño. Si la vista previa de ese tamaño aún no se ha creado, se creará durante esta llamada, lo que puede tardar algún tiempo.
GetTextBackgroundColorDetecta los colores del texto y del fondo en el rectángulo especificado de la imagen.
ModifyPermite modificar la imagen. Este método ofrece modificaciones más avanzadas que el método Transform.
RemoveColorObjectsElimina los objetos de color especificados de toda la imagen o de partes de ella. Este método solo puede usarse con imágenes en color.
RemoveColorObjectsExElimina de la imagen todos los objetos de color de los tonos especificados y los reemplaza por el color especificado. Los objetos eliminados pueden guardarse en una imagen independiente.
RemoveGarbageElimina el ruido de la imagen (puntos sobrantes más pequeños que un tamaño determinado).
RemoveGeometricalDistortionsElimina las distorsiones geométricas de la imagen (como las líneas curvadas cerca del borde de una página).
RemoveMotionBlurElimina el desenfoque por movimiento de la imagen.
RemoveNoiseReduce el ruido en la imagen.
SaveImageRegionToGuarda las partes de la imagen en una carpeta del disco. La imagen guardada está en el formato interno de ABBYY FineReader Engine.
SaveModifiedGuarda todas las modificaciones realizadas en el objeto ImageDocument actual en una carpeta del disco.
SaveToGuarda el contenido del objeto ImageDocument en una carpeta del disco. La imagen se guarda en el formato interno de ABBYY FineReader Engine.
SaveToFileGuarda el contenido del objeto ImageDocument en un archivo.
SaveToMemory

Nota: Solo para Windows.
Guarda el contenido del objeto ImageDocument en la memoria global.
SmoothImagePermite suavizar la imagen. Este método solo puede utilizarse con imágenes en escala de grises y en color.
SmoothTextureSuaviza la imagen mediante un filtro no lineal. Es útil para imágenes con textura. Este método solo puede utilizarse con imágenes en escala de grises y en color que midan al menos 3 píxeles en cada dimensión.
TransformAplica un conjunto limitado de transformaciones a la imagen.
ImageDocument Diagrama de objetos

Parámetro de salida

Este objeto es el parámetro de salida de los siguientes métodos LoadImageDocFromFile, LoadImageDocFromMemory (solo para Windows), LoadImageDoc, OpenBitmap, OpenDib, OpenBitmapBits, OpenImageFileFromMemory del objeto Engine.

Parámetro de entrada

Este objeto se pasa como parámetro de entrada a los siguientes métodos:

Ejemplos

El objeto se utiliza en los ejemplos de código: Linux: CommandLineInterface y BCR macOS: Reconocimiento de tarjetas de visita Windows: CommandLineInterface; y Demo Tools: Perfiles de procesamiento predefinidos del motor

Consulte también

IImageDocumentEvents Trabajar con imágenes Trabajar con objetos conectables Trabajar con propiedades