This function clears and, optionally, reallocates memory that the Typesetter uses for its bitmap and transformation cache.
Parameter | Description |
---|---|
cache_bitmap_bytes |
New size of the bitmap cache in RAM, in bytes. A negative value indicates that this cache setting should remain the same. |
cache_bitmap_items |
New value for the maximum number of bitmaps to store in the bitmap cache at the same time. A negative value indicates that this cache setting should remain the same. |
cache_transform_items |
If positive, new value for the maximum number of transformations to store in the transformation cache at the same time. A negative value indicates that this cache setting should remain the same. |
If successful, the return value is 1. Otherwise, the function returns 0.
The bitmap cache holds grayscale bitmap images of glyphs and characters that are rasterized using D-Type Rasterizer. Its limits are defined by the total amount of memory for the bitmap images and the maximum number of bitmap images to hold in memory at the same time.
The transformation cache holds frequently used font transformations and works in conjunction with the bitmap cache. Each transformation has its own sub-cache in the bitmap cache.
The process of reading, storing and clearing bitmaps and transformations from/to the cache is a fully automated operation which is under exclusive control of the Typesetter. In a typical scenario there is no need for applications to use this function. However, this function may be useful to those applications that wish to change/reconfigure their cache settings during run-time.