ImageMask

Inheritance: java.lang.Object

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

public abstract class ImageMask implements IImageMask

Descrive una maschera immagine binaria.

Metodi

Metodo	Descrizione
to_ImageGrayscaleMask(ImageMask mask)	Conversione di mask a un ImageGrayscaleMask.
op_LogicalNot(ImageMask a)	Inverte la maschera.
op_Addition(ImageMask a, ImageMask b)	Unione di due maschere.
op_Subtraction(ImageMask a, ImageMask b)	Sottrai la seconda maschera dalla prima.
op_Multiply(ImageMask a, ImageMask b)	Intersezione di due maschere.
op_ExclusiveOr(ImageMask a, ImageMask b)	Disgiunzione esclusiva di due maschere.
getSource()	Restituisce l’immagine sorgente utilizzata per creare questa maschera, se esiste.
getWidth()	Restituisce la larghezza, in pixel, di questa maschera.
getHeight()	Restituisce l’altezza, in pixel, di questa maschera.
getBounds()	Restituisce i limiti, in pixel, di questa maschera.
get_Item(int x, int y)	Ottiene l’opacità del pixel specificato.
inflate(int size)	Espande questa maschera dell’importo specificato.
crop(Size size)	Ritaglia la maschera con la dimensione specificata.
crop(int width, int height)	Ritaglia la maschera con la larghezza e l’altezza specificate.
crop(Rectangle rectangle)	Ritaglia la maschera con il rettangolo specificato.
isOpaque(int x, int y)	Verifica se il pixel specificato è opaco.
isTransparent(int x, int y)	Verifica se il pixel specificato è trasparente.
getByteOpacity(int x, int y)	Ottiene l’opacità del pixel specificato con precisione a byte.
getFeathered()	Ottiene la maschera in scala di grigi con il bordo sfumato con le impostazioni predefinite.
getFeathered(FeatheringSettings settings)	Ottiene la maschera in scala di grigi con il bordo sfumato con le impostazioni specificate.
apply()	Applica la maschera corrente alla sorgente RasterImage, se esiste.
applyTo(RasterImage image)	Applica la maschera corrente alla RasterImage specificata.
invert()	Ottiene l’inversione della maschera corrente.
union(ImageMask mask)	Ottiene l’unione della maschera corrente con quella fornita.
union()	Ottiene l’unione della maschera corrente con il risultato della selezione magic wand applicata alla sorgente della maschera.
union(MagicWandSettings settings)	Ottiene l’unione della maschera corrente con il risultato della selezione magic wand applicata alla sorgente della maschera.
union(RasterImage image)	Ottiene l’unione della maschera corrente con il risultato della selezione magic wand applicata all’immagine fornita.
union(RasterImage image, MagicWandSettings settings)	Ottiene l’unione della maschera corrente con il risultato della selezione magic wand applicata all’immagine fornita.
subtract(ImageMask mask)	Ottiene la sottrazione della maschera fornita dalla corrente.
subtract()	Ottiene il risultato della selezione magic wand applicata alla sorgente della maschera corrente sottratto dalla maschera.
subtract(MagicWandSettings settings)	Ottiene il risultato della selezione magic wand applicata alla sorgente della maschera corrente sottratto dalla maschera.
subtract(RasterImage image)	Ottiene il risultato della selezione magic wand applicata all’immagine fornita, sottratto dalla maschera corrente.
subtract(RasterImage image, MagicWandSettings settings)	Ottiene il risultato della selezione magic wand applicata all’immagine fornita, sottratto dalla maschera corrente.
intersect(ImageMask mask)	Ottiene l’intersezione della maschera corrente con quella fornita.
intersect()	Ottiene l’intersezione della maschera corrente con il risultato della selezione magic wand applicata alla sorgente della maschera.
intersect(MagicWandSettings settings)	Ottiene l’intersezione della maschera corrente con il risultato della selezione magic wand applicata alla sorgente della maschera.
intersect(RasterImage image)	Ottiene l’intersezione della maschera corrente con il risultato della selezione bacchetta magica applicata all’immagine fornita.
intersect(RasterImage image, MagicWandSettings settings)	Ottiene l’intersezione della maschera corrente con il risultato della selezione bacchetta magica applicata all’immagine fornita.
exclusiveDisjunction(ImageMask mask)	Ottiene la disgiunzione esclusiva della maschera corrente con quella fornita.
exclusiveDisjunction()	Ottiene la disgiunzione esclusiva della maschera corrente con il risultato della selezione bacchetta magica applicata alla sorgente della maschera.
exclusiveDisjunction(MagicWandSettings settings)	Ottiene la disgiunzione esclusiva della maschera corrente con il risultato della selezione bacchetta magica applicata alla sorgente della maschera.
exclusiveDisjunction(RasterImage image)	Ottiene la disgiunzione esclusiva della maschera corrente con il risultato della selezione bacchetta magica applicata all’immagine fornita.
exclusiveDisjunction(RasterImage image, MagicWandSettings settings)	Ottiene la disgiunzione esclusiva della maschera corrente con il risultato della selezione bacchetta magica applicata all’immagine fornita.

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 nuova maschera usando lo strumento magic wand basata sul tono e sul colore del pixel (845, 128)
    MagicWandTool.select(image, new MagicWandSettings(845, 128))
            // Unisci la maschera esistente con quella specificata creata dallo strumento magic wand
            .union(new MagicWandSettings(416, 387))
            // Inverti la maschera esistente
            .invert()
            // Sottrai la maschera specificata creata dallo strumento magic wand con soglia specificata dalla maschera esistente
            .subtract(new MagicWandSettings(1482, 346) {{ setThreshold(69); }})
            // Sottrai quattro maschere rettangolari specificate dalla maschera esistente una alla volta
            .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))
            // Sfuma la maschera con le impostazioni specificate
            .getFeathered(new FeatheringSettings() {{ setSize(3); }})
            // Applica la maschera all'immagine
            .apply();

    // Salva immagine
    image.save(outputFilePath);
}

