説明

このプロパティは、希望するグリフレイアウトキャッシュのサイズを指定します。このキャッシュには、グリフのシェーピングおよびレイアウトデータが含まれます。

設定するキャッシュサイズは、アプリケーションで表示される最も長い文字列が収まる十分な大きさであることを確認してください。理想的には、キャッシュには同時に表示されるすべての文字列を収容できる必要があります。これにより、キャッシュエントリの削除や再作成を回避できます。最適なサイズを決定するには、試行錯誤が必要になる場合があります。 割り当てに失敗した場合、エラーコードはQulError_GlyphLayoutCache_GlyphDataDoesNotFitInCache となります。

グリフレイアウトキャッシュ用のメモリは、Qul::PlatformInterface::MemoryAllocator::GlyphLayoutCache を通じてプラットフォーム層から割り当てられます。単一のメモリバッファが事前に割り当てられ、グリフレイアウトキャッシュによって内部的に管理されます。内部的な管理処理を考慮するため、実際のバッファサイズはMCU.Config.glyphsLayoutCacheSize で指定された値よりわずかに大きくなる場合があります。

キャッシュはこのバッファ内でのエントリの割り当てを管理し、LRU戦略を用いてエントリを再利用します。

デフォルト値は 24 KB です。

使用方法

このプロパティは、メインアプリケーションの `.qmlproject ` ファイルで指定できます。引数には整数を指定します。

コード例:

MCU.Config {
    glyphsLayoutCacheSize: 30000
}

古い（qmlproject 以外の）ビルド設定を使用している場合、CMake 定義 `GLYPHS_LAYOUT_CACHE_SIZE ` を希望の値に設定することで、キャッシュサイズを構成できます。

このプロパティは

このプロパティは、QmlProject API 1.12で導入されました。