MagicWandSettings

Inheritance: java.lang.Object

public class MagicWandSettings

فئة إعدادات اختيار magic wand.

المنشئات

المنشئ	الوصف
MagicWandSettings(Point point)	يُنشئ مثيلًا جديدًا للفئة MagicWandSettings.
MagicWandSettings(int x, int y)	يُنشئ مثيلًا جديدًا للفئة MagicWandSettings.

الطرق

طريقة	الوصف
getAreaOfInterest()	يحصل على حدود المنطقة لعمل الخوارزمية.
setAreaOfInterest(Rectangle value)	يحدد حدود المنطقة لعمل الخوارزمية.
getPoint()	يحصل على نقطة المرجع لعمل الخوارزمية.
getThreshold()	يحصل على مستوى التحمل لمقارنة ألوان البكسل.
setThreshold(int value)	يحدد مستوى التحمل لمقارنة ألوان البكسل.
getContiguousMode()	يحصل على قيمة تشير إلى ما إذا كانت أداة السحر ستحدد البكسلات المتجاورة فقط.
setContiguousMode(boolean value)	يضبط قيمة تشير إلى ما إذا كانت عصا السحر ستحدد فقط البكسلات المتجاورة.
getDirectionalMode()	يحصل على وضع خوارزمية البحث بالتعبئة المتدفقة: بحث بأربعة أو ثمانية اتجاهات.
setDirectionalMode(int value)	يضبط وضع خوارزمية البحث بالتعبئة المتدفقة: بحث بأربعة أو ثمانية اتجاهات.
getColorCompareMode()	يحصل على الخوارزمية التي تُقارن بها الألوان.
setColorCompareMode(int value)	يضبط الخوارزمية التي تُقارن بها الألوان.
getColorComparisonDelegate()	يحصل على خوارزمية مقارنة الألوان المخصصة إذا تم تعيين ColorCompareMode(#getColorCompareMode.getColorCompareMode/#setColorCompareMode(int).setColorCompareMode(int)) إلى ColorComparisonMode.Custom.
setColorComparisonDelegate(MagicWandSettings.ColorComparison value)	يضبط خوارزمية مقارنة الألوان المخصصة إذا تم تعيين ColorCompareMode(#getColorCompareMode.getColorCompareMode/#setColorCompareMode(int).setColorCompareMode(int)) إلى ColorComparisonMode.Custom.

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))
{
    // أنشئ قناعًا جديدًا باستخدام أداة العصا السحرية بناءً على نغمة ولون البكسل (120, 100) مع عتبة مخصصة تساوي 150
    MagicWandTool
            .select(image, new MagicWandSettings(120, 100) {{ setThreshold(150); }})
            // طبق القناع على الصورة
            .apply();

    // احفظ الصورة مع خيار نوع لون الشفافية القسري
    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))
{
    // أنشئ قناعًا جديدًا باستخدام أداة العصا السحرية بناءً على نغمة ولون البكسل (845, 128)
    MagicWandTool.select(image, new MagicWandSettings(845, 128))
            // ادمج القناع الحالي مع القناع المحدد الذي تم إنشاؤه بأداة العصا السحرية
            .union(new MagicWandSettings(416, 387))
            // اعكس القناع الحالي
            .invert()
            // اطرح القناع المحدد الذي تم إنشاؤه بأداة العصا السحرية مع العتبة المحددة من القناع الحالي
            .subtract(new MagicWandSettings(1482, 346) {{ setThreshold(69); }})
            // اطرح أربعة أقنعة مستطيلة محددة من القناع الحالي واحدًا تلو الآخر
            .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))
            // نقّح القناع باستخدام الإعدادات المحددة
            .getFeathered(new FeatheringSettings() {{ setSize(3); }})
            // طبق القناع على الصورة
            .apply();

    // احفظ الصورة
    image.save(outputFilePath);
}

MagicWandSettings(Point point)

public MagicWandSettings(Point point)

يُنشئ مثيلًا جديدًا للفئة MagicWandSettings.

Parameters:

معامل	نوع	الوصف
point	Point	نقطة الإشارة.

MagicWandSettings(int x, int y)

public MagicWandSettings(int x, int y)

يُنشئ مثيلًا جديدًا للفئة MagicWandSettings.

Parameters:

معامل	نوع	الوصف
س	int	الإحداثي x لنقطة الإشارة.
ص	int	الإحداثي y لنقطة الإشارة.

getAreaOfInterest()

public final Rectangle getAreaOfInterest()

يحصل على حدود المنطقة لعمل الخوارزمية.

القيمة: المستطيل الذي يمثل حدود منطقة الاهتمام.

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

setAreaOfInterest(Rectangle value)

public final void setAreaOfInterest(Rectangle value)

يحدد حدود المنطقة لعمل الخوارزمية.

القيمة: المستطيل الذي يمثل حدود منطقة الاهتمام.

Parameters:

معامل	نوع	الوصف
value	Rectangle	حدود المنطقة لعمل الخوارزمية.

getPoint()

public final Point getPoint()

يحصل على نقطة المرجع لعمل الخوارزمية.

القيمة: قيمة Point.

Returns: Point - the reference point for algorithm work.

getThreshold()

public final int getThreshold()

يحصل على مستوى التحمل لمقارنة ألوان البكسل.

القيمة: العتبة لمقارنة الألوان.

Returns: int - مستوى التحمل لمقارنة ألوان البكسلات.

setThreshold(int value)

public final void setThreshold(int value)

يحدد مستوى التحمل لمقارنة ألوان البكسل.

القيمة: العتبة لمقارنة الألوان.

Parameters:

معامل	نوع	الوصف
القيمة	int	مستوى التحمل لمقارنة ألوان البكسلات.

getContiguousMode()

public final boolean getContiguousMode()

يحصل على قيمة تشير إلى ما إذا كانت أداة السحر ستحدد البكسلات المتجاورة فقط.

القيمة: true إذا كان العنصر مفعلاً؛ وإلا false. القيمة الافتراضية هي true.

Returns: boolean - قيمة تشير إلى ما إذا كانت عصا السحر ستحدد فقط البكسلات المتجاورة.

setContiguousMode(boolean value)

public final void setContiguousMode(boolean value)

يضبط قيمة تشير إلى ما إذا كانت عصا السحر ستحدد فقط البكسلات المتجاورة.

القيمة: true إذا كان العنصر مفعلاً؛ وإلا false. القيمة الافتراضية هي true.

Parameters:

معامل	نوع	الوصف
القيمة	boolean	قيمة تشير إلى ما إذا كانت عصا السحر ستحدد فقط البكسلات المتجاورة.

getDirectionalMode()

public final int getDirectionalMode()

يحصل على وضع خوارزمية البحث بالتعبئة المتدفقة: بحث بأربعة أو ثمانية اتجاهات.

القيمة: وضع خوارزمية البحث بالتعبئة المتدفقة.

Returns: int - وضع خوارزمية البحث بالتعبئة المتدفقة: بحث بأربعة أو ثمانية اتجاهات.

setDirectionalMode(int value)

public final void setDirectionalMode(int value)

يضبط وضع خوارزمية البحث بالتعبئة المتدفقة: بحث بأربعة أو ثمانية اتجاهات.

القيمة: وضع خوارزمية البحث بالتعبئة المتدفقة.

Parameters:

معامل	نوع	الوصف
القيمة	int	وضع خوارزمية البحث بالتعبئة المتدفقة: بحث بأربعة أو ثمانية اتجاهات.

getColorCompareMode()

public final int getColorCompareMode()

يحصل على الخوارزمية التي تُقارن بها الألوان.

القيمة: وضع مقارنة الألوان.

Returns: int - الخوارزمية التي تُقارن بها الألوان.

setColorCompareMode(int value)

public final void setColorCompareMode(int value)

يضبط الخوارزمية التي تُقارن بها الألوان.

القيمة: وضع مقارنة الألوان.

Parameters:

معامل	نوع	الوصف
القيمة	int	الخوارزمية التي تُقارن بها الألوان.

getColorComparisonDelegate()

public final MagicWandSettings.ColorComparison getColorComparisonDelegate()

يحصل على خوارزمية مقارنة الألوان المخصصة إذا تم تعيين ColorCompareMode(#getColorCompareMode.getColorCompareMode/#setColorCompareMode(int).setColorCompareMode(int)) إلى ColorComparisonMode.Custom.

القيمة: مفوض مقارنة اللون.

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)

يضبط خوارزمية مقارنة الألوان المخصصة إذا تم تعيين ColorCompareMode(#getColorCompareMode.getColorCompareMode/#setColorCompareMode(int).setColorCompareMode(int)) إلى ColorComparisonMode.Custom.

القيمة: مفوض مقارنة اللون.

Parameters:

معامل	نوع	الوصف
value	ColorComparison	خوارزمية مقارنة اللون المخصصة إذا تم تعيين ColorCompareMode(#getColorCompareMode.getColorCompareMode/#setColorCompareMode(int).setColorCompareMode(int)) إلى ColorComparisonMode.Custom.