ImageGrayscaleMask

Inheritance: java.lang.Object

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

public class ImageGrayscaleMask implements IImageMask

Beschreibt eine Graustufen‑Bildmaske.

Konstruktoren

Konstruktor	Beschreibung
ImageGrayscaleMask(int width, int height)	Initialisiert eine neue Instanz der ImageGrayscaleMask Klasse mit der angegebenen Breite und Höhe.
ImageGrayscaleMask(RasterImage image)	Initialisiert eine neue Instanz der ImageGrayscaleMask Klasse mit der Größe des angegebenen vorhandenen RasterImage.

Methoden

Methode	Beschreibung
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.
getSelectionBounds()	Gibt die Begrenzungen des ausgewählten Teils der Maske in Pixeln zurück.
get_Item(int x, int y)	Ermittelt die Opazität des angegebenen Pixels.
set_Item(int x, int y, byte value)	Setzt die Deckkraft des angegebenen Pixels.
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.
deepClone()	Erstellt ein neues Objekt, das eine Kopie der aktuellen Instanz ist.
apply()	Wendet die aktuelle Maske auf die RasterImage-Quelle an, falls vorhanden.
applyTo(RasterImage image)	Wendet die aktuelle Maske auf die angegebene RasterImage an.
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.
invert()	Ermittelt die Inversion der aktuellen Maske.
union(ImageGrayscaleMask mask)	Vereinigung von zwei Masken.
subtract(ImageGrayscaleMask mask)	Ermittelt die Subtraktion der bereitgestellten Maske von der aktuellen.
intersect(ImageGrayscaleMask mask)	Ermittelt die Schnittmenge der aktuellen Maske mit der bereitgestellten.
exclusiveDisjunction(ImageGrayscaleMask mask)	Ermittelt die exklusive Disjunktion der aktuellen Maske mit der bereitgestellten.
op_LogicalNot(ImageGrayscaleMask a)	Invertiert die Maske.
op_Addition(ImageGrayscaleMask a, ImageGrayscaleMask b)	Vereinigung von zwei Masken.
op_Subtraction(ImageGrayscaleMask a, ImageGrayscaleMask b)	Subtrahiere die zweite Maske von der ersten.
op_Multiply(ImageGrayscaleMask a, ImageGrayscaleMask b)	Schnittmenge von zwei Masken.
op_ExclusiveOr(ImageGrayscaleMask a, ImageGrayscaleMask b)	Exklusive Disjunktion von zwei Masken.

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);
}

ImageGrayscaleMask(int width, int height)

public ImageGrayscaleMask(int width, int height)

Initialisiert eine neue Instanz der ImageGrayscaleMask Klasse mit der angegebenen Breite und Höhe.

Parameters:

Parameter	Typ	Beschreibung
Breite	int	Breite der Maske.
Höhe	int	Höhe der Maske.

ImageGrayscaleMask(RasterImage image)

public ImageGrayscaleMask(RasterImage image)

Initialisiert eine neue Instanz der ImageGrayscaleMask Klasse mit der Größe des angegebenen vorhandenen RasterImage. Das angegebene RasterImage wird als Quellbild gespeichert.

Parameters:

Parameter	Typ	Beschreibung
image	RasterImage	Quellbild.

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.

getSelectionBounds()

public final Rectangle getSelectionBounds()

Gibt die Begrenzungen des ausgewählten Teils der Maske in Pixeln zurück.

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

get_Item(int x, int y)

public final byte get_Item(int x, int y)

Ermittelt die Opazität des angegebenen Pixels.

Parameters:

Parameter	Typ	Beschreibung
x	int	Die x‑Koordinate des Pixels.
y	int	Die y‑Koordinate des Pixels. Wert: Byte-Wert; 0 wenn transparent; 255 wenn undurchsichtig.

Returns: byte

set_Item(int x, int y, byte value)

public final void set_Item(int x, int y, byte value)

Setzt die Deckkraft des angegebenen Pixels.

Parameters:

Parameter	Typ	Beschreibung
x	int	Die x‑Koordinate des Pixels.
y	int	Die y‑Koordinate des Pixels. Wert: Byte-Wert; 0 wenn transparent; 255 wenn undurchsichtig.
Wert	byte	die Deckkraft des angegebenen Pixels.

isOpaque(int x, int y)

public final boolean isOpaque(int x, int y)

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

Parameters:

Parameter	Typ	Beschreibung
x	int	Die x‑Koordinate des Pixels.
y	int	Die 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:

Parameter	Typ	Beschreibung
x	int	Die x‑Koordinate des Pixels.
y	int	Die 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:

Parameter	Typ	Beschreibung
x	int	Die x‑Koordinate des Pixels.
y	int	Die y‑Koordinate des Pixels.

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

deepClone()

public final Object deepClone()

Erstellt ein neues Objekt, das eine Kopie der aktuellen Instanz ist.

