|The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....|
|Home GeoPack GeoMap Class TGeoMap Properties CacheMagLimit|
|See also: Magnification|
TGeoMap provides a caching mechanism to speed up the display of reduced maps. This mechanism creates a reduced map image in memory if the magnification factor of the map is set below the value of CacheMagLimit. Thus the subsequent accesses to the reduced map are accelerated considerably.
However, there is a trade-off between gain in speed and required additional memory. Setting the property CacheMagLimit to high values will allocate considerably more memory (in theory, with CacheMagLimit set to 1.0 the caching mechanism would allocated an additional amount of memory which equals the amount of the original map - which could be several hundred MBytes). The amount of additional memory can be calculated according to the following equation:
Additional Amount = Original Requirements * sqr(CacheMagLimit);
The property CacheMagLimit can be set to values between 0 and 2/3. Values outside this range will be automatically restricted to this interval. Setting CacheMagLimit to 0 turns off caching. By default, CacheMagLimit is set to 2/3 (which means a maximum allocation of additional memory in the range of 45% of the original map requirements).