com.nttdocomo.ui
クラス Palette

Object
  |
  +--com.nttdocomo.ui.Palette

public class Palette
extends Object

パレットを定義します。 パレットには任意の数の色を保持することができます。

複数の PalettedImage オブジェクトに対して同一のパレットを設定した場合は、 パレットの色が全ての PalettedImage オブジェクトの描画に反映されます。

導入されたバージョン:
DoJa-3.5
関連項目:
PalettedImage

コンストラクタの概要
Palette(int n)
           エントリの数を指定してパレットオブジェクトを生成します。
Palette(int[] colors)
           エントリの値を含む配列を指定してパレットオブジェクトを生成します。
 
メソッドの概要
 int getEntry(int index)
           パレットのエントリの色を取得します。
 int getEntryCount()
           パレットのエントリの数を取得します。
 void setEntry(int index, int color)
           パレットのエントリに色を設定します。
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

Palette

public Palette(int n)

エントリの数を指定してパレットオブジェクトを生成します。 それぞれのエントリは、黒を表す機種依存の値(Graphics.getColorOfName(Graphics.BLACK) の値)で初期化されます。

PalettedImage が保持するイメージ情報は GIF 画像から生成されるため、 パレット情報の色数は最大 256 色です。 したがって、エントリの数に 256 より大きい値を指定しても無意味です。 PalettedImage の描画の際に 256 番以降のインデックスのエントリが参照されることはありません。

パラメータ:
n - パレットのエントリの数を指定します。
例外:
IllegalArgumentException - 引数 n に 0 以下の値が指定された場合に発生します。

Palette

public Palette(int[] colors)

エントリの値を含む配列を指定してパレットオブジェクトを生成します。 生成されたパレットオブジェクトは、 引数で指定された配列の長さと同じ数のエントリを持ちます。 このコンストラクタでは内部で引数に渡された配列の値をコピーする処理が行われるため、 パレットオブジェクトの生成後に引数に渡された配列の値を書換えても、 変更は反映されません。

PalettedImage が保持するイメージ情報は GIF 画像から生成されるため、 パレット情報の色数は最大 256 色です。 したがって、エントリの値を含む配列として 256 より長い配列を指定しても無意味です。 PalettedImage の描画の際に 256 番以降のインデックスのエントリが参照されることはありません。

パラメータ:
colors - パレットのエントリの値を含む配列を指定します。 配列の要素には Graphics.getColorOfRGB(int, int, int) メソッド等で返される値を指定します。
例外:
NullPointerException - 引数 colors に null が指定された場合に発生します。
IllegalArgumentException - 引数 colors の要素数が 0 の場合に発生します。
IllegalArgumentException - 引数 colors のいずれかの要素が色として不正な値の場合に発生します。 第 256 番以降のインデックスの要素についても、 不正な値かどうかをチェックします。
メソッドの詳細

getEntryCount

public int getEntryCount()
パレットのエントリの数を取得します。

戻り値:
パレットのエントリの数を返します。

setEntry

public void setEntry(int index,
                     int color)
パレットのエントリに色を設定します。

パラメータ:
index - 色を設定するエントリのインデックスを指定します。
color - パレットのエントリに設定する色を指定します。 色は Graphics.getColorOfRGB(int, int, int) メソッド等で返される値を指定します。
例外:
ArrayIndexOutOfBoundsException - 引数 index に負の値またはエントリの数以上の値が指定された場合に発生します。
IllegalArgumentException - 引数 color に不正な値が指定された場合に発生します。 第 256 番以降のインデックスが指定された場合も、 不正な値かどうかをチェックします。

getEntry

public int getEntry(int index)
パレットのエントリの色を取得します。

パラメータ:
index - 色を取得するエントリのインデックスを指定します。
戻り値:
パレットのエントリの色を返します。
例外:
ArrayIndexOutOfBoundsException - 引数 index に負の値またはエントリの数以上の値が指定された場合に発生します。


NTT DoCoMo,Inc.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ(その他に許諾者がある場合は当該許諾者も含めて)の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

「iモード」、「iアプリ/アイアプリ」、「i-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。