This constructor is required by ISerializable.
protected RasterImage(
SerializationInfo info,
StreamingContext context
)
info
The data needed to serialize or deserialize an object.
context
The source and destination of a given serialized stream.
The RasterImage class supports standard .NET serialization. Serialization of a RasterImage is the process of converting the state of a RasterImage object into a form that can be persisted or transported. The complement of serialization is deserialization, which converts a stream into an RasterImage object. Together, these processes allow the image data to be easily stored and transferred.
When you serialize an RasterImage object, all the data inside the object are saved. This includes the image data of all pages as well as the current page number, region information, low bit/high bit, palette data, metadata (tags, markers and comments), etc. In other words, the RasterImage can be constructed back to its original state from the stream.
For more information and examples regarding serialization of an RasterImage object, refer to RasterImage Serialization.
For more information, refer to Grayscale Images.
using Leadtools;
using Leadtools.Codecs;
using Leadtools.ImageProcessing;
using Leadtools.ImageProcessing.Color;
using LeadtoolsExamples.Common;
public void MyRasterImageSerializationTest()
{
// Load an image
RasterCodecs codecs = new RasterCodecs();
RasterImage img = codecs.Load(Path.Combine(ImagesPath.Path, "Image1.cmp"));
// create a new MyRasterImage instance out of this image
MyRasterImage myImage = new MyRasterImage(img);
// Set our custom data
myImage.MyIntegerData = 10;
myImage.MyStringData = "My string";
string msg = string.Format("Before serialization. MyIntegerData = {0}, MyStringData = {1}", myImage.MyIntegerData, myImage.MyStringData);
MessageBox.Show(msg);
// img is invalid now and should be disposed
img.Dispose();
// Serialize myImage
BinaryFormatter formatter = new BinaryFormatter();
MemoryStream ms = new MemoryStream();
formatter.Serialize(ms, myImage);
// dispose myImage
myImage.Dispose();
myImage = null;
// Deserialize back from the stream
ms.Position = 0;
myImage = formatter.Deserialize(ms) as MyRasterImage;
msg = string.Format("After serialization. MyIntegerData = {0}, MyStringData = {1}", myImage.MyIntegerData, myImage.MyStringData);
Console.WriteLine(msg);
// re-save the image
codecs.Save(myImage, Path.Combine(ImagesPath.Path, "Image1_MySerialized.bmp"), RasterImageFormat.Bmp, 24);
// Clean up
ms.Close();
ms.Dispose();
myImage.Dispose();
codecs.Dispose();
}
Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.ImageProcessing
Imports Leadtools.ImageProcessing.Color
Public Sub MyRasterImageSerializationTest()
' Load an image
Dim codecs As RasterCodecs = New RasterCodecs()
Dim img As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"))
' create a new MyRasterImage instance out of this image
Dim myImage As MyRasterImage = New MyRasterImage(img)
' Set our custom data
myImage.MyIntegerData = 10
myImage.MyStringData = "My string"
Dim msg As String = String.Format("Before serialization. MyIntegerData = {0}, MyStringData = {1}", myImage.MyIntegerData, myImage.MyStringData)
MessageBox.Show(msg)
' img is invalid now and should be disposed
img.Dispose()
' Serialize myImage
Dim formatter As BinaryFormatter = New BinaryFormatter()
Dim ms As MemoryStream = New MemoryStream()
formatter.Serialize(ms, myImage)
' dispose myImage
myImage.Dispose()
myImage = Nothing
' Deserialize back from the stream
ms.Position = 0
myImage = CType(formatter.Deserialize(ms), MyRasterImage)
msg = String.Format("After serialization. MyIntegerData = {0}, MyStringData = {1}", myImage.MyIntegerData, myImage.MyStringData)
MessageBox.Show(msg)
' re-save the image
codecs.Save(myImage, Path.Combine(LEAD_VARS.ImagesDir, "Image1_MySerialized.bmp"), RasterImageFormat.Bmp, 24)
' Clean up
ms.Close()
myImage.Dispose()
codecs.Dispose()
End Sub
Public NotInheritable Class LEAD_VARS
Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS 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