to_ImageGrayscaleMask(ImageMask mask)

public static ImageGrayscaleMask to_ImageGrayscaleMask(ImageMask mask)

Conversione di mask a un ImageGrayscaleMask.

Parameters:

Parametro	Tipo	Descrizione
mask	ImageMask	Il valore della maschera.

Returns: ImageGrayscaleMask - The new ImageGrayscaleMask base on mask.

op_LogicalNot(ImageMask a)

public static ImageBitMask op_LogicalNot(ImageMask a)

Inverte la maschera.

Parameters:

Parametro	Tipo	Descrizione
a	ImageMask	La maschera da invertire.

Returns: ImageBitMask - New ImageBitMask.

op_Addition(ImageMask a, ImageMask b)

public static ImageBitMask op_Addition(ImageMask a, ImageMask b)

Unione di due maschere.

Parameters:

Parametro	Tipo	Descrizione
a	ImageMask	La prima maschera.
b	ImageMask	La seconda maschera.

Returns: ImageBitMask - New ImageBitMask.

op_Subtraction(ImageMask a, ImageMask b)

public static ImageBitMask op_Subtraction(ImageMask a, ImageMask b)

Sottrai la seconda maschera dalla prima.

Parameters:

Parametro	Tipo	Descrizione
a	ImageMask	La prima maschera.
b	ImageMask	La seconda maschera.

Returns: ImageBitMask - New ImageBitMask.

op_Multiply(ImageMask a, ImageMask b)

public static ImageBitMask op_Multiply(ImageMask a, ImageMask b)

Intersezione di due maschere.

Parameters:

Parametro	Tipo	Descrizione
a	ImageMask	La prima maschera.
b	ImageMask	La seconda maschera.

Returns: ImageBitMask - New ImageBitMask.

op_ExclusiveOr(ImageMask a, ImageMask b)

public static ImageBitMask op_ExclusiveOr(ImageMask a, ImageMask b)

Disgiunzione esclusiva di due maschere.

