Creates or updates a LEADTOOLS image region using the specified GDI+ region data.
public static void AddGdiPlusDataToRegion(
RasterImage image,
RasterRegionXForm xform,
RegionData data,
RasterRegionCombineMode combineMode
)
Public Shared Sub AddGdiPlusDataToRegion( _
ByVal image As RasterImage, _
ByVal xform As RasterRegionXForm, _
ByVal data As RegionData, _
ByVal combineMode As RasterRegionCombineMode _
)
public:
static void AddGdiPlusDataToRegion(
RasterImage^ image,
RasterRegionXForm^ xform,
RegionData^ data,
RasterRegionCombineMode combineMode
)
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) for this parameter, the scalar fields default to 1, the offsets default to 0, and the view perspective defaults to the image view perspective.
data
A System.Drawing.Drawing2D.RegionData object that defines the region to add.
combineMode
The action to take regarding the existing image region, if one is defined.
To update an existing region, specify how the new region is to be combined with the existing one using the combineMode parameter. For more information, refer to Leadtools.RasterRegionCombineMode.
This method can be used to copy the region data from one RasterImage to another, using the GetGdiPlusRegionData method.
To get the region data as Windows API HRGN data, use GetGdiRegionData and AddGdiDataToRegion.
To get the region data as platform independent byte array, use RasterRegion.GetData and RasterRegion.SetData.
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 GDI/GDI+.
This example will use AddGdiPlusDataToRegion and GetGdiPlusRegionData to add an elliptical region to a Leadtools.RasterImage, gets the region as a GDI+ RegionData object then re-sets it in another image.
using Leadtools;
using Leadtools.Codecs;
using Leadtools.Drawing;
using Leadtools.ImageProcessing;
using Leadtools.ImageProcessing.Color;
public void GdiPlusRegionDataExample()
{
RasterCodecs codecs = new RasterCodecs();
string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp");
string destFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1_GdiPlusData.bmp");
RegionData gdipRegionData = null;
// Load the source image
using (RasterImage image = codecs.Load(srcFileName))
{
// Add a polygon region to it
// Add a polygon region to the image
int x1 = image.ImageWidth / 4;
int y1 = image.ImageHeight / 4;
int x2 = image.ImageWidth / 3;
int y2 = image.ImageHeight / 3;
LeadPoint[] pts =
{
new LeadPoint(x1, y1),
new LeadPoint(x2, y1),
new LeadPoint(x1, y2),
new LeadPoint(x2, y2)
};
image.AddPolygonToRegion(null, pts, LeadFillMode.Winding, RasterRegionCombineMode.Set);
// Save the region as a GDI+ RegionData object
gdipRegionData = RasterRegionConverter.GetGdiPlusRegionData(image, null);
}
// Re-load the source image
using (RasterImage image = codecs.Load(srcFileName))
{
// Add the GDI+ region data we saved to it
RasterRegionConverter.AddGdiPlusDataToRegion(image, null, gdipRegionData, RasterRegionCombineMode.Set);
// Fill this region with Yellow
FillCommand cmd = new FillCommand(RasterColor.FromKnownColor(RasterKnownColor.Yellow));
cmd.Run(image);
// Save this image
codecs.Save(image, destFileName, RasterImageFormat.Bmp, 24);
}
codecs.Dispose();
}
static class LEAD_VARS
{
public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}
Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.Drawing
Imports Leadtools.ImageProcessing
Imports Leadtools.ImageProcessing.Color
Public Sub GdiPlusRegionDataExample()
Dim codecs As New RasterCodecs()
Dim srcFileName As String = LeadtoolsExamples.Common.ImagesPath.Path + "Image1.cmp"
Dim destFileName As String = LeadtoolsExamples.Common.ImagesPath.Path + "Image1_GdiPlusData.bmp"
Dim gdipRegionData As RegionData = Nothing
' Load the source image
Using image As RasterImage = codecs.Load(srcFileName)
' Add a polygon region to it
' Add a polygon region to the image
Dim x1 As Integer = image.ImageWidth \ 4
Dim y1 As Integer = image.ImageHeight \ 4
Dim x2 As Integer = image.ImageWidth \ 3
Dim y2 As Integer = image.ImageHeight \ 3
Dim pts() As LeadPoint =
{
New LeadPoint(x1, y1),
New LeadPoint(x2, y1),
New LeadPoint(x1, y2),
New LeadPoint(x2, y2)
}
image.AddPolygonToRegion(Nothing, pts, LeadFillMode.Winding, RasterRegionCombineMode.Set)
' Save the region as a GDI+ RegionData object
gdipRegionData = RasterRegionConverter.GetGdiPlusRegionData(image, Nothing)
End Using
' Re-load the source image
Using image As RasterImage = codecs.Load(srcFileName)
' Add the GDI+ region data we saved to it
RasterRegionConverter.AddGdiPlusDataToRegion(image, Nothing, gdipRegionData, RasterRegionCombineMode.Set)
' Fill this region with Yellow
Dim cmd As New FillCommand(RasterColor.FromKnownColor(RasterKnownColor.Yellow))
cmd.Run(image)
' Save this image
codecs.Save(image, destFileName, RasterImageFormat.Bmp, 24)
End Using
codecs.Dispose()
End Sub
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document
Your email has been sent to support! Someone should be in touch! If your matter is urgent please come back into chat.
Chat Hours:
Monday - Friday, 8:30am to 6pm ET
Thank you for your feedback!
Please fill out the form again to start a new chat.
All agents are currently offline.
Chat Hours:
Monday - Friday
8:30AM - 6PM EST
To contact us please fill out this form and we will contact you via email.