ImageMask

Inheritance: java.lang.Object

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

public abstract class ImageMask implements IImageMask

Décrit un masque d’image binaire.

Méthodes

Méthode	Description
to_ImageGrayscaleMask(ImageMask mask)	Conversion de mask en un ImageGrayscaleMask.
op_LogicalNot(ImageMask a)	Inverse le masque.
op_Addition(ImageMask a, ImageMask b)	Union de deux masques.
op_Subtraction(ImageMask a, ImageMask b)	Soustraire le deuxième masque du premier.
op_Multiply(ImageMask a, ImageMask b)	Intersection de deux masques.
op_ExclusiveOr(ImageMask a, ImageMask b)	Disjonction exclusive de deux masques.
getSource()	Obtient l’image source utilisée pour créer ce masque, si elle existe.
getWidth()	Obtient la largeur, en pixels, de ce masque.
getHeight()	Obtient la hauteur, en pixels, de ce masque.
getBounds()	Obtient les limites, en pixels, de ce masque.
get_Item(int x, int y)	Obtient l’opacité du pixel spécifié.
inflate(int size)	Agrandit ce masque du montant spécifié.
crop(Size size)	Recadre le masque avec la taille spécifiée.
crop(int width, int height)	Recadre le masque avec la largeur et la hauteur spécifiées.
crop(Rectangle rectangle)	Recadre le masque avec le rectangle spécifié.
isOpaque(int x, int y)	Vérifie si le pixel spécifié est opaque.
isTransparent(int x, int y)	Vérifie si le pixel spécifié est transparent.
getByteOpacity(int x, int y)	Obtient l’opacité du pixel spécifié avec une précision d’octet.
getFeathered()	Obtient le masque en niveaux de gris avec la bordure adoucie selon les paramètres par défaut.
getFeathered(FeatheringSettings settings)	Obtient le masque en niveaux de gris avec la bordure adoucie selon les paramètres spécifiés.
apply()	Applique le masque actuel à la source RasterImage, si elle existe.
applyTo(RasterImage image)	Applique le masque actuel au RasterImage spécifié.
invert()	Obtient l’inversion du masque actuel.
union(ImageMask mask)	Obtient l’union du masque actuel avec celui fourni.
union()	Obtient l’union du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.
union(MagicWandSettings settings)	Obtient l’union du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.
union(RasterImage image)	Obtient l’union du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.
union(RasterImage image, MagicWandSettings settings)	Obtient l’union du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.
subtract(ImageMask mask)	Obtient la soustraction du masque fourni du masque actuel.
subtract()	Obtient le résultat de la sélection baguette magique appliquée à la source du masque actuel, soustrait du masque.
subtract(MagicWandSettings settings)	Obtient le résultat de la sélection baguette magique appliquée à la source du masque actuel, soustrait du masque.
subtract(RasterImage image)	Obtient le résultat de la sélection baguette magique appliquée à l’image fournie, soustrait du masque actuel.
subtract(RasterImage image, MagicWandSettings settings)	Obtient le résultat de la sélection baguette magique appliquée à l’image fournie, soustrait du masque actuel.
intersect(ImageMask mask)	Obtient l’intersection du masque actuel avec celui fourni.
intersect()	Obtient l’intersection du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.
intersect(MagicWandSettings settings)	Obtient l’intersection du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.
intersect(RasterImage image)	Obtient l’intersection du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.
intersect(RasterImage image, MagicWandSettings settings)	Obtient l’intersection du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.
exclusiveDisjunction(ImageMask mask)	Obtient la disjonction exclusive du masque actuel avec le fourni.
exclusiveDisjunction()	Obtient la disjonction exclusive du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.
exclusiveDisjunction(MagicWandSettings settings)	Obtient la disjonction exclusive du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.
exclusiveDisjunction(RasterImage image)	Obtient la disjonction exclusive du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.
exclusiveDisjunction(RasterImage image, MagicWandSettings settings)	Obtient la disjonction exclusive du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.

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))
{
    // Créez un nouveau masque en utilisant le magic wand tool basé sur la tonalité et la couleur du pixel (845, 128).
    MagicWandTool.select(image, new MagicWandSettings(845, 128))
            // Fusionnez le masque existant avec celui spécifié créé par le magic wand tool.
            .union(new MagicWandSettings(416, 387))
            // Inversez le masque existant.
            .invert()
            // Soustrayez le masque spécifié créé par le magic wand tool avec le seuil spécifié du masque existant.
            .subtract(new MagicWandSettings(1482, 346) {{ setThreshold(69); }})
            // Soustrayez quatre masques rectangulaires spécifiés du masque existant un par un.
            .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))
            // Adoucissez le masque avec les paramètres spécifiés.
            .getFeathered(new FeatheringSettings() {{ setSize(3); }})
            // Appliquez le masque à l'image.
            .apply();

    // Enregistrez l'image.
    image.save(outputFilePath);
}

