Combine(RasterRegion,RasterRegionCombineMode) Method

Summary

Updates this RasterRegion to a combination of itself and the specified RasterRegion

Syntax

Objective-C

C++/CLI

Java

Python

public void Combine( 
   RasterRegion region, 
   RasterRegionCombineMode combineMode 
)

- (BOOL)combineWithRegion:(LTRasterRegion *)region 
              combineMode:(LTRasterRegionCombineMode)combineMode 
                    error:(NSError **)error

public void combine( 
   RasterRegion region, 
   RasterRegionCombineMode combineMode 
);

public: 
void Combine(  
   RasterRegion^ region, 
   RasterRegionCombineMode combineMode 
)

def Combine(self,combineMode):

Parameters

region
The RasterRegion to combine with this RasterRegion.

combineMode
One of the RasterRegionCombineMode enumeration members that describes the combine method to use. This cannot be RasterRegionCombineMode.AndNotImage or RasterRegionCombineMode.AndNotRegion. Using any of these combine method will result in an exception.

Remarks

For more information, refer to RasterRegionCombineMode.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
 
 
public void RasterRegionCombineRegionExample() 
{ 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
   string destFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1_CombineRegion.bmp"); 
 
   using (RasterCodecs codecs = new RasterCodecs()) 
   { 
      // Load the source image 
      using (RasterImage image = codecs.Load(srcFileName, 0, CodecsLoadByteOrder.BgrOrGray, 1, 1)) 
      { 
         // Add a small elliptical region 
         image.AddEllipseToRegion(null, new LeadRect(0, 0, image.ImageWidth / 3, image.ImageHeight / 3), RasterRegionCombineMode.Set); 
 
         // Get this region 
         RasterRegion region1 = image.GetRegion(null); 
         image.MakeRegionEmpty(); 
 
         // Add a smaller elliptical region 
         image.AddEllipseToRegion(null, new LeadRect(0, 0, image.ImageWidth / 4, image.ImageHeight / 4), RasterRegionCombineMode.Set); 
 
         // Get this region 
         RasterRegion region2 = image.GetRegion(null); 
         image.MakeRegionEmpty(); 
 
         // Combine both regions to contain only the difference between the two 
         region1.Combine(region2, RasterRegionCombineMode.Xor); 
         region2.Dispose(); 
 
         // Set this region to the image and fill it with yellow 
         image.SetRegion(null, region1, RasterRegionCombineMode.Set); 
         region1.Dispose(); 
 
         FillCommand cmd = new FillCommand(RasterColor.FromKnownColor(RasterKnownColor.Yellow)); 
         cmd.Run(image); 
 
         codecs.Save(image, destFileName, RasterImageFormat.Bmp, 24); 
      } 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms

Reference

RasterRegion Class

RasterRegion Members

Overload List

Download our FREE evaluation

Help Version 22.0.2023.5.16

Leadtools Assembly

Introduction

Getting Started

Namespaces

Leadtools Namespace

Leadtools.ImageProcessing Namespace

Assemblies