ImageMask

Inheritance: java.lang.Object

All Implemented Interfaces: com.aspose.imaging.magicwand.imagemasks.IImageMask

public abstract class ImageMask implements IImageMask

Describe una máscara de imagen binaria.

Métodos

Método	Descripción
to_ImageGrayscaleMask(ImageMask mask)	Convertir `mask` a un ImageGrayscaleMask.
op_LogicalNot(ImageMask a)	Invierte la máscara.
op_Addition(ImageMask a, ImageMask b)	Unión de dos máscaras.
op_Subtraction(ImageMask a, ImageMask b)	Restar la segunda máscara de la primera.
op_Multiply(ImageMask a, ImageMask b)	Intersección de dos máscaras.
op_ExclusiveOr(ImageMask a, ImageMask b)	Disyunción exclusiva de dos máscaras.
getSource()	Obtiene la imagen fuente utilizada para crear esta máscara, si existe.
getWidth()	Obtiene el ancho, en píxeles, de esta máscara.
getHeight()	Obtiene la altura, en píxeles, de esta máscara.
getBounds()	Obtiene los límites, en píxeles, de esta máscara.
get_Item(int x, int y)	Obtiene la opacidad del píxel especificado.
inflate(int size)	Infla esta máscara en la cantidad especificada.
crop(Size size)	Recorta la máscara con el tamaño especificado.
crop(int width, int height)	Recorta la máscara con el ancho y la altura especificados.
crop(Rectangle rectangle)	Recorta la máscara con el rectángulo especificado.
isOpaque(int x, int y)	Comprueba si el píxel especificado es opaco.
isTransparent(int x, int y)	Comprueba si el píxel especificado es transparente.
getByteOpacity(int x, int y)	Obtiene la opacidad del píxel especificado con precisión de byte.
getFeathered()	Obtiene la máscara en escala de grises con el borde difuminado con la configuración predeterminada.
getFeathered(FeatheringSettings settings)	Obtiene la máscara en escala de grises con el borde difuminado con la configuración especificada.
apply()	Aplica la máscara actual a la fuente RasterImage, si existe.
applyTo(RasterImage image)	Aplica la máscara actual al RasterImage especificado.
invert()	Obtiene la inversión de la máscara actual.
union(ImageMask mask)	Obtiene la unión de la máscara actual con la proporcionada.
union()	Obtiene la unión de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.
union(MagicWandSettings settings)	Obtiene la unión de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.
union(RasterImage image)	Obtiene la unión de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.
union(RasterImage image, MagicWandSettings settings)	Obtiene la unión de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.
subtract(ImageMask mask)	Obtiene la sustracción de la máscara proporcionada de la actual.
subtract()	Obtiene el resultado de la selección con varita mágica aplicada a la fuente de la máscara actual restado de la máscara.
subtract(MagicWandSettings settings)	Obtiene el resultado de la selección con varita mágica aplicada a la fuente de la máscara actual restado de la máscara.
subtract(RasterImage image)	Obtiene el resultado de la selección con varita mágica aplicada a la imagen proporcionada restado de la máscara actual.
subtract(RasterImage image, MagicWandSettings settings)	Obtiene el resultado de la selección con varita mágica aplicada a la imagen proporcionada restado de la máscara actual.
intersect(ImageMask mask)	Obtiene la intersección de la máscara actual con la proporcionada.
intersect()	Obtiene la intersección de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.
intersect(MagicWandSettings settings)	Obtiene la intersección de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.
intersect(RasterImage image)	Obtiene la intersección de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.
intersect(RasterImage image, MagicWandSettings settings)	Obtiene la intersección de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.
exclusiveDisjunction(ImageMask mask)	Obtiene la disyunción exclusiva de la máscara actual con la proporcionada.
exclusiveDisjunction()	Obtiene la disyunción exclusiva de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.
exclusiveDisjunction(MagicWandSettings settings)	Obtiene la disyunción exclusiva de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.
exclusiveDisjunction(RasterImage image)	Obtiene la disyunción exclusiva de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.
exclusiveDisjunction(RasterImage image, MagicWandSettings settings)	Obtiene la disyunción exclusiva de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.

