ImageMap (DoJa 3.5 (APIリファレンス))

イメージを縦横に並べて大きな画像として扱うイメージマップを定義します。

イメージを割り当てる単位をここではセルと呼びます。セルのサイズは固定サイズで、コンストラクタで指定します。セルを縦横に並べてそれぞれにイメージを割り当てることで、ゲームの背景などに適した大きな画像を作成することができます。

どのセルにどのイメージを割り当てるかは、マップデータで指定します。マップデータは byte の一次元配列で、配列のインデックス(index)とセルの座標(x, y)との間には以下の関係があります。

 index = mapWidth * y + x;

例えば、以下のような幅(mapWidth) 10、高さ(mapHeight) 8 のイメージマップの場合、座標 (6, 4) にある X のセルのインデックスは 10 * 4 + 6 = 46 となります。

     0   1   2   3   4   5   6   7   8   9
   +---+---+---+---+---+---+---+---+---+---+
 0 |   |   |   |   |   |   |   |   |   |   |
   +---+---+---+---+---+---+---+---+---+---+
 1 |   |   |   |   |   |   |   |   |   |   |
   +---+---+---+---+---+---+---+---+---+---+
 2 |   |   |   |   |   |   |   |   |   |   |
   +---+---+---+---+---+---+---+---+---+---+
 3 |   |   |   |   |   |   |   |   |   |   |
   +---+---+---+---+---+---+---+---+---+---+
 4 |   |   |   |   |   |   | X |   |   |   |
   +---+---+---+---+---+---+---+---+---+---+
 5 |   |   |   |   |   |   |   |   |   |   |
   +---+---+---+---+---+---+---+---+---+---+
 6 |   |   |   |   |   |   |   |   |   |   |
   +---+---+---+---+---+---+---+---+---+---+
 7 |   |   |   |   |   |   |   |   |   |   |
   +---+---+---+---+---+---+---+---+---+---+

イメージマップにマップデータを設定する際は、マップデータと一緒にイメージの配列を指定します。マップデータの配列の要素には、イメージ配列の中のどのイメージを使用するかをイメージ配列中のインデックスで格納します。マップデータの配列は byte の配列なので、0 から 127 まで最大 128 個のイメージを使用することができます。

マップデータの配列の要素が以下のいずれかの条件を満たす場合、そのセルは描画されません。

配列の要素の値が負の場合
配列の要素の値がイメージの配列の長さ以上の場合
イメージ配列中の対応するイメージが null の場合
イメージ配列中の対応するイメージが dispose されている場合
(この場合は、イメージマップの描画メソッドで例外が発生します)

また、マップの幅および高さに 0 を指定することができますが、その状態ではイメージマップを描画しても何も描画されません。
セルに割り当てられたイメージの幅および高さがセルの幅および高さよりも大きい場合は、セルの幅および高さを超える部分は描画されません。また、セルに割り当てられたイメージの幅および高さがセルの幅および高さよりも小さい場合は、セル内のイメージの幅および高さを超える部分には何も描画されません。

コンストラクタの概要
`protected`	`ImageMap()` アプリケーションが直接このコンストラクタを呼び出してオブジェクトを生成することはできません。
	`ImageMap(int cellWidth, int cellHeight)` セルの幅と高さを指定してイメージマップを生成します。
	`ImageMap(int cellWidth, int cellHeight, int mapWidth, int mapHeight, byte[] data, Image[] images)` セルの幅と高さとマップデータを指定してイメージマップを生成します。

メソッドの概要
`void`	`moveWindowLocation(int dx, int dy)` イメージマップの中で表示する領域の幅と高さを変えずに座標だけを相対位置指定で設定します。
`void`	`setImageMap(int mapWidth, int mapHeight, byte[] data, Image[] images)` マップデータを設定します。
`void`	`setWindow(int x, int y, int width, int height)` イメージマップの中で表示する領域を設定します。
`void`	`setWindowLocation(int x, int y)` イメージマップの中で表示する領域の幅と高さを変えずに座標だけを設定します。

クラス Object から継承したメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

com.nttdocomo.ui クラス ImageMap

ImageMap

ImageMap

ImageMap

setImageMap

setWindow

setWindowLocation

moveWindowLocation

com.nttdocomo.ui
クラス ImageMap