Occurs during the file save process to provide functionality for manually handling the output image data or monitoring a progress status.
public event EventHandler<CodecsSaveImageEventArgs> SaveImage Public Event SaveImage As EventHandler(Of CodecsSaveImageEventArgs) synchronized public void addSaveImageListener(CodecsSaveImageListener listener)synchronized public void removeSaveImageListener(CodecsSaveImageListener listener)
public:event EventHandler<CodecsSaveImageEventArgs^>^ SaveImage
The event handler receives an argument of type CodecsSaveImageEventArgs containing data related to this event. The following CodecsSaveImageEventArgs properties provide information specific to this event.
| Property | Description |
|---|---|
| Buffer | Gets the memory buffer containing one or more lines of output image data that the you must provide. |
This event will fire during saving images with the Save methods. If you use this event, you must copy the image data to the provided event buffer.
You can also use this event to get information about the image being saved, provide a progress status, and/or abort the save operation. For information on how to use this event as a progress status monitor, refer to CodecsSaveOptions.RetrieveDataFromImage and CodecsSaveImageEventArgs.
This example will double the density of an image as it is being saved.
using Leadtools;using Leadtools.Codecs;using Leadtools.ImageProcessing;using Leadtools.ImageProcessing.Color;using Leadtools.Svg;using LeadtoolsExamples.Common;public void SaveImageExample(){RasterCodecs codecs = new RasterCodecs();string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp");string destFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1_SaveImage.cmp");// Load the source file (make sure to load as 24 bits/pixel)RasterImage image = codecs.Load(srcFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1);// Instruct RasterCodecs to generate the saved scanlines data for us to manipulatecodecs.Options.Save.RetrieveDataFromImage = true;// Add a handler to the SaveImage eventcodecs.SaveImage += new EventHandler<CodecsSaveImageEventArgs>(codecs_SaveImage);// Save the imagecodecs.Save(image, destFileName, RasterImageFormat.Cmp, 24);codecs.SaveImage -= new EventHandler<CodecsSaveImageEventArgs>(codecs_SaveImage);image.Dispose();// Clean upcodecs.Dispose();}private void codecs_SaveImage(object sender, CodecsSaveImageEventArgs e){// This example works with images saved as 24-bit per pixel onlyDebug.Assert(e.Image.BitsPerPixel == 24);if (e.Row == 0){// Show information about the image being savedConsole.WriteLine("Saving an image with {0} bpp to {1}", e.Image.BitsPerPixel, e.FileName);Console.WriteLine("Offset: {0}, OffsetValid: {1}", e.Offset, e.OffsetValid);Console.WriteLine("Page: {0} of {1}", e.Page, e.LastPage - e.FirstPage + 1);Console.WriteLine("Page percent: {0}%, Total percent: {1}%", e.PagePercent, e.TotalPercent);}Console.WriteLine("Row: {0}, Lines {1}", e.Row, e.Lines);// Get the scanlines from the imageint scanlineLength = e.Image.BytesPerLine;byte[] scanline = new byte[scanlineLength];// Loop through all the scanlines in the datafor (int y = 0; y < e.Lines; y++){// Get this rowe.Buffer.GetData(y * scanlineLength, scanline, 0, scanlineLength);// We got the data, now double the intensity// Remember, this is 24-bits/pixelfor (int x = 0; x < scanlineLength; x++){scanline[x] *= 2;}// Copy it back to the event buffere.Buffer.SetData(y * scanlineLength, scanline, 0, scanlineLength);}}static class LEAD_VARS{public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";}
Imports LeadtoolsImports Leadtools.CodecsImports Leadtools.ImageProcessingImports Leadtools.ImageProcessing.ColorImports Leadtools.DrawingImports Leadtools.SvgPublic Sub SaveImageExample()Dim codecs As New RasterCodecs()Dim srcFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp")Dim destFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1_SaveImage.cmp")' Load the source file (make sure to load as 24 bits/pixel)Dim image As RasterImage = codecs.Load(srcFileName, 24, CodecsLoadByteOrder.Bgr, 1, 1)' Instruct RasterCodecs to generate the saved scanlines data for us to manipulatecodecs.Options.Save.RetrieveDataFromImage = True' Add a handler to the SaveImage eventAddHandler codecs.SaveImage, AddressOf codecs_SaveImage' Save the imagecodecs.Save(image, destFileName, RasterImageFormat.Cmp, 24)RemoveHandler codecs.SaveImage, AddressOf codecs_SaveImageimage.Dispose()' Clean upcodecs.Dispose()End SubPrivate Sub codecs_SaveImage(ByVal sender As Object, ByVal e As CodecsSaveImageEventArgs)' This example works with images saved as 24-bit per pixel onlyDebug.Assert(e.Image.BitsPerPixel = 24)If e.Row = 0 Then' Show information about the image being savedConsole.WriteLine("Saving an image with {0} bpp to {1}", e.Image.BitsPerPixel, e.FileName)Console.WriteLine("Offset: {0}, OffsetValid: {1}", e.Offset, e.OffsetValid)Console.WriteLine("Page: {0} of {1}", e.Page, e.LastPage - e.FirstPage + 1)Console.WriteLine("Page percent: {0}%, Total percent: {1}%", e.PagePercent, e.TotalPercent)End IfConsole.WriteLine("Row: {0}, Lines {1}", e.Row, e.Lines)' Get the scanlines from the imageDim scanlineLength As Integer = e.Image.BytesPerLineDim scanline(scanlineLength - 1) As Byte' Loop through all the scanlines in the dataFor y As Integer = 0 To e.Lines - 1' Get this rowe.Buffer.GetData(y * scanlineLength, scanline, 0, scanlineLength)' We got the data, now double the intensity' Remember, this is 24-bits/pixelFor x As Integer = 0 To scanlineLengthscanline(x) = CType(scanline(x) * 2, Byte)Next' Copy it back to the event buffere.Buffer.SetData(y * scanlineLength, scanline, 0, scanlineLength)NextEnd SubPublic NotInheritable Class LEAD_VARSPublic Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"End Class
c#[Silverlight C# Example]using Leadtools;using Leadtools.Codecs;using Leadtools.Examples;using Leadtools.ImageProcessing;using Leadtools.ImageProcessing.Color;using Leadtools.Windows.Media;public void SaveImageExample(Stream inStreamCmp, Stream outStreamCmp){RasterCodecs codecs = new RasterCodecs();// Load the source file (make sure to load as 24 bits/pixel)RasterImage image = codecs.Load(inStreamCmp, 24, CodecsLoadByteOrder.Bgr, 1, 1);// Add a handler to the SaveImage eventcodecs.SaveImage += new EventHandler<CodecsSaveImageEventArgs>(codecs_SaveImage);// Save the imagecodecs.Save(image, outStreamCmp, RasterImageFormat.Cmp, 24);codecs.SaveImage -= new EventHandler<CodecsSaveImageEventArgs>(codecs_SaveImage);image.Dispose();}byte[] _saveImageScanLine;void codecs_SaveImage(object sender, CodecsSaveImageEventArgs e){if (e.Row == 0){// Show information about the image being savedConsole.WriteLine("Saving an image with {0} bpp to {1}", e.Image.BitsPerPixel, e.FileName);//Console.WriteLine("Offset: {0}, OffsetValid: {1}", e.Offset, e.OffsetValid);Console.WriteLine("Page: {0} of {1}", e.Page, e.PageCount);}Console.WriteLine("Row: {0}, Lines {1}", e.Row, e.Lines);// Get the scanlines from the imageint lastRow = e.Row + e.Lines;int bytesPerLine = e.Image.BytesPerLine;RasterNativeBuffer buffer = e.Buffer;// See if we need to re-allocate the managed bufferif (_saveImageScanLine == null || _saveImageScanLine.Length < bytesPerLine)_saveImageScanLine = new byte[bytesPerLine];long offset = 0;for (int y = e.Row; y < lastRow; y++){// Get the row into the managed buffere.Image.Access();e.Image.GetRow(y, _saveImageScanLine, 0, bytesPerLine);e.Image.Release();// We got the data, now double the intensity// Remember, this is 24-bits/pixelfor (int x = 0; x < bytesPerLine; x++)_saveImageScanLine[x] *= 2;// Copy the data into the bufferbuffer.SetData(offset, _saveImageScanLine, 0, bytesPerLine);// Move the pointer to the position in the buffer for the next rowoffset += bytesPerLine;}}vb[Silverlight VB Example]Imports LeadtoolsImports Leadtools.CodecsImports Leadtools.ImageProcessingImports Leadtools.ImageProcessing.ColorImports Leadtools.Windows.MediaPublic Sub SaveImageExample(ByVal inStreamCmp As Stream, ByVal outStreamCmp As Stream)Dim codecs As RasterCodecs = New RasterCodecs()' Load the source file (make sure to load as 24 bits/pixel)Dim image As RasterImage = codecs.Load(inStreamCmp, 24, CodecsLoadByteOrder.Bgr, 1, 1)' Add a handler to the SaveImage eventAddHandler codecs.SaveImage, AddressOf codecs_SaveImage' Save the imagecodecs.Save(image, outStreamCmp, RasterImageFormat.Cmp, 24)RemoveHandler codecs.SaveImage, AddressOf codecs_SaveImageimage.Dispose()End SubPrivate _saveImageScanLine As Byte()Private Sub codecs_SaveImage(ByVal sender As Object, ByVal e As CodecsSaveImageEventArgs)If e.Row = 0 Then' Show information about the image being savedConsole.WriteLine("Saving an image with {0} bpp to {1}", e.Image.BitsPerPixel, e.FileName)'Console.WriteLine("Offset: {0}, OffsetValid: {1}", e.Offset, e.OffsetValid);Console.WriteLine("Page: {0} of {1}", e.Page, e.PageCount)End IfConsole.WriteLine("Row: {0}, Lines {1}", e.Row, e.Lines)' Get the scanlines from the imageDim lastRow As Integer = e.Row + e.LinesDim bytesPerLine As Integer = e.Image.BytesPerLineDim buffer As RasterNativeBuffer = e.Buffer' See if we need to re-allocate the managed bufferIf _saveImageScanLine Is Nothing OrElse _saveImageScanLine.Length < bytesPerLine Then_saveImageScanLine = New Byte(bytesPerLine - 1) {}End IfDim offset As Long = 0Dim y As Integer = e.RowDo While y < lastRow' Get the row into the managed buffere.Image.Access()e.Image.GetRow(y, _saveImageScanLine, 0, bytesPerLine)e.Image.Release()' We got the data, now double the intensity' Remember, this is 24-bits/pixelDim x As Integer = 0Do While x < bytesPerLine_saveImageScanLine(x) *= 2x += 1Loop' Copy the data into the bufferbuffer.SetData(offset, _saveImageScanLine, 0, bytesPerLine)' Move the pointer to the position in the buffer for the next rowoffset += bytesPerLiney += 1LoopEnd 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
