com.nttdocomo.opt.ui.j3d
クラス Texture

java.lang.Object
  |
  +--com.nttdocomo.opt.ui.j3d.Texture

public class Texture

extends java.lang.Object

テクスチャのデータを保持するクラスを定義します。
テクスチャはモデルマッピングならびに環境マッピングのために使用されます。 コンストラクタでどちら用のものかを指定します。
モデルマッピング用のテクスチャは、Figureオブジェクトにセットして使用します。 モデルマッピング用のテクスチャに対しては陰影設定を行うことができます。
環境マッピング用のテクスチャは、Graphics3Dオブジェクトにセットして使用します。 環境マッピング用のテクスチャに対しては陰影設定を行うことはできません。
元となるテクスチャデータはBMP形式の8bitで非圧縮のもののみ使用できます。 画像のサイズが規定のサイズよりも大きい場合は、 不正なデータとして読み込み時に例外が発生します。 画像のサイズが規定のサイズより小さい場合や、規定のサイズに満たない領域の色は機種依存です。

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

コンストラクタの概要

Texture(byte[] data, boolean forEnv)
テクスチャデータからテクスチャオブジェクトを生成します。

Texture(java.io.InputStream is, boolean forEnv)
テクスチャデータからテクスチャオブジェクトを生成します。

メソッドの概要

void	setNormalShader() このテクスチャが貼り付けられた物体の陰影設定を通常のモードに戻します。
void	setToonShader(int threshold, int high, int low) このテクスチャが貼り付けられた物体の陰影をトゥーンシェーディング にて描画するための情報を設定します。

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

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

コンストラクタの詳細

Texture

public Texture(java.io.InputStream is,
               boolean forEnv)
        throws java.io.IOException

テクスチャデータからテクスチャオブジェクトを生成します。
モデルマッピング用のテクスチャの場合、陰影設定は通常のモードになります。

パラメータ:

is - データのソースの入力ストリームを指定します。

forEnv - 環境マッピングのために使う場合にtrueを指定します。

例外:

java.io.IOException - データを読み出す際に I/O エラーが起こった場合に発生します。

com.nttdocomo.ui.UIException - データが不正な場合に発生します (UNSUPPORTED_FORMAT)。

Texture

public Texture(byte[] data,
               boolean forEnv)

テクスチャデータからテクスチャオブジェクトを生成します。
モデルマッピング用のテクスチャの場合、陰影設定は通常のモードになります。

パラメータ:

data - データを表すバイト列を指定します。

forEnv - 環境マッピングのために使う場合にtrueを指定します。

例外:

com.nttdocomo.ui.UIException - データが不正な場合に発生します (UNSUPPORTED_FORMAT)。

メソッドの詳細

setNormalShader

public void setNormalShader()

このテクスチャが貼り付けられた物体の陰影設定を通常のモードに戻します。 setToonShader(int, int, int) メソッドの呼び出しを取り消します。

例外:

com.nttdocomo.ui.UIException - 環境マッピング用のテクスチャに対して呼び出した場合に発生します(ILLEGAL_STATE)。

setToonShader

public void setToonShader(int threshold,
                          int high,
                          int low)

このテクスチャが貼り付けられた物体の陰影をトゥーンシェーディング にて描画するための情報を設定します。 シェーディング対象となる任意の点に対して、 通常の(グロー)シェーディングの結果として、その点の明るさが 元のテクスチャの明るさのd %と計算されたとすると、 このメソッド呼び出しにより、実際に描画される明るさは、 以下のようになります。

• d > threshold の時、 high % の明るさ。
• d ≤ thresholdの時、 low % の明るさ。

パラメータ:

threshold - 上記threasholdの値を指定します。 区間[0, 255]の値を指定することができ、 255が100%を表します。

high - 上記highの値を指定します。 区間[0, 255]の値を指定することができ、 255が100%を表します。

low - 上記lowの値を指定します。 区間[0, 255]の値を指定することができ、 255が100%を表します。

例外:

IllegalArgumentException - 引数のいずれかが区間[0, 255]に収まっていない場合に発生します。

com.nttdocomo.ui.UIException - 環境マッピング用のテクスチャに対して呼び出した場合に発生します(ILLEGAL_STATE)。

関連項目:

setNormalShader()