Returns: java.lang.Object - Ein neues Objekt, das eine Kopie dieser Instanz ist.

apply()

public final void apply()

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

applyTo(RasterImage image)

public final void applyTo(RasterImage image)

Wendet die aktuelle Maske auf die angegebene RasterImage an.

Parameters:

Parameter	Typ	Beschreibung
image	RasterImage	Bild, auf das die Maske angewendet wird.

crop(Size size)

public final ImageGrayscaleMask crop(Size size)

Beschneidet die Maske mit der angegebenen Größe.

Parameters:

Parameter	Typ	Beschreibung
size	Size	Die angegebene Größe.

Returns: ImageGrayscaleMask - A cropped ImageGrayscaleMask.

crop(int width, int height)

public final ImageGrayscaleMask crop(int width, int height)

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

Parameters:

Parameter	Typ	Beschreibung
Breite	int	Die angegebene Breite.
Höhe	int	Die angegebene Höhe.

Returns: ImageGrayscaleMask - A cropped ImageGrayscaleMask.

crop(Rectangle rectangle)

public final ImageGrayscaleMask crop(Rectangle rectangle)

Schneidet die Maske mit dem angegebenen Rechteck zu.

Parameters:

Parameter	Typ	Beschreibung
rectangle	Rectangle	Das angegebene Rechteck.

Returns: ImageGrayscaleMask - A cropped ImageGrayscaleMask.

invert()

public final ImageGrayscaleMask invert()

Ermittelt die Inversion der aktuellen Maske.

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

union(ImageGrayscaleMask mask)

public final ImageGrayscaleMask union(ImageGrayscaleMask mask)

Vereinigung von zwei Masken.

Parameters:

Parameter	Typ	Beschreibung
mask	ImageGrayscaleMask	Bereitgestellte Maske

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

subtract(ImageGrayscaleMask mask)

public final ImageGrayscaleMask subtract(ImageGrayscaleMask mask)

Ermittelt die Subtraktion der bereitgestellten Maske von der aktuellen.

Parameters:

Parameter	Typ	Beschreibung
mask	ImageGrayscaleMask	Bereitgestellte Maske

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

intersect(ImageGrayscaleMask mask)

public final ImageGrayscaleMask intersect(ImageGrayscaleMask mask)

Ermittelt die Schnittmenge der aktuellen Maske mit der bereitgestellten.

Parameters:

Parameter	Typ	Beschreibung
mask	ImageGrayscaleMask	Bereitgestellte Maske

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

exclusiveDisjunction(ImageGrayscaleMask mask)

public final ImageGrayscaleMask exclusiveDisjunction(ImageGrayscaleMask mask)

Ermittelt die exklusive Disjunktion der aktuellen Maske mit der bereitgestellten.

Parameters:

Parameter	Typ	Beschreibung
mask	ImageGrayscaleMask	Bereitgestellte Maske

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

op_LogicalNot(ImageGrayscaleMask a)

public static ImageGrayscaleMask op_LogicalNot(ImageGrayscaleMask a)

Invertiert die Maske.

Parameters:

Parameter	Typ	Beschreibung
a	ImageGrayscaleMask	Die zu invertierende Maske.

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

op_Addition(ImageGrayscaleMask a, ImageGrayscaleMask b)

public static ImageGrayscaleMask op_Addition(ImageGrayscaleMask a, ImageGrayscaleMask b)

Vereinigung von zwei Masken.

Parameters:

Parameter	Typ	Beschreibung
a	ImageGrayscaleMask	Die erste Maske.
b	ImageGrayscaleMask	Die zweite Maske.

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

op_Subtraction(ImageGrayscaleMask a, ImageGrayscaleMask b)

public static ImageGrayscaleMask op_Subtraction(ImageGrayscaleMask a, ImageGrayscaleMask b)

Subtrahiere die zweite Maske von der ersten.

Parameters:

Parameter	Typ	Beschreibung
a	ImageGrayscaleMask	Die erste Maske.
b	ImageGrayscaleMask	Die zweite Maske.

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

op_Multiply(ImageGrayscaleMask a, ImageGrayscaleMask b)

public static ImageGrayscaleMask op_Multiply(ImageGrayscaleMask a, ImageGrayscaleMask b)

Schnittmenge von zwei Masken.

Parameters:

Parameter	Typ	Beschreibung
a	ImageGrayscaleMask	Die erste Maske.
b	ImageGrayscaleMask	Die zweite Maske.

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

op_ExclusiveOr(ImageGrayscaleMask a, ImageGrayscaleMask b)

public static ImageGrayscaleMask op_ExclusiveOr(ImageGrayscaleMask a, ImageGrayscaleMask b)

Exklusive Disjunktion von zwei Masken.

Parameters:

Parameter	Typ	Beschreibung
a	ImageGrayscaleMask	Die erste Maske.
b	ImageGrayscaleMask	Die zweite Maske.

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

ImageBitMask ImageMask