←Select platform

AllocateImage Property

Summary

Enables or disables allocating memory for storing image data.

Syntax
C#
VB
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
C#
VB
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:\Users\Public\Documents\LEADTOOLS Images"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
 
Private image As RasterImage 
 
Private Sub Codecs_LoadImage(sender As Object, e As CodecsLoadImageEventArgs) 
   'copy each row of data into our manually allocated RasterImage 
   image.SetRow(e.Row, e.Buffer.Data, image.BytesPerLine * e.Lines) 
End Sub 
 
Public Sub AllocateImageExample() 
   Dim fileName As String = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp") 
   Dim codecs As New RasterCodecs() 
   Dim info As CodecsImageInfo = codecs.GetInformation(fileName, False) 
   Dim size As Integer = info.Width * info.Height * info.BitsPerPixel 
   Dim data As IntPtr = Marshal.AllocHGlobal(size) 
 
   image = New RasterImage(RasterMemoryFlags.User, info.Width, info.Height, info.BitsPerPixel, RasterByteOrder.Bgr, info.ViewPerspective, 
Nothing, 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 
 
   AddHandler codecs.LoadImage, AddressOf Codecs_LoadImage 
   codecs.Load(fileName) 
   RemoveHandler codecs.LoadImage, AddressOf 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" 
 
   Dim resolutions As LeadSize() = New LeadSize(0) {} 
   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() 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public 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; 
 
public void AllocateImageExample(Stream inStreamCmp, Stream outStreamTif) 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   //Setting the loading options. 
   //allow LEADTOOLS to allocate the image data 
   codecs.Options.Load.AllocateImage = true; 
   //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.NoInterlace = false; 
   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; 
   codecs.Options.Load.StoreDataInImage = true; 
   //load super-compressed in memory 
   codecs.Options.Load.XResolution = 350; 
   codecs.Options.Load.YResolution = 350; 
   //allow loading corrupted images 
   codecs.Options.Load.LoadCorrupted = true; 
 
   RasterImage image = codecs.Load(inStreamCmp); 
 
   //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, outStreamTif, RasterImageFormat.Tif, 8, 1, image.PageCount, 1, CodecsSavePageMode.Overwrite); 
 
   // Clean up 
   image.Dispose(); 
} 
vb[Silverlight VB Example] 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing 
 
Public Sub AllocateImageExample(ByVal inStreamCmp As Stream, ByVal outStreamTif As Stream) 
   Dim codecs As RasterCodecs = New RasterCodecs() 
 
   'Setting the loading options. 
   'allow LEADTOOLS to allocate the image data 
   codecs.Options.Load.AllocateImage = True 
   '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.NoInterlace = False 
   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 
   codecs.Options.Load.StoreDataInImage = True 
   'load super-compressed in memory 
   codecs.Options.Load.XResolution = 350 
   codecs.Options.Load.YResolution = 350 
   'allow loading corrupted images 
   codecs.Options.Load.LoadCorrupted = True 
 
   Dim image As RasterImage = codecs.Load(inStreamCmp) 
 
   '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" 
 
   Dim resolutions As LeadSize() = New LeadSize(0) {} 
   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, outStreamTif, RasterImageFormat.Tif, 8, 1, image.PageCount, 1, CodecsSavePageMode.Overwrite) 
 
   ' Clean up 
   image.Dispose() 
End Sub

Requirements

Target Platforms

Help Version 20.0.2020.4.3
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Codecs Assembly
Introduction
Getting Started
Namespaces
Leadtools.Codecs Namespace
Assemblies