Parameters:

Parametro	Tipo	Descrizione
a	ImageMask	La prima maschera.
b	ImageMask	La seconda maschera.

Returns: ImageBitMask - New ImageBitMask.

getSource()

public final RasterImage getSource()

Restituisce l’immagine sorgente utilizzata per creare questa maschera, se esiste.

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

getWidth()

public final int getWidth()

Restituisce la larghezza, in pixel, di questa maschera.

Returns: int - la larghezza, in pixel, di questa maschera.

getHeight()

public final int getHeight()

Restituisce l’altezza, in pixel, di questa maschera.

Returns: int - l’altezza, in pixel, di questa maschera.

getBounds()

public final Rectangle getBounds()

Restituisce i limiti, in pixel, di questa maschera.

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

get_Item(int x, int y)

public abstract boolean get_Item(int x, int y)

Ottiene l’opacità del pixel specificato.

Parameters:

Parametro	Tipo	Descrizione
x	int	La coordinata x del pixel.
y	int	La coordinata y del pixel.

Returns: boolean - true se il pixel specificato è opaco; altrimenti, false.

inflate(int size)

public abstract ImageMask inflate(int size)

Espande questa maschera dell’importo specificato.

Parameters:

Parametro	Tipo	Descrizione
dimensione	int	La quantità da gonfiare questa maschera.

Returns: ImageMask - An ImageMask.

crop(Size size)

public final ImageMask crop(Size size)

Ritaglia la maschera con la dimensione specificata.

Parameters:

Parametro	Tipo	Descrizione
size	Size	La dimensione specificata.

Returns: ImageMask - An ImageMask.

crop(int width, int height)

public final ImageMask crop(int width, int height)

Ritaglia la maschera con la larghezza e l’altezza specificate.

Parameters:

Parametro	Tipo	Descrizione
width	int	La larghezza specificata.
height	int	L’altezza specificata.

Returns: ImageMask - An ImageMask.

crop(Rectangle rectangle)

public abstract ImageMask crop(Rectangle rectangle)

Ritaglia la maschera con il rettangolo specificato.

Parameters:

Parametro	Tipo	Descrizione
rectangle	Rectangle	Il rettangolo specificato.

Returns: ImageMask - An ImageMask.

isOpaque(int x, int y)

public final boolean isOpaque(int x, int y)

Verifica se il pixel specificato è opaco.

Parameters:

Parametro	Tipo	Descrizione
x	int	La coordinata x del pixel.
y	int	La coordinata y del pixel.

Returns: boolean - true se il pixel specificato è opaco; altrimenti, false.

isTransparent(int x, int y)

public final boolean isTransparent(int x, int y)

Verifica se il pixel specificato è trasparente.

Parameters:

Parametro	Tipo	Descrizione
x	int	La coordinata x del pixel.
y	int	La coordinata y del pixel.

Returns: boolean - true se il pixel specificato è trasparente; altrimenti, false.

getByteOpacity(int x, int y)

public final byte getByteOpacity(int x, int y)

Ottiene l’opacità del pixel specificato con precisione a byte.

Parameters:

Parametro	Tipo	Descrizione
x	int	La coordinata x del pixel.
y	int	La coordinata y del pixel.

Returns: byte - Valore byte, che rappresenta l’opacità del pixel specificato.

getFeathered()

public final ImageGrayscaleMask getFeathered()

Ottiene la maschera in scala di grigi con il bordo sfumato con le impostazioni predefinite.

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

getFeathered(FeatheringSettings settings)

public final ImageGrayscaleMask getFeathered(FeatheringSettings settings)

Ottiene la maschera in scala di grigi con il bordo sfumato con le impostazioni specificate.

Parameters:

Parametro	Tipo	Descrizione
settings	FeatheringSettings	Impostazioni di sfumatura.

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

apply()

public final void apply()