Example: The example shows how to select a complicated area of an image using Magic Wand tool and the ability to interact with masks (invert, union, subtract).

String imageFilePath = "input.png";
String outputFilePath = "masked-complex.png";
try (RasterImage image = (RasterImage)Image.load(imageFilePath))
{
    // Crea una nueva máscara usando la herramienta magic wand basada en el tono y color del píxel (845, 128)
    MagicWandTool.select(image, new MagicWandSettings(845, 128))
            // Unir la máscara existente con la especificada creada por la herramienta magic wand
            .union(new MagicWandSettings(416, 387))
            // Invertir la máscara existente
            .invert()
            // Restar la máscara especificada creada por la herramienta magic wand con el umbral especificado de la existente
            .subtract(new MagicWandSettings(1482, 346) {{ setThreshold(69); }})
            // Restar cuatro máscaras rectangulares especificadas de la máscara existente una por una
            .subtract(new RectangleMask(0, 0, 800, 150))
            .subtract(new RectangleMask(0, 380, 600, 220))
            .subtract(new RectangleMask(930, 520, 110, 40))
            .subtract(new RectangleMask(1370, 400, 120, 200))
            // Suavizar la máscara con los ajustes especificados
            .getFeathered(new FeatheringSettings() {{ setSize(3); }})
            // Aplicar máscara a la imagen
            .apply();

    // Guardar imagen
    image.save(outputFilePath);
}

to_ImageGrayscaleMask(ImageMask mask)

public static ImageGrayscaleMask to_ImageGrayscaleMask(ImageMask mask)

Convertir mask a un ImageGrayscaleMask.

Parameters:

Parámetro	Tipo	Descripción
mask	ImageMask	El valor de la máscara.

Returns: ImageGrayscaleMask - The new ImageGrayscaleMask base on mask.

op_LogicalNot(ImageMask a)

public static ImageBitMask op_LogicalNot(ImageMask a)

Invierte la máscara.

Parameters:

Parámetro	Tipo	Descripción
a	ImageMask	La máscara a invertir.

Returns: ImageBitMask - New ImageBitMask.

op_Addition(ImageMask a, ImageMask b)

public static ImageBitMask op_Addition(ImageMask a, ImageMask b)

Unión de dos máscaras.

Parameters:

Parámetro	Tipo	Descripción
a	ImageMask	La primera máscara.
b	ImageMask	La segunda máscara.

Returns: ImageBitMask - New ImageBitMask.

op_Subtraction(ImageMask a, ImageMask b)

public static ImageBitMask op_Subtraction(ImageMask a, ImageMask b)

Restar la segunda máscara de la primera.

Parameters:

Parámetro	Tipo	Descripción
a	ImageMask	La primera máscara.
b	ImageMask	La segunda máscara.

Returns: ImageBitMask - New ImageBitMask.

op_Multiply(ImageMask a, ImageMask b)

public static ImageBitMask op_Multiply(ImageMask a, ImageMask b)

Intersección de dos máscaras.

Parameters:

Parámetro	Tipo	Descripción
a	ImageMask	La primera máscara.
b	ImageMask	La segunda máscara.

Returns: ImageBitMask - New ImageBitMask.

op_ExclusiveOr(ImageMask a, ImageMask b)

public static ImageBitMask op_ExclusiveOr(ImageMask a, ImageMask b)

Disyunción exclusiva de dos máscaras.

Parameters:

Parámetro	Tipo	Descripción
a	ImageMask	La primera máscara.
b	ImageMask	La segunda máscara.

Returns: ImageBitMask - New ImageBitMask.

getSource()

public final RasterImage getSource()

Obtiene la imagen fuente utilizada para crear esta máscara, si existe.

Returns: RasterImage - the source image used to create this mask, if exists.

getWidth()

