MagicWandSettings

Inheritance: java.lang.Object

public class MagicWandSettings

Eine Klasse für Magic‑Wand‑Auswahleinstellungen.

Konstruktoren

Konstruktor	Beschreibung
MagicWandSettings(Point point)	Initialisiert eine neue Instanz der MagicWandSettings Klasse.
MagicWandSettings(int x, int y)	Initialisiert eine neue Instanz der MagicWandSettings Klasse.

Methoden

Methode	Beschreibung
getAreaOfInterest()	Liefert die Grenzen des Bereichs für die Algorithmus‑Ausführung.
setAreaOfInterest(Rectangle value)	Setzt die Grenzen des Bereichs für die Algorithmus‑Ausführung.
getPoint()	Liefert den Referenzpunkt für die Algorithmus‑Ausführung.
getThreshold()	Liefert den Toleranzwert für den Farbvergleich von Pixeln.
setThreshold(int value)	Setzt den Toleranzwert für den Farbvergleich von Pixeln.
getContiguousMode()	Liefert einen Wert, der angibt, ob magic wand nur zusammenhängende Pixel definiert.
setContiguousMode(boolean value)	Legt einen Wert fest, der angibt, ob der Magic Wand nur zusammenhängende Pixel definiert.
getDirectionalMode()	Liefert den Modus des Flood-Fill-Suchalgorithmus: vier- oder acht Richtungs-Suche.
setDirectionalMode(int value)	Legt den Modus des Flood-Fill-Suchalgorithmus fest: vier- oder acht Richtungs-Suche.
getColorCompareMode()	Liefert den Algorithmus, wie Farben verglichen werden.
setColorCompareMode(int value)	Legt den Algorithmus fest, wie Farben verglichen werden.
getColorComparisonDelegate()	Liefert den benutzerdefinierten Farbabgleich-Algorithmus, wenn `ColorCompareMode`(#getColorCompareMode.getColorCompareMode/#setColorCompareMode(int).setColorCompareMode(int)) auf ColorComparisonMode.Custom gesetzt ist.
setColorComparisonDelegate(MagicWandSettings.ColorComparison value)	Legt den benutzerdefinierten Farbabgleich-Algorithmus fest, wenn `ColorCompareMode`(#getColorCompareMode.getColorCompareMode/#setColorCompareMode(int).setColorCompareMode(int)) auf ColorComparisonMode.Custom gesetzt ist.

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

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

MagicWandSettings(Point point)

public MagicWandSettings(Point point)

Initialisiert eine neue Instanz der MagicWandSettings Klasse.

Parameters:

Parameter	Typ	Beschreibung
point	Point	Der Referenzpunkt.

MagicWandSettings(int x, int y)

public MagicWandSettings(int x, int y)

Initialisiert eine neue Instanz der MagicWandSettings Klasse.

Parameters:

Parameter	Typ	Beschreibung
x	int	Die x-Koordinate des Referenzpunkts.
y	int	Die y-Koordinate des Referenzpunkts.

getAreaOfInterest()

public final Rectangle getAreaOfInterest()

Liefert die Grenzen des Bereichs für die Algorithmus‑Ausführung.

Wert: Das Rechteck, das die Grenzen des Interessengebiets darstellt.

Returns: Rectangle - the bounds of the area for algorithm work.

setAreaOfInterest(Rectangle value)

public final void setAreaOfInterest(Rectangle value)

Setzt die Grenzen des Bereichs für die Algorithmus‑Ausführung.

Wert: Das Rechteck, das die Grenzen des Interessengebiets darstellt.

Parameters:

Parameter	Typ	Beschreibung
value	Rectangle	die Grenzen des Bereichs für die Algorithmusarbeit.

getPoint()

public final Point getPoint()

Liefert den Referenzpunkt für die Algorithmus‑Ausführung.

Wert: Der Point-Wert.

Returns: Point - the reference point for algorithm work.

getThreshold()

public final int getThreshold()

Liefert den Toleranzwert für den Farbvergleich von Pixeln.

Wert: Der Schwellenwert für den Farbabgleich.

Returns: int – die Toleranzstufe für den Farbvergleich von Pixeln.

setThreshold(int value)

public final void setThreshold(int value)

Setzt den Toleranzwert für den Farbvergleich von Pixeln.

Wert: Der Schwellenwert für den Farbabgleich.

Parameters:

Parameter	Typ	Beschreibung
Wert	int	die Toleranzstufe für den Farbvergleich von Pixeln.

getContiguousMode()

public final boolean getContiguousMode()

Liefert einen Wert, der angibt, ob magic wand nur zusammenhängende Pixel definiert.

Wert: true, wenn das Element aktiviert ist; andernfalls false. Der Standardwert ist true.

Returns: boolean – ein Wert, der angibt, ob der Magic Wand nur zusammenhängende Pixel definiert.

setContiguousMode(boolean value)

public final void setContiguousMode(boolean value)

Legt einen Wert fest, der angibt, ob der Magic Wand nur zusammenhängende Pixel definiert.

Wert: true, wenn das Element aktiviert ist; andernfalls false. Der Standardwert ist true.

Parameters:

Parameter	Typ	Beschreibung
Wert	boolean	ein Wert, der angibt, ob der Magic Wand nur zusammenhängende Pixel definiert.

getDirectionalMode()

public final int getDirectionalMode()

Liefert den Modus des Flood-Fill-Suchalgorithmus: vier- oder acht Richtungs-Suche.

Wert: Der Modus des Flood-Fill-Suchalgorithmus.

Returns: int – der Modus des Flood-Fill-Suchalgorithmus: vier- oder acht Richtungs-Suche.

setDirectionalMode(int value)

public final void setDirectionalMode(int value)

Legt den Modus des Flood-Fill-Suchalgorithmus fest: vier- oder acht Richtungs-Suche.

Wert: Der Modus des Flood-Fill-Suchalgorithmus.

Parameters:

Parameter	Typ	Beschreibung
Wert	int	der Modus des Flood-Fill-Suchalgorithmus: vier- oder acht Richtungs-Suche.

getColorCompareMode()

public final int getColorCompareMode()

Liefert den Algorithmus, wie Farben verglichen werden.

Wert: Der Farbvergleichsmodus.

Returns: int – der Algorithmus, wie Farben verglichen werden.

setColorCompareMode(int value)

public final void setColorCompareMode(int value)

Legt den Algorithmus fest, wie Farben verglichen werden.

Wert: Der Farbvergleichsmodus.

Parameters:

Parameter	Typ	Beschreibung
Wert	int	der Algorithmus, wie Farben verglichen werden.

getColorComparisonDelegate()

public final MagicWandSettings.ColorComparison getColorComparisonDelegate()

Liefert den benutzerdefinierten Farbabgleich-Algorithmus, wenn ColorCompareMode(#getColorCompareMode.getColorCompareMode/#setColorCompareMode(int).setColorCompareMode(int)) auf ColorComparisonMode.Custom gesetzt ist.

Wert: Der Farbvergleich-Delegat.

Returns: ColorComparison - the custom color comparison algorithm if ColorCompareMode(#getColorCompareMode.getColorCompareMode/#setColorCompareMode(int).setColorCompareMode(int)) is set to ColorComparisonMode.Custom.

setColorComparisonDelegate(MagicWandSettings.ColorComparison value)

public final void setColorComparisonDelegate(MagicWandSettings.ColorComparison value)

Legt den benutzerdefinierten Farbabgleich-Algorithmus fest, wenn ColorCompareMode(#getColorCompareMode.getColorCompareMode/#setColorCompareMode(int).setColorCompareMode(int)) auf ColorComparisonMode.Custom gesetzt ist.

Wert: Der Farbvergleich-Delegat.

Parameters:

Parameter	Typ	Beschreibung
value	ColorComparison	der benutzerdefinierte Farbvergleich-Algorithmus, wenn `ColorCompareMode`(#getColorCompareMode.getColorCompareMode/#setColorCompareMode(int).setColorCompareMode(int)) auf ColorComparisonMode.Custom gesetzt ist.

FloodFillDirectionalMode MagicWandTool