←Select platform

HasRegion Property

Summary

Determines whether this RasterImage has a region.

Syntax

Java

Objective-C

WinRT C#

C++

public bool HasRegion { get; }

Public ReadOnly Property HasRegion As Boolean

public bool HasRegion {get;}

@property (nonatomic, assign, readonly) BOOL hasRegion

public boolean hasRegion()

 get_HasRegion();

public: 
property bool HasRegion { 
   bool get(); 
}

Property Value

true if this RasterImage has a region; false, otherwise.

Remarks

When an image has a region, the LEADTOOLS methods that modify the pixel values (for example PosterizeCommand) act on the region, rather than the whole image. In addition, the LEADTOOLS methods that flip, reverse, rotate, shear, or resize an image also transform the region to match the image. For example, if you were to shear the image that had a rectangular region, the region would become a parallelogram.

To remove an image region, use MakeRegionEmpty.

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

Example

Silverlight C#

Silverlight VB

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 LeadtoolsExamples.Common; 
using Leadtools.Svg; 
 
public void RegionExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   string srcFileName = Path.Combine(ImagesPath.Path, "Image1.cmp"); 
   string destFileName1 = Path.Combine(ImagesPath.Path, "Image1_InvertRegion.bmp"); 
   string destFileName2 = Path.Combine(ImagesPath.Path, "Image1_InvertNoRegion.bmp"); 
 
   // Load the image 
   RasterImage image = codecs.Load(srcFileName); 
 
   // The image should have no region 
   Console.WriteLine("After loading, HasRegion = {0}", image.HasRegion); 
   Assert.IsTrue(!image.HasRegion); 
 
   // Add a region to the image 
   LeadRect rc = new LeadRect(0, 0, image.Width / 4, image.Height / 4); 
   image.AddEllipseToRegion(null, rc, RasterRegionCombineMode.Set); 
 
   // The image should have a region now 
   Console.WriteLine("After AddEllipseToRegion, HasRegion = {0}", image.HasRegion); 
   Assert.IsTrue(image.HasRegion); 
 
   // Invert this image and save it to a file 
   InvertCommand command = new InvertCommand(); 
   command.Run(image); 
   codecs.Save(image, destFileName1, RasterImageFormat.Bmp, 24); 
 
   // Get rid of the region 
   image.MakeRegionEmpty(); 
 
   // The image should not have a region now 
   Console.WriteLine("After MakeRegionEmpty, HasRegion = {0}", image.HasRegion); 
   Assert.IsTrue(!image.HasRegion); 
 
   // Invert again and save it 
   command.Run(image); 
   codecs.Save(image, destFileName2, RasterImageFormat.Bmp, 24); 
 
   image.Dispose(); 
   codecs.Dispose(); 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing 
Imports Leadtools.ImageProcessing.Core 
Imports Leadtools.ImageProcessing.Color 
Imports Leadtools.Controls 
Imports Leadtools.Dicom 
Imports Leadtools.Drawing 
Imports Leadtools.Svg 
 
Public Sub RegionExample() 
   Dim codecs As RasterCodecs = New RasterCodecs() 
 
   Dim srcFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp") 
   Dim destFileName1 As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1_InvertRegion.bmp") 
   Dim destFileName2 As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1_InvertNoRegion.bmp") 
 
   ' Load the image 
   Dim image As RasterImage = codecs.Load(srcFileName) 
 
   ' The image should have no region 
   Console.WriteLine("After loading, HasRegion = {0}", image.HasRegion) 
   Debug.Assert((Not image.HasRegion)) 
 
   ' Add a region to the image 
   Dim rc As LeadRect = New LeadRect(0, 0, image.Width \ 4, image.Height \ 4) 
   image.AddEllipseToRegion(Nothing, rc, RasterRegionCombineMode.Set) 
 
   ' The image should have a region now 
   Console.WriteLine("After AddEllipseToRegion, HasRegion = {0}", image.HasRegion) 
   Debug.Assert(image.HasRegion) 
 
   ' Invert this image and save it to a file 
   Dim command As InvertCommand = New InvertCommand() 
   command.Run(image) 
   codecs.Save(image, destFileName1, RasterImageFormat.Bmp, 24) 
 
   ' Get rid of the region 
   image.MakeRegionEmpty() 
 
   ' The image should not have a region now 
   Console.WriteLine("After MakeRegionEmpty, HasRegion = {0}", image.HasRegion) 
   Debug.Assert((Not image.HasRegion)) 
 
   ' Invert again and save it 
   command.Run(image) 
   codecs.Save(image, destFileName2, RasterImageFormat.Bmp, 24) 
 
   image.Dispose() 
   codecs.Dispose() 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Dicom; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Core; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Examples; 
