Public Property TiledThreshold As Integer

Visual Basic (Usage)	Copy Code
Dim instance As RasterMemoryThreshold Dim value As Integer   instance.TiledThreshold = value   value = instance.TiledThreshold

public int TiledThreshold {get; set;}

public:
property int TiledThreshold {
   int get();
   void set (int value);
}

Return Value

If the amount of free memory falls below this threshold, all images will be allocated as tiled. The exception is when the image size is smaller than the tile size – in this case, the image will be allocated in conventional memory.

Values less than –100 are not allowed.

If the TiledThreshold value is < 0, it represents the required number of free bytes.

If the TiledThreshold value is 0, then there is no minimum requirement for free memory, all images are allocated as conventional if there is enough memory.

Tiled images use a combination of memory tiles and disk tiles. When an image is allocated, LEADTOOLS decides how many conventional memory tiles and how many disk tiles should be allocated. The TiledThreshold value influences the number of conventional tiles allocated as follows: the toolkit will not allocate any more conventional tiles when the amount of memory falls below TiledThreshold. When the amount of memory falls below TiledThreshold, disk tiles will be allocated and several swap buffers might back these disk tiles. For each image there will be at least one swap tile.

If the TiledThreshold value is > 0, then it represents a percentage of free memory out of the total memory. For example, when you pass –20, tiled images will be used when the amount of free physical and swap memory will drop below 20% of the total memory.

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

Reference