画像のキャッシュへの読み込み
| storages | キャッシュに入れたい画像ストレージ名を配列(Arrayクラスのオブジェクト)で渡します。 |
| limitbytes | このメソッドの呼び出しで使用するキャッシュ容量の制限値をバイト単位で指定します。 |
| timeout | タイムアウト ( 時間制限 ) を ms 単位で指定します。0 を指定すると無制限となります。 |
このメソッドは、指定された画像をキャッシュに入れようと試行します。
ただし、このメソッドはキャッシュに画像を入れようと努力はしますが、実際に画像がキャッシュにはいる保証はありません。
画像キャッシュの制限値をすぎたり、タイムアウトすると画像読み込みを中断します。
画像は、storages引数に指定した物のうち、最初に書いた物ほどキャッシュに入る可能性が大きくなります ( 優先されます )。
すでに指定された画像がキャッシュに入っていた場合は、キャッシュ中での生存の順位を引き上げるだけの動作をします。
このメソッドは、画像読み込み中のエラーはすべて無視します。
現バージョンでは、このメソッドでキャッシュに入れることのできる画像は、通常Layer.loadImages で読み込み可能な画像で、かつカラーキーを指定しない画像です ( アルファチャンネル付き画像は問題ありません )。
ユニバーサルトランジションのルール画像や、領域画像は読み込む動作はしますが、キャッシュとして有効なデータにはなりません ( 読み込んだデータは無駄になります ) ので、指定しないようにしてください。
画像がキャッシュで使用するバイト数については System.graphicCacheLimit を参照してください。