←Select platform

AddGeometryToRegion Method

Summary

Creates or updates a LEADTOOLS image region by adding the specified WPF geometry.

Syntax
C#
VB
C++
public static void AddGeometryToRegion( 
   RasterImage image, 
   RasterRegionXForm xform, 
   Geometry geometry, 
   RasterRegionCombineMode combineMode 
) 
  
Public Shared Sub AddGeometryToRegion( _ 
   ByVal image As RasterImage, _ 
   ByVal xform As RasterRegionXForm, _ 
   ByVal geometry As Geometry, _ 
   ByVal combineMode As RasterRegionCombineMode _ 
)  
public: 
static void AddGeometryToRegion(  
   RasterImage^ image, 
   RasterRegionXForm^ xform, 
   Geometry^ geometry, 
   RasterRegionCombineMode combineMode 
)  

Parameters

image
The source image.

xform
Leadtools.RasterRegionXForm object that LEADTOOLS uses to translate between display coordinates and image coordinates. If you specify null (Nothing in VB) in this parameter, the scalar fields default to 1, the offsets default to 0, and the view perspective defaults to the image view perspective.

geometry
The WPF geometry to add.

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 Leadtools.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.

For more information refer to RasterImage and WPF.

Example
C#
VB
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.Windows.Media; 
 
public void AddGeometryToRegionExample() 
{ 
   // Load an image  
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
   string dstFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1_AddGeometryToRegion.jpg"); 
 
   RasterCodecs codecs = new RasterCodecs(); 
 
   RasterImage image = codecs.Load(srcFileName); 
 
   // We will add an ellipse region to the image 
 
   // Using WPF, create an elliptical geometry 
   // Create the ellipse geometry to add to the Path 
   EllipseGeometry ellipseGeometry = new EllipseGeometry(); 
   ellipseGeometry.Center = new Point(250, 250); 
   ellipseGeometry.RadiusX = 200; 
   ellipseGeometry.RadiusY = 150; 
 
   Geometry geometry = ellipseGeometry; 
 
   // Add this geometry to the image 
   RasterRegionConverter.AddGeometryToRegion(image, null, geometry, RasterRegionCombineMode.Set); 
 
   // Fill the image with a color 
   FillCommand cmd = new FillCommand(RasterColor.FromKnownColor(RasterKnownColor.Red)); 
   cmd.Run(image); 
 
   // Save it 
   codecs.Save(image, dstFileName, RasterImageFormat.Jpeg, 24); 
 
   image.Dispose(); 
 
   codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing 
Imports Leadtools.Windows.Media 
 
Public Sub AddGeometryToRegionExample() 
   ' Load an image  
   Dim srcFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp") 
   Dim dstFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1_AddGeometryToRegion.jpg") 
 
   Dim codecs As New RasterCodecs() 
 
   Dim image As RasterImage = codecs.Load(srcFileName) 
 
   ' We will add an ellipse region to the image 
 
   ' Using WPF, create an elliptical geometry 
   ' Create the ellipse geometry to add to the Path 
   Dim ellipseGeometry As New EllipseGeometry() 
   ellipseGeometry.Center = New Point(250, 250) 
   ellipseGeometry.RadiusX = 200 
   ellipseGeometry.RadiusY = 150 
 
   Dim geometry As Geometry = ellipseGeometry 
 
   ' Add this geometry to the image 
   RasterRegionConverter.AddGeometryToRegion(image, Nothing, geometry, RasterRegionCombineMode.Set) 
 
   ' Fill the image with a color 
   Dim cmd As New FillCommand(RasterColor.FromKnownColor(RasterKnownColor.Red)) 
   cmd.Run(image) 
 
   ' Save it 
   codecs.Save(image, dstFileName, RasterImageFormat.Jpeg, 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 

Requirements

Target Platforms

Help Version 20.0.2020.3.31
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.