public final int getWidth()

Obtiene el ancho, en píxeles, de esta máscara.

Returns: int - el ancho, en píxeles, de esta máscara.

getHeight()

public final int getHeight()

Obtiene la altura, en píxeles, de esta máscara.

Returns: int - la altura, en píxeles, de esta máscara.

getBounds()

public final Rectangle getBounds()

Obtiene los límites, en píxeles, de esta máscara.

Returns: Rectangle - the bounds, in pixels, of this mask.

get_Item(int x, int y)

public abstract boolean get_Item(int x, int y)

Obtiene la opacidad del píxel especificado.

Parameters:

Parámetro	Tipo	Descripción
x	int	La coordenada x del píxel.
y	int	La coordenada y del píxel.

Returns: boolean - true si el píxel especificado es opaco; de lo contrario, false.

inflate(int size)

public abstract ImageMask inflate(int size)

Infla esta máscara en la cantidad especificada.

Parameters:

Parámetro	Tipo	Descripción
size	int	La cantidad para inflar esta máscara.

Returns: ImageMask - An ImageMask.

crop(Size size)

public final ImageMask crop(Size size)

Recorta la máscara con el tamaño especificado.

Parameters:

Parámetro	Tipo	Descripción
size	Size	El tamaño especificado.

Returns: ImageMask - An ImageMask.

crop(int width, int height)

public final ImageMask crop(int width, int height)

Recorta la máscara con el ancho y la altura especificados.

Parameters:

Parámetro	Tipo	Descripción
width	int	El ancho especificado.
height	int	La altura especificada.

Returns: ImageMask - An ImageMask.

crop(Rectangle rectangle)

public abstract ImageMask crop(Rectangle rectangle)

Recorta la máscara con el rectángulo especificado.

Parameters:

Parámetro	Tipo	Descripción
rectangle	Rectangle	El rectángulo especificado.

Returns: ImageMask - An ImageMask.

isOpaque(int x, int y)

public final boolean isOpaque(int x, int y)

Comprueba si el píxel especificado es opaco.

Parameters:

Parámetro	Tipo	Descripción
x	int	La coordenada x del píxel.
y	int	La coordenada y del píxel.

Returns: boolean - true si el píxel especificado es opaco; de lo contrario, false.

isTransparent(int x, int y)

public final boolean isTransparent(int x, int y)

Comprueba si el píxel especificado es transparente.

Parameters:

Parámetro	Tipo	Descripción
x	int	La coordenada x del píxel.
y	int	La coordenada y del píxel.

Returns: boolean - true si el píxel especificado es transparente; de lo contrario, false.

getByteOpacity(int x, int y)

public final byte getByteOpacity(int x, int y)

Obtiene la opacidad del píxel especificado con precisión de byte.

Parameters:

Parámetro	Tipo	Descripción
x	int	La coordenada x del píxel.
y	int	La coordenada y del píxel.

Returns: byte - Valor Byte, que representa la opacidad del píxel especificado.

getFeathered()

public final ImageGrayscaleMask getFeathered()

Obtiene la máscara en escala de grises con el borde difuminado con la configuración predeterminada.

Returns: ImageGrayscaleMask - #to_ImageGrayscaleMask(ImageMask).to_ImageGrayscaleMask(ImageMask)} with feathered border.

getFeathered(FeatheringSettings settings)

public final ImageGrayscaleMask getFeathered(FeatheringSettings settings)

Obtiene la máscara en escala de grises con el borde difuminado con la configuración especificada.

Parameters:

Parámetro	Tipo	Descripción
settings	FeatheringSettings	Configuración de difuminado.

Returns: ImageGrayscaleMask - #to_ImageGrayscaleMask(ImageMask).to_ImageGrayscaleMask(ImageMask)} with feathered border.

apply()

public final void apply()

Aplica la máscara actual a la fuente RasterImage, si existe.

Example: The example shows how to select a simple area of an image based on tone and color of any pixel using Magic Wand tool.

