Class: ImageManager

画像ファイルの読み込み、保持(キャッシュ)、管理を行う静的オブジェクト。

読み込みには、キャッシュの方式などが異なる loadXxxx()、reserveXxxx()、requestXxxx() の 3 系統がある。

loadXxxx()

主に使われる、基本的な画像読み込み。
メモリ管理上限( ImageCache.limit )に達すると古い画像からキャッシュが自動で破棄される。
そのため以前読んだ画像が、常にキャッシュされている保証はない。

reserveXxxx()

自動でキャッシュが破棄されることはないのでプリロードに使える。
キャッシュは releaseReservation() によって、明示的に解放できる。
キャッシュの際の reservationId は Utils.generateRuntimeId() メソッドを使って生成すれば ID の衝突を防げる。
バージョン 1.5.0 で導入された機能。

requestXxxx()

まず専用の予約キュー( RequestQueue )に保存され。
予約キューから順に取り出されて画像が読み込まれる。
Game_Interpreter.requestImages() でイベントに含まれる画像の先読みに使われている。
読み込みが終わっていれば、次に loadXxxx() を実行した時に瞬時に使える。
バージョン 1.5.0 で導入された機能。

関連クラス: Bitmap, Graphics, Game_Screen

Properties:

Name	Type	Description
`cache`	CacheMap	[static] キャッシュマップ
`_imageCache`	ImageCache	[static] 画像キャッシュ
`_requestQueue`	RequestQueue	[static] リクエストキュー
`_systemReservationId`	Number	[static] システム予約 ID

Methods

(static) clear ()

RPG ツクール MV の画像キャッシュをクリア。
ブラウザなどが持っているキャッシュがクリアされるわけではない。

(static) clearRequest ()

リクエストをクリア。

(static) isBigCharacter (filename) → {Boolean}

指定したファイル名に’$’がついているか。
‘$’がついている場合は 3×4 のひとキャラ分の画像とみなすのであって、実際大きい(big)かどうかはわからない。

Parameters:

Name	Type	Description
`filename`	String	ファイル名

(static) isObjectCharacter (filename) → {Boolean}

指定したファイル名に’!’がついているか。
‘!’がついている場合は表示際に上にずらさない画像とみなすのであって、実際が物体(object)の画像かどうかはわからない。

Parameters:

Name	Type	Description
`filename`	String	ファイル名

(static) isReady () → {Boolean}

画像のキャッシュが完了しているか。

(static) isZeroParallax (filename) → {Boolean}

指定したファイル名に’!’がついているか。
‘!’がついている場合はずらさない遠景画像とみなす。

Parameters:

Name	Type	Description
`filename`	String	ファイル名

(static) loadAnimation (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/animations/’フォルダから読み込み、指定した色相にずらしスムージングをかけて返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度) (規定値:0)

(static) loadBattleback1 (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/battlebacks1/’フォルダから読み込み、指定した色相にずらしスムージングをかけて返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度) (規定値:0)

(static) loadBattleback2 (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/battlebacks2/’フォルダから読み込み、指定した色相にずらしスムージングをかけて返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度) (規定値:0)

(static) loadBitmap (folder, filename, hue opt, smooth opt) → {Bitmap}

指定したフォルダ・ファイル名の画像をプロジェクトフォルダ以下から読み込み、指定した色相にずらし、指定したスムージングの状態で返す。
色相の変更が必要ない場合 loadBitmap( folder, filename, null, true )　のように、色相に null を渡せば良い。

Parameters:

Name	Type	Attributes	Description
`folder`	String		フォルダ名(‘img/faces/’のように指定する)
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度) (規定値:0)
`smooth`	Boolean	<optional>	スムージングを行うか (規定値:false)

(static) loadCharacter (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/characters/’フォルダから読み込み、指定した色相にずらして返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度) (規定値:0)

(static) loadEmptyBitmap () → {Bitmap}

カラの画像を返す。load とあるが、特にどこからか読み込むわけではない。

(static) loadEnemy (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/enemies/’フォルダから読み込み、指定した色相にずらしスムージングをかけて返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度) (規定値:0)

(static) loadFace (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/faces/’フォルダから読み込み、指定した色相にずらしスムージングをかけて返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度) (規定値:0)

(static) loadNormalBitmap (path, hue) → {Bitmap}

指定したパスの画像をプロジェクトフォルダ以下から読み込み、指定した色相にずらして返す。

Parameters:

Name	Type	Description
`path`	String	パス文字列(‘img/system/Balloon.png’のように記述)
`hue`	Number	色相(360 度)

(static) loadParallax (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/parallaxes/’フォルダから読み込み、指定した色相にずらしスムージングをかけて返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度)

(static) loadPicture (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/pictures/’フォルダから読み込み、指定した色相にずらしスムージングをかけて返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度)

(static) loadSvActor (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/sv_actors/’フォルダから読み込み、指定した色相にずらして返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度)

(static) loadSvEnemy (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/sv_enemies/’フォルダから読み込み、指定した色相にずらしスムージングをかけて返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度)

(static) loadSystem (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/system/’フォルダから読み込み、指定した色相にずらして返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度)

(static) loadTileset (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/tilesets/’フォルダから読み込み、指定した色相にずらして返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度)

(static) loadTitle1 (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/titles1/’フォルダから読み込み、指定した色相にずらしスムージングをかけて返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度)

(static) loadTitle2 (filename, hue opt) → {Bitmap}

指定したファイル名の画像を’img/titles2/’フォルダから読み込み、指定した色相にずらしスムージングをかけて返す。

Parameters:

Name	Type	Attributes	Description
`filename`	String		ファイル名(拡張子.png を除く）
`hue`	Number	<optional>	色相(360 度)

(static) releaseReservation (reservationId)

指定 ID の予約を開放。

Parameters:

Name	Type	Description
`reservationId`	Number	キャッシュ ID

(static) requestAnimation (filename, hue) → {Bitmap}

アニメーションを予約し、画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestBattleback1 (filename, hue) → {Bitmap}

戦闘の背景 1 を予約し、画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestBattleback2 (filename, hue) → {Bitmap}

戦闘の背景 2 を予約し、画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestBitmap (folder, filename, hue, smooth) → {Bitmap}

画像を返す。

Parameters:

Name	Type	Description
`folder`	String	フォルダ名(‘img/faces/’のように指定する)
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)
`smooth`	Boolean	スムージングを行うか

(static) requestCharacter (filename, hue) → {Bitmap}

キャラ画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestEnemy (filename, hue) → {Bitmap}

[敵キャラ]画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestFace (filename, hue) → {Bitmap}

[顔]画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestNormalBitmap (path, hue) → {Bitmap}

通常の画像を返す。

Parameters:

Name	Type	Description
`path`	String	パス文字列(‘img/system/Balloon.png’のように記述)
`hue`	Number	色相(360 度)

(static) requestParallax (filename, hue) → {Bitmap}

マップ背景画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestPicture (filename, hue) → {Bitmap}

画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestSvActor (filename, hue) → {Bitmap}

サイドビュー[アクター]画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestSvEnemy (filename, hue) → {Bitmap}

サイドビュー[敵キャラ]画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestSystem (filename, hue) → {Bitmap}

システム画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestTileset (filename, hue) → {Bitmap}

タイルセット画像を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestTitle1 (filename, hue) → {Bitmap}

タイトル画像 1 を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) requestTitle2 (filename, hue) → {Bitmap}

タイトル画像 2 を返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)

(static) reserveAnimation (filename, hue, reservationId) → {Bitmap}

指定したファイル名の画像を’img/animations/’フォルダから読み込み、指定したキャッシュ ID に登録し、返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)
`reservationId`	Number	キャッシュ ID

(static) reserveBattleback1 (filename, hue, reservationId) → {Bitmap}

指定したファイル名の画像を’img/battlebacks1/’フォルダから読み込み、指定したキャッシュ ID に登録し、返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)
`reservationId`	Number	キャッシュ ID

(static) reserveBattleback2 (filename, hue, reservationId) → {Bitmap}

指定したファイル名の画像を’img/battlebacks2/’フォルダから読み込み、指定したキャッシュ ID に登録し、返す。

Parameters:

Name	Type	Description
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)
`reservationId`	Number	キャッシュ ID

(static) reserveBitmap (folder, filename, hue, smooth, reservationId) → {Bitmap}

指定したフォルダ・ファイル名の画像をプロジェクトフォルダ以下から読み込み、指定した色相にずらし、指定したスムージングの状態で、指定したキャッシュ ID に登録し、返す。

Parameters:

Name	Type	Description
`folder`	String	フォルダ名(‘img/faces/’のように指定する)
`filename`	String	ファイル名(拡張子.png を除く）
`hue`	Number	色相(360 度)
`smooth`	Boolean	スムージングを行うか
`reservationId`	Number	キャッシュ ID