ImageMask

Inheritance: java.lang.Object

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

public abstract class ImageMask implements IImageMask

Beschreibt eine binäre Bildmaske.

Methoden

MethodeBeschreibung
to_ImageGrayscaleMask(ImageMask mask)Umwandeln von mask zu einer ImageGrayscaleMask.
op_LogicalNot(ImageMask a)Invertiert die Maske.
op_Addition(ImageMask a, ImageMask b)Vereinigung von zwei Masken.
op_Subtraction(ImageMask a, ImageMask b)Subtrahiere die zweite Maske von der ersten.
op_Multiply(ImageMask a, ImageMask b)Schnittmenge von zwei Masken.
op_ExclusiveOr(ImageMask a, ImageMask b)Exklusive Disjunktion von zwei Masken.
getSource()Gibt das Quellbild zurück, das zur Erstellung dieser Maske verwendet wurde, falls vorhanden.
getWidth()Gibt die Breite dieser Maske in Pixeln zurück.
getHeight()Gibt die Höhe dieser Maske in Pixeln zurück.
getBounds()Gibt die Begrenzungen dieser Maske in Pixeln zurück.
get_Item(int x, int y)Ermittelt die Opazität des angegebenen Pixels.
inflate(int size)Vergrößert diese Maske um den angegebenen Betrag.
crop(Size size)Beschneidet die Maske mit der angegebenen Größe.
crop(int width, int height)Beschneidet die Maske mit der angegebenen Breite und Höhe.
crop(Rectangle rectangle)Schneidet die Maske mit dem angegebenen Rechteck zu.
isOpaque(int x, int y)Überprüft, ob das angegebene Pixel undurchsichtig ist.
isTransparent(int x, int y)Überprüft, ob das angegebene Pixel transparent ist.
getByteOpacity(int x, int y)Ermittelt die Opazität des angegebenen Pixels mit Byte-Präzision.
getFeathered()Ermittelt Graustufenmaske mit dem Rand verwischt nach den Standardeinstellungen.
getFeathered(FeatheringSettings settings)Ermittelt Graustufenmaske mit dem Rand verwischt nach den angegebenen Einstellungen.
apply()Wendet die aktuelle Maske auf die RasterImage-Quelle an, falls vorhanden.
applyTo(RasterImage image)Wendet die aktuelle Maske auf die angegebene RasterImage an.
invert()Ermittelt die Inversion der aktuellen Maske.
union(ImageMask mask)Ermittelt die Vereinigung der aktuellen Maske mit der bereitgestellten.
union()Ermittelt die Vereinigung der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf die Quelle der Maske angewendet wurde.
union(MagicWandSettings settings)Ermittelt die Vereinigung der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf die Quelle der Maske angewendet wurde.
union(RasterImage image)Ermittelt die Vereinigung der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf das bereitgestellte Bild angewendet wurde.
union(RasterImage image, MagicWandSettings settings)Ermittelt die Vereinigung der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf das bereitgestellte Bild angewendet wurde.
subtract(ImageMask mask)Ermittelt die Subtraktion der bereitgestellten Maske von der aktuellen.
subtract()Ermittelt das Ergebnis der Zauberstab-Auswahl, die auf die Quelle der aktuellen Maske angewendet wurde, subtrahiert von der Maske.
subtract(MagicWandSettings settings)Ermittelt das Ergebnis der Zauberstab-Auswahl, die auf die Quelle der aktuellen Maske angewendet wurde, subtrahiert von der Maske.
subtract(RasterImage image)Ermittelt das Ergebnis der Zauberstab-Auswahl, die auf das bereitgestellte Bild angewendet wurde, subtrahiert von der aktuellen Maske.
subtract(RasterImage image, MagicWandSettings settings)Ermittelt das Ergebnis der Zauberstab-Auswahl, die auf das bereitgestellte Bild angewendet wurde, subtrahiert von der aktuellen Maske.
intersect(ImageMask mask)Ermittelt die Schnittmenge der aktuellen Maske mit der bereitgestellten.
intersect()Ermittelt die Schnittmenge der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf die Quelle der Maske angewendet wurde.
intersect(MagicWandSettings settings)Ermittelt die Schnittmenge der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf die Quelle der Maske angewendet wurde.
intersect(RasterImage image)Ermittelt die Schnittmenge der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf das bereitgestellte Bild angewendet wurde.
intersect(RasterImage image, MagicWandSettings settings)Ermittelt die Schnittmenge der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf das bereitgestellte Bild angewendet wurde.
exclusiveDisjunction(ImageMask mask)Ermittelt die exklusive Disjunktion der aktuellen Maske mit der bereitgestellten.
exclusiveDisjunction()Ermittelt die exklusive Disjunktion der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf die Quelle der Maske angewendet wurde.
exclusiveDisjunction(MagicWandSettings settings)Ermittelt die exklusive Disjunktion der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf die Quelle der Maske angewendet wurde.
exclusiveDisjunction(RasterImage image)Ermittelt die exklusive Disjunktion der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf das bereitgestellte Bild angewendet wurde.
exclusiveDisjunction(RasterImage image, MagicWandSettings settings)Ermittelt die exklusive Disjunktion der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf das bereitgestellte Bild angewendet wurde.

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))
{
    // Erstellen Sie eine neue Maske mit dem Magic‑Wand‑Tool basierend auf Ton und Farbe des Pixels (845, 128).
    MagicWandTool.select(image, new MagicWandSettings(845, 128))
            // Vereinen Sie die vorhandene Maske mit der angegebenen, die vom Magic‑Wand‑Tool erstellt wurde.
            .union(new MagicWandSettings(416, 387))
            // Invertieren Sie die vorhandene Maske.
            .invert()
            // Subtrahieren Sie die angegebene, vom Magic‑Wand‑Tool erstellte Maske mit dem angegebenen Schwellenwert von der vorhandenen Maske.
            .subtract(new MagicWandSettings(1482, 346) {{ setThreshold(69); }})
            // Subtrahieren Sie vier angegebene Rechteckmasken nacheinander von der vorhandenen Maske.
            .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))
            // Weichzeichnen Sie die Maske mit den angegebenen Einstellungen.
            .getFeathered(new FeatheringSettings() {{ setSize(3); }})
            // Maske auf das Bild anwenden.
            .apply();

    // Bild speichern.
    image.save(outputFilePath);
}

