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))
{
    // Создайте новую маску с помощью инструмента magic wand, основанную на тоне и цвете пикселя (845, 128).
    MagicWandTool.select(image, new MagicWandSettings(845, 128))
            // Объедините существующую маску с указанной, созданной инструментом magic wand.
            .union(new MagicWandSettings(416, 387))
            // Инвертируйте существующую маску
            .invert()
            // Вычтите указанную маску, созданную инструментом magic wand с заданным порогом, из существующей.
            .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	Координата x пикселя.
y	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:

Параметр	Тип	Описание
x	int	Координата x пикселя.
y	int	Координата Y пикселя. Значение: байтовое значение; 0 — прозрачный; 255 — непрозрачный.
value	byte	непрозрачность указанного пикселя.

isOpaque(int x, int y)

public final boolean isOpaque(int x, int y)

Проверяет, является ли указанный пиксель непрозрачным.

Parameters:

Параметр	Тип	Описание
x	int	Координата x пикселя.
y	int	Координата y пикселя.

Returns: boolean — true, если указанный пиксель непрозрачный; иначе false.

isTransparent(int x, int y)

public final boolean isTransparent(int x, int y)

Проверяет, является ли указанный пиксель прозрачным.

Parameters:

Параметр	Тип	Описание
x	int	Координата x пикселя.
y	int	Координата y пикселя.

Returns: boolean — true, если указанный пиксель прозрачный; иначе false.

getByteOpacity(int x, int y)

public final byte getByteOpacity(int x, int y)

Получает непрозрачность указанного пикселя с точностью до байта.

Parameters:

Параметр	Тип	Описание
x	int	Координата x пикселя.
y	int	Координата y пикселя.

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.