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))
{
    // Создайте новую маску с помощью инструмента 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);
}

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	Координата x пикселя.
y	int	Координата y пикселя.

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	Координата 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 — значение байта, представляющее непрозрачность указанного пикселя.

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))
{
    // Создайте новую маску с помощью инструмента magic wand, основанную на тоне и цвете пикселя (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))
{
    // Создайте новую маску с помощью инструмента 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);
}

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