RasterCodecs Class

Summary

Provides support for loading and saving raster image files.

Syntax

Objective-C

C++/CLI

Java

Python

public class RasterCodecs : IDisposable

@interface LTRasterCodecs : NSObject

public class RasterCodecs

public ref class RasterCodecs : public System.IDisposable

class RasterCodecs(IDisposable):

Remarks

LEADTOOLS provides many options for loading and saving image files.

Whether an image file is on disk or in memory, you can get information about the image before loading it. You can also handle file-format-specific information, such as the page number or physical resolution.

You can supply the input for a load operation or the output of a save operation, and you can add processing, such as a paint-while-load feature.

You can create as many instances of the RasterCodecs class as desired. However, you should not pass a RasterCodecs object created in one thread to another. Instead, create another instance of RasterCodecs in the thread. If desired, you can copy the options from one RasterCodecs object to another by cloning the options from the source RasterCodecs using CodecsOptions.Clone and setting in the destination object Options property.

The RasterCodecs.SaveOptions and RasterCodecs.LoadOptions methods can be used to save or load the current options to a disk file or a stream.

Example

This example loads an existing image file and re-saves it in another format.

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Svg; 
 
 
public void RasterCodecsExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   Console.WriteLine(codecs.Options); 
 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
   string dstFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1_test.jpg"); 
 
   RasterImage image = codecs.Load(srcFileName); 
   codecs.Save(image, dstFileName, RasterImageFormat.Jpeg, 0); 
 
   // Finalize cannot be called directly, it is invoked automatically. 
   // To clean up before exiting, use Dispose 
   image.Dispose(); 
   codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

 
import java.io.*; 
import java.net.*; 
import java.nio.file.Paths; 
import java.util.*; 
import java.time.Instant; 
import java.time.Duration; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.codecs.RasterCodecs.FeedCallbackThunk; 
import leadtools.drawing.internal.*; 
import leadtools.imageprocessing.*; 
import leadtools.imageprocessing.color.ChangeIntensityCommand; 
import leadtools.svg.*; 
 
 
public void rasterCodecsExample() { 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
   RasterCodecs codecs = new RasterCodecs(); 
 
   System.out.println(codecs.getOptions()); 
 
   String srcFileName = combine(LEAD_VARS_IMAGES_DIR, "Image1.cmp"); 
   String dstFileName = combine(LEAD_VARS_IMAGES_DIR, "Image1_test.jpg"); 
 
   RasterImage image = codecs.load(srcFileName); 
   codecs.save(image, dstFileName, RasterImageFormat.JPEG, 0); 
 
   assertTrue("File unsuccessfully saved", (new File(dstFileName)).exists()); 
   System.out.println("File successfully saved to " + dstFileName); 
 
   // Finalize cannot be called directly, it is invoked automatically. 
   // To clean up before exiting, use Dispose 
   image.dispose(); 
   codecs.dispose(); 
}