ImageMask

Inheritance: java.lang.Object

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

public abstract class ImageMask implements IImageMask

يصف قناع صورة ثنائي.

الطرق

طريقة	الوصف
to_ImageGrayscaleMask(ImageMask mask)	تحويل `mask` إلى ImageGrayscaleMask.
op_LogicalNot(ImageMask a)	يعكس القناع.
op_Addition(ImageMask a, ImageMask b)	اتحاد قناعين.
op_Subtraction(ImageMask a, ImageMask b)	اطرح القناع الثاني من الأول.
op_Multiply(ImageMask a, ImageMask b)	تقاطع قناعين.
op_ExclusiveOr(ImageMask a, ImageMask b)	اختلاف حصري بين قناعين.
getSource()	يحصل على الصورة المصدر المستخدمة لإنشاء هذه القناع، إذا وجدت.
getWidth()	يحصل على العرض، بوحدات البكسل، لهذه القناع.
getHeight()	يحصل على الارتفاع، بوحدات البكسل، لهذه القناع.
getBounds()	يحصل على الحدود، بوحدات البكسل، لهذه القناع.
get_Item(int x, int y)	يحصل على شفافية البكسل المحدد.
inflate(int size)	يضخم هذه القناع بالمقدار المحدد.
crop(Size size)	يقص القناع بالحجم المحدد.
crop(int width, int height)	يقص القناع بالعرض والارتفاع المحددين.
crop(Rectangle rectangle)	يقص القناع بالمستطيل المحدد.
isOpaque(int x, int y)	يتحقق مما إذا كان البكسل المحدد غير شفاف.
isTransparent(int x, int y)	يتحقق مما إذا كان البكسل المحدد شفافًا.
getByteOpacity(int x, int y)	يحصل على شفافية البكسل المحدد بدقة بايت.
getFeathered()	يحصل على قناع رمادي مع حد مموه بالإعدادات الافتراضية.
getFeathered(FeatheringSettings settings)	يحصل على قناع رمادي مع حد مموه بالإعدادات المحددة.
apply()	يطبق القناع الحالي على مصدر RasterImage إذا كان موجودًا.
applyTo(RasterImage image)	يطبق القناع الحالي على RasterImage المحدد.
invert()	يحصل على عكس القناع الحالي.
union(ImageMask mask)	يحصل على اتحاد القناع الحالي مع القناع المقدم.
union()	يحصل على اتحاد القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.
union(MagicWandSettings settings)	يحصل على اتحاد القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.
union(RasterImage image)	يحصل على اتحاد القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.
union(RasterImage image, MagicWandSettings settings)	يحصل على اتحاد القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.
subtract(ImageMask mask)	يحصل على طرح القناع المقدم من القناع الحالي.
subtract()	يحصل على نتيجة اختيار العصا السحرية المطبقة على مصدر القناع الحالي مطروحًا من القناع.
subtract(MagicWandSettings settings)	يحصل على نتيجة اختيار العصا السحرية المطبقة على مصدر القناع الحالي مطروحًا من القناع.
subtract(RasterImage image)	يحصل على نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة مطروحًا من القناع الحالي.
subtract(RasterImage image, MagicWandSettings settings)	يحصل على نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة مطروحًا من القناع الحالي.
intersect(ImageMask mask)	يحصل على تقاطع القناع الحالي مع القناع المقدم.
intersect()	يحصل على تقاطع القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.
intersect(MagicWandSettings settings)	يحصل على تقاطع القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.
intersect(RasterImage image)	يحصل على تقاطع القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.
intersect(RasterImage image, MagicWandSettings settings)	يحصل على تقاطع القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.
exclusiveDisjunction(ImageMask mask)	يحصل على التفريق الحصري للقناع الحالي مع القناع المقدم.
exclusiveDisjunction()	يحصل على التفريق الحصري للقناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.
exclusiveDisjunction(MagicWandSettings settings)	يحصل على التفريق الحصري للقناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.
exclusiveDisjunction(RasterImage image)	يحصل على التفريق الحصري للقناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.
exclusiveDisjunction(RasterImage image, MagicWandSettings settings)	يحصل على التفريق الحصري للقناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.

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

