Description

Sets the size, in bytes, of the glyph layout cache, which holds glyph shaping and layout data. The cache size must be at least as big as the largest single text the application displays, including multi-paragraph text. Ideally, make it large enough to hold all text visible at the same time, so entries are not evicted and recreated. Finding the optimal size may take some trial and error. The default is 24 KB.

QUL_GLYPHS_LAYOUT_CACHE_EXHAUSTION_POLICY selects what happens if a text is larger than the whole cache, which is a sizing error: by default the text is not rendered and a throttled sizing hint is logged.

The memory for the glyph layout cache is allocated from the platform layer via Qul::PlatformInterface::MemoryAllocator::GlyphLayoutCache. A single memory buffer is preallocated and managed internally by the glyph layout cache. The actual buffer size may be slightly larger than the value of this property, to account for internal bookkeeping. The cache manages entry allocations within this buffer, recycling entries using an LRU strategy.

Example

set_target_properties(<Executable Target> PROPERTIES
    QUL_GLYPHS_LAYOUT_CACHE_SIZE <size in bytes>
)