to_ImageGrayscaleMask(ImageMask mask)

public static ImageGrayscaleMask to_ImageGrayscaleMask(ImageMask mask)

Umwandeln von mask zu einer ImageGrayscaleMask.

Parameters:

ParameterTypBeschreibung
maskImageMaskDer Maskenwert.

Returns: ImageGrayscaleMask - The new ImageGrayscaleMask base on mask.

op_LogicalNot(ImageMask a)

public static ImageBitMask op_LogicalNot(ImageMask a)

Invertiert die Maske.

Parameters:

ParameterTypBeschreibung
aImageMaskDie zu invertierende Maske.

Returns: ImageBitMask - New ImageBitMask.

op_Addition(ImageMask a, ImageMask b)

public static ImageBitMask op_Addition(ImageMask a, ImageMask b)

Vereinigung von zwei Masken.

Parameters:

ParameterTypBeschreibung
aImageMaskDie erste Maske.
bImageMaskDie zweite Maske.

Returns: ImageBitMask - New ImageBitMask.

op_Subtraction(ImageMask a, ImageMask b)

public static ImageBitMask op_Subtraction(ImageMask a, ImageMask b)

Subtrahiere die zweite Maske von der ersten.

Parameters:

ParameterTypBeschreibung
aImageMaskDie erste Maske.
bImageMaskDie zweite Maske.

Returns: ImageBitMask - New ImageBitMask.

op_Multiply(ImageMask a, ImageMask b)

public static ImageBitMask op_Multiply(ImageMask a, ImageMask b)

Schnittmenge von zwei Masken.

Parameters:

ParameterTypBeschreibung
aImageMaskDie erste Maske.
bImageMaskDie zweite Maske.

Returns: ImageBitMask - New ImageBitMask.

op_ExclusiveOr(ImageMask a, ImageMask b)

public static ImageBitMask op_ExclusiveOr(ImageMask a, ImageMask b)

Exklusive Disjunktion von zwei Masken.

Parameters:

ParameterTypBeschreibung
aImageMaskDie erste Maske.
bImageMaskDie zweite Maske.

Returns: ImageBitMask - New ImageBitMask.

getSource()

public final RasterImage getSource()

