SaveImageAs

Guarda una nueva copia de la imagen, lo que permite el ajuste del tipo de imagen, el color, la profundidad y la compresión.

Sintaxis

bool SaveImageAs ()

Parámetros

NewFileType: Serie. El tipo de archivo de la nueva imagen. Tipos soportados: TIF, JPG, BMP, PNG.

NewColorDepth: Serie. La nueva profundidad de color de la imagen. Valores: 0, 1, 8, 24.

0: conserva la misma profundidad de color que la imagen de origen. Si está en blanco, se utiliza 0 como valor predeterminado. Si la imagen de origen es una imagen en color de 32 bits, la profundidad de bits máxima de la imagen guardada es de 24 bits por píxel.
1, 8, 24: los nuevos bits por píxel de la imagen guardada.

Palette: Serie. La paleta de colores que se utiliza para la imagen guardada. Se aceptan los valores siguientes:

Optimized: una paleta con los colores optimizados para la imagen. Si no se especifica, es el valor predeterminado.
Fixed: una paleta de colores fija.
Gray: una paleta en escala de grises.

Dither: Serie. El patrón de puntos que se utiliza al reducir la profundidad de color de una imagen. Se aceptan los valores siguientes: Binarize1, Binarize2, FS, None, Optimized y Ordered.

Binarize1: una conversión optimizada para eliminar información de segundo plano y dejar la información de primer plano como, por ejemplo, el texto oscuro. Normalmente es el mejor valor para convertir una imagen o una fotografía a blanco y negro para utilizarse para el reconocimiento de texto. No se realiza ningún difuminado. Da como resultado una imagen en blanco y negro. Si no se proporciona dither, es el método predeterminado para guardar imágenes de 1 bit.
Binarize2: similar a Binarize1, pero puede ser un poco más rápida. No se realiza ningún difuminado. Da como resultado una imagen en blanco y negro.
FS: utiliza el algoritmo de Floyd-Steinberg para difuminar una imagen de color en una imagen en blanco y negro. No utilice este valor si la imagen se va a reconocer posteriormente. El difuminado solo debe utilizarse para mantener un aspecto "sombreado" en la imagen y cuando la imagen no se va a utilizar posteriormente en un paso de reconocimiento.
None: no se realiza ningún difuminado. Es similar a los métodos Binarize, pero no puede generar resultados tan buenos como Binarize1 para realizar el reconocimiento de texto. A diferencia de Binarize, este valor no está limitado a imágenes en blanco y negro.
Optimized: el motor de imagen determina cómo se debe difuminar la imagen. Una imagen difuminada genera una imagen en blanco y negro que simula una imagen en escala de grises, similar a un periódico. Se recomienda utilizar este método para convertir una fotografía a blanco y negro con la intención de conservar la imagen fotográfica mientras se convierte en una imagen en blanco y negro. Este es el valor predeterminado si la profundidad de color de destino es mayor que 1. Si se realiza el reconocimiento en la imagen, utilice Binarize1 en su lugar para convertir la imagen a blanco y negro o utilice "None" cuando se convierta a 24 bits o 8 bits por píxel.
Ordered: un método alternativo para convertir una imagen en color en una fotografía difuminada en blanco y negro. De nuevo, no se recomienda utilizar este valor si la imagen se va a reconocer posteriormente.

BackupSuffix: Serie. Cuando se guarda la imagen actual, la imagen original también se mantiene. Si la nueva imagen guardada tiene el mismo nombre que la imagen de origen original, la imagen de origen se guarda añadiendo un sufijo al nombre. De forma predeterminada, se añade el sufijo ".original" al nombre de archivo. Por ejemplo, si el nombre de la imagen de origen es "TM000001.tif", la imagen original se guarda como "TM000001.original.tif" y la nueva imagen se guarda como "TM000001.tif". Si lo desea, este sufijo se puede cambiar utilizando este parámetro. Por ejemplo, si se pasa el valor ".backup", se guarda la imagen original como "TM000001.backup.tif". Si la imagen de origen es de un tipo como, por ejemplo, "TM000001.jpg" y la nueva imagen es de un tipo diferente como, por ejemplo, "TM000001.TIF", el nombre de imagen de origen no entra en conflicto con el nuevo nombre de imagen guardada y el nombre de imagen de origen no cambia. Si desea cambiar el nombre de la imagen de origen en este caso, puede utilizar las acciones FileIO para cambiar el nombre del archivo original como desee.

DeleteOriginal: Serie. "True" o "False". Si este parámetro se establece en "True", la imagen original no se guarda en el lote. Si este parámetro se establece en "False", la imagen original se mantiene y está disponible para su uso posterior en el lote, por ejemplo, para el archivado. Si no se proporciona este parámetro, el valor predeterminado es "False" y se guarda la imagen original.

Se admiten parámetros Smart para todos los parámetros.

