public int Passes { get; set; } @property (nonatomic, assign) NSInteger passes; public int getPasses()public void setPasses(int value)
Passes # get and set (CodecsLoadOptions)
The number of passes (scans through the image) when loading a progressive image.
| Value | Description |
|---|---|
| Any positive number | Load a progressive file showing at most the specified number of passes. |
| 0 | Load the file in one pass. The default value is 0 |
| -1 | Load a progressive file showing only significant scans. |
| -2 | Load a progressive file showing all the scans. |
This value is also used when loading JBIG files to determine the number of resolutions to load to create a progressive load effect.
This property controls the number of times the RasterCodecs.LoadImage event can be called for a particular row. If you do not use the RasterCodecs.LoadImage event, this value is ignored.The RasterCodecs.LoadImage event can be used to implement a paint while load feature. For progressive files, the event is called several times for the same image row. The quality of the row is improved with every call. The improvements in some passes do not have visual improvements, so it is recommended you show only the significant scans (-1).
using Leadtools;using Leadtools.Codecs;using Leadtools.ImageProcessing.Core;using Leadtools.Pdf;RasterImage image;private void Codecs_LoadImage(object sender, CodecsLoadImageEventArgs e){//copy each row of data into our manually allocated RasterImageimage.SetRow(e.Row, e.Buffer.Data, image.BytesPerLine * e.Lines);}public void AllocateImageExample(){string fileName = Path.Combine(LEAD_VARS.ImagesDir, "image1.cmp");RasterCodecs codecs = new RasterCodecs();CodecsImageInfo info = codecs.GetInformation(fileName, false);int size = info.Width * info.Height * info.BitsPerPixel;IntPtr data = Marshal.AllocHGlobal(size);image = new RasterImage(RasterMemoryFlags.User, info.Width, info.Height, info.BitsPerPixel, RasterByteOrder.Bgr, info.ViewPerspective, null, data, size);image.Access();//Setting the loading options.//Do NOT allow LEADTOOLS to allocate the image datacodecs.Options.Load.AllocateImage = false; // CodecsOptions & CodecsLoadOptions referencecodecs.Options.Load.StoreDataInImage = false;//keeping the loaded image data compressed in memory.codecs.Options.Load.Compressed = true;codecs.Options.Load.DiskMemory = false;//force a palletized image to be dithered to the LEAD fixed palette.codecs.Options.Load.FixedPalette = true;//we know the format of the filecodecs.Options.Load.Format = RasterImageFormat.Cmp;//disable loading metadata markers if present in the file, false to ignore them.codecs.Options.Load.Markers = false;codecs.Options.Load.NoDiskMemory = true;codecs.Options.Load.NoInterlace = false;codecs.Options.Load.NoTiledMemory = true;codecs.Options.Load.Passes = 0;//ignore the view perspective stored in the file.codecs.Options.Load.Rotated = false;//set negative pixel values to 0.codecs.Options.Load.Signed = false;codecs.Options.Load.InitAlpha = true;//load super-compressed in memorycodecs.Options.Load.SuperCompressed = true;codecs.Options.Load.TiledMemory = false;codecs.Options.Load.XResolution = 350;codecs.Options.Load.YResolution = 350;//allow loading corrupted imagescodecs.Options.Load.LoadCorrupted = true;codecs.LoadImage += Codecs_LoadImage;codecs.Load(fileName);codecs.LoadImage -= Codecs_LoadImage;image.Release();//Meta file's comments will be saved.//CodecsSaveOptions referencecodecs.Options.Save.Comments = true;codecs.Options.Save.FixedPalette = true;codecs.Options.Save.GeoKeys = false;//Tiff file output will be gray.codecs.Options.Save.GrayOutput = true;//Meta file's markers will be saved.codecs.Options.Save.Markers = true;codecs.Options.Save.MotorolaOrder = false;codecs.Options.Save.OptimizedPalette = true;codecs.Options.Save.Password = "LEADTOOLS";LeadSize[] resolutions = new LeadSize[1];resolutions[0].Width = 350;resolutions[0].Height = 350;codecs.Options.Save.GetResolutions();codecs.Options.Save.SetResolutions(resolutions);codecs.Options.Save.Reset();//Meta file's tags will be saved.codecs.Options.Save.Tags = true;codecs.Options.Save.UseImageDitheringMethod = true;codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "allocate_image.tif"), RasterImageFormat.Tif, 8, 1, image.PageCount, 1, CodecsSavePageMode.Overwrite);// Finalize cannot be called directly, it is invoked automatically.// To clean up before exiting, use Disposeimage.Dispose();Marshal.FreeHGlobal(data);codecs.Dispose();}static class LEAD_VARS{public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images";}
import java.io.File;import java.io.IOException;import java.net.URI;import java.net.URISyntaxException;import java.nio.file.Paths;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.imageprocessing.core.MinMaxBitsCommand;RasterImage image;public void codecsAllocateImageExample() {final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images";String fileName = combine(LEAD_VARS_IMAGES_DIR, "barcode1.tif");RasterCodecs codecs = new RasterCodecs();CodecsImageInfo info = codecs.getInformation(fileName, false);byte[] data = new byte[1];image = new RasterImage(10, info.getWidth(), info.getHeight(), info.getBitsPerPixel(), info.getOrder(),info.getViewPerspective(), info.getPalette(), data, data.length);image.access();// Setting the loading options.// Do NOT allow LEADTOOLS to allocate the image datacodecs.getOptions().getLoad().setAllocateImage(false);// CodecsOptions & CodecsLoadOptions referencecodecs.getOptions().getLoad().setStoreDataInImage(false);// keeping the loaded image data compressed in memory.codecs.getOptions().getLoad().setCompressed(true);codecs.getOptions().getLoad().setDiskMemory(false);// force a palletized image to be dithered to the LEAD fixed palette.codecs.getOptions().getLoad().setFixedPalette(true);// we know the format of the filecodecs.getOptions().getLoad().setFormat(RasterImageFormat.CMP);// disable loading metadata markers if present in the file, false to ignore// them.codecs.getOptions().getLoad().setMarkers(false);codecs.getOptions().getLoad().setNoDiskMemory(true);codecs.getOptions().getLoad().setNoInterlace(false);codecs.getOptions().getLoad().setNoTiledMemory(true);codecs.getOptions().getLoad().setPasses(0);// ignore the view perspective stored in the file.codecs.getOptions().getLoad().setRotated(false);// set negative pixel values to 0.codecs.getOptions().getLoad().setSigned(false);codecs.getOptions().getLoad().setInitAlpha(true);// load super-compressed in memorycodecs.getOptions().getLoad().setSuperCompressed(true);codecs.getOptions().getLoad().setTiledMemory(false);codecs.getOptions().getLoad().setXResolution(350);codecs.getOptions().getLoad().setYResolution(350);// allow loading corrupted imagescodecs.getOptions().getLoad().setLoadCorrupted(true);// Created this method belowcodecs.addLoadImageListener(loadListener);codecs.load(fileName);codecs.removeLoadImageListener(loadListener);image.release();// Meta file's comments will be saved.// CodecsSaveOptions referencecodecs.getOptions().getSave().setComments(true);codecs.getOptions().getSave().setFixedPalette(true);codecs.getOptions().getSave().setGeoKeys(false);// tiff file output will be gray.codecs.getOptions().getSave().setGrayOutput(true);// Meta file's markers will be saved.codecs.getOptions().getSave().setMarkers(true);codecs.getOptions().getSave().setMotorolaOrder(false);codecs.getOptions().getSave().setOptimizedPalette(true);codecs.getOptions().getSave().setPassword("LEADTOOLS");LeadSize[] resolutions = new LeadSize[1];resolutions[0] = new LeadSize();resolutions[0].setWidth(350);resolutions[0].setHeight(350);codecs.getOptions().getSave().getResolutions();codecs.getOptions().getSave().setResolutions(resolutions);codecs.getOptions().getSave().reset();// Meta file's tags will be saved.codecs.getOptions().getSave().setTags(true);codecs.getOptions().getSave().setUseImageDitheringMethod(true);String outputFileName = combine(LEAD_VARS_IMAGES_DIR, "allocate_image.tif");codecs.save(image, outputFileName, RasterImageFormat.TIF, 8, 1, image.getPageCount(), 1,CodecsSavePageMode.OVERWRITE);assertTrue("File unsuccessfully saved to " + outputFileName, (new File(outputFileName)).exists());System.out.printf("File successfully saved to %s%n", outputFileName);// Finalize cannot be called directly, it is invoked automatically.// To clean up before exiting, use Disposeimage.dispose();data = null;codecs.dispose();}CodecsLoadImageListener loadListener = new CodecsLoadImageListener() {@Overridepublic void onLoadImage(CodecsLoadImageEvent e) {image.setRow(e.getRow(), e.getBuffer().getData(), image.getBytesPerLine() * e.getLines());}};
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
