LEADTOOLS JPEG 2000 (Leadtools.Jpeg2000 assembly)

Save(RasterCodecs,String,RasterImage,Jpeg2000FileFormat,Int32,Int32) Method

Show in webframe
Example 





The Leadtools.Codecs.RasterCodecs object.
System.String containing the name of the file currently being saved.
The Leadtools.RasterImage object that holds the image data.
Output JPEG 2000 file format. For valid values, refer to Jpeg2000FileFormat.
The resulting file's pixel depth. Possible values are: 8, 12, 16, 24, 32, 48, 64, and 0. A value of zero [0] means that each image will be saved with its bits per pixel value, if that value is equal to one of the possible values (8, 12, 16, 24, 32, 48, or 64).
Quality factor. This value determines the degree of loss in the compression process. Possible values are from 0 to 255. A value of zero (0) represents lossless compression. Values between 1 and 255 are interpreted as a compression ratio.
Saves a Leadtools.RasterImage to a file in any of the supported JPEG 2000 file formats. This method is available in the Document/Medical Toolkits.
Syntax
public void Save( 
   RasterCodecs codecs,
   string fileName,
   RasterImage image,
   Jpeg2000FileFormat format,
   int bitsPerPixel,
   int qualityFactor
)
'Declaration
 
Public Overloads Sub Save( _
   ByVal codecs As RasterCodecs, _
   ByVal fileName As String, _
   ByVal image As RasterImage, _
   ByVal format As Jpeg2000FileFormat, _
   ByVal bitsPerPixel As Integer, _
   ByVal qualityFactor As Integer _
) 
'Usage
 
Dim instance As Jpeg2000Engine
Dim codecs As RasterCodecs
Dim fileName As String
Dim image As RasterImage
Dim format As Jpeg2000FileFormat
Dim bitsPerPixel As Integer
Dim qualityFactor As Integer
 
instance.Save(codecs, fileName, image, format, bitsPerPixel, qualityFactor)

            

            
public:
void Save( 
   RasterCodecs^ codecs,
   String^ fileName,
   RasterImage^ image,
   Jpeg2000FileFormat format,
   int bitsPerPixel,
   int qualityFactor
) 

Parameters

codecs
The Leadtools.Codecs.RasterCodecs object.
fileName
System.String containing the name of the file currently being saved.
image
The Leadtools.RasterImage object that holds the image data.
format
Output JPEG 2000 file format. For valid values, refer to Jpeg2000FileFormat.
bitsPerPixel
The resulting file's pixel depth. Possible values are: 8, 12, 16, 24, 32, 48, 64, and 0. A value of zero [0] means that each image will be saved with its bits per pixel value, if that value is equal to one of the possible values (8, 12, 16, 24, 32, 48, or 64).
qualityFactor
Quality factor. This value determines the degree of loss in the compression process. Possible values are from 0 to 255. A value of zero (0) represents lossless compression. Values between 1 and 255 are interpreted as a compression ratio.
Remarks
All of the engine boxes that are currently set will also be saved in this file
Example
Copy Code  
Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.Jpeg2000

Public Sub SaveStringExample()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   ' Load a JPEG 2000 image
   Dim engine As New Jpeg2000Engine()
   Dim image As RasterImage = engine.Load(codecs, Path.Combine(LEAD_VARS.ImagesDir, "image1.jp2"), 0, CodecsLoadByteOrder.BgrOrGray)

   Dim xmlBoxes As List(Of XmlBox) = engine.GetBoxes(Of XmlBox)(Jpeg2000FileFormat.LeadJp2)
   Dim resBox As ResolutionBox = DirectCast(engine.GetBox(Jpeg2000FileFormat.LeadJp2, Jpeg2000BoxType.ResolutionBox), ResolutionBox)

   engine.ResetEngineBoxes()
   ' Set the JPX engine's XML box
   engine.SetBoxes(Jpeg2000FileFormat.LeadJpx, xmlBoxes)
   engine.SetBox(Jpeg2000FileFormat.LeadJpx, resBox)
   ' Save the image in JPX file format
   engine.Save(codecs, Path.Combine(LEAD_VARS.ImagesDir, "Test.jpx"), image, Jpeg2000FileFormat.LeadJpx, 24, 5)
   ' Append Intellectual Property Rights box
   Dim copyRights As String = ("Copyright (c) 1991-2008 by LEAD Technologies, Inc. All Rights Reserved.")
   Dim ipr As New IprBox()
   ipr.Data = Encoding.ASCII.GetBytes(copyRights)
   engine.AppendBox(Path.Combine(LEAD_VARS.ImagesDir, "Test.jpx"), ipr)
   ' Clean up
   image.Dispose()
   codecs.Dispose()
End Sub

Public NotInheritable Class LEAD_VARS
Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
using Leadtools;
using Leadtools.Codecs;
using Leadtools.Jpeg2000;

public void SaveStringExample()
{
   RasterCodecs codecs = new RasterCodecs();
   codecs.ThrowExceptionsOnInvalidImages = true;

   // Load a JPEG 2000 image
   Jpeg2000Engine engine = new Jpeg2000Engine();
   RasterImage image = engine.Load(codecs, Path.Combine(LEAD_VARS.ImagesDir, "image1.jp2"), 0, CodecsLoadByteOrder.BgrOrGray);

   List<XmlBox> xmlBoxes = engine.GetBoxes<XmlBox>(Jpeg2000FileFormat.LeadJp2);
   ResolutionBox resBox = (ResolutionBox)engine.GetBox(Jpeg2000FileFormat.LeadJp2, Jpeg2000BoxType.ResolutionBox);

   engine.ResetEngineBoxes();
   //Set the JPX engine's XML box
   engine.SetBoxes(Jpeg2000FileFormat.LeadJpx, xmlBoxes);
   engine.SetBox(Jpeg2000FileFormat.LeadJpx, resBox);
   //Save the image in JPX file format
   engine.Save(codecs, Path.Combine(LEAD_VARS.ImagesDir, "Test.jpx"), image, Jpeg2000FileFormat.LeadJpx, 24, 5);
   //Append Intellectual Property Rights box
   String copyRights = ("Copyright (c) 1991-2008 by LEAD Technologies, Inc. All Rights Reserved.");
   IprBox ipr = new IprBox();
   ipr.Data = Encoding.ASCII.GetBytes(copyRights);
   engine.AppendBox(Path.Combine(LEAD_VARS.ImagesDir, "Test.jpx"), ipr);
   // Clean up
   image.Dispose();
   codecs.Dispose();
}

static class LEAD_VARS
{
public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}
Requirements

Target Platforms

See Also

Reference

Jpeg2000Engine Class
Jpeg2000Engine Members
Overload List
AppendFrames
Load
LoadComposite
ReadFrames
Save(RasterCodecs, Stream, RasterImage, Jpeg2000FileFormat, Int32, Int32)
SaveComposite
Compression Using LEAD and JPEG Formats
File Formats - JPEG And LEAD Compressed
Bitmaps In Memory And In Files
JPEG2000 File Comments
JPEG And LEAD File Comments
Programming with JPEG 2000 Features
JPEG 2000 Boxes

 

 


Products | Support | Contact Us | Copyright Notices
© 2006-2014 All Rights Reserved. LEAD Technologies, Inc.

Leadtools.Jpeg2000 requires a Document or Medical toolkit license and unlock key. For more information, refer to: LEADTOOLS Toolkit Features