Devuelve

True, si la operación se ha realizado correctamente, False, si se produce algún error.

Nivel

Solo nivel de página, y la página debe hacer referencia a un archivo de imagen válido de una sola página.

Detalles

Esta acción actualiza la imagen actual asociada con el objeto de página y cambia alguno o todos estos atributos de imagen:

Formato de imagen
Tipo de compresión
Profundidad de color/bits por píxel

Formatos de entrada: BMP, DIB, EMF, GIF, JPEG, JPEG2000, PNG, TIF, WMF.

Formatos de salida: BMP, PNG, JPEG, TIF.

La imagen actual puede guardarse como el mismo tipo de archivo, cambiando solo la compresión o la profundidad de color de la imagen. Por ejemplo, un TIF con compresión JPEG puede volverse a guardar como un TIF con compresión LZW. La imagen actual también puede cambiarse a un nuevo tipo de archivo, por ejemplo, una imagen JPEG se puede convertir en una imagen TIFF.

La imagen de origen puede tener una profundidad de color de hasta 32 bits por píxel. La imagen puede guardarse con una profundidad de color de hasta 24 bits por píxel. Algunas acciones de Datacap tienen requisitos de profundidad de color específicos; esta acción puede utilizarse para ajustar la imagen actual a diferentes profundidades de color según sea necesario en las acciones y conjuntos de reglas posteriores.

Si el tipo de archivo de imagen final es el mismo que el tipo de archivo de imagen de origen, la acción primero realiza una copia de seguridad de la imagen original y le da un nombre exclusivo añadiendo el sufijo ".original" al nombre de archivo. Por ejemplo, si el nombre de archivo de origen es "TM000001.tif" y la imagen se guarda como un TIF, el archivo original se guarda como "TM000001.orignal.tif" y el archivo "TM000001.tif" es el nombre del nuevo archivo actualizado.

El archivo de imagen asociado con el objeto de página actual se puede convertir en uno de estos tipos de archivo: BMP, PNG, TIF y JPEG. Las imágenes de bitmap (BMP) siempre se guardan sin compresión, por lo que pueden ser grandes. Los archivos PNG (Portable Network Graphics) utilizan una compresión sin pérdidas que funciona en una imagen de 1 bit, 8 bits o 24 bits.

Las acciones SaveImageSettingsTIFF y SaveImageSettingsJPEG se pueden invocar antes de esta acción para ajustar el formato de archivo utilizado para guardar la imagen cuando se guarda como una imagen TIF o JPG. Por ejemplo, la compresión de archivo predeterminada de las imágenes TIF es LZW. Si se invoca primero SaveImageSettingsTIFF, se puede cambiar la compresión predeterminada para cuando la acción SaveImageAs guarde un archivo como un TIFF. Por ejemplo, si se convierte en una imagen en blanco y negro, se pueden configurar Group 3 o Group 4 como el tipo de compresión, ya que es un método eficiente y sin pérdidas para las imágenes en blanco y negro.

Si una aplicación está ingiriendo imágenes JPEG o imágenes TIF con compresión JPEG, y estas imágenes se van a utilizar para el reconocimiento, se recomienda especialmente convertir la imagen en un formato sin pérdidas como, por ejemplo, un TIF con compresión LZW, inmediatamente después de que se ingieran las imágenes en un lote. Las acciones posteriores podrán operar en la nueva imagen TIF utilizando una compresión sin pérdidas. Si es necesario, la versión original de la imagen siempre está disponible para la visualización en un panel Verificación o para la exportación al final del lote. La compresión JPEG está especialmente indicada para las fotografías, no para las imágenes que contienen texto que se va a reconocer. La compresión JPEG convierte las líneas nítidas de las letras en difusas, lo que reduce la calidad del reconocimiento. Si continúa manipulándose la imagen, por ejemplo, con la mejora de imagen, la rotación, etc., y se guarda de nuevo con compresión JPEG, se pierde calidad adicional con cada operación de guardar, aunque la compresión se establezca en una calidad alta.

Puede ser muy útil utilizar la acción SaveImageInformation junto con esta acción. SaveImageInformation lee atributos de imagen y almacena los valores en el DCO. Se pueden configurar reglas de aplicación para que actúen en esta información. Por ejemplo, si una imagen tiene una profundidad de color mayor de 24 bits por píxel, las reglas pueden invocar SaveImageAs para reducir la profundidad de color de la imagen.

También se puede utilizar la acción SaveImageInformation para obtener la compresión utilizada dentro de la imagen. Por ejemplo, se pueden organizar las reglas para comprobar el tipo de compresión de imagen actual y, si el tipo de compresión es "JPEG", las reglas pueden invocar SaveImageAs solo en esas imágenes para guardarlas con una compresión sin pérdidas y, si la imagen ya tiene una compresión sin pérdidas, la imagen se puede dejar tal cual.

