IEditablePictureObject - ABBYY Documentation

Qué hace

Representa una imagen que se puede editar en ABBYY FlexiCapture. El objeto es una extensión de la interfaz IPictureObject.

Este objeto no está disponible en la estación web de verificación para la comprobación local de reglas.

Métodos

Método	Descripción	Color de imagen admitido
`ApplyContourSmoother( params: IContourSmootherParams )`	Aplica el suavizado de contornos a una imagen.	Para imágenes en escala de grises y en color
`ApplyLocalContrastFilter( params: ILocalContrastParams )`	Aplica el filtro de contraste no adaptativo a una imagen.	Para imágenes en escala de grises y en color
`ApplyMultiscaleLocalContrastFilter()`	Aplica el filtro de contraste adaptativo a una imagen. Use este método para transformar una imagen en un documento escaneado.	Para imágenes en escala de grises y en color
`ApplyShadowsHighlightsFilter( params: IShadowsHighlightsParams )`	Aplica el realce de sombras a una imagen.	Para imágenes en escala de grises y en color
`ApplySigmaFilter()`	Elimina el ruido digital de una imagen.	Para todas las imágenes
`AutoCrop( [optional] type: string )`	Recorta una imagen automáticamente. Los valores posibles del parámetro `type` son `Photo`, `Scan` y `Generic`. El valor predeterminado es `Generic`.	Para todas las imágenes
`Binarize( params: IBinarizationParams )`	Convierte los colores de una imagen a blanco y negro. Tiene un conjunto de propiedades distinto del método `ConvertToBW`.	Para imágenes en escala de grises y en color
`ConvertToBW( [optional] threshold: int )`	Convierte una imagen a blanco y negro. Puede especificar un valor de umbral de brillo. Los valores superiores al umbral se consideran blancos y los inferiores, negros. El valor del umbral de brillo puede variar de `0` a `255`.	Para todas las imágenes
`CreateBinarizationParams(): IBinarizationParams`	Crea un objeto con los parámetros del método `Binarize`.	Para todas las imágenes
`CreateContourSmootherParams(): IContourSmootherParams`	Crea un objeto con parámetros para el suavizador de contornos.	Para todas las imágenes
`CreateLocalContrastFilterParams(): ILocalContrastParams`	Crea un objeto con parámetros para la acción de contraste. Los parámetros del filtro se establecen con los valores predeterminados.	Para todas las imágenes
`CreateShadowsHighlightsFilterParams(): IShadowsHighlightsParams`	Crea un objeto con parámetros para la acción de cambiar el efecto de iluminación de las sombras.	Para todas las imágenes
`Crop( rect: string )`	Recorta la imagen fuera del rectángulo especificado.	Para todas las imágenes
`CutOut( rect: string ): IEditablePictureObject`	Corta un rectángulo especificado de la imagen y devuelve este rectángulo.	Para todo tipo de imágenes
`Deskew( [optional] byLines: bool, [optional] byBlackSquares: bool, [optional] byText: bool )`	Corrige la inclinación de la imagen. La inclinación puede corregirse basándose en líneas rectas, cuadrados negros o texto. De forma predeterminada, el parámetro `byText` está establecido en `true`.	Para todo tipo de imágenes
`Despeckle( [optional] garbageSize: int )`	Elimina el ruido de las imágenes en blanco y negro. Se eliminan las motas de hasta el tamaño indicado. Si no se especifica el parámetro `garbageSize`, el tamaño se detecta automáticamente.	Solo para imágenes en blanco y negro
`Erase( rectangle: cadena, [opcional] red: int, [opcional] green: int, [opcional] blue: int )`	Borra un área de la imagen. Puede especificar el color con el que se borrará el área. De forma predeterminada, se utiliza el color negro.	Para todas las imágenes
`FlipHorizontal()`	Invierte la imagen horizontalmente.	Para todas las imágenes
`FlipVertical()`	Voltea la imagen verticalmente.	Para todas las imágenes
`FreeScale( newWidth: int, newHeight: int, newResolution: int )`	Redimensiona la página según los nuevos valores.	Para todas las imágenes
`Invert( [opcional] rectString: cadena )`	Invierte la imagen. Puede especificar una cadena con las coordenadas del rectángulo que desea invertir.	Para todas las imágenes
`NewRectsArray(): IRects`	Crea una nueva colección de rectángulos. Devuelve un objeto IRects.	Solo para imágenes en color
`RemoveMotionBlur()`	Elimina el desenfoque causado por el movimiento del documento, la cámara o el escáner durante el escaneo.	Para todas las imágenes
`RemoveStamps( color: TColorToFilter, rects: IRects )`	Elimina sellos de color y otras marcas de un color determinado de una imagen. Para obtener más información, consulte Eliminar sellos de color de una imagen.	Solo para imágenes en color
`RemoveStampsExt( colorsToFilter: string )`	Elimina sellos de color y otras marcas de una imagen mediante un algoritmo mejorado que permite eliminar una mayor variedad de colores. Este es el método recomendado. Para obtener más información, consulte Quitar colores de sello adicionales.	Solo para imágenes en color
`Rotate( angle: int )`	Gira la imagen en el sentido de las agujas del reloj hasta el ángulo indicado.	Para todas las imágenes
`Scale( ratio: int )`	Estira o comprime la imagen con respecto al tamaño base del 100 %. El método solo se aplica al tamaño en píxeles de la imagen. El tamaño físico de la imagen no cambia.	Para todas las imágenes

