Skip to main content
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

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