Ejemplo 1:

SaveImageInformation("","","","","","","","@X.ImgCompression")
rrCompareCase("Jpeg", "@X.ImgCompression", "False")
SaveImageAsSettingsTIFF("LZW")
SaveImageAs("TIF","0","","","","")

En este ejemplo, se comprueba si la imagen TIFF actual utiliza la compresión JPEG. Si tiene compresión JPEG, las acciones configuran la compresión para las imágenes TIF guardadas en LZW utilizando la acción SaveImageAsSettingsTIFF. El ejemplo se muestra en la misma regla que la regla de SaveImageAs. Si los valores se supone que serán iguales en todas las páginas, será más eficaz colocar SaveImageAsSettingsTIFF en una regla conectada al suceso de apertura de lote. Esto solo permitirá invocar la acción una vez, en lugar de una y otra vez para cada página.

La acción SaveImageAs convierte la imagen de página actual en un TIF utilizando la compresión LZW. No importa si la imagen de origen es un TIF o un tipo de imagen diferente como, por ejemplo, JPEG o PNG. El parámetro 0 retiene la misma profundidad de color que la imagen original. Si la imagen era en blanco y negro, se queda como una imagen en blanco y negro de 1 bit. Si la imagen de origen era en color de 24 bits, se guarda como en color de 24 bits. Este ejemplo es una buena forma de convertir imágenes que se pueden guardar utilizando una compresión con pérdidas como, por ejemplo, JPEG, en una compresión sin pérdidas para limitar la degradación adicional de la calidad provocada por una compresión sin pérdidas.

Ejemplo 2:

SaveImageAsSettingsJPEG("100","False","True")
SaveImageAs("JPEG","0","Optimized","Optimized",".Old","False")

En este ejemplo, se convierte la imagen actual en una imagen JPEG. Aunque el parámetro de profundidad de color se establezca en "0", lo que significa conservar la profundidad de color original, las imágenes JPEG solo pueden guardarse como una escala de grises de 8 bits o un color de 24 bits. Si la imagen de origen es de 1 bit, se convierte en sentido ascendente. Aunque aún se ve en blanco y negro, se convierte a una profundidad de color de 24 bits. Este ejemplo también utiliza una extensión personalizada, ".Old", para hacer una copia de seguridad del nombre de archivo original, en el caso de que el nuevo nombre de archivo y el nombre de archivo anterior se evalúen en el mismo nombre.

De nuevo, aunque este ejemplo muestra la invocación de SaveImageAsSettingsJPEG en la misma función de regla justo antes de SaveImageAs, si todas las páginas van a tener los mismos valores, se puede invocar esta acción a nivel de documento o de lote y el valor permanecerá en vigor el resto del perfil de tarea actual. La invocación de esta acción a un nivel superior evita la invocación innecesaria de esta acción una y otra vez para cada objeto de página. Si cada objeto de página necesita parámetros diferentes al guardarse, será necesario invocar la acción con cada página.

Se recomienda guardarla como un JPEG o un TIF con compresión JPEG si no se van a utilizar fotografías de procesamiento para el reconocimiento de texto. Si se realiza el reconocimiento de texto en una imagen o si se realizan mejoras de imagen, se recomienda convertir primero a una compresión sin pérdidas y no utilizar el formato de imagen JPEG.

Ejemplo 3:

rrSet("Group4", "@X.Compression")
rrSet("TIF", "@X.NewFileType")
rrSet("True", "@X.DeleteOriginal")
SaveImageAsSettingsTIFF(@X.Compression)
SaveImageAs("@X,NewFileType","1","","","","@X.DeleteOriginal")

Este es otro ejemplo que convierte la imagen de página actual en un TIF, independientemente del formato original. También convierte la imagen en una imagen en blanco y negro con compresión de fax Group 4, que es una compresión en blanco y negro eficiente y sin pérdidas.

Este ejemplo demuestra el uso de parámetros Smart para pasar valores a las acciones. El ejemplo muestra cómo se pasa una variable, New Filetype, como un parámetro Smart a la acción en el tiempo de ejecución. Se obtendrá el valor de la variable "NewFileType" y se utilizará como parámetro de entrada. En un ejemplo realista, es probable que alguna regla o acción anterior haya establecido el valor en la variable DCO "NewFileType" antes de invocar la acción. Por ejemplo, puede haberse establecido previamente un valor en un campo o haber datos que se han reconocido en un campo y, a continuación, se ha pasado la referencia a un campo como el parámetro, utilizando el valor de tiempo de ejecución actual del campo como entrada para la acción. En otro método, se podría configurar los valores en el DCO de configuración, que se puede establecer en Datacap Studio, por lo que preexistirán para el objeto y, a continuación, las acciones extraerán el valor en el tiempo de ejecución de una variable preconfigurada.