AddMaskToRegion Method

Summary

Creates or updates the image region by adding a region that consists of all the white pixels in a 1-bit mask image.

Syntax

Objective-C

C++/CLI

Java

Python

public void AddMaskToRegion( 
   RasterRegionXForm xform, 
   RasterImage maskImage, 
   RasterRegionCombineMode combineMode 
)

- (BOOL)addMaskToRegion:(nullable LTRasterRegionXForm *)xform  
              maskImage:(LTRasterImage *)mask  
            combineMode:(LTRasterRegionCombineMode)combineMode  
                  error:(NSError **)error

public void addMaskToRegion( 
  RasterRegionXForm xform,  
  RasterImage maskImage,  
  RasterRegionCombineMode combineMode 
)

public: 
void AddMaskToRegion(  
   RasterRegionXForm^ xform, 
   RasterImage^ maskImage, 
   RasterRegionCombineMode combineMode 
)

def AddMaskToRegion(self,xform,maskImage,combineMode):

Parameters

xform
RasterRegionXForm object that LEADTOOLS uses to translate between display coordinates and image coordinates.

maskImage
The 1-bit black-and-white RasterImage used as a mask.

combineMode
The action to take regarding the existing image region, if one is defined.

Remarks

To update an existing region, you specify how the new region is to be combined with the existing one using the combineMode parameter. For more information, refer to RasterRegionCombineMode.

For more information, refer to Creating a Region.

For more information, refer to Saving A Region.

For more information, refer to Working with the Existing Region.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Core; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Dicom; 
using Leadtools.Drawing; 
using Leadtools.Controls; 
using Leadtools.Svg; 
 
 
public void CreateMaskFromRegionExample() 
{ 
	RasterCodecs codecs = new RasterCodecs(); 
 
	string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
	string destFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1_CreateMaskFromRegion.bmp"); 
 
	// Load the image 
	RasterImage image = codecs.Load(srcFileName); 
 
	// Posterize the image to decrease the number of colors 
	PosterizeCommand posterize = new PosterizeCommand(16); 
	posterize.Run(image); 
 
	// Specify a pixel in the upper left of the displayed image 
	LeadPoint pt = new LeadPoint(image.ImageWidth / 8, image.ImageHeight / 8); 
 
	// Adjust the point in case the view perspective is not TopLeft 
	pt = image.PointToImage(RasterViewPerspective.TopLeft, pt); 
 
	// Get the color of the specified pixel 
	RasterColor regionColor = image.GetPixelColor(pt.Y, pt.X); 
 
	// Create a region that includes all pixels of that color 
	image.AddColorToRegion(regionColor, RasterRegionCombineMode.Set); 
 
	RasterImage maskImage = image.CreateMaskFromRegion(); 
 
	codecs.Save(maskImage, destFileName, RasterImageFormat.Bmp, 1); 
 
	maskImage.Dispose(); 
	image.Dispose(); 
	codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms

Reference

RasterImage Class

RasterImage Members

Download our FREE evaluation

Help Version 22.0.2023.5.16

Leadtools Assembly

Introduction

Getting Started

Namespaces

Leadtools Namespace

Leadtools.ImageProcessing Namespace

Assemblies