String imageFilePath = "input.png";
String outputFilePath = "masked.png";
try (RasterImage image = (RasterImage)Image.load(imageFilePath))
{
    // Crea una nueva máscara usando la herramienta magic wand basada en el tono y color del píxel (120, 100) con un umbral personalizado igual a 150
    MagicWandTool
            .select(image, new MagicWandSettings(120, 100) {{ setThreshold(150); }})
            // Aplicar máscara a la imagen
            .apply();

    // Guardar imagen con la opción de tipo de color de transparencia forzada
    image.save(outputFilePath, new PngOptions()
    {{
        setColorType(PngColorType.TruecolorWithAlpha);
    }});
}

applyTo(RasterImage image)

public final void applyTo(RasterImage image)

Aplica la máscara actual al RasterImage especificado.

Parameters:

Parámetro	Tipo	Descripción
image	RasterImage	Imagen a la que aplicar la máscara.

invert()

public final ImageBitMask invert()

Obtiene la inversión de la máscara actual.

Returns: ImageBitMask - New ImageBitMask.

Example: The example shows how to select a complicated area of an image using Magic Wand tool and the ability to interact with masks (invert, union, subtract).

String imageFilePath = "input.png";
String outputFilePath = "masked-complex.png";
try (RasterImage image = (RasterImage)Image.load(imageFilePath))
{
    // Crea una nueva máscara usando la herramienta magic wand basada en el tono y color del píxel (845, 128)
    MagicWandTool.select(image, new MagicWandSettings(845, 128))
            // Unir la máscara existente con la especificada creada por la herramienta magic wand
            .union(new MagicWandSettings(416, 387))
            // Invertir la máscara existente
            .invert()
            // Restar la máscara especificada creada por la herramienta magic wand con el umbral especificado de la existente
            .subtract(new MagicWandSettings(1482, 346) {{ setThreshold(69); }})
            // Restar cuatro máscaras rectangulares especificadas de la máscara existente una por una
            .subtract(new RectangleMask(0, 0, 800, 150))
            .subtract(new RectangleMask(0, 380, 600, 220))
            .subtract(new RectangleMask(930, 520, 110, 40))
            .subtract(new RectangleMask(1370, 400, 120, 200))
            // Suavizar la máscara con los ajustes especificados
            .getFeathered(new FeatheringSettings() {{ setSize(3); }})
            // Aplicar máscara a la imagen
            .apply();

    // Guardar imagen
    image.save(outputFilePath);
}

union(ImageMask mask)

public final ImageBitMask union(ImageMask mask)

Obtiene la unión de la máscara actual con la proporcionada.

Parameters:

Parámetro	Tipo	Descripción
mask	ImageMask	Máscara proporcionada

Returns: ImageBitMask - New ImageBitMask.

union()

public final ImageBitMask union()

Obtiene la unión de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.

Returns: ImageBitMask - New ImageBitMask.

union(MagicWandSettings settings)

public final ImageBitMask union(MagicWandSettings settings)

Obtiene la unión de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.

Parameters:

Parámetro	Tipo	Descripción
settings	MagicWandSettings	Configuración de la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

union(RasterImage image)

public final ImageBitMask union(RasterImage image)

Obtiene la unión de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.

Parameters:

Parámetro	Tipo	Descripción
image	RasterImage	Imagen para la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

union(RasterImage image, MagicWandSettings settings)

public final ImageBitMask union(RasterImage image, MagicWandSettings settings)

Obtiene la unión de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.

Parameters:

Parámetro	Tipo	Descripción
image	RasterImage	Imagen para la varita mágica.
settings	MagicWandSettings	Configuración de la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

subtract(ImageMask mask)

public final ImageBitMask subtract(ImageMask mask)

Obtiene la sustracción de la máscara proporcionada de la actual.

Parameters:

Parámetro	Tipo	Descripción
mask	ImageMask	Máscara proporcionada

Returns: ImageBitMask - New ImageBitMask.

subtract()

public final ImageBitMask subtract()

Obtiene el resultado de la selección con varita mágica aplicada a la fuente de la máscara actual restado de la máscara.

Returns: ImageBitMask - New ImageBitMask.

subtract(MagicWandSettings settings)

public final ImageBitMask subtract(MagicWandSettings settings)

Obtiene el resultado de la selección con varita mágica aplicada a la fuente de la máscara actual restado de la máscara.

Parameters:

Parámetro	Tipo	Descripción
settings	MagicWandSettings	Configuración de la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

subtract(RasterImage image)

public final ImageBitMask subtract(RasterImage image)

Obtiene el resultado de la selección con varita mágica aplicada a la imagen proporcionada restado de la máscara actual.

Parameters:

Parámetro	Tipo	Descripción
image	RasterImage	Imagen para la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

subtract(RasterImage image, MagicWandSettings settings)

public final ImageBitMask subtract(RasterImage image, MagicWandSettings settings)

Obtiene el resultado de la selección con varita mágica aplicada a la imagen proporcionada restado de la máscara actual.

Parameters:

Parámetro	Tipo	Descripción
image	RasterImage	Imagen para la varita mágica.
settings	MagicWandSettings	Configuración de la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

intersect(ImageMask mask)

public final ImageBitMask intersect(ImageMask mask)

Obtiene la intersección de la máscara actual con la proporcionada.

Parameters:

Parámetro	Tipo	Descripción
mask	ImageMask	Máscara proporcionada

Returns: ImageBitMask - New ImageBitMask.

intersect()

public final ImageBitMask intersect()

Obtiene la intersección de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.

Returns: ImageBitMask - New ImageBitMask.

intersect(MagicWandSettings settings)

public final ImageBitMask intersect(MagicWandSettings settings)

Obtiene la intersección de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.

Parameters:

Parámetro	Tipo	Descripción
settings	MagicWandSettings	Configuración de la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

intersect(RasterImage image)

public final ImageBitMask intersect(RasterImage image)

Obtiene la intersección de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.

Parameters:

Parámetro	Tipo	Descripción
image	RasterImage	Imagen para la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

intersect(RasterImage image, MagicWandSettings settings)

public final ImageBitMask intersect(RasterImage image, MagicWandSettings settings)

Obtiene la intersección de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.

Parameters:

Parámetro	Tipo	Descripción
image	RasterImage	Imagen para la varita mágica.
settings	MagicWandSettings	Configuración de la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(ImageMask mask)

public final ImageBitMask exclusiveDisjunction(ImageMask mask)

Obtiene la disyunción exclusiva de la máscara actual con la proporcionada.

Parameters:

Parámetro	Tipo	Descripción
mask	ImageMask	Máscara proporcionada

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction()

public final ImageBitMask exclusiveDisjunction()

Obtiene la disyunción exclusiva de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(MagicWandSettings settings)

public final ImageBitMask exclusiveDisjunction(MagicWandSettings settings)

Obtiene la disyunción exclusiva de la máscara actual con el resultado de la selección con varita mágica aplicada a la fuente de la máscara.

Parameters:

Parámetro	Tipo	Descripción
settings	MagicWandSettings	Configuración de la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(RasterImage image)

public final ImageBitMask exclusiveDisjunction(RasterImage image)

Obtiene la disyunción exclusiva de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.

Parameters:

Parámetro	Tipo	Descripción
image	RasterImage	Imagen para la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(RasterImage image, MagicWandSettings settings)

public final ImageBitMask exclusiveDisjunction(RasterImage image, MagicWandSettings settings)

Obtiene la disyunción exclusiva de la máscara actual con el resultado de la selección con varita mágica aplicada a la imagen proporcionada.

Parameters:

Parámetro	Tipo	Descripción
image	RasterImage	Imagen para la varita mágica.
settings	MagicWandSettings	Configuración de la varita mágica.

Returns: ImageBitMask - New ImageBitMask.

ImageGrayscaleMask RectangleMask