MemoryTiledThreshold property (ILEADRaster)

Remarks

Gets or sets the Minimum amount of free memory required to allow the allocation of conventional bitmaps (default 0). If the amount of free memory falls below this threshold, all bitmaps will be allocated as tiled. The exception is when the bitmap size is smaller than the tile size – in this case, the bitmap will be allocated in conventional memory.

Values less than –100 are not allowed.

If this property is > 0, it represents the required number of free bytes.

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

Tiled bitmaps use a combination of memory tiles and disk tiles. When a bitmap is allocated, LEADTOOLS decides how many conventional memory tiles and how many disk tiles should be allocated. This property 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 the value of this property. When the amount of memory falls below the value of this property, disk tiles will be allocated and several swap buffers might back these disk tiles. For each bitmap there will be at least one swap tile.

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

The value of this property is ignored if the MemoryFlags property does not contain MEMORY_TILED_THRESHOLD.

See Also