Gibt das Quellbild zurück, das zur Erstellung dieser Maske verwendet wurde, falls vorhanden.

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

getWidth()

public final int getWidth()

Gibt die Breite dieser Maske in Pixeln zurück.

Returns: int – die Breite dieser Maske in Pixeln.

getHeight()

public final int getHeight()

Gibt die Höhe dieser Maske in Pixeln zurück.

Returns: int – die Höhe dieser Maske in Pixeln.

getBounds()

public final Rectangle getBounds()

Gibt die Begrenzungen dieser Maske in Pixeln zurück.

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

get_Item(int x, int y)

public abstract boolean get_Item(int x, int y)

Ermittelt die Opazität des angegebenen Pixels.

Parameters:

ParameterTypBeschreibung
xintDie x‑Koordinate des Pixels.
yintDie y‑Koordinate des Pixels.

Returns: boolean – true, wenn das angegebene Pixel undurchsichtig ist; andernfalls false.

inflate(int size)

public abstract ImageMask inflate(int size)

Vergrößert diese Maske um den angegebenen Betrag.

Parameters:

ParameterTypBeschreibung
GrößeintDer Betrag, um diese Maske aufzublähen.

Returns: ImageMask - An ImageMask.

crop(Size size)

public final ImageMask crop(Size size)

Beschneidet die Maske mit der angegebenen Größe.

Parameters:

ParameterTypBeschreibung
sizeSizeDie angegebene Größe.

Returns: ImageMask - An ImageMask.

crop(int width, int height)

public final ImageMask crop(int width, int height)

Beschneidet die Maske mit der angegebenen Breite und Höhe.

Parameters:

ParameterTypBeschreibung
BreiteintDie angegebene Breite.
HöheintDie angegebene Höhe.

Returns: ImageMask - An ImageMask.

crop(Rectangle rectangle)

public abstract ImageMask crop(Rectangle rectangle)

Schneidet die Maske mit dem angegebenen Rechteck zu.

Parameters:

ParameterTypBeschreibung
rectangleRectangleDas angegebene Rechteck.

Returns: ImageMask - An ImageMask.

isOpaque(int x, int y)

public final boolean isOpaque(int x, int y)

Überprüft, ob das angegebene Pixel undurchsichtig ist.

Parameters:

ParameterTypBeschreibung
xintDie x‑Koordinate des Pixels.
yintDie y‑Koordinate des Pixels.

Returns: boolean – true, wenn das angegebene Pixel undurchsichtig ist; andernfalls false.

isTransparent(int x, int y)

public final boolean isTransparent(int x, int y)

Überprüft, ob das angegebene Pixel transparent ist.

Parameters:

ParameterTypBeschreibung
xintDie x‑Koordinate des Pixels.
yintDie y‑Koordinate des Pixels.

Returns: boolean – true, wenn das angegebene Pixel transparent ist; andernfalls false.

getByteOpacity(int x, int y)

public final byte getByteOpacity(int x, int y)

Ermittelt die Opazität des angegebenen Pixels mit Byte-Präzision.

Parameters:

ParameterTypBeschreibung
xintDie x‑Koordinate des Pixels.
yintDie y‑Koordinate des Pixels.

Returns: byte – Byte‑Wert, der die Opazität des angegebenen Pixels darstellt.

getFeathered()

public final ImageGrayscaleMask getFeathered()

Ermittelt Graustufenmaske mit dem Rand verwischt nach den Standardeinstellungen.

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

getFeathered(FeatheringSettings settings)

public final ImageGrayscaleMask getFeathered(FeatheringSettings settings)

Ermittelt Graustufenmaske mit dem Rand verwischt nach den angegebenen Einstellungen.

Parameters:

ParameterTypBeschreibung
settingsFeatheringSettingsWeichzeichnungs‑Einstellungen.

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

apply()

public final void apply()

Wendet die aktuelle Maske auf die RasterImage-Quelle an, falls vorhanden.

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))
{
    // Erstellen Sie eine neue Maske mit dem Magic‑Wand‑Tool basierend auf Ton und Farbe des Pixels (120, 100) mit einem benutzerdefinierten Schwellenwert von 150.
    MagicWandTool
            .select(image, new MagicWandSettings(120, 100) {{ setThreshold(150); }})
            // Maske auf das Bild anwenden.
            .apply();

    // Bild mit erzwungenem Transparenzfarbtyp‑Option speichern.
    image.save(outputFilePath, new PngOptions()
    {{
        setColorType(PngColorType.TruecolorWithAlpha);
    }});
}