Applica la maschera corrente alla sorgente RasterImage, se esiste.

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 nuova maschera usando lo strumento magic wand basata sul tono e sul colore del pixel (120, 100) con soglia personalizzata pari a 150
    MagicWandTool
            .select(image, new MagicWandSettings(120, 100) {{ setThreshold(150); }})
            // Applica la maschera all'immagine
            .apply();

    // Salva l'immagine con l'opzione di tipo colore di trasparenza forzata
    image.save(outputFilePath, new PngOptions()
    {{
        setColorType(PngColorType.TruecolorWithAlpha);
    }});
}

applyTo(RasterImage image)

public final void applyTo(RasterImage image)

Applica la maschera corrente alla RasterImage specificata.

Parameters:

Parametro	Tipo	Descrizione
image	RasterImage	Immagine a cui applicare la maschera.

invert()

public final ImageBitMask invert()

Ottiene l’inversione della maschera corrente.

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 nuova maschera usando lo strumento magic wand basata sul tono e sul colore del pixel (845, 128)
    MagicWandTool.select(image, new MagicWandSettings(845, 128))
            // Unisci la maschera esistente con quella specificata creata dallo strumento magic wand
            .union(new MagicWandSettings(416, 387))
            // Inverti la maschera esistente
            .invert()
            // Sottrai la maschera specificata creata dallo strumento magic wand con soglia specificata dalla maschera esistente
            .subtract(new MagicWandSettings(1482, 346) {{ setThreshold(69); }})
            // Sottrai quattro maschere rettangolari specificate dalla maschera esistente una alla volta
            .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))
            // Sfuma la maschera con le impostazioni specificate
            .getFeathered(new FeatheringSettings() {{ setSize(3); }})
            // Applica la maschera all'immagine
            .apply();

    // Salva immagine
    image.save(outputFilePath);
}

union(ImageMask mask)

public final ImageBitMask union(ImageMask mask)

Ottiene l’unione della maschera corrente con quella fornita.

Parameters:

Parametro	Tipo	Descrizione
mask	ImageMask	Maschera fornita

Returns: ImageBitMask - New ImageBitMask.

union()

public final ImageBitMask union()

Ottiene l’unione della maschera corrente con il risultato della selezione magic wand applicata alla sorgente della maschera.

Returns: ImageBitMask - New ImageBitMask.

union(MagicWandSettings settings)

public final ImageBitMask union(MagicWandSettings settings)

Ottiene l’unione della maschera corrente con il risultato della selezione magic wand applicata alla sorgente della maschera.

Parameters:

Parametro	Tipo	Descrizione
settings	MagicWandSettings	Impostazioni della bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.

union(RasterImage image)

public final ImageBitMask union(RasterImage image)

Ottiene l’unione della maschera corrente con il risultato della selezione magic wand applicata all’immagine fornita.

Parameters:

Parametro	Tipo	Descrizione
image	RasterImage	Immagine per la bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.

union(RasterImage image, MagicWandSettings settings)

public final ImageBitMask union(RasterImage image, MagicWandSettings settings)

Ottiene l’unione della maschera corrente con il risultato della selezione magic wand applicata all’immagine fornita.

Parameters:

Parametro	Tipo	Descrizione
image	RasterImage	Immagine per la bacchetta magica.
settings	MagicWandSettings	Impostazioni della bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.

subtract(ImageMask mask)

public final ImageBitMask subtract(ImageMask mask)

Ottiene la sottrazione della maschera fornita dalla corrente.

Parameters:

Parametro	Tipo	Descrizione
mask	ImageMask	Maschera fornita

Returns: ImageBitMask - New ImageBitMask.

subtract()

public final ImageBitMask subtract()

Ottiene il risultato della selezione magic wand applicata alla sorgente della maschera corrente sottratto dalla maschera.

Returns: ImageBitMask - New ImageBitMask.

subtract(MagicWandSettings settings)

public final ImageBitMask subtract(MagicWandSettings settings)

Ottiene il risultato della selezione magic wand applicata alla sorgente della maschera corrente sottratto dalla maschera.

Parameters:

Parametro	Tipo	Descrizione
settings	MagicWandSettings	Impostazioni della bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.

