このページでは

C

MCU.Config.maxResourceCacheSize

ランタイム・アロケーション・タイプの最大リソース・キャッシュ・サイズを定義します。

説明

このプロパティを使用して、指定されたランタイム・アロケーション・タイプの最大リソース・キャッシュ・サイズを定義します。このプロパティには、バイト単位の最大キャッシュ・サイズを表す int 値、または各AllocationType のキャッシュ・サイズのリストを設定できます。

リソース・キャッシュは、"OnDemand" キャッシュ・ポリシーを持つリソースをキャッシュするために使用されます。これには、すべての圧縮リソースと "OnDemand "ポリシーのリソースが含まれます。このようなリソースが表示されると、リソースのランタイム・アロケーション・タイプに応じてリソース・キャッシュにコピーされます。キャッシュが満杯になると、新しいリソースを収容するために、使用されずに最も長い間キャッシュにあったリソースが削除されます。

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

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

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

注: 実際のバッファサイズは、内部的な簿記を考慮するため、MCU.Config.maxResourceCacheSize で指定された値よりも若干大きくなる可能性があります。

使用法

このプロパティは、メイン・アプリケーションの.qmlproject ファイル、またはターゲット・プラットフォームのBoardDefaults.qmlprojectconfig で受け付ける。整数または配列の配列を指定します。

コード例

MCU.Config {
    // single value
    // maxResourceCacheSize: CacheSize
    maxResourceCacheSize: 3000
}
MCU.Config {
    // list of cache sizes per (optional) allocation type
    // maxResourceCacheSize: [ [ CacheSize, (AllocationType) ] , ... ]
    maxResourceCacheSize: [
        [1000, 128],
        [2000, 129],
        [3000]
    ]
}

から

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

リソースの管理ImageFiles.MCU.resourceCachePolicyImageFiles.MCU.resourceRuntimeAllocationTypequl_set_maximum_resource_cache_sizeも参照してください


詳細はこちら。