applyTo(RasterImage image)

public final void applyTo(RasterImage image)

Wendet die aktuelle Maske auf die angegebene RasterImage an.

Parameters:

ParameterTypBeschreibung
imageRasterImageBild, auf das die Maske angewendet wird.

invert()

public final ImageBitMask invert()

Ermittelt die Inversion der aktuellen Maske.

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))
{
    // Erstellen Sie eine neue Maske mit dem Magic‑Wand‑Tool basierend auf Ton und Farbe des Pixels (845, 128).
    MagicWandTool.select(image, new MagicWandSettings(845, 128))
            // Vereinen Sie die vorhandene Maske mit der angegebenen, die vom Magic‑Wand‑Tool erstellt wurde.
            .union(new MagicWandSettings(416, 387))
            // Invertieren Sie die vorhandene Maske.
            .invert()
            // Subtrahieren Sie die angegebene, vom Magic‑Wand‑Tool erstellte Maske mit dem angegebenen Schwellenwert von der vorhandenen Maske.
            .subtract(new MagicWandSettings(1482, 346) {{ setThreshold(69); }})
            // Subtrahieren Sie vier angegebene Rechteckmasken nacheinander von der vorhandenen Maske.
            .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))
            // Weichzeichnen Sie die Maske mit den angegebenen Einstellungen.
            .getFeathered(new FeatheringSettings() {{ setSize(3); }})
            // Maske auf das Bild anwenden.
            .apply();

    // Bild speichern.
    image.save(outputFilePath);
}

union(ImageMask mask)

public final ImageBitMask union(ImageMask mask)

Ermittelt die Vereinigung der aktuellen Maske mit der bereitgestellten.

Parameters:

ParameterTypBeschreibung
maskImageMaskBereitgestellte Maske

Returns: ImageBitMask - New ImageBitMask.

union()

public final ImageBitMask union()

Ermittelt die Vereinigung der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf die Quelle der Maske angewendet wurde.

Returns: ImageBitMask - New ImageBitMask.

union(MagicWandSettings settings)

public final ImageBitMask union(MagicWandSettings settings)

Ermittelt die Vereinigung der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf die Quelle der Maske angewendet wurde.

Parameters:

ParameterTypBeschreibung
settingsMagicWandSettingsZauberstab‑Einstellungen.

Returns: ImageBitMask - New ImageBitMask.

union(RasterImage image)

public final ImageBitMask union(RasterImage image)

Ermittelt die Vereinigung der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf das bereitgestellte Bild angewendet wurde.

Parameters:

ParameterTypBeschreibung
imageRasterImageBild für den Zauberstab.

Returns: ImageBitMask - New ImageBitMask.

union(RasterImage image, MagicWandSettings settings)

public final ImageBitMask union(RasterImage image, MagicWandSettings settings)

Ermittelt die Vereinigung der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf das bereitgestellte Bild angewendet wurde.

Parameters:

ParameterTypBeschreibung
imageRasterImageBild für den Zauberstab.
settingsMagicWandSettingsZauberstab‑Einstellungen.

Returns: ImageBitMask - New ImageBitMask.

subtract(ImageMask mask)

public final ImageBitMask subtract(ImageMask mask)

Ermittelt die Subtraktion der bereitgestellten Maske von der aktuellen.

Parameters:

ParameterTypBeschreibung
maskImageMaskBereitgestellte Maske

Returns: ImageBitMask - New ImageBitMask.

subtract()

public final ImageBitMask subtract()

Ermittelt das Ergebnis der Zauberstab-Auswahl, die auf die Quelle der aktuellen Maske angewendet wurde, subtrahiert von der Maske.

Returns: ImageBitMask - New ImageBitMask.

subtract(MagicWandSettings settings)

public final ImageBitMask subtract(MagicWandSettings settings)

Ermittelt das Ergebnis der Zauberstab-Auswahl, die auf die Quelle der aktuellen Maske angewendet wurde, subtrahiert von der Maske.

Parameters:

ParameterTypBeschreibung
settingsMagicWandSettingsZauberstab‑Einstellungen.