El parámetro rect que se pasa a los métodos CutOut y Crop es una cadena con el formato "[left, top, right, bottom]". Para obtener esta cadena, llame al método ToString de cualquier objeto IRect o use el método Rect de IFlexiCaptureTools (FCTools).

Eliminar sellos de color de una imagen

El método RemoveStamps elimina sellos de color y otras marcas de un color especificado de una imagen. Este método solo funciona con imágenes en color.

Parámetro	Tipo	Descripción
`color`	TColorToFilter	El color de los sellos que se van a eliminar.
`rects`	IRects	La colección de rectángulos de los sellos que se van a eliminar.

El siguiente script de ejemplo para un evento On User Command elimina los sellos rojos de todas las páginas. Se buscan sellos en toda el área de la página.

MainWindow.TaskWindow.OpenDocument( MainWindow.TaskWindow.EditorWindow.Document );
foreach (IPage page in MainWindow.TaskWindow.EditorWindow.Document.Pages)
{
    if (page.Picture.IsColor)
    {
        IEditablePictureObject editablePicture = page.Picture.CreateEditableCopy();
        IRects rects = editablePicture.NewRectsArray();
        rects.AddRect(0, 0, editablePicture.Width - 1, editablePicture.Height - 1); // toda la página
        editablePicture.RemoveStamps(TColorToFilter.CTF_Red, rects);
        page.ReplaceImage(editablePicture);
    }
}

Eliminar colores de sello adicionales

El método RemoveStampsExt elimina de una imagen los sellos de color y otras marcas de un color especificado. Es similar a RemoveStamps, pero utiliza un algoritmo mejorado que elimina una mayor variedad de colores. Este es el método recomendado para eliminar sellos. El parámetro colorsToFilter (string) establece el color de los sellos que se deben eliminar:

Acepta los siguientes valores de cadena: Red, Green, Blue, Yellow, Orange, LightBlue y Purple (no distingue entre mayúsculas y minúsculas).
Puede especificar varios valores separados por comas, por ejemplo, "Red, Green".
Puede especificar una cadena vacía ("") para que el programa seleccione automáticamente el color de sello adecuado. El programa elimina cualquier sello que detecte en una imagen y que tenga uno de los valores de color permitidos.

