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:

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

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

inflate(int size)

public abstract ImageMask inflate(int size)

يوسع هذا القناع بالمقدار المحدد.

Parameters:

معامل	نوع	الوصف
الحجم	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:

معامل	نوع	الوصف
العرض	int	العرض المحدد.
الارتفاع	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:

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

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

isTransparent(int x, int y)

public final boolean isTransparent(int x, int y)

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

Parameters:

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

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

getByteOpacity(int x, int y)

public final byte getByteOpacity(int x, int y)

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

Parameters:

معامل	نوع	الوصف
س	int	الإحداثي السيني للبكسل.
ص	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