Leadtools Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
RegionContains Method
See Also  Example
Leadtools Namespace > RasterImage Class : RegionContains Method



row
The row number of the pixel.
col
The column number of the pixel.
Determines whether the specified pixel is in the image region.

Syntax

Visual Basic (Declaration)  
Public Function RegionContains( _
   ByVal row As Integer, _
   ByVal col As Integer _
) As Boolean
Visual Basic (Usage) Copy Code
Dim instance As RasterImage
Dim row As Integer
Dim col As Integer
Dim value As Boolean
 
value = instance.RegionContains(row, col)
C#  
public bool RegionContains( 
   int row,
   int col
)
C++/CLI  
public:
bool RegionContains( 
   int row,
   int col
)

Parameters

row
The row number of the pixel.
col
The column number of the pixel.

Return Value

true if the specified pixel is in the region, otherwise; false.

Example

Visual Basic Copy Code
Public Sub RegionContainsExample()
   RasterCodecs.Startup()
   Dim codecs As RasterCodecs = New RasterCodecs()

   Dim srcFileName As String = LeadtoolsExamples.Common.ImagesPath.Path + "Image1.cmp"
   Dim destFileName As String = LeadtoolsExamples.Common.ImagesPath.Path + "Image1_RegionContains.bmp"

   ' Load the image
   Dim image As RasterImage = codecs.Load(srcFileName)

   ' Add an ellipse inside a rectangle region to the image

   Dim rc As Rectangle = New Rectangle(image.Width \ 3, image.Height \ 3, image.Width \ 3, image.Height \ 3)
   image.AddEllipseToRegion(Nothing, rc, RasterRegionCombineMode.Set)

   ' Loop through the image and turn all pixels in the region to double intensity
   Dim y As Integer = 0
   Do While y < image.Height
      Dim x As Integer = 0
      Do While x < image.Width
         If image.RegionContains(y, x) Then
            Dim clr As RasterColor = image.GetPixelColor(y, x)
            clr = New RasterColor(clr.R * 2, clr.G * 2, clr.B * 2)
            image.SetPixelColor(y, x, clr)
         End If
         x += 1
      Loop
      y += 1
   Loop

   codecs.Save(image, destFileName, RasterImageFormat.Bmp, 24)

   image.Dispose()
   codecs.Dispose()
   RasterCodecs.Shutdown()
End Sub
C# Copy Code
public void RegionContainsExample() 
{ 
   RasterCodecs.Startup(); 
   RasterCodecs codecs = new RasterCodecs(); 
 
   string srcFileName = LeadtoolsExamples.Common.ImagesPath.Path + "Image1.cmp"; 
   string destFileName = LeadtoolsExamples.Common.ImagesPath.Path + "Image1_RegionContains.bmp"; 
 
   // Load the image 
   RasterImage image = codecs.Load(srcFileName); 
 
   // Add an ellipse inside a rectangle region to the image 
 
   Rectangle rc = new Rectangle(image.Width / 3, image.Height / 3, image.Width / 3, image.Height / 3); 
   image.AddEllipseToRegion(null, rc, RasterRegionCombineMode.Set); 
 
   // Loop through the image and turn all pixels in the region to double intensity 
   for(int y = 0; y < image.Height; y++) 
   { 
      for(int x = 0; x < image.Width; x++) 
      { 
         if(image.RegionContains(y, x)) 
         { 
            RasterColor clr = image.GetPixelColor(y, x); 
            clr = new RasterColor(clr.R * 2, clr.G * 2, clr.B * 2); 
            image.SetPixelColor(y, x, clr); 
         } 
      } 
   } 
 
   codecs.Save(image, destFileName, RasterImageFormat.Bmp, 24); 
 
   image.Dispose(); 
   codecs.Dispose(); 
   RasterCodecs.Shutdown(); 
}

Remarks

This method uses image coordinates to specify the pixel. Therefore, you must account for the view perspective of the image.

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

Requirements

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

See Also