ImageMask.Union

Union(ImageMask)

Gets the union of the current mask with provided.

public ImageBitMask Union(ImageMask mask)
ParameterTypeDescription
maskImageMaskProvided mask

Return Value

New ImageBitMask.

Examples

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, substract).

[C#]

var imageFilePath = "input.png"; 
using (RasterImage image = (RasterImage)Image.Load(inputFilePath))
{
    // Create a new mask using magic wand tool based on tone and color of pixel (845, 128)
    MagicWandTool.Select(image, new MagicWandSettings(845, 128))
        // Union the existing mask with the specified one created by magic wand tool
        .Union(new MagicWandSettings(416, 387))
        // Invert the existing mask
        .Invert()
        // Subtract the specified mask created by magic wand tool with specified threshold from the existing one 
        .Subtract(new MagicWandSettings(1482, 346) { Threshold = 69 })
        // Subtract four specified rectangle masks from the existing mask one by one
        .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))
        // Feather mask with specified settings
        .GetFeathered(new FeatheringSettings() { Size = 3 })
        // Apply mask to the image
        .Apply();
        
    // Save image
    image.Save(outputFilePath);
}

See Also


Union(MagicWandSettings)

Gets the union of the current mask with the result of magic wand selection applied to the source of the mask.

public ImageBitMask Union(MagicWandSettings settings)
ParameterTypeDescription
settingsMagicWandSettingsMagic wand settings.

Return Value

New ImageBitMask.

Exceptions

exceptioncondition
ArgumentNullExceptionThrown when the source image is not defined in mask.

See Also


Union(RasterImage, MagicWandSettings)

Gets the union of the current mask with the result of magic wand selection applied to the provided image.

public ImageBitMask Union(RasterImage image, MagicWandSettings settings)
ParameterTypeDescription
imageRasterImageImage for magic wand.
settingsMagicWandSettingsMagic wand settings.

Return Value

New ImageBitMask.

See Also