Returns: ImageBitMask - New ImageBitMask.

subtract(RasterImage image)

public final ImageBitMask subtract(RasterImage image)

Ermittelt das Ergebnis der Zauberstab-Auswahl, die auf das bereitgestellte Bild angewendet wurde, subtrahiert von der aktuellen Maske.

Parameters:

ParameterTypBeschreibung
imageRasterImageBild für den Zauberstab.

Returns: ImageBitMask - New ImageBitMask.

subtract(RasterImage image, MagicWandSettings settings)

public final ImageBitMask subtract(RasterImage image, MagicWandSettings settings)

Ermittelt das Ergebnis der Zauberstab-Auswahl, die auf das bereitgestellte Bild angewendet wurde, subtrahiert von der aktuellen Maske.

Parameters:

ParameterTypBeschreibung
imageRasterImageBild für den Zauberstab.
settingsMagicWandSettingsZauberstab‑Einstellungen.

Returns: ImageBitMask - New ImageBitMask.

intersect(ImageMask mask)

public final ImageBitMask intersect(ImageMask mask)

Ermittelt die Schnittmenge der aktuellen Maske mit der bereitgestellten.

Parameters:

ParameterTypBeschreibung
maskImageMaskBereitgestellte Maske

Returns: ImageBitMask - New ImageBitMask.

intersect()

public final ImageBitMask intersect()

Ermittelt die Schnittmenge der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf die Quelle der Maske angewendet wurde.

Returns: ImageBitMask - New ImageBitMask.

intersect(MagicWandSettings settings)

public final ImageBitMask intersect(MagicWandSettings settings)

Ermittelt die Schnittmenge der aktuellen Maske mit dem Ergebnis der Zauberstab-Auswahl, die auf die Quelle der Maske angewendet wurde.

Parameters:

ParameterTypBeschreibung
settingsMagicWandSettingsZauberstab‑Einstellungen.

Returns: ImageBitMask - New ImageBitMask.

intersect(RasterImage image)

public final ImageBitMask intersect(RasterImage image)

Ermittelt die Schnittmenge der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf das bereitgestellte Bild angewendet wurde.

Parameters:

ParameterTypBeschreibung
imageRasterImageBild für den Zauberstab.

Returns: ImageBitMask - New ImageBitMask.

intersect(RasterImage image, MagicWandSettings settings)

public final ImageBitMask intersect(RasterImage image, MagicWandSettings settings)

Ermittelt die Schnittmenge der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf das bereitgestellte Bild angewendet wurde.

Parameters:

ParameterTypBeschreibung
imageRasterImageBild für den Zauberstab.
settingsMagicWandSettingsZauberstab‑Einstellungen.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(ImageMask mask)

public final ImageBitMask exclusiveDisjunction(ImageMask mask)

Ermittelt die exklusive Disjunktion der aktuellen Maske mit der bereitgestellten.

Parameters:

ParameterTypBeschreibung
maskImageMaskBereitgestellte Maske

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction()

public final ImageBitMask exclusiveDisjunction()

Ermittelt die exklusive Disjunktion der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf die Quelle der Maske angewendet wurde.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(MagicWandSettings settings)

public final ImageBitMask exclusiveDisjunction(MagicWandSettings settings)

Ermittelt die exklusive Disjunktion der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf die Quelle der Maske angewendet wurde.

Parameters:

ParameterTypBeschreibung
settingsMagicWandSettingsZauberstab‑Einstellungen.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(RasterImage image)

public final ImageBitMask exclusiveDisjunction(RasterImage image)

Ermittelt die exklusive Disjunktion der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf das bereitgestellte Bild angewendet wurde.

Parameters:

ParameterTypBeschreibung
imageRasterImageBild für den Zauberstab.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(RasterImage image, MagicWandSettings settings)

public final ImageBitMask exclusiveDisjunction(RasterImage image, MagicWandSettings settings)

Ermittelt die exklusive Disjunktion der aktuellen Maske mit dem Ergebnis der Zauberstab‑Auswahl, die auf das bereitgestellte Bild angewendet wurde.

Parameters:

ParameterTypBeschreibung
imageRasterImageBild für den Zauberstab.
settingsMagicWandSettingsZauberstab‑Einstellungen.

Returns: ImageBitMask - New ImageBitMask.