com.kddi.graphics
クラス ImageEncoder　＜Phase3＞

java.lang.Object
  |
  +--com.kddi.graphics.ImageEncoder

public class ImageEncoder

extends java.lang.Object

イメージを JPEG 形式でエンコードして byte 型配列のデータに変換します。

エンコードできるデータは mutable な Image オブジェクトだけです。 immutable な Image オブジェクト は mutable な Image オブジェクトに変換してください。 Image オブジェクトの mutable、immutable については MIDP の javax.microedition.lcdui.Image クラスの説明を参照してください。

フィールドの概要

static int	QUALITY_HIGH エンコード品質 ： 高 を示します。
static int	QUALITY_LOW エンコード品質 ： 低 を示します。
static int	QUALITY_NORMAL エンコード品質 ： 標準 を示します。

コンストラクタの概要

ImageEncoder()
イメージエンコーダーを作成します。

ImageEncoder(int quality)
イメージエンコーダーを作成します。

メソッドの概要

byte[]	encode(javax.microedition.lcdui.Image src) 画像をエンコードします。
byte[]	encode(javax.microedition.lcdui.Image src, int x, int y, int width, int height) 指定された領域の画像をエンコードします。
int	getQuality() 品質を返します。
void	setQuality(int quality) 品質を設定します。

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

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

フィールドの詳細

QUALITY_LOW

public static final int QUALITY_LOW

エンコード品質 ： 低 を示します。
品質は悪くなりますが、サイズも小さくなります。 実際の圧縮率は移動機依存となります。

定数 0 が割り当てられています。

QUALITY_NORMAL

public static final int QUALITY_NORMAL

エンコード品質 ： 標準 を示します。
実際の圧縮率は移動機依存となります。 品質が未設定の場合の初期値はこの値になります。

定数 1 が割り当てられています。

QUALITY_HIGH

public static final int QUALITY_HIGH

エンコード品質 ： 高 を示します。
品質を重視しますが、サイズも大きくなります。 実際の圧縮率は移動機依存となります。

定数 2 が割り当てられています。

コンストラクタの詳細

ImageEncoder

public ImageEncoder()

イメージエンコーダーを作成します。 品質の初期値は QUALITY_NORMAL となります。

ImageEncoder

public ImageEncoder(int quality)

イメージエンコーダーを作成します。

パラメータ:

quality - 品質です。 以下の値が指定されます。

• QUALITY_HIGH
• QUALITY_NORMAL
• QUALITY_LOW

例外:

java.lang.IllegalArgumentException - 品質の指定が不正な場合に発生する

メソッドの詳細

getQuality

public int getQuality()

品質を返します。

戻り値:

品質
QUALITY_HIGH ： 高品質
QUALITY_NORMAL ： 標準品質
QUALITY_LOW ： 低品質

setQuality

public void setQuality(int quality)

品質を設定します。

パラメータ:

quality - 品質です。 以下の値が指定されます。

• QUALITY_HIGH
• QUALITY_NORMAL
• QUALITY_LOW

例外:

java.lang.IllegalArgumentException - 品質の指定が不正な場合に発生する

encode

public byte[] encode(javax.microedition.lcdui.Image src,
                     int x,
                     int y,
                     int width,
                     int height)

指定された領域の画像をエンコードします。

画像は mutable である必要があります。

パラメータ:

src - エンコードする Image オブジェクト

x - エンコードする領域の左上の x 座標値

y - エンコードする領域の左上の y 座標値

width - エンコードする領域の幅

height - エンコードする領域の高さ

戻り値:

エンコード結果のデータ
null ： エンコード失敗

例外:

java.lang.IllegalArgumentException - 引数 x、y、width、height で指定する領域が引数 src の画像領域からはみ出ている場合に発生する
または、引数 src が示す Image オブジェクトが immutable イメージの場合に発生する

encode

public byte[] encode(javax.microedition.lcdui.Image src)

画像をエンコードします。

画像は mutable である必要があります。

パラメータ:

src - エンコードする Image オブジェクト

戻り値:

エンコード結果のデータ
null ： エンコード失敗

例外:

java.lang.IllegalArgumentException - 引数 src が示す Image オブジェクトが immutable イメージの場合に発生する