Index

CDTEngineV8

TypesetterRealloc

This function clears and, optionally, reallocates memory that the Typesetter uses for its bitmap and transformation cache.

Parameters

ParameterDescription

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.

Return Value

If successful, the return value is 1. Otherwise, the function returns 0.

Comments

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.



 

Index