El siguiente script de ejemplo para un evento On User Command elimina los sellos rojos y verdes de todas las páginas:

foreach (IPage page in Document.Pages)
{
    if (page.Picture.IsColor)
    {
        IPictureObject picture = page.Picture;
        IEditablePictureObject editablePicture = picture.CreateEditableCopy();
        editablePicture.RemoveStampsExt("Red, Green");
        page.ReplaceImage(editablePicture);
    }
}

Ejemplos de etapas de procesamiento personalizadas

Estos scripts muestran cómo usar métodos de IEditablePictureObject en etapas de procesamiento personalizadas.

Aplicar un filtro de contraste local

Este script crea un objeto con parámetros para el filtro de contraste local, ajusta los parámetros manualmente y aplica el filtro a una imagen.

foreach( IPage page in Document.Pages )
{
    IPictureObject picture = page.Picture;
    IEditablePictureObject editablePicture = picture.CreateEditableCopy();
    // Creación de un objeto con parámetros (los parámetros se establecen de forma predeterminada)
    ILocalContrastParams localContrastParams = editablePicture.CreateLocalContrastFilterParams();
    // Configuración de los parámetros cuyos valores se modificarán posteriormente
    localContrastParams.Radius = 7;
    localContrastParams.NoiseLevel = 200;
    // Aplicación de un filtro a la imagen
    editablePicture.ApplyLocalContrastFilter( localContrastParams );
    // Reemplazo de la imagen de una página por la versión modificada
    page.ReplaceImage( editablePicture );
}

Binarizar una imagen con parámetros personalizados

Este script crea un objeto con parámetros para el método Binarize y convierte la imagen en blanco y negro con los parámetros establecidos.

foreach ( IPage page in Document.Pages )
{
    IPictureObject picture = page.Picture;
    IEditablePictureObject editablePicture = picture.CreateEditableCopy();
    // Creación de un objeto con parámetros (los parámetros se establecen de forma predeterminada)
    IBinarizationParams binarizationParams =  editablePicture.CreateBinarizationParams();
    // Configuración del parámetro en verdadero o falso
    binarizationParams.SmoothTexture = false;
    editablePicture.Binarize( binarizationParams );
    page.ReplaceImage( editablePicture );
}

Mejorar las páginas seleccionadas en Verification Station

Este script aumenta el contraste, elimina el ruido digital, aplica el recorte automático y corrige el desenfoque de las páginas seleccionadas. El operador de Verification Station ejecuta el script.

foreach( IPageItem pageItem in MainWindow.Selection.PageItems) {
    pageItem.TaskWindow.CloseEditorWindow();
    pageItem.TaskWindow.OpenDocument(  pageItem.DocumentItem.Document );
    IPage page = pageItem.Page;
    IEditablePictureObject editablePicture = page.Picture.CreateEditableCopy();
    // Aplica las transformaciones de imagen
    editablePicture.AutoCrop();
    editablePicture.ApplySigmaFilter();
    editablePicture.ApplyMultiscaleLocalContrastFilter();
    editablePicture.RemoveMotionBlur();
    // Reemplaza la imagen del documento original con la imagen editada
    page.ReplaceImage( editablePicture );
    pageItem.TaskWindow.CloseDocument(  pageItem.DocumentItem.Document );
}

​Qué hace

​Métodos

​Eliminar sellos de color de una imagen

​Eliminar colores de sello adicionales

​Ejemplos de etapas de procesamiento personalizadas

​Aplicar un filtro de contraste local

​Binarizar una imagen con parámetros personalizados

​Mejorar las páginas seleccionadas en Verification Station

Qué hace

Métodos

Eliminar sellos de color de una imagen

Eliminar colores de sello adicionales

Ejemplos de etapas de procesamiento personalizadas

Aplicar un filtro de contraste local

Binarizar una imagen con parámetros personalizados

Mejorar las páginas seleccionadas en Verification Station