using Leadtools.Windows.Media; 
 
public void RegionExample(RasterImage image, Stream destStream1, Stream destStream2) 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   // The image should have no region 
   Debug.WriteLine("After loading, HasRegion = {0}", image.HasRegion); 
   Debug.Assert(!image.HasRegion); 
 
   // Add a region to the image 
   LeadRect rc = new LeadRect(0, 0, image.Width / 4, image.Height / 4); 
   image.AddRectangleToRegion(null, rc, RasterRegionCombineMode.Set); 
 
   // The image should have a region now 
   Debug.WriteLine("After AddRectangleToRegion, HasRegion = {0}", image.HasRegion); 
   Debug.Assert(image.HasRegion); 
 
   // Invert this image and save it to a file 
   InvertCommand command = new InvertCommand(); 
   command.Run(image); 
   codecs.Save(image, destStream1, RasterImageFormat.Bmp, 0); 
 
   // Get rid of the region 
   image.MakeRegionEmpty(); 
 
   // The image should not have a region now 
   Debug.WriteLine("After MakeRegionEmpty, HasRegion = {0}", image.HasRegion); 
   Debug.Assert(!image.HasRegion); 
 
   // Invert again and save it 
   command.Run(image); 
   codecs.Save(image, destStream2, RasterImageFormat.Bmp, 0); 
 
   image.Dispose(); 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.Dicom 
Imports Leadtools.ImageProcessing 
Imports Leadtools.ImageProcessing.Core 
Imports Leadtools.ImageProcessing.Color 
Imports Leadtools.Windows.Media 
 
Public Sub RegionExample(ByVal image As RasterImage, ByVal destStream1 As Stream, ByVal destStream2 As Stream) 
   Dim codecs As RasterCodecs = New RasterCodecs() 
 
   ' The image should have no region 
   Debug.WriteLine("After loading, HasRegion = {0}", image.HasRegion) 
   Debug.Assert((Not image.HasRegion)) 
 
   ' Add a region to the image 
   Dim rc As LeadRect = New LeadRect(0, 0, image.Width / 4, image.Height / 4) 
   image.AddRectangleToRegion(Nothing, rc, RasterRegionCombineMode.Set) 
 
   ' The image should have a region now 
   Debug.WriteLine("After AddRectangleToRegion, HasRegion = {0}", image.HasRegion) 
   Debug.Assert(image.HasRegion) 
 
   ' Invert this image and save it to a file 
   Dim command As InvertCommand = New InvertCommand() 
   command.Run(image) 
   codecs.Save(image, destStream1, RasterImageFormat.Bmp, 0) 
 
   ' Get rid of the region 
   image.MakeRegionEmpty() 
 
   ' The image should not have a region now 
   Debug.WriteLine("After MakeRegionEmpty, HasRegion = {0}", image.HasRegion) 
   Debug.Assert((Not image.HasRegion)) 
 
   ' Invert again and save it 
   command.Run(image) 
   codecs.Save(image, destStream2, RasterImageFormat.Bmp, 0) 
 
   image.Dispose() 
End Sub

Requirements

Target Platforms

Reference

RasterImage Class

RasterImage Members

Help Version 19.0.2017.10.27