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:

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

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

Returns: byte

set_Item(int x, int y, byte value)

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

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

Parameters:

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

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

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:

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