to_ImageGrayscaleMask(ImageMask mask)

public static ImageGrayscaleMask to_ImageGrayscaleMask(ImageMask mask)

Conversion de mask en un ImageGrayscaleMask.

Parameters:

Paramètre	Type	Description
mask	ImageMask	La valeur du masque.

Returns: ImageGrayscaleMask - The new ImageGrayscaleMask base on mask.

op_LogicalNot(ImageMask a)

public static ImageBitMask op_LogicalNot(ImageMask a)

Inverse le masque.

Parameters:

Paramètre	Type	Description
a	ImageMask	Le masque à inverser.

Returns: ImageBitMask - New ImageBitMask.

op_Addition(ImageMask a, ImageMask b)

public static ImageBitMask op_Addition(ImageMask a, ImageMask b)

Union de deux masques.

Parameters:

Paramètre	Type	Description
a	ImageMask	Le premier masque.
b	ImageMask	Le deuxième masque.

Returns: ImageBitMask - New ImageBitMask.

op_Subtraction(ImageMask a, ImageMask b)

public static ImageBitMask op_Subtraction(ImageMask a, ImageMask b)

Soustraire le deuxième masque du premier.

Parameters:

Paramètre	Type	Description
a	ImageMask	Le premier masque.
b	ImageMask	Le deuxième masque.

Returns: ImageBitMask - New ImageBitMask.

op_Multiply(ImageMask a, ImageMask b)

public static ImageBitMask op_Multiply(ImageMask a, ImageMask b)

Intersection de deux masques.

Parameters:

Paramètre	Type	Description
a	ImageMask	Le premier masque.
b	ImageMask	Le deuxième masque.

Returns: ImageBitMask - New ImageBitMask.

op_ExclusiveOr(ImageMask a, ImageMask b)

public static ImageBitMask op_ExclusiveOr(ImageMask a, ImageMask b)

Disjonction exclusive de deux masques.

Parameters:

Paramètre	Type	Description
a	ImageMask	Le premier masque.
b	ImageMask	Le deuxième masque.

Returns: ImageBitMask - New ImageBitMask.

getSource()

public final RasterImage getSource()

Obtient l’image source utilisée pour créer ce masque, si elle existe.

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

getWidth()

public final int getWidth()

Obtient la largeur, en pixels, de ce masque.

Returns: int - la largeur, en pixels, de ce masque.

getHeight()

public final int getHeight()

Obtient la hauteur, en pixels, de ce masque.

Returns: int - la hauteur, en pixels, de ce masque.

getBounds()

public final Rectangle getBounds()

Obtient les limites, en pixels, de ce masque.

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

get_Item(int x, int y)

public abstract boolean get_Item(int x, int y)

Obtient l’opacité du pixel spécifié.

Parameters:

Paramètre	Type	Description
x	int	La coordonnée x du pixel.
y	int	La coordonnée y du pixel.

Returns: boolean - vrai si le pixel spécifié est opaque ; sinon, faux.

inflate(int size)

public abstract ImageMask inflate(int size)

Agrandit ce masque du montant spécifié.

Parameters:

Paramètre	Type	Description
taille	int	La quantité à gonfler ce masque.

Returns: ImageMask - An ImageMask.

crop(Size size)

public final ImageMask crop(Size size)

Recadre le masque avec la taille spécifiée.

Parameters:

Paramètre	Type	Description
size	Size	La taille spécifiée.

Returns: ImageMask - An ImageMask.

crop(int width, int height)

public final ImageMask crop(int width, int height)

Recadre le masque avec la largeur et la hauteur spécifiées.

Parameters:

Paramètre	Type	Description
width	int	La largeur spécifiée.
height	int	La hauteur spécifiée.

Returns: ImageMask - An ImageMask.

crop(Rectangle rectangle)

public abstract ImageMask crop(Rectangle rectangle)

Recadre le masque avec le rectangle spécifié.

Parameters:

Paramètre	Type	Description
rectangle	Rectangle	Le rectangle spécifié.

Returns: ImageMask - An ImageMask.

isOpaque(int x, int y)

public final boolean isOpaque(int x, int y)

Vérifie si le pixel spécifié est opaque.