subtract(RasterImage image)

public final ImageBitMask subtract(RasterImage image)

Ottiene il risultato della selezione magic wand applicata all’immagine fornita, sottratto dalla maschera corrente.

Parameters:

Parametro	Tipo	Descrizione
image	RasterImage	Immagine per la bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.

subtract(RasterImage image, MagicWandSettings settings)

public final ImageBitMask subtract(RasterImage image, MagicWandSettings settings)

Ottiene il risultato della selezione magic wand applicata all’immagine fornita, sottratto dalla maschera corrente.

Parameters:

Parametro	Tipo	Descrizione
image	RasterImage	Immagine per la bacchetta magica.
settings	MagicWandSettings	Impostazioni della bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.

intersect(ImageMask mask)

public final ImageBitMask intersect(ImageMask mask)

Ottiene l’intersezione della maschera corrente con quella fornita.

Parameters:

Parametro	Tipo	Descrizione
mask	ImageMask	Maschera fornita

Returns: ImageBitMask - New ImageBitMask.

intersect()

public final ImageBitMask intersect()

Ottiene l’intersezione della maschera corrente con il risultato della selezione magic wand applicata alla sorgente della maschera.

Returns: ImageBitMask - New ImageBitMask.

intersect(MagicWandSettings settings)

public final ImageBitMask intersect(MagicWandSettings settings)

Ottiene l’intersezione della maschera corrente con il risultato della selezione magic wand applicata alla sorgente della maschera.

Parameters:

Parametro	Tipo	Descrizione
settings	MagicWandSettings	Impostazioni della bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.

intersect(RasterImage image)

public final ImageBitMask intersect(RasterImage image)

Ottiene l’intersezione della maschera corrente con il risultato della selezione bacchetta magica applicata all’immagine fornita.

Parameters:

Parametro	Tipo	Descrizione
image	RasterImage	Immagine per la bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.

intersect(RasterImage image, MagicWandSettings settings)

public final ImageBitMask intersect(RasterImage image, MagicWandSettings settings)

Ottiene l’intersezione della maschera corrente con il risultato della selezione bacchetta magica applicata all’immagine fornita.

Parameters:

Parametro	Tipo	Descrizione
image	RasterImage	Immagine per la bacchetta magica.
settings	MagicWandSettings	Impostazioni della bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(ImageMask mask)

public final ImageBitMask exclusiveDisjunction(ImageMask mask)

Ottiene la disgiunzione esclusiva della maschera corrente con quella fornita.

Parameters:

Parametro	Tipo	Descrizione
mask	ImageMask	Maschera fornita

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction()

public final ImageBitMask exclusiveDisjunction()

Ottiene la disgiunzione esclusiva della maschera corrente con il risultato della selezione bacchetta magica applicata alla sorgente della maschera.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(MagicWandSettings settings)

public final ImageBitMask exclusiveDisjunction(MagicWandSettings settings)

Ottiene la disgiunzione esclusiva della maschera corrente con il risultato della selezione bacchetta magica applicata alla sorgente della maschera.

Parameters:

Parametro	Tipo	Descrizione
settings	MagicWandSettings	Impostazioni della bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(RasterImage image)

public final ImageBitMask exclusiveDisjunction(RasterImage image)

Ottiene la disgiunzione esclusiva della maschera corrente con il risultato della selezione bacchetta magica applicata all’immagine fornita.

Parameters:

Parametro	Tipo	Descrizione
image	RasterImage	Immagine per la bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(RasterImage image, MagicWandSettings settings)

public final ImageBitMask exclusiveDisjunction(RasterImage image, MagicWandSettings settings)

Ottiene la disgiunzione esclusiva della maschera corrente con il risultato della selezione bacchetta magica applicata all’immagine fornita.

Parameters:

Parametro	Tipo	Descrizione
image	RasterImage	Immagine per la bacchetta magica.
settings	MagicWandSettings	Impostazioni della bacchetta magica.

Returns: ImageBitMask - New ImageBitMask.