GlobalMemoryThresholds Structure

Summary

Holds conventional memory restrictions used when allocating new RasterImage objects.

Syntax

Objective-C

C++

Java

public struct GlobalMemoryThresholds

Public Structure GlobalMemoryThresholds

@interface GlobalMemoryThresholds : NSObject

public class GlobalMemoryThresholds

public: struct GlobalMemoryThresholds

Remarks

Use RasterDefaults.GetGlobalMemoryThresholds and RasterDefaults.SetGlobalMemoryThresholds to get or set the conventional memory restrictions used when allocating new RasterImage objects.

GlobalMemoryThresholds contains the following members:

Member	Description
MaximumConventionalMemory	Maximum size of continuous conventional memory in bytes to use when creating a RasterImage object.

Example

using Leadtools; 
using Leadtools.Codecs; 
using LeadtoolsExamples.Common; 
 
public static void MaximumConventionalMemoryTest() 
{ 
   Console.WriteLine("maximumConventionalMemoryTest"); 
   string imageFileName = @"C:\Users\Public\Documents\LEADTOOLS Images\Leadtools.pdf"; 
 
   long size = 0; 
 
   using (var rasterCodecs = new RasterCodecs()) 
   { 
      using (var rasterImage = rasterCodecs.Load(imageFileName, 1)) 
      { 
         Console.WriteLine("loaded, size:{0} Conventional:{1} Disk:{2}", 
            rasterImage.DataSize, rasterImage.IsConventionalMemory, rasterImage.IsDiskMemory); 
         Debug.Assert(rasterImage.IsConventionalMemory); 
         Debug.Assert(!rasterImage.IsDiskMemory); 
 
         size = rasterImage.DataSize; 
      } 
 
      // Set maximum conventional size to half of the bitmap's and re-check. Should be disk 
      GlobalMemoryThresholds thresholds = RasterDefaults.GetGlobalMemoryThresholds(); 
      Console.WriteLine("Original GlobalMemoryThresholds.MaximumConventionalMemory = {0}", thresholds.MaximumConventionalMemory); 
      thresholds.MaximumConventionalMemory = size / 2; 
      RasterDefaults.SetGlobalMemoryThresholds(thresholds); 
      thresholds = RasterDefaults.GetGlobalMemoryThresholds(); 
      Console.WriteLine("New      GlobalMemoryThresholds.MaximumConventionalMemory = {0}", thresholds.MaximumConventionalMemory); 
 
      using (var rasterImage = rasterCodecs.Load(imageFileName, 1)) 
      { 
         Console.WriteLine("loaded, size:{0} Conventional:{1} Disk:{2}", 
               rasterImage.DataSize, rasterImage.IsConventionalMemory, rasterImage.IsDiskMemory); 
         Debug.Assert(!rasterImage.IsConventionalMemory); 
         Debug.Assert(rasterImage.IsDiskMemory); 
      } 
 
      // Now set to -1 and try to create a 20 by 20 at 32-BPP inch bitmap, should be disk 
      // Reset 
      RasterDefaults.SetGlobalMemoryThresholds(GlobalMemoryThresholds.Default); 
      thresholds = RasterDefaults.GetGlobalMemoryThresholds(); 
      Console.WriteLine("Original GlobalMemoryThresholds.MaximumConventionalMemory = {0}", thresholds.MaximumConventionalMemory); 
      thresholds.MaximumConventionalMemory = -1; 
      RasterDefaults.SetGlobalMemoryThresholds(thresholds); 
      thresholds = RasterDefaults.GetGlobalMemoryThresholds(); 
      Console.WriteLine("New      GlobalMemoryThresholds.MaximumConventionalMemory = {0}", thresholds.MaximumConventionalMemory); 
 
      using (var rasterImage = new RasterImage( 
         RasterMemoryFlags.Conventional, 
         20 * 300, 
         20 * 300, 
         32, 
         RasterByteOrder.Bgr, 
         RasterViewPerspective.TopLeft, 
         null, 
         null, 
         0)) 
      { 
         Console.WriteLine("created, size:{0} Conventional:{1} Disk:{2}", 
               rasterImage.DataSize, rasterImage.IsConventionalMemory, rasterImage.IsDiskMemory); 
         Debug.Assert(!rasterImage.IsConventionalMemory); 
         Debug.Assert(rasterImage.IsDiskMemory); 
      } 
 
      // finally create 8.5 by 11 at 300 DPI, should be conv 
      using (var rasterImage = new RasterImage( 
         RasterMemoryFlags.Conventional, 
         (int)(8.5 * 300), 
         11 * 300, 
         32, 
         RasterByteOrder.Bgr, 
         RasterViewPerspective.TopLeft, 
         null, 
         null, 
         0)) 
      { 
         Console.WriteLine("created, size:{0} Conventional:{1} Disk:{2}", 
                  rasterImage.DataSize, rasterImage.IsConventionalMemory, rasterImage.IsDiskMemory); 
         Debug.Assert(rasterImage.IsConventionalMemory); 
         Debug.Assert(!rasterImage.IsDiskMemory); 
      } 
   } 
 
   // Reset 
   RasterDefaults.SetGlobalMemoryThresholds(GlobalMemoryThresholds.Default); 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing 
 
Public Shared Sub MaximumConventionalMemoryTest() 
   Console.WriteLine("maximumConventionalMemoryTest") 
   Dim imageFileName As String = "C:\Users\Public\Documents\LEADTOOLS Images\Leadtools.pdf" 
 
   Dim size As Long = 0 
 
   Using rasterCodecs As New RasterCodecs() 
      Using rasterImage As RasterImage = rasterCodecs.Load(imageFileName, 1) 
         Console.WriteLine("loaded, size:{0} Conventional:{1} Disk:{2}", 
         rasterImage.DataSize, rasterImage.IsConventionalMemory, rasterImage.IsDiskMemory) 
         Debug.Assert(rasterImage.IsConventionalMemory) 
         Debug.Assert(Not rasterImage.IsDiskMemory) 
 
         size = rasterImage.DataSize 
      End Using 
 
      ' Set maximum conventional size to half of the bitmap's and re-check. Should be disk 
      Dim thresholds As GlobalMemoryThresholds = RasterDefaults.GetGlobalMemoryThresholds() 
      Console.WriteLine("Original GlobalMemoryThresholds.MaximumConventionalMemory = {0}", thresholds.MaximumConventionalMemory) 
      thresholds.MaximumConventionalMemory = CType(size / 2, Long) 
      RasterDefaults.SetGlobalMemoryThresholds(thresholds) 
      thresholds = RasterDefaults.GetGlobalMemoryThresholds() 
      Console.WriteLine("New      GlobalMemoryThresholds.MaximumConventionalMemory = {0}", thresholds.MaximumConventionalMemory) 
 
      Using rasterImage As RasterImage = rasterCodecs.Load(imageFileName, 1) 
         Console.WriteLine("loaded, size:{0} Conventional:{1} Disk:{2}", 
            rasterImage.DataSize, rasterImage.IsConventionalMemory, rasterImage.IsDiskMemory) 
         Debug.Assert(Not rasterImage.IsConventionalMemory) 
         Debug.Assert(rasterImage.IsDiskMemory) 
 
      End Using 
 
      ' Now set to -1 And try to create a 20 by 20 at 32-BPP inch bitmap, should be disk 
      ' Reset 
      RasterDefaults.SetGlobalMemoryThresholds(GlobalMemoryThresholds.Default) 
      thresholds = RasterDefaults.GetGlobalMemoryThresholds() 
      Console.WriteLine("Original GlobalMemoryThresholds.MaximumConventionalMemory = {0}", thresholds.MaximumConventionalMemory) 
      thresholds.MaximumConventionalMemory = -1 
      RasterDefaults.SetGlobalMemoryThresholds(thresholds) 
      thresholds = RasterDefaults.GetGlobalMemoryThresholds() 
      Console.WriteLine("New      GlobalMemoryThresholds.MaximumConventionalMemory = {0}", thresholds.MaximumConventionalMemory) 
 
      Using rasterImage As New RasterImage( 
         RasterMemoryFlags.Conventional, 
         20 * 300, 
         20 * 300, 
         32, 
         RasterByteOrder.Bgr, 
         RasterViewPerspective.TopLeft, 
         Nothing, 
         Nothing, 
         0) 
         Console.WriteLine("created, size:{0} Conventional:{1} Disk:{2}", 
            rasterImage.DataSize, rasterImage.IsConventionalMemory, rasterImage.IsDiskMemory) 
         Debug.Assert(Not rasterImage.IsConventionalMemory) 
         Debug.Assert(rasterImage.IsDiskMemory) 
      End Using 
 
      ' finally create 8.5 by 11 at 300 DPI, should be conv 
      Using rasterImage As New RasterImage( 
         RasterMemoryFlags.Conventional, 
         CInt(8.5 * 300), 
         11 * 300, 
         32, 
         RasterByteOrder.Bgr, 
         RasterViewPerspective.TopLeft, 
         Nothing, 
         Nothing, 
         0) 
         Console.WriteLine("created, size:{0} Conventional:{1} Disk:{2}", 
               rasterImage.DataSize, rasterImage.IsConventionalMemory, rasterImage.IsDiskMemory) 
         Debug.Assert(rasterImage.IsConventionalMemory) 
         Debug.Assert(Not rasterImage.IsDiskMemory) 
 
      End Using 
   End Using 
 
   ' Reset 
   RasterDefaults.SetGlobalMemoryThresholds(GlobalMemoryThresholds.Default) 
End Sub

Requirements

Target Platforms

Reference

Leadtools Namespace

Download our FREE evaluation

Help Version 20.0.2020.4.2

Leadtools Assembly

Introduction

Getting Started

Namespaces

Leadtools Namespace

Leadtools.ImageProcessing Namespace

Assemblies