Parameters:

Paramètre	Type	Description
x	int	La coordonnée x du pixel.
y	int	La coordonnée y du pixel.

Returns: boolean - vrai si le pixel spécifié est opaque ; sinon, faux.

isTransparent(int x, int y)

public final boolean isTransparent(int x, int y)

Vérifie si le pixel spécifié est transparent.

Parameters:

Paramètre	Type	Description
x	int	La coordonnée x du pixel.
y	int	La coordonnée y du pixel.

Returns: boolean - vrai si le pixel spécifié est transparent ; sinon, faux.

getByteOpacity(int x, int y)

public final byte getByteOpacity(int x, int y)

Obtient l’opacité du pixel spécifié avec une précision d’octet.

Parameters:

Paramètre	Type	Description
x	int	La coordonnée x du pixel.
y	int	La coordonnée y du pixel.

Returns: byte - Valeur d’octet, représentant l’opacité du pixel spécifié.

getFeathered()

public final ImageGrayscaleMask getFeathered()

Obtient le masque en niveaux de gris avec la bordure adoucie selon les paramètres par défaut.

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

getFeathered(FeatheringSettings settings)

public final ImageGrayscaleMask getFeathered(FeatheringSettings settings)

Obtient le masque en niveaux de gris avec la bordure adoucie selon les paramètres spécifiés.

Parameters:

Paramètre	Type	Description
settings	FeatheringSettings	Paramètres de plume.

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

apply()

public final void apply()

Applique le masque actuel à la source RasterImage, si elle 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))
{
    // Créez un nouveau masque en utilisant le magic wand tool basé sur la tonalité et la couleur du pixel (120, 100) avec un seuil personnalisé égal à 150.
    MagicWandTool
            .select(image, new MagicWandSettings(120, 100) {{ setThreshold(150); }})
            // Appliquez le masque à l'image.
            .apply();

    // Enregistrez l'image avec l'option de type de couleur de transparence forcée.
    image.save(outputFilePath, new PngOptions()
    {{
        setColorType(PngColorType.TruecolorWithAlpha);
    }});
}

applyTo(RasterImage image)

public final void applyTo(RasterImage image)

Applique le masque actuel au RasterImage spécifié.

Parameters:

Paramètre	Type	Description
image	RasterImage	Image à laquelle appliquer le masque.

invert()

public final ImageBitMask invert()

Obtient l’inversion du masque actuel.

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))
{
    // Créez un nouveau masque en utilisant le magic wand tool basé sur la tonalité et la couleur du pixel (845, 128).
    MagicWandTool.select(image, new MagicWandSettings(845, 128))
            // Fusionnez le masque existant avec celui spécifié créé par le magic wand tool.
            .union(new MagicWandSettings(416, 387))
            // Inversez le masque existant.
            .invert()
            // Soustrayez le masque spécifié créé par le magic wand tool avec le seuil spécifié du masque existant.
            .subtract(new MagicWandSettings(1482, 346) {{ setThreshold(69); }})
            // Soustrayez quatre masques rectangulaires spécifiés du masque existant un par un.
            .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))
            // Adoucissez le masque avec les paramètres spécifiés.
            .getFeathered(new FeatheringSettings() {{ setSize(3); }})
            // Appliquez le masque à l'image.
            .apply();

    // Enregistrez l'image.
    image.save(outputFilePath);
}

union(ImageMask mask)

public final ImageBitMask union(ImageMask mask)

Obtient l’union du masque actuel avec celui fourni.

Parameters:

Paramètre	Type	Description
mask	ImageMask	Masque fourni

Returns: ImageBitMask - New ImageBitMask.

union()

public final ImageBitMask union()

Obtient l’union du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.

Returns: ImageBitMask - New ImageBitMask.

union(MagicWandSettings settings)

public final ImageBitMask union(MagicWandSettings settings)

Obtient l’union du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.

Parameters:

Paramètre	Type	Description
settings	MagicWandSettings	Paramètres de la baguette magique.

Returns: ImageBitMask - New ImageBitMask.

union(RasterImage image)

public final ImageBitMask union(RasterImage image)

Obtient l’union du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.

Parameters:

Paramètre	Type	Description
image	RasterImage	Image pour la baguette magique.

Returns: ImageBitMask - New ImageBitMask.

union(RasterImage image, MagicWandSettings settings)

public final ImageBitMask union(RasterImage image, MagicWandSettings settings)

Obtient l’union du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.

Parameters:

Paramètre	Type	Description
image	RasterImage	Image pour la baguette magique.
settings	MagicWandSettings	Paramètres de la baguette magique.

