AllocateImage Property

Summary

Enables or disables allocating memory for storing image data.

Syntax

Objective-C

C++

Java

public bool AllocateImage { get; set; }

Public Property AllocateImage As Boolean

@property (nonatomic, assign) BOOL allocateImage

public boolean getAllocateImage() 
public void setAllocateImage(boolean value)

public: 
property bool AllocateImage { 
   bool get(); 
   void set (    bool ); 
}

Property Value

true to have LEADTOOLS do the necessary allocation, false to disable it.

Remarks

If you do not allow LEADTOOLS to allocate the memory for the storage of the image data, then you should process the data manually using the RasterCodecs.LoadImage event.

Example

using Leadtools; 
using Leadtools.Codecs; 
 
 
 
RasterImage image; 
private void Codecs_LoadImage(object sender, CodecsLoadImageEventArgs e) 
{ 
	//copy each row of data into our manually allocated RasterImage 
	image.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 data 
	codecs.Options.Load.AllocateImage = false; 
	codecs.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 file 
	codecs.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 memory 
	codecs.Options.Load.SuperCompressed = true; 
	codecs.Options.Load.TiledMemory = false; 
	codecs.Options.Load.XResolution = 350; 
	codecs.Options.Load.YResolution = 350; 
	//allow loading corrupted images 
	codecs.Options.Load.LoadCorrupted = true; 
 
	codecs.LoadImage += Codecs_LoadImage; 
	codecs.Load(fileName); 
	codecs.LoadImage -= Codecs_LoadImage; 
	image.Release(); 
 
	//Meta file's comments will be saved. 
	codecs.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.SetResolutions(resolutions); 
	//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); 
 
	// Clean up 
	image.Dispose(); 
	Marshal.FreeHGlobal(data); 
	codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS21\Resources\Images"; 
}

Requirements

Target Platforms

Reference

CodecsLoadOptions Class

CodecsLoadOptions Members

Download our FREE evaluation

Help Version 21.0.2021.7.2

Leadtools.Codecs Assembly

Introduction

Getting Started

Namespaces

Leadtools.Codecs Namespace

Assemblies