Kanzi Engine が未使用のリソースをどのように処理するかを設定する

リソースが使用されていない場合、Kanzi Engine は ResourceManager::purge を呼び出すまでメモリに保持します。各リソースごとに ResourceManager::purge を呼び出す際に、Kanzi Engine が未使用のリソースをどのように処理するかを設定することができます。また、プロジェクト全体のリソースに対して設定することも可能です。

ResourceManager::setDefaultMemoryStrategy を interop::MemoryStrategy::OptimizeMemory に設定することで、使用されていないリソースを Kanzi Engine がただちにメモリから削除するように設定することもできます。

プロジェクト全体で Kanzi Engine が未使用のリソースをどのように処理するかを設定する

プロジェクト全体で Kanzi Engine が ResourceManager::purge を呼び出す際に未使用のリソースをどのように処理するかを設定するには、メインメニューで Project > Properties を選択し、Properties で設定します。

  • Resource Keep Alive Behavior プロパティは、Kanzi Engine がすべての未使用リソースをどのように処理するかを設定します。

    • Allow unload if unused は、リソースが使用されなくなったときに削除します。

    • Keep alive は、リソースがもう使用されていない場合でもメモリに保持するためです。

  • Material Type Keep Alive Behavior プロパティは、Kanzi Engine が未使用のマテリアルタイプをどのように処理するかを設定します。

    • Allow unload if unused は、使用されていないリソースを自動的に削除します。

    • Keep alive は、リソースがもう使用されていない場合でもメモリに保持するためです。

    • Project setting が Resource Keep Alive Behavior プロパティに設定された値を使用するようにします。

この設定は、Keep Alive Behavior プロパティを個別に設定していないすべてのリソースに適用されます。

../../_images/project-properties-myproject.png ../../_images/keep-alive-properties.png

Kanzi Engine が個々の未使用リソースをどのように処理するかを設定する

Kanzi Engine が ResourceManager::purge を呼び出したときに個々の未使用リソースをどのように処理するかを設定するには、Library でリソースを選択し、Properties で Keep Alive Behavior プロパティを追加して設定します。

../../_images/add-keep-alive-behavior-property.png ../../_images/set-keep-alive-behavior-property.png

Kanzi Engine が未使用のリソースをAPIでどのように処理するかを設定するには、Resource::isKeepAlive と Resource::setKeepAlive を使用します。

関連項目

リソース管理 (Resource management)

プロジェクトで使用していないリソースとプレハブを削除する