Leadtools Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.3.5
TiledThreshold Property
See Also 
Leadtools Namespace > RasterMemoryThreshold Structure : TiledThreshold Property




Gets or sets a value that specifies the minimum amount of free memory required to allow the allocation of conventional images.

Syntax

Visual Basic (Declaration) 
Public Property TiledThreshold As Integer
Visual Basic (Usage)Copy Code
Dim instance As RasterMemoryThreshold
Dim value As Integer
 
instance.TiledThreshold = value
 
value = instance.TiledThreshold
C# 
public int TiledThreshold {get; set;}
Managed Extensions for C++ 
public: __property int get_TiledThreshold();
public: __property void set_TiledThreshold( 
   int value
);
C++/CLI 
public:
property int TiledThreshold {
   int get();
   void set (int value);
}

Return Value

An integer value that specifies the minimum amount of free memory required to allow the allocation of conventional images. Default value is 0.

Example

For an example, refer to RasterDefaults.

Remarks

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.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also