概要

qul_set_maximum_resource_cache_size(<target>
                                    CACHE_SIZE <cache_size_in_bytes>
                                    [RUNTIME_ALLOCATION_TYPE <runtime_allocation_type>])

説明

このコマンドは、指定されたランタイム割り当てタイプの最大リソースキャッシュサイズを設定します。

リソース・キャッシュは、"OnDemand "キャッシュ・ポリシーでリソースをキャッシュするために使用されます。これには、すべての圧縮リソースと、QUL_RESOURCE_CACHE_POLICY プロパティが明示的に "OnDemand" に設定されているリソースが含まれます。このようなリソースが表示されると、リソースのランタイム・アロケーション・タイプに対応するリソース・キャッシュにコピーされます。その時点でリソース・キャッシュが満杯になっている場合、新しいリソースのためのスペースを確保するために、使用されずにキャッシュに最長時間残っているリソースが追い出されます。

最大リソース・キャッシュ・サイズが、"OnDemand "キャッシュ・ポリシーを持つ最大のリソースのサイズよりも大きいことを確認してください。理想的な最大リソースキャッシュサイズは、フレームの更新ごとに画像リソースを解凍したりRAMにコピーしたりする必要がないように、同時に表示される可能性のあるすべての "OnDemand "画像を収めることができるサイズであるべきです。

例えば、色深度32bppの400x300の画像は、最大480,000バイトのRAMを占有します。このような画像が同時に2つ表示され、そのキャッシュ・ポリシーが "OnDemand "である場合、妥当な最大リソース・キャッシュ・サイズは960,000バイトになります：

# Assuming that no custom runtime allocation type has been set for the images
qul_set_maximum_resource_cache_size(<target> CACHE_SIZE 960000)

オプション

CACHE_SIZE オプションは必須で、最大キャッシュサイズをバイト単位で指定します。

RUNTIME_ALLOCATION_TYPE オプシ ョ ンは整数型で、 その値は0 以上、256 未満でなければな り ません。 こ れは、 個々の リ ソ ース ご と に設定 さ れてい る QUL_RESOURCE_RUNTIME_ALLOCATION_TYPE に対応 し てい ます。こ の値は、 プ ラ ッ ト フ ォームで既知のmemory allocator types と 一致す る 必要があ り ます。 範囲[128,255] は、 ユーザー定義のカ ス タ ム割 り 当て専用です。

RUNTIME_ALLOCATION_TYPE オプションが指定されない場合、デフォルトでImage enum値が使用されます。

内部的には、リソースキャッシュサイズは収集され、JSONファイルでqulrccツールリソースコンパイラーに渡されます。qulrcc tool 、Qul::Coreライブラリーが各ランタイムアロケーションタイプのキャッシュサイズを知るために必要なシンボルを含むC++ファイルが生成されます。