: クラス PalettedImage

概要

パッケージ

クラス

階層ツリー

非推奨 API

索引

ヘルプ

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

com.nttdocomo.opt.ui
クラス PalettedImage

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

public class PalettedImage
extends com.nttdocomo.ui.Image

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

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

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

コンストラクタの概要

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

メソッドの概要

static PalettedImage createPalettedImage(byte[] data)
           パレットを設定できるイメージを生成します。

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

Palette getPalette()
           パレットを取得します。

void setPalette(Palette palette)
           パレットを設定します。

クラス java.lang.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()

このクラスのインスタンスに対して呼び出すことはできません。

例外:: UnsupportedOperationException - このメソッドが呼ばれた場合に発生します。

概要