Returns: ImageBitMask - New ImageBitMask.

subtract(ImageMask mask)

public final ImageBitMask subtract(ImageMask mask)

Obtient la soustraction du masque fourni du masque actuel.

Parameters:

Paramètre	Type	Description
mask	ImageMask	Masque fourni

Returns: ImageBitMask - New ImageBitMask.

subtract()

public final ImageBitMask subtract()

Obtient le résultat de la sélection baguette magique appliquée à la source du masque actuel, soustrait du masque.

Returns: ImageBitMask - New ImageBitMask.

subtract(MagicWandSettings settings)

public final ImageBitMask subtract(MagicWandSettings settings)

Obtient le résultat de la sélection baguette magique appliquée à la source du masque actuel, soustrait du masque.

Parameters:

Paramètre	Type	Description
settings	MagicWandSettings	Paramètres de la baguette magique.

Returns: ImageBitMask - New ImageBitMask.

subtract(RasterImage image)

public final ImageBitMask subtract(RasterImage image)

Obtient le résultat de la sélection baguette magique appliquée à l’image fournie, soustrait du masque actuel.

Parameters:

Paramètre	Type	Description
image	RasterImage	Image pour la baguette magique.

Returns: ImageBitMask - New ImageBitMask.

subtract(RasterImage image, MagicWandSettings settings)

public final ImageBitMask subtract(RasterImage image, MagicWandSettings settings)

Obtient le résultat de la sélection baguette magique appliquée à l’image fournie, soustrait du masque actuel.

Parameters:

Paramètre	Type	Description
image	RasterImage	Image pour la baguette magique.
settings	MagicWandSettings	Paramètres de la baguette magique.

Returns: ImageBitMask - New ImageBitMask.

intersect(ImageMask mask)

public final ImageBitMask intersect(ImageMask mask)

Obtient l’intersection du masque actuel avec celui fourni.

Parameters:

Paramètre	Type	Description
mask	ImageMask	Masque fourni

Returns: ImageBitMask - New ImageBitMask.

intersect()

public final ImageBitMask intersect()

Obtient l’intersection du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.

Returns: ImageBitMask - New ImageBitMask.

intersect(MagicWandSettings settings)

public final ImageBitMask intersect(MagicWandSettings settings)

Obtient l’intersection du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.

Parameters:

Paramètre	Type	Description
settings	MagicWandSettings	Paramètres de la baguette magique.

Returns: ImageBitMask - New ImageBitMask.

intersect(RasterImage image)

public final ImageBitMask intersect(RasterImage image)

Obtient l’intersection du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.

Parameters:

Paramètre	Type	Description
image	RasterImage	Image pour la baguette magique.

Returns: ImageBitMask - New ImageBitMask.

intersect(RasterImage image, MagicWandSettings settings)

public final ImageBitMask intersect(RasterImage image, MagicWandSettings settings)

Obtient l’intersection du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.

Parameters:

Paramètre	Type	Description
image	RasterImage	Image pour la baguette magique.
settings	MagicWandSettings	Paramètres de la baguette magique.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(ImageMask mask)

public final ImageBitMask exclusiveDisjunction(ImageMask mask)

Obtient la disjonction exclusive du masque actuel avec le fourni.

Parameters:

Paramètre	Type	Description
mask	ImageMask	Masque fourni

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction()

public final ImageBitMask exclusiveDisjunction()

Obtient la disjonction exclusive du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(MagicWandSettings settings)

public final ImageBitMask exclusiveDisjunction(MagicWandSettings settings)

Obtient la disjonction exclusive du masque actuel avec le résultat de la sélection baguette magique appliquée à la source du masque.

Parameters:

Paramètre	Type	Description
settings	MagicWandSettings	Paramètres de la baguette magique.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(RasterImage image)

public final ImageBitMask exclusiveDisjunction(RasterImage image)

Obtient la disjonction exclusive du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.

Parameters:

Paramètre	Type	Description
image	RasterImage	Image pour la baguette magique.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(RasterImage image, MagicWandSettings settings)

public final ImageBitMask exclusiveDisjunction(RasterImage image, MagicWandSettings settings)

Obtient la disjonction exclusive du masque actuel avec le résultat de la sélection baguette magique appliquée à l’image fournie.

Parameters:

Paramètre	Type	Description
image	RasterImage	Image pour la baguette magique.
settings	MagicWandSettings	Paramètres de la baguette magique.

Returns: ImageBitMask - New ImageBitMask.