ImageGrayscaleMask

Inheritance: java.lang.Object

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

public class ImageGrayscaleMask implements IImageMask

يصف قناع صورة بتدرج الرمادي.

المنشئات

المنشئ	الوصف
ImageGrayscaleMask(int width, int height)	ينشئ مثيلاً جديداً من الفئة ImageGrayscaleMask مع العرض والارتفاع المحددين.
ImageGrayscaleMask(RasterImage image)	ينشئ مثيلاً جديداً من الفئة ImageGrayscaleMask بحجم الصورة النقطية RasterImage الموجودة المحددة.

الطرق

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

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

ImageGrayscaleMask(int width, int height)

public ImageGrayscaleMask(int width, int height)

ينشئ مثيلاً جديداً من الفئة ImageGrayscaleMask مع العرض والارتفاع المحددين.

Parameters:

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

ImageGrayscaleMask(RasterImage image)

public ImageGrayscaleMask(RasterImage image)

يُنشئ مثيلًا جديدًا من الفئة ImageGrayscaleMask بالحجم المحدد لصورة RasterImage الموجودة. سيتم تخزين صورة RasterImage المحددة كصورة المصدر.

Parameters:

معامل	نوع	الوصف
image	RasterImage	صورة المصدر.

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.

getSelectionBounds()

public final Rectangle getSelectionBounds()

يحصل على حدود الجزء المحدد من القناع، بوحدات البكسل.

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)

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

Parameters:

معامل	نوع	الوصف
x	int	الإحداثي السيني للبكسل.
y	int	الإحداثي ص للبيكسل. القيمة: قيمة بايت؛ 0 إذا كان شفافًا؛ 255 إذا كان غير شفاف.

Returns: byte

set_Item(int x, int y, byte value)

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

يضبط شفافية البكسل المحدد.

Parameters:

معامل	نوع	الوصف
x	int	الإحداثي السيني للبكسل.
y	int	الإحداثي ص للبيكسل. القيمة: قيمة بايت؛ 0 إذا كان شفافًا؛ 255 إذا كان غير شفاف.
value	byte	الشفافية للبيكسل المحدد.

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 - قيمة بايت، تمثل شفافية البكسل المحدد.

deepClone()

public final Object deepClone()

ينشئ كائنًا جديدًا يكون نسخة من المثيل الحالي.

Returns: java.lang.Object - كائن جديد يكون نسخة من هذا المثيل.

apply()

public final void apply()

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

applyTo(RasterImage image)

public final void applyTo(RasterImage image)

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

Parameters:

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

crop(Size size)

public final ImageGrayscaleMask crop(Size size)

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

Parameters:

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

Returns: ImageGrayscaleMask - A cropped ImageGrayscaleMask.

crop(int width, int height)

public final ImageGrayscaleMask crop(int width, int height)

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

Parameters:

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

Returns: ImageGrayscaleMask - A cropped ImageGrayscaleMask.

crop(Rectangle rectangle)

public final ImageGrayscaleMask crop(Rectangle rectangle)

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

Parameters:

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

Returns: ImageGrayscaleMask - A cropped ImageGrayscaleMask.

invert()

public final ImageGrayscaleMask invert()

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

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

union(ImageGrayscaleMask mask)

public final ImageGrayscaleMask union(ImageGrayscaleMask mask)

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

Parameters:

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

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

subtract(ImageGrayscaleMask mask)

public final ImageGrayscaleMask subtract(ImageGrayscaleMask mask)

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

Parameters:

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

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

intersect(ImageGrayscaleMask mask)

public final ImageGrayscaleMask intersect(ImageGrayscaleMask mask)

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

Parameters:

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

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

exclusiveDisjunction(ImageGrayscaleMask mask)

public final ImageGrayscaleMask exclusiveDisjunction(ImageGrayscaleMask mask)

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

Parameters:

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

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

op_LogicalNot(ImageGrayscaleMask a)

public static ImageGrayscaleMask op_LogicalNot(ImageGrayscaleMask a)

يعكس القناع.

Parameters:

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

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

op_Addition(ImageGrayscaleMask a, ImageGrayscaleMask b)

public static ImageGrayscaleMask op_Addition(ImageGrayscaleMask a, ImageGrayscaleMask b)

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

Parameters:

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

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

op_Subtraction(ImageGrayscaleMask a, ImageGrayscaleMask b)

public static ImageGrayscaleMask op_Subtraction(ImageGrayscaleMask a, ImageGrayscaleMask b)

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

Parameters:

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

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

op_Multiply(ImageGrayscaleMask a, ImageGrayscaleMask b)

public static ImageGrayscaleMask op_Multiply(ImageGrayscaleMask a, ImageGrayscaleMask b)

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

Parameters:

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

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.

op_ExclusiveOr(ImageGrayscaleMask a, ImageGrayscaleMask b)

public static ImageGrayscaleMask op_ExclusiveOr(ImageGrayscaleMask a, ImageGrayscaleMask b)

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

Parameters:

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

Returns: ImageGrayscaleMask - New ImageGrayscaleMask.