public RasterImage Clone()
Public Overloads Function Clone() As RasterImage
- (nullable LTRasterImage *)clone:(NSError **)error
public RasterImage clone()
public:
RasterImage^ Clone();
The RasterImage this method creates.
You can also use the RasterImage constructor to create an exact copy of an existing RasterImage.
This method copies only the current active page and no metadata information is copied. To create an exact copy of a RasterImage object use the CloneAll method.
To clone an image with support for a progress event, refer to CloneCommand.
This example loads a multipage image and clones it in 3 different ways.
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 Leadtools.Svg;
public void CloneExample()
{
RasterCodecs codecs = new RasterCodecs();
string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "eye.gif");
// Load the multi-page image
RasterImage srcImage = codecs.Load(srcFileName);
Console.WriteLine("Pages in source image: {0}", srcImage.PageCount);
// Use the Clone method to clone this image
// Notice, this method only clones the current active page only
RasterImage destImage1 = srcImage.Clone();
Console.WriteLine("Pages in image created with Clone: {0}", destImage1.PageCount);
Assert.IsTrue(destImage1.PageCount == 1);
// Use the Clone rectangle method to clone this image
// Notice, this method also clones the current active page only
LeadRect rc = new LeadRect(0, 0, srcImage.Width / 2, srcImage.Height / 2);
Console.WriteLine("Cloning with a rectangle = {0}", rc.ToString());
RasterImage destImage2 = srcImage.Clone(rc);
Console.WriteLine("Pages in image created with Clone(LeadRect): {0}", destImage2.PageCount);
Console.WriteLine("Image created with Clone(LeadRect) size = {0} by {1}", destImage2.Width, destImage2.Height);
Assert.IsTrue(destImage2.PageCount == 1);
Assert.IsTrue(destImage2.Width == srcImage.Width / 2);
Assert.IsTrue(destImage2.Height == srcImage.Height / 2);
// Use the CloneAll method, this should create a copy
// of all the pages
RasterImage destImage3 = srcImage.CloneAll();
Console.WriteLine("Pages in image created with CloneAll: {0}", destImage3.PageCount);
Assert.IsTrue(destImage3.PageCount == srcImage.PageCount);
// Use the CloneCommand, this allows you to have a progress
// bar as well as control the memory flags, here
// we will create a destination image using disk memory.
CloneCommand cloneCmd = new CloneCommand();
cloneCmd.Progress += new EventHandler<RasterCommandProgressEventArgs>(cloneCmd_Progress);
cloneCmd.CreateFlags = RasterMemoryFlags.Disk;
cloneCmd.Run(srcImage);
cloneCmd.Progress -= new EventHandler<RasterCommandProgressEventArgs>(cloneCmd_Progress);
RasterImage destImage4 = cloneCmd.DestinationImage;
Console.WriteLine("Pages in image created with CloneCommand: {0}", destImage4.PageCount);
Console.WriteLine("Disk memory model of image created with CloneCommand: {0}", destImage4.IsDiskMemory);
Assert.IsTrue(destImage4.PageCount == 1);
Assert.IsTrue(destImage4.IsDiskMemory);
// Clean up
destImage4.Dispose();
destImage3.Dispose();
destImage2.Dispose();
destImage1.Dispose();
srcImage.Dispose();
codecs.Dispose();
}
void cloneCmd_Progress(object sender, RasterCommandProgressEventArgs e)
{
if (e.Percent == 0)
Console.WriteLine("Clone progress started");
if (e.Percent == 100)
Console.WriteLine("Clone progress ended");
}
static class LEAD_VARS
{
public const string ImagesDir = @"C:\LEADTOOLS21\Resources\Images";
}
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 CloneExample()
Dim codecs As RasterCodecs = New RasterCodecs()
Dim srcFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "eye.gif")
' Load the multi-page image
Dim srcImage As RasterImage = codecs.Load(srcFileName)
Console.WriteLine("Pages in source image: {0}", srcImage.PageCount)
' Use the Clone method to clone this image
' Notice, this method only clones the current active page only
Dim destImage1 As RasterImage = srcImage.Clone()
Console.WriteLine("Pages in image created with Clone: {0}", destImage1.PageCount)
Debug.Assert(destImage1.PageCount = 1)
' Use the Clone rectangle method to clone this image
' Notice, this method also clones the current active page only
Dim rc As LeadRect = New LeadRect(0, 0, srcImage.Width \ 2, srcImage.Height \ 2)
Console.WriteLine("Cloning with a rectangle = {0}", rc.ToString())
Dim destImage2 As RasterImage = srcImage.Clone(rc)
Console.WriteLine("Pages in image created with Clone(LeadRect): {0}", destImage2.PageCount)
Console.WriteLine("Image created with Clone(LeadRect) size = {0} by {1}", destImage2.Width, destImage2.Height)
Debug.Assert(destImage2.PageCount = 1)
Debug.Assert(destImage2.Width = srcImage.Width \ 2)
Debug.Assert(destImage2.Height = srcImage.Height \ 2)
' Use the CloneAll method, this should create a copy
' of all the pages
Dim destImage3 As RasterImage = srcImage.CloneAll()
Console.WriteLine("Pages in image created with CloneAll: {0}", destImage3.PageCount)
Debug.Assert(destImage3.PageCount = srcImage.PageCount)
' Use the CloneCommand, this allows you to have a progress
' bar as well as control the memory flags, here
' we will create a destination image using disk memory.
Dim cloneCmd As CloneCommand = New CloneCommand()
AddHandler cloneCmd.Progress, AddressOf cloneCmd_Progress
cloneCmd.CreateFlags = RasterMemoryFlags.Disk
cloneCmd.Run(srcImage)
RemoveHandler cloneCmd.Progress, AddressOf cloneCmd_Progress
Dim destImage4 As RasterImage = cloneCmd.DestinationImage
Console.WriteLine("Pages in image created with CloneCommand: {0}", destImage4.PageCount)
Console.WriteLine("Disk memory model of image created with CloneCommand: {0}", destImage4.IsDiskMemory)
Debug.Assert(destImage4.PageCount = 1)
Debug.Assert(destImage4.IsDiskMemory)
' Clean up
destImage4.Dispose()
destImage3.Dispose()
destImage2.Dispose()
destImage1.Dispose()
srcImage.Dispose()
codecs.Dispose()
End Sub
Private Sub cloneCmd_Progress(ByVal sender As Object, ByVal e As RasterCommandProgressEventArgs)
If e.Percent = 0 Then
Console.WriteLine("Clone progress started")
End If
If e.Percent = 100 Then
Console.WriteLine("Clone progress ended")
End If
End Sub
Public NotInheritable Class LEAD_VARS
Public Const ImagesDir As String = "C:\LEADTOOLS21\Resources\Images"
End Class
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.