to_ImageGrayscaleMask(ImageMask mask)

public static ImageGrayscaleMask to_ImageGrayscaleMask(ImageMask mask)

تحويل mask إلى ImageGrayscaleMask.

Parameters:

معامل	نوع	الوصف
mask	ImageMask	قيمة القناع.

Returns: ImageGrayscaleMask - The new ImageGrayscaleMask base on mask.

op_LogicalNot(ImageMask a)

public static ImageBitMask op_LogicalNot(ImageMask a)

يعكس القناع.

Parameters:

معامل	نوع	الوصف
a	ImageMask	القناع الذي سيُعكس.

Returns: ImageBitMask - New ImageBitMask.

op_Addition(ImageMask a, ImageMask b)

public static ImageBitMask op_Addition(ImageMask a, ImageMask b)

اتحاد قناعين.

Parameters:

معامل	نوع	الوصف
a	ImageMask	القناع الأول.
b	ImageMask	القناع الثاني.

Returns: ImageBitMask - New ImageBitMask.

op_Subtraction(ImageMask a, ImageMask b)

public static ImageBitMask op_Subtraction(ImageMask a, ImageMask b)

اطرح القناع الثاني من الأول.

Parameters:

معامل	نوع	الوصف
a	ImageMask	القناع الأول.
b	ImageMask	القناع الثاني.

Returns: ImageBitMask - New ImageBitMask.

op_Multiply(ImageMask a, ImageMask b)

public static ImageBitMask op_Multiply(ImageMask a, ImageMask b)

تقاطع قناعين.

Parameters:

معامل	نوع	الوصف
a	ImageMask	القناع الأول.
b	ImageMask	القناع الثاني.

Returns: ImageBitMask - New ImageBitMask.

op_ExclusiveOr(ImageMask a, ImageMask b)

public static ImageBitMask op_ExclusiveOr(ImageMask a, ImageMask b)

اختلاف حصري بين قناعين.

Parameters:

معامل	نوع	الوصف
a	ImageMask	القناع الأول.
b	ImageMask	القناع الثاني.

Returns: ImageBitMask - New ImageBitMask.

getSource()

public final RasterImage getSource()

يحصل على الصورة المصدر المستخدمة لإنشاء هذه القناع، إذا وجدت.

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

getWidth()

public final int getWidth()

يحصل على العرض، بوحدات البكسل، لهذه القناع.

Returns: int - العرض، بوحدات البكسل، لهذه القناع.

getHeight()

public final int getHeight()

يحصل على الارتفاع، بوحدات البكسل، لهذه القناع.

Returns: int - الارتفاع، بوحدات البكسل، لهذه القناع.

getBounds()

public final Rectangle getBounds()

يحصل على الحدود، بوحدات البكسل، لهذه القناع.

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

get_Item(int x, int y)

public abstract boolean get_Item(int x, int y)

يحصل على شفافية البكسل المحدد.

Parameters:

معامل	نوع	الوصف
x	int	الإحداثي السيني للبكسل.
y	int	الإحداثي الصادي للبكسل.

Returns: boolean - true إذا كان البكسل المحدد غير شفاف؛ وإلا false.

inflate(int size)

public abstract ImageMask inflate(int size)

يضخم هذه القناع بالمقدار المحدد.

Parameters:

معامل	نوع	الوصف
size	int	المقدار لتضخيم هذه القناع.

Returns: ImageMask - An ImageMask.

crop(Size size)

public final ImageMask crop(Size size)

يقص القناع بالحجم المحدد.

Parameters:

معامل	نوع	الوصف
size	Size	الحجم المحدد.

Returns: ImageMask - An ImageMask.

crop(int width, int height)

public final ImageMask crop(int width, int height)

يقص القناع بالعرض والارتفاع المحددين.

Parameters:

معامل	نوع	الوصف
width	int	العرض المحدد.
height	int	الارتفاع المحدد.

Returns: ImageMask - An ImageMask.

crop(Rectangle rectangle)

public abstract ImageMask crop(Rectangle rectangle)

يقص القناع بالمستطيل المحدد.

Parameters:

معامل	نوع	الوصف
rectangle	Rectangle	المستطيل المحدد.

Returns: ImageMask - An ImageMask.

isOpaque(int x, int y)

public final boolean isOpaque(int x, int y)

يتحقق مما إذا كان البكسل المحدد غير شفاف.

Parameters:

معامل	نوع	الوصف
x	int	الإحداثي السيني للبكسل.
y	int	الإحداثي الصادي للبكسل.

Returns: boolean - true إذا كان البكسل المحدد غير شفاف؛ وإلا false.

isTransparent(int x, int y)

public final boolean isTransparent(int x, int y)

يتحقق مما إذا كان البكسل المحدد شفافًا.

Parameters:

معامل	نوع	الوصف
x	int	الإحداثي السيني للبكسل.
y	int	الإحداثي الصادي للبكسل.

Returns: boolean - true إذا كان البكسل المحدد شفافًا؛ وإلا false.

getByteOpacity(int x, int y)

public final byte getByteOpacity(int x, int y)

يحصل على شفافية البكسل المحدد بدقة بايت.

Parameters:

معامل	نوع	الوصف
x	int	الإحداثي السيني للبكسل.
y	int	الإحداثي الصادي للبكسل.

Returns: byte - قيمة بايت، تمثل شفافية البكسل المحدد.

getFeathered()

public final ImageGrayscaleMask getFeathered()

يحصل على قناع رمادي مع حد مموه بالإعدادات الافتراضية.

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

getFeathered(FeatheringSettings settings)

public final ImageGrayscaleMask getFeathered(FeatheringSettings settings)

يحصل على قناع رمادي مع حد مموه بالإعدادات المحددة.

Parameters:

معامل	نوع	الوصف
settings	FeatheringSettings	إعدادات التنعيم.

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

apply()

public final void apply()

يطبق القناع الحالي على مصدر RasterImage إذا كان موجودًا.

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

applyTo(RasterImage image)

public final void applyTo(RasterImage image)

يطبق القناع الحالي على RasterImage المحدد.

Parameters:

معامل	نوع	الوصف
image	RasterImage	الصورة التي سيُطبق عليها القناع.

invert()

public final ImageBitMask invert()

يحصل على عكس القناع الحالي.

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))
{
    // أنشئ قناعًا جديدًا باستخدام أداة العصا السحرية بناءً على درجة اللون ولون البكسل (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);
}

union(ImageMask mask)

public final ImageBitMask union(ImageMask mask)

يحصل على اتحاد القناع الحالي مع القناع المقدم.

Parameters:

معامل	نوع	الوصف
mask	ImageMask	القناع المقدم

Returns: ImageBitMask - New ImageBitMask.

union()

public final ImageBitMask union()

يحصل على اتحاد القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.

Returns: ImageBitMask - New ImageBitMask.

union(MagicWandSettings settings)

public final ImageBitMask union(MagicWandSettings settings)

يحصل على اتحاد القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.

Parameters:

معامل	نوع	الوصف
settings	MagicWandSettings	إعدادات العصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

union(RasterImage image)

public final ImageBitMask union(RasterImage image)

يحصل على اتحاد القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.

Parameters:

معامل	نوع	الوصف
image	RasterImage	الصورة للعصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

union(RasterImage image, MagicWandSettings settings)

public final ImageBitMask union(RasterImage image, MagicWandSettings settings)

يحصل على اتحاد القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.

Parameters:

معامل	نوع	الوصف
image	RasterImage	الصورة للعصا السحرية.
settings	MagicWandSettings	إعدادات العصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

subtract(ImageMask mask)

public final ImageBitMask subtract(ImageMask mask)

يحصل على طرح القناع المقدم من القناع الحالي.

Parameters:

معامل	نوع	الوصف
mask	ImageMask	القناع المقدم

Returns: ImageBitMask - New ImageBitMask.

subtract()

public final ImageBitMask subtract()

يحصل على نتيجة اختيار العصا السحرية المطبقة على مصدر القناع الحالي مطروحًا من القناع.

Returns: ImageBitMask - New ImageBitMask.

subtract(MagicWandSettings settings)

public final ImageBitMask subtract(MagicWandSettings settings)

يحصل على نتيجة اختيار العصا السحرية المطبقة على مصدر القناع الحالي مطروحًا من القناع.

Parameters:

معامل	نوع	الوصف
settings	MagicWandSettings	إعدادات العصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

subtract(RasterImage image)

public final ImageBitMask subtract(RasterImage image)

يحصل على نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة مطروحًا من القناع الحالي.

Parameters:

معامل	نوع	الوصف
image	RasterImage	الصورة للعصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

subtract(RasterImage image, MagicWandSettings settings)

public final ImageBitMask subtract(RasterImage image, MagicWandSettings settings)

يحصل على نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة مطروحًا من القناع الحالي.

Parameters:

معامل	نوع	الوصف
image	RasterImage	الصورة للعصا السحرية.
settings	MagicWandSettings	إعدادات العصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

intersect(ImageMask mask)

public final ImageBitMask intersect(ImageMask mask)

يحصل على تقاطع القناع الحالي مع القناع المقدم.

Parameters:

معامل	نوع	الوصف
mask	ImageMask	القناع المقدم

Returns: ImageBitMask - New ImageBitMask.

intersect()

public final ImageBitMask intersect()

يحصل على تقاطع القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.

Returns: ImageBitMask - New ImageBitMask.

intersect(MagicWandSettings settings)

public final ImageBitMask intersect(MagicWandSettings settings)

يحصل على تقاطع القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.

Parameters:

معامل	نوع	الوصف
settings	MagicWandSettings	إعدادات العصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

intersect(RasterImage image)

public final ImageBitMask intersect(RasterImage image)

يحصل على تقاطع القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.

Parameters:

معامل	نوع	الوصف
image	RasterImage	الصورة للعصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

intersect(RasterImage image, MagicWandSettings settings)

public final ImageBitMask intersect(RasterImage image, MagicWandSettings settings)

يحصل على تقاطع القناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.

Parameters:

معامل	نوع	الوصف
image	RasterImage	الصورة للعصا السحرية.
settings	MagicWandSettings	إعدادات العصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(ImageMask mask)

public final ImageBitMask exclusiveDisjunction(ImageMask mask)

يحصل على التفريق الحصري للقناع الحالي مع القناع المقدم.

Parameters:

معامل	نوع	الوصف
mask	ImageMask	القناع المقدم

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction()

public final ImageBitMask exclusiveDisjunction()

يحصل على التفريق الحصري للقناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(MagicWandSettings settings)

public final ImageBitMask exclusiveDisjunction(MagicWandSettings settings)

يحصل على التفريق الحصري للقناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على مصدر القناع.

Parameters:

معامل	نوع	الوصف
settings	MagicWandSettings	إعدادات العصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(RasterImage image)

public final ImageBitMask exclusiveDisjunction(RasterImage image)

يحصل على التفريق الحصري للقناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.

Parameters:

معامل	نوع	الوصف
image	RasterImage	الصورة للعصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

exclusiveDisjunction(RasterImage image, MagicWandSettings settings)

public final ImageBitMask exclusiveDisjunction(RasterImage image, MagicWandSettings settings)

يحصل على التفريق الحصري للقناع الحالي مع نتيجة اختيار العصا السحرية المطبقة على الصورة المقدمة.

Parameters:

معامل	نوع	الوصف
image	RasterImage	الصورة للعصا السحرية.
settings	MagicWandSettings	إعدادات العصا السحرية.

Returns: ImageBitMask - New ImageBitMask.

ImageGrayscaleMask RectangleMask