Combine(LeadRect,RasterRegionCombineMode) Method

Summary

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

Syntax

Objective-C

C++/CLI

Java

Python

public void Combine( 
   LeadRect rect, 
   RasterRegionCombineMode combineMode 
)

- (BOOL)combineWithRect:(LeadRect)rect 
            combineMode:(LTRasterRegionCombineMode)combineMode 
                  error:(NSError **)error

public void combine( 
   LeadRect rect, 
   RasterRegionCombineMode combineMode 
);

public: 
void Combine(  
   LeadRect rect, 
   RasterRegionCombineMode combineMode 
)

def Combine(self,combineMode):

Parameters

rect
The LeadRect structure 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 RasterRegionCombineRectExample() 
{ 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
   string destFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1_CombineRect.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 region = image.GetRegion(null); 
         image.MakeRegionEmpty(); 
 
         // Create a rectangle that fits in this region area 
         LeadRect rc = new LeadRect(0, 0, image.ImageWidth / 4, image.ImageHeight / 4); 
 
         // Combine the region to contain only the difference between the it and the rectangle 
         region.Combine(rc, RasterRegionCombineMode.Xor); 
 
         // Set this region to the image and fill it with yellow 
         image.SetRegion(null, region, RasterRegionCombineMode.Set); 
 
         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