com.nttdocomo.opt.ui
クラス PalettedImage

Object
  |
  +--com.nttdocomo.ui.Image
        |
        +--com.nttdocomo.opt.ui.PalettedImage

推奨されていません。 パレットを設定できるイメージを使用する場合は基本 API の com.nttdocomo.ui.PalettedImage クラスを使用してください。

public class PalettedImage
extends com.nttdocomo.ui.Image

パレットを設定できるイメージを定義します。 PalettedImageのオブジェクトはイメージの情報とパレットの情報を別々に持ち、パレットを後から入れ替えることによって、色違いの画像を描画することができます。
PalettedImageがどの描画メソッドで使用できるのかは機種依存です。 PalettedImageに対応していないメソッドの引数にPalettedImageオブジェクトを指定した場合には、UIException(UNSUPPORTED_FORMAT)となります。

端末によってサポートされていない場合があります。未サポートの場合、メソッドが呼び出された時点でUnsupportedOperationExceptionを発生します。

[DoJa-3.0]
基本 API の中で Image オブジェクトを引数に取るメソッドが PalettedImage に対応しているかどうかは機種依存です。 PalettedImage に対応していないメソッドの引数に PalettedImage オブジェクトを指定して呼び出した場合、 特に例外は発生しませんが、描画内容については機種依存となります。

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

コンストラクタの概要
protected PalettedImage()
          推奨されていません。  アプリケーションが直接このクラスのインスタンスを生成することはできません。
 
メソッドの概要
static PalettedImage createPalettedImage(byte[] data)
          推奨されていません。  パレットを設定できるイメージを生成します。
 com.nttdocomo.ui.Graphics getGraphics()
          推奨されていません。  このクラスのインスタンスに対して呼び出すことはできません。
 Palette getPalette()
          推奨されていません。  パレットを取得します。
 void setPalette(Palette palette)
          推奨されていません。  パレットを設定します。
 
クラス com.nttdocomo.ui.Image から継承したメソッド
createImage, createImage, dispose, getHeight, getWidth
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

PalettedImage

protected PalettedImage()
推奨されていません。 
アプリケーションが直接このクラスのインスタンスを生成することはできません。

メソッドの詳細

createPalettedImage

public static PalettedImage createPalettedImage(byte[] data)
推奨されていません。 
パレットを設定できるイメージを生成します。 GIF 画像のバイナリデータからイメージ情報とパレットオブジェクトが生成されます。 この時生成されるパレットオブジェクトは、GIFのヘッダに記録されているカラーテーブルと同順・同サイズのものとなります。 イメージ情報は最大256色までのインデックスカラー表現で格納され、描画時には現在設定されているパレット情報を用いて色を復元しながら描画を行います。
createPalettedImageで取得されたパレットのサイズ(元のGIF画像の色数)は取得されたPalettedImageオブジェクトに記録され、以後この色数に満たないパレットを設定することはできません。
なお、アニメーションGIFを指定した場合の動作は機種依存です。 また、元のGIF画像が透明色ありのGIFだった場合の動作も機種依存となります。

パラメータ:
data - イメージのデータを指定します。GIF画像のバイナリデータがそのまま格納されたバイト配列を指定します。
戻り値:
パレットを設定できるイメージを返します。
例外:
NullPointerException - 引数 data に null が指定された場合に発生します。
com.nttdocomo.ui.UIException - 引数 data に不正なデータが指定された場合に発生します(UNSUPPORTED_FORMAT)。

setPalette

public void setPalette(Palette palette)
推奨されていません。 
パレットを設定します。 本メソッド内部では、Paletteオブジェクトへの参照がコピーされます。 したがって、本メソッド実行後に当該PaletteオブジェクトのsetEntryメソッドを呼び出せば、次の描画時にはPaletteの変更が反映されます。

パラメータ:
palette - パレットオブジェクトを指定します。
例外:
NullPointerException - 引数 palette に null が指定された場合に発生します。

getPalette

public Palette getPalette()
推奨されていません。 
パレットを取得します。

戻り値:
パレットオブジェクトを返します。

getGraphics

public final com.nttdocomo.ui.Graphics getGraphics()
推奨されていません。 
このクラスのインスタンスに対して呼び出すことはできません。

オーバーライド:
クラス com.nttdocomo.ui.Image 内の getGraphics
戻り値:
イメージに描画するためのグラフィックスオブジェクトを返します。
例外:
com.nttdocomo.lang.UnsupportedOperationException - このメソッドが呼ばれた場合に発生します。


NTT DoCoMo,Inc.

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

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

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