Class Cache

Namespace: Aspose.Imaging
Assembly: Aspose.Imaging.dll (25.7.0)

Contains cache settings.

public static class Cache
   {
       private static readonly Dictionary<string, object> _cache;
       static Cache()
       {
           _cache = new Dictionary<string, object>();
       }
       public static void Add(string key, object value)
       {
           lock (_cache)
           {
               if (!_cache.ContainsKey(key))
               {
                   _cache[key] = value;
               }
           }
       }
       public static T Get<T>(string key) where T : new()
       {
           lock (_cache)
           {
               if (_cache.ContainsKey(key))
               {
                   return (T)_cache[key];
               }
               else
               {
                   return new T();
               }
           }
       }
       public static void Remove(string key)
       {
           lock (_cache)
           {
               _cache.Remove(key);
           }
       }
   }

Inheritance

object ← Cache

Inherited Members

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Examples

This example demonstrates the use of Aspose.Imaging.Cache

Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
   Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.ExactReallocateOnly = false;
   long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
   options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
   options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
   using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
   {
       Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
       for (int i = 0; i < pixels.Length; i++)
       {
           pixels[i] = Aspose.Imaging.Color.White;
       }
       image.SavePixels(image.Bounds, pixels);
       long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
       long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   }
   l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;

Properties

AllocatedDiskBytesCount

Gets the allocated disk bytes count.

public static long AllocatedDiskBytesCount
   {
      get;
   }

Property Value

long

Examples

This example demonstrates the use of Aspose.Imaging.Cache

Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
   Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.ExactReallocateOnly = false;
   long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
   options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
   options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
   using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
   {
       Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
       for (int i = 0; i < pixels.Length; i++)
       {
           pixels[i] = Aspose.Imaging.Color.White;
       }
       image.SavePixels(image.Bounds, pixels);
       long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
       long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   }
   l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;

AllocatedMemoryBytesCount

Gets the allocated in-memory bytes count.

public static long AllocatedMemoryBytesCount
{
    get;
}

Property Value

long

Examples

This example demonstrates the use of Aspose.Imaging.Cache

Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
   Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.ExactReallocateOnly = false;
   long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
   options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
   options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
   using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
   {
       Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
       for (int i = 0; i < pixels.Length; i++)
       {
           pixels[i] = Aspose.Imaging.Color.White;
       }
       image.SavePixels(image.Bounds, pixels);
       long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
       long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   }
   l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;

CacheFolder

Gets or sets the cache folder.

public static string CacheFolder
    {
        get;
        set;
    }

Property Value

string

CacheType

Gets or sets the cache scheme used.

public static CacheType CacheType
    {
        get;
        set;
    }

Property Value

CacheType

Examples

This example demonstrates the use of Aspose.Imaging.Cache

Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
   Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.ExactReallocateOnly = false;
   long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
   options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
   options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
   using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
   {
       Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
       for (int i = 0; i < pixels.Length; i++)
       {
           pixels[i] = Aspose.Imaging.Color.White;
       }
       image.SavePixels(image.Bounds, pixels);
       long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
       long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   }
   l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;

ExactReallocateOnly

Gets or sets a value indicating whether reallocation should be exact or not. If reallocation is non exact the performance should be higher.

public static bool ExactReallocateOnly
    {
        get;
        set;
    }

Property Value

bool

Examples

This example demonstrates the use of Aspose.Imaging.Cache

Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
   Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.ExactReallocateOnly = false;
   long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
   options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
   options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
   using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
   {
       Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
       for (int i = 0; i < pixels.Length; i++)
       {
           pixels[i] = Aspose.Imaging.Color.White;
       }
       image.SavePixels(image.Bounds, pixels);
       long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
       long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   }
   l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;

Remarks

The exact reallocation will perform reallocation of additional memory only up to the upper limit specified.When passing upper limit for in-memory during reallocation the cached data will be copied to disk if possible.When passing upper limit for disk memory during reallocation the appropriate exception is thrown.The performance should be higher if this option is turned off as no additional copying will be performed if possible,however this may also lead to pass upper limits specified for memory or disk.

MaxDiskSpaceForCache

Gets or sets the maximum available disk space for cache. The value specified is megabytes count.

public static int MaxDiskSpaceForCache
   {
      get;
      set;
   }

Property Value

int

Examples

This example demonstrates the use of Aspose.Imaging.Cache

Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
   Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.ExactReallocateOnly = false;
   long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
   options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
   options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
   using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
   {
       Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
       for (int i = 0; i < pixels.Length; i++)
       {
           pixels[i] = Aspose.Imaging.Color.White;
       }
       image.SavePixels(image.Bounds, pixels);
       long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
       long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   }
   l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;

Remarks

Value of 0 will consume all available memory and serves as no upper limit.

MaxMemoryForCache

Gets or sets the maximum available memory for cache in memory. The value specified is megabytes count.

public static int MaxMemoryForCache
    {
        get;
        set;
    }

Property Value

int

Examples

This example demonstrates the use of Aspose.Imaging.Cache

Aspose.Imaging.Cache.CacheType = Aspose.Imaging.CacheType.Auto;
   Aspose.Imaging.Cache.MaxDiskSpaceForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.MaxMemoryForCache = 1073741824; // 1 gigabyte
   Aspose.Imaging.Cache.ExactReallocateOnly = false;
   long l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   long l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   Aspose.Imaging.ImageOptions.GifOptions options = new Aspose.Imaging.ImageOptions.GifOptions();
   options.Palette = new ColorPalette(new Aspose.Imaging.Color[] { Aspose.Imaging.Color.Red, Aspose.Imaging.Color.Blue, Aspose.Imaging.Color.Black, Aspose.Imaging.Color.White });
   options.Source = new Aspose.Imaging.Sources.StreamSource(new System.IO.MemoryStream(), true);
   using (Aspose.Imaging.RasterImage image = (Aspose.Imaging.RasterImage)Aspose.Imaging.Image.Create(options, 100, 100))
   {
       Aspose.Imaging.Color[] pixels = new Aspose.Imaging.Color[10000];
       for (int i = 0; i < pixels.Length; i++)
       {
           pixels[i] = Aspose.Imaging.Color.White;
       }
       image.SavePixels(image.Bounds, pixels);
       long diskBytes = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
       long memoryBytes = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;
   }
   l1 = Aspose.Imaging.Cache.AllocatedDiskBytesCount;
   l2 = Aspose.Imaging.Cache.AllocatedMemoryBytesCount;

Remarks

Value of 0 will consume all available memory and serves as no upper limit.

Methods

SetDefaults()

Sets the Aspose.Imaging.Cache settings to defaults.

public